BaseLinker

1. Zaloguj się na panel-d.baselinker.com kontem z uprawnieniami administratora.
2. W menu po lewej: Moje konto → API.
3. Kliknij „Generuj nowy token".
4. W polu opisu wpisz np. BidBil (żebyś wiedział, do czego klucz służy, gdybyś chciał go w przyszłości odwołać).
5. Skopiuj token — będzie ~32 znaki alfanumeryczne. Nie pokaże się drugi raz — jeśli zgubisz, trzeba wygenerować nowy.

1. Zaloguj się na /profile/settings/integrations/new (musisz mieć konto firmowe — typ konta zmienisz w ustawieniach).
2. Platforma: wybierz BaseLinker.
3. Nazwa: dowolna, np. Mój sklep BL. To etykieta dla Ciebie — admin BidBil tego nie widzi.
4. Token API BaseLinker: wklej token z kroku 1.
5. ID magazynu: zostaw puste jeśli masz jeden magazyn. Inaczej zobacz krok 3.
6. Kliknij Utwórz. Integracja powstanie w statusie Szkic.

BaseLinker pozwala mieć kilka magazynów na jednym koncie (np. produkty PL/DE/CZ, albo różne marki). BidBil domyślnie używa pierwszego magazynu z konta.

Jeśli chcesz inny:

1. Na stronie integracji (klikasz „Konfiguruj" przy integracji na liście) zobaczysz sekcję „Magazyn BaseLinker".
2. Kliknij „Pobierz listę magazynów" — pojawi się dropdown z nazwami + ID.
3. Wybierz, kliknij Zapisz. Od następnego cyklu sync produkty będą szły z wybranego magazynu.

Kategorie

1. Sekcja „Mapowanie kategorii" → „Pobierz kategorie sklepu".
2. Dla każdej kategorii BL wybierz odpowiednik z BidBil. Pomiń = produkty z tej kategorii NIE pójdą do BidBil.
3. Musisz zmapować min. 1 kategorię, inaczej nie aktywujesz.
4. Kliknij Zapisz mapowanie.

Atrybuty (np. marka, rozmiar)

1. Sekcja „Mapowanie atrybutów" → „Skanuj atrybuty produktów".
2. System pobierze próbkę produktów i zaproponuje dopasowanie do atrybutów BidBil po nazwie (tag auto).
3. Przejrzyj sugestie, popraw te które źle dopasował, pomiń te których nie chcesz w BidBil.
4. Kliknij Zapisz mapowanie atrybutów.

Aktywacja

1. Kliknij Aktywuj w prawym górnym rogu.
2. Status zmieni się na Aktywna. Pierwszy sync ruszy w ciągu ≤15 minut.
3. Pierwsza partia produktów (do 200) trafi do BidBil jako oczekujące na akceptację. Admin BidBil sprawdza i zatwierdza.
4. Po pierwszej akceptacji admin oznacza integrację jako zaufaną — kolejne produkty idą od razu na żywo.

BaseLinker pozwala każdej firmie zdefiniować własne statusy zamówień. BidBil potrzebuje wiedzieć, który status oznacza wysłane, który anulowane itd. — żeby zaktualizować zamówienie w BidBil gdy zmienisz status w BL.

Domyślnie BidBil zakłada następujące ID (typowe dla świeżego konta BL):

Twoje ID sprawdzisz w BL: Zamówienia → Statusy. Obok każdej nazwy jest ID.

Aby nadpisać, edytuj integrację w BidBil i dorzuć te klucze do pola credentials (na razie wymaga supportu — napisz na integracje@bidbil.com; wkrótce zrobimy UI).

Domyślnie BidBil oznacza zamówienia push-owane do BL stawką 23% VAT (standard PL). Jeśli sprzedajesz książki (5%), jedzenie (8%) albo mieszane (różne stawki), w polu default_vat_rate credentials wpisz właściwą stawkę.

Dla shopów mieszanych: BL pokaże zamówienia z jedną stawką (najczęstsza w Twojej ofercie). Faktury i tak generujesz w BL ręcznie/automatem, gdzie możesz skorygować per pozycja.