Elbuz łączy się z kontem sprzedawcy Bol.com (marketplace w Holandii i Belgii) parą kluczy Retailer API: pobiera Twoje oferty do katalogu, przyjmuje zamówienia i odsyła na marketplace ceny i stany.
Kiedy to się przyda:
- Sprzedajesz na Bol.com i jeszcze gdzie indziej — stany i zamówienia wszystkich kanałów są prowadzone w jednym katalogu.
- Masz dużo zamówień — nowe i zmienione zamówienia przychodzą same co 5 minut.
- Ceny liczysz w Elbuz — eksport aktualizuje cenę i stan każdej oferty na Bol.com.
- Wchodzisz z nowymi produktami — Elbuz wystawia ofertę po EAN, a jeśli karty jeszcze nie ma, wysyła ją do katalogu Bol.com.
Od czego zacząć: utwórz klucze w Seller Dashboard i wklej je do szablonu typu „Bol.com”.
Co potrafi połączenie z Bol.com
- Połączenie dwoma kluczami — bez powiązania aplikacji i bez logowania do panelu z Elbuz.
- Import ofert — nazwa, opis i marka karty Bol.com, Twój kod produktu, , cena i stan.
- Zamówienia — otwarte przy pierwszym uruchomieniu, dalej wszystko, co zmieniło się w ostatnich dniach.
- Ceny i stany z powrotem na Bol.com — oferta po ofercie, z osobnym wierszem dziennika dla każdej odmowy.
- Publikacja nowych produktów — oferta po EAN na istniejącą kartę albo nowa karta według dopasowanej kategorii.
Skąd wziąć klucze Bol.com
Klucze sprzedawca tworzy sam, nie trzeba rejestrować żadnej aplikacji. Panel Bol.com jest po niderlandzku, dlatego nazwy pozycji podajemy tak jak w nim:
- Zaloguj się do Seller Dashboard (partner.bol.com) i otwórz Instellingen → API-instellingen.
- Utwórz klucze dla Retailer API, a nie dla Advertising API.
- Skopiuj Client ID i Client secret. Secret jest pokazywany tylko raz: jeśli okno zostało zamknięte bez skopiowania, utwórz nową parę.
W szablonie importu typu „Bol.com” karta „Połączenie” ma cztery pola, obowiązkowe są dwa pierwsze:
| Pole w szablonie | Co wpisać |
|---|---|
| Client ID | Client ID z API-instellingen. Obowiązkowe |
| Client secret | Client secret z tego samego miejsca. Po zapisaniu pole pokazuje kropki, samego klucza nie widać. Obowiązkowe |
| Język kart | nl, nl-BE, fr lub fr-BE. Puste pole lub inna wartość oznacza nl. Potrzebne tylko dla nowych kart |
| Czas dostawy do klienta | Dni w formacie min-max, na przykład 1-2 (tak będzie, jeśli pole zostanie puste). Potrzebne tylko dla nowych ofert |
Po wklejeniu kluczy kliknij „Sprawdź połączenie”. Elbuz pobierze token dostępu i odczyta jedną Twoją ofertę. Odpowiedź „Połączenie działa. Bol.com” oznacza, że klucze skopiowano w całości i pochodzą z Retailer API.
„Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po zapisaniu kluczy Elbuz zacznie pobierać otwarte zamówienia. Statusy marketplace’u Elbuz sam sprowadza do Twoich, po nazwie; co przyszło i jak zostało dopasowane, widać w oknie „Statusy zamówienia” szablonu. Jeśli chcesz najpierw wszystko sprawdzić, odznacz „Zamówienia”.
1
Client ID2
Client secret3
Język kart4
Czas dostawy- Client ID — pierwsza połowa pary kluczy z Seller Dashboard.
- Client secret — tajna połowa; po zapisaniu jest ukryta.
- Język kart — język nowych kart (nl, nl-BE, fr, fr-BE).
- Czas dostawy — obietnica dla klienta w nowych ofertach.
Dokumentacja Bol.com dla sprzedawców: Retailer API (po angielsku, wersji polskiej nie ma).
Co trafia do karty
Katalog Bol.com jest wspólny: kartę produktu (nazwa, opis, zdjęcia) prowadzi marketplace i znajduje ją po EAN, a Twoja oferta to cena, stan i czas dostawy. Elbuz pobiera listę Twoich ofert i do każdej osobno doczytuje kartę po EAN.
| Dane Bol.com | Pole produktu w Elbuz |
|---|---|
| nazwa karty (jeśli karty nie ma — nazwa, z którą wystawiono ofertę) | Nazwa |
| opis karty | Opis |
| marka karty | Producent |
| reference — Twój kod oferty | Kod produktu |
| EAN oferty | Kod kreskowy |
| cena oferty | Cena — liczbą, tak jak jest |
| stan oferty | Ilość |
| oferta nie jest wstrzymana, a stan jest większy od zera | produkt włączony; w przeciwnym razie wyłączony |
Czego z Bol.com nie dostaniesz: zdjęć (w Retailer API nie ma linków do obrazów), parametrów, kategorii. Pole wyboru „Zdjęcia” w formularzu szablonu dla Bol.com niczego nie importuje.
Bol.com liczy wszystko w euro, a Elbuz zapisuje cenę oferty w polu „Cena” tą samą liczbą. Jeśli prowadzisz katalog w innej walucie, 19,99 z Bol.com stanie się 19,99 Twojej waluty. W takim przypadku nie importuj cen z Bol.com, tylko prowadź je w Elbuz (Bol.com jako kanał).
Wszystkie nowe produkty trafiają do kategorii technicznej „Produkty - bol”. Powstaje ona jako wyłączona i nie bierze udziału w eksportach: takie produkty nigdzie nie trafią, dopóki nie przeniesiesz ich do swoich kategorii. Jak uporządkować kategorię techniczną: kategorie techniczne i marki.
Co nadpisze ponowny przebieg
Ponowny import szuka swojego produktu najpierw po powiązaniu z ofertą, które Elbuz zapamiętał poprzednim razem, a jeśli go jeszcze nie ma — po nazwie. Po EAN istniejący produkt katalogu nie jest wyszukiwany: pierwszy przebieg powiąże ofertę z Twoją kartą tylko wtedy, gdy nazwa się zgadza, a w karcie nie ma kodu producenta ani linku do produktu. W przeciwnym razie utworzy nową kartę.
| Co robi przebieg | Pola |
|---|---|
| Nadpisuje danymi Bol.com | nazwa, opis, producent, kod produktu, kod kreskowy, cena, ilość, znacznik „włączony” |
| Nie czyści, bo Bol.com ich nie przekazuje | krótki opis, stara cena, tagi |
| Nie rusza | miejsce w drzewie kategorii, zdjęcia, parametry |
Pusta wartość z Bol.com nie czyści wypełnionego pola. Jeśli nie udało się odczytać karty po EAN, nazwa i opis istniejącego już produktu zostają bez zmian, a nie są zastępowane zaślepką.
Osobnego pola „nie aktualizuj nazwy” w szablonie Bol.com nie ma. Jeśli chcesz zachować własne nazwy i opisy, włącz w karcie produktu przełącznik „Nie aktualizuj” (sekcja „Ochrona podczas importu”): przebieg nie zmieni w niej niczego. Przełącznik „Stała cena” chroni przed nadpisaniem tylko cenę. Dla całego katalogu prościej odznaczyć „Produkty” po pierwszym przebiegu (scenariusz).
Oferty, której nie było w przebiegu, import nie rusza: produkt zostaje z ostatnią ceną i stanem, nie jest wyłączany ani usuwany.
Jak przychodzą zamówienia
Elbuz pobiera zamówienia, które wysyłasz sam. Zamówienia wysyłane przez Bol.com z jego własnego magazynu nie trafiają do tego połączenia.
- Pierwsze uruchomienie pobiera tylko otwarte zamówienia — historii wysłanych Elbuz nie przenosi.
- Kolejne uruchomienia pobierają wszystkie zamówienia zmienione od daty poprzedniego uruchomienia, z zapasem dwunastu godzin. Dzięki temu do już zaimportowanych docierają wysyłki i anulowania.
- Dalej niż 90 dni wstecz Elbuz nie sięga: tyle historii przechowuje Bol.com.
Do dokumentu „Zamówienie klienta” trafiają numer i data zamówienia, imię i nazwisko odbiorcy, telefon, e-mail, adres dostawy (ulica, numer domu, miasto, kod pocztowy, kraj; dla punktu odbioru — jego nazwa), pozycje z cenami i kwota w euro. E-mail Bol.com przekazuje w formie zanonimizowanej, ale stałej dla klienta, więc kolejne zamówienia jednej osoby trafiają do jednego kontrahenta.
Osobnego statusu zamówienia w Bol.com nie ma, Elbuz wyprowadza go z wierszy:
| Kod | Kiedy |
|---|---|
OPEN | są niewysłane i nieanulowane pozycje |
SHIPPED | wszystko wysłano albo część anulowano, a resztę wysłano |
CANCELLED | anulowano wszystko |
SHIPPED i CANCELLED Elbuz sam sprowadza do „Wysłano” i „Anulowano”, OPEN trafia jako „Nowy”; jeśli chcesz inaczej, ustaw to przyciskiem „Statusy zamówienia” w karcie „Powiązane ustawienia” formularza szablonu. Co ponowny przebieg zmienia w już zaimportowanym zamówieniu — kto kogo nadpisuje: Twój status czy marketplace’u.
1
Statusy zamówienia2
Ustawienia harmonogramu- Statusy zamówienia — dopasowanie OPEN, SHIPPED, CANCELLED do Twoich statusów.
- Ustawienia harmonogramu — jak często pobierać zamówienia i katalog.
Na Bol.com Elbuz niczego nie potwierdza ani nie wysyła: wysyłkę i numer śledzenia rejestrujesz w panelu Bol.com, a następny przebieg zmieni status zamówienia na SHIPPED.
Jeśli nie udało się pobrać szczegółów pojedynczego zamówienia, w dzienniku pojawi się wiersz z jego numerem, a data, od której pobierana jest następna porcja, cofnie się. Następne uruchomienie pobierze to zamówienie jeszcze raz.
Jak ceny i stany wracają na Bol.com
Kierunek odwrotny to osobny szablon eksportu typu „Bol.com”. W karcie „Połączenie” są te same Client ID i Client secret, a pole „Wersja API (parametry platformy)” ustala język kart i czas dostawy, rozdzielone pionową kreską: nl|1-2.
1
Client ID2
Client secret3
Wersja API (parametry platformy)- Client ID — ten sam klucz co w szablonie importu.
- Client secret — tajna połowa pary kluczy.
- Wersja API (parametry platformy) — język kart i czas dostawy, połączone pionową kreską.
Gdy w karcie „Co eksportować” zaznaczone jest pole „Produkty”, Elbuz wysyła każdą ofertę osobnym zapytaniem: cenę i stan. Klucz oferty bierze z powiązania, które utworzył import katalogu lub poprzednia publikacja, dlatego najpierw raz zaimportuj katalog z Bol.com, a potem ustaw eksport. Produkty z wyniku filtrowania bez powiązania są po cichu pomijane, chyba że włączono „Publikuj nowe produkty”.
- Waluta. Bol.com przyjmuje tylko euro, a Elbuz wysyła cenę taką liczbą, jaka jest w produkcie, bez przeliczenia. Jeśli katalog jest w złotych lub innej walucie, przelicz cenę formułą w „Ustawienia eksportu pól” szablonu, inaczej 1500 zł pojedzie jako 1500 euro.
- Narzut dla Bol.com ustawia się tą samą formułą ceny w szablonie eksportu, ceny w katalogu zostają bez zmian.
- Granice ceny — od 1 do 9999 euro. Oferta z ceną spoza nich nie jest wysyłana, a w dzienniku pojawi się wiersz „Bol.com: „…” — cena … poza dozwolonym zakresem 1–9999 EUR, oferta nie została zaktualizowana”.
- Stan mniejszy od zera jest wysyłany jako zero.
Elbuz nie potrafi wycofywać ani usuwać ofert: produkt, który wypadł z wyniku filtrowania, po prostu przestanie dostawać aktualizacje. Żeby zatrzymać sprzedaż, ustaw stan zero i poczekaj na eksport albo wycofaj ofertę w panelu Bol.com.
Publikacja nowych produktów
Gdy w karcie „Co eksportować” zaznaczone jest pole „Publikuj nowe produkty”, Elbuz wystawia ofertę dla produktu, który nie ma jeszcze powiązania z Bol.com. Potrzebne są kod kreskowy z co najmniej 8 cyfr i cena od 1 do 9999 euro.
1
Produkty2
Publikuj nowe produkty- Produkty — aktualizuje ceny i stany powiązanych ofert.
- Publikuj nowe produkty — wystawia produkty, które nie mają jeszcze powiązania z Bol.com po EAN.
Oferta idzie z Twoją ceną, stanem, kodem produktu (albo numerem produktu w Elbuz, jeśli kodu nie ma), czasem dostawy z pola „Wersja API (parametry platformy)” i stanem z pola „Stan produktu”:
| Stan produktu w Elbuz | Stan oferty na Bol.com |
|---|---|
| Nowy lub niewypełniony | nowy |
| Przeceniony | używany, jak nowy |
| Używany | używany, w dobrym stanie |
| Odnowiony | odnowiony |
Jeśli masz już na Bol.com ofertę na ten EAN (wystawioną w panelu lub poprzednim uruchomieniem), Elbuz nie tworzy drugiej, tylko znajduje istniejącą i wiąże ją z produktem. Każda publikacja to wiersz dziennika „Bol.com: opublikowano produkt „…” (oferta …)”.
Jeśli karty produktu na Bol.com jeszcze nie ma
Przed publikacją Elbuz sprawdza EAN w katalogu Bol.com. Jeśli karty nie ma, wysyła ją do weryfikacji przez marketplace: EAN, nazwę, opis, producenta, zdjęcie główne i kategorię Bol.com. Kategorię bierze z dopasowania kategorii produktu.
Gdzie: Słowniki → Kategorie → kafelek „Powiązanie z marketplace'ami” → przełącznik „Bol.com”.
Przy pierwszym otwarciu kliknij „Pobierz słownik platformy” — drzewo kategorii Bol.com pobierze się z kluczy szablonu importu. Następnie dopasuj swoje kategorie w kolumnie „Kategoria Bol.com”. Jak działa to okno: dopasowanie kategorii do marketplace’ów.
1
Przełącznik Bol.com2
Kolumna „Kategoria Bol.com”3
Pobierz słownik platformy- Przełącznik Bol.com pokazuje kolumny tylko tego marketplace’u.
- Kolumna „Kategoria Bol.com” zawiera kategorię Bol.com, do której trafi nowa karta produktu.
- Przycisk „Pobierz słownik platformy” pobiera drzewo kategorii Bol.com.
Ograniczenia nowej karty:
- jedna karta — jeden produkt: wariantów (rozmiar, kolor) Elbuz nie grupuje;
- zdjęcie jest jedno — pierwszy link z produktu, oznaczony jako główny;
- parametrów poza nazwą, opisem i marką nie wysyła — resztę marketplace może poprosić o uzupełnienie w panelu;
- język karty — z pola „Wersja API (parametry platformy)” (
nl,nl-BE,fr,fr-BE).
Na odpowiedź Bol.com Elbuz czeka kilka sekund. Jeśli zdąży, w dzienniku będzie „kartę wysłano do katalogu Bol.com (status: SUCCESS)” albo „karta odrzucona: …” z przyczyną. Jeśli nie zdąży, status to PENDING: oferta i tak powstaje i pojawi się na stronie Bol.com, gdy marketplace zatwierdzi kartę.
Aktualizacja według harmonogramu
Bol.com nie wysyła natychmiastowych powiadomień, dlatego zamówienia Elbuz pobiera sam co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i wypełniono klucze. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań”, tam też zmienia się interwał. Katalog nie jest importowany w tym przebiegu, a zamówienia pobrane dodatkowo przez harmonogram szablonu nie dublują się.
Katalog aktualizuje harmonogram samego szablonu — przycisk „Ustawienia harmonogramu”. Ustaw go rzadko, na przykład w nocy: dopóki trwa import katalogu, przebieg zamówień jest pomijany do następnego. Eksport to osobny szablon z własnym harmonogramem i własnym przełącznikiem „Aktywny”.
Limit zapytań w Bol.com jest sztywny: dla zamówień — około 25 zapytań na minutę. Po odmowie z powodu limitu Elbuz czeka tyle, ile wskazał marketplace (do minuty), i ponawia próbę do trzech razy. Najdłużej trwa import katalogu, bo kartę każdej oferty Elbuz pobiera osobno, oraz eksport — bo każda oferta jest aktualizowana własnym zapytaniem.
Przerwanie przebiegu jest bezpieczne: katalog zapisuje się partiami po 500 ofert, zamówienia są wyszukiwane po numerze, a powiązana oferta jest aktualizowana po tym samym kluczu. Ogólne zasady: jeśli przebieg został przerwany.
Scenariusze
1
Produkty2
Zamówienia- Produkty — pobiera Twoje oferty Bol.com do katalogu.
- Zamówienia — odbiera zamówienia z Bol.com.
Przenieść katalog Bol.com do Elbuz
Co włączyć. Wypełnij „Client ID” i „Client secret”, a w karcie „Wybór danych do importu” zaznacz „Produkty”.
Efekt. Każda oferta trafi do kategorii „Produkty - bol” z nazwą, opisem i marką karty, Twoim kodem produktu, kodem kreskowym, ceną w euro i stanem. Zdjęcia, parametry i kategorie dodaj sam albo z cennika dostawcy.
Przyjmować zamówienia z Bol.com
Co włączyć. Pole „Zamówienia”; statusy Elbuz dopasuje sam, przycisk „Statusy zamówienia” — jeśli chcesz inaczej. Harmonogram szablonu nie jest potrzebny: zamówienia przychodzą same co 5 minut.
Efekt. Pierwszy przebieg pobierze otwarte zamówienia, kolejne — wszystko, co zmieniło się od daty w polu „Import zamówień począwszy od daty (RRRR-MM-DD)” w bloku „Zaawansowane”. Wysyłka zarejestrowana w panelu Bol.com zmieni status dokumentu przy następnym przebiegu.
Bol.com jako kanał dla katalogu, który prowadzisz w Elbuz
Co włączyć. Raz uruchom import z zaznaczonym polem „Produkty” — powiąże on produkty z ofertami. Potem zostaw tylko „Zamówienia”, inaczej przebieg katalogu będzie nadpisywał cenę i stan wartościami z Bol.com. Ceny wysyła szablon eksportu typu „Bol.com”, w razie potrzeby z formułą przeliczenia na euro.
Efekt. Powiązane produkty będą dostawać nową cenę i stan przy każdym eksporcie, a z zaznaczonym polem „Publikuj nowe produkty” Elbuz będzie wystawiał również nowe pozycje po EAN.
Co zrobić, gdy Bol.com nie zwraca lub nie przyjmuje danych
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Bol.com: podaj Client ID i Client secret z Seller Dashboard” | Jedno z pól kluczy jest puste | Wklej oba klucze i zapisz szablon (skąd wziąć klucze) |
| „Połączenie nie powiodło się: HTTP 401 (token): …” lub „Bol.com: błąd API — HTTP 401 (token): …” | Klucz skopiowano niecały, usunięto go w panelu albo to klucz Advertising API | Utwórz nową parę dla Retailer API w API-instellingen i wklej oba klucze od nowa |
| „Bol.com: błąd API — HTTP 429: rate limit” | Limit zapytań nie odnowił się nawet po trzech ponowieniach | W przebiegu zamówień — zwiększ interwał zadania „Zamówienia z marketplace’ów”: każdy przebieg od nowa pobiera szczegóły wszystkich zamówień zmienionych dziś (rano — także wczoraj); w katalogu — uruchamiaj import katalogu rzadziej. Ponowienie jest bezpieczne (harmonogram) |
| „Bol.com: ceny i stany zaktualizowane, ofert: N (błędów: M)” z niezerowym M | Bol.com odrzucił część ofert; przyczyna jest w wierszu „Bol.com: błąd eksportu [nazwa] …” wyżej | Popraw wskazane dane w produktach i uruchom eksport jeszcze raz — pozostałe oferty są już zaktualizowane |
| „Bol.com: „…” — cena … poza dozwolonym zakresem 1–9999 EUR, oferta nie została zaktualizowana” | Cena jest pusta, zerowa lub nieprzeliczona na euro | Ustaw cenę albo formułę przeliczenia w szablonie eksportu (waluta) |
| „Bol.com: „…” — brak kodu kreskowego EAN, publikacja na Bol.com jest niemożliwa” | Oferta na Bol.com istnieje tylko z EAN | Wypełnij w produkcie kod kreskowy z co najmniej 8 cyfr (publikacja) |
| „Bol.com: „…” — brak karty w katalogu Bol.com, a kategoria Bol.com nie jest powiązana…” | Nowa karta wymaga kategorii Bol.com | Dopasuj kategorię produktu do kategorii Bol.com (nowe karty) |
| „Bol.com: „…” — karta odrzucona: …” | Bol.com nie przyjął danych karty; przyczyna jest po dwukropku | Popraw nazwę, opis lub zdjęcie produktu albo utwórz kartę w panelu Bol.com |
| Po pierwszym imporcie produkt się zdublował | Nazwa w Elbuz i na Bol.com jest różna, a po EAN import nie łączy produktów | Prowadź dalej nową kartę — to z nią powiązana jest oferta; potrzebne dane przenieś ze starej, a starą usuń (ponowny przebieg) |
Najczęstsze pytania
Nie jestem z Holandii ani Belgii — czy mogę się podłączyć?
Tylko jeśli Bol.com zaprosił Cię do sprzedaży, a połączenie idzie przez certyfikowanego partnera. Ustala się to z Bol.com; przy działającym koncie klucze tworzy się tak samo (kto może sprzedawać).
Dlaczego produkty z Bol.com przyszły bez zdjęć?
Retailer API nie zwraca linków do obrazów kart. Dodaj zdjęcia w Elbuz sam albo z cennika dostawcy (co trafia do karty).
Dlaczego po pierwszym uruchomieniu nie ma starych zamówień?
Pierwsze uruchomienie pobiera tylko otwarte zamówienia. Wysłane wcześniej nie są przenoszone do Elbuz (zamówienia).
Czy Elbuz przekazuje na Bol.com numer śledzenia?
Nie. Wysyłkę rejestruj w panelu Bol.com — następny przebieg zmieni status zamówienia na SHIPPED (zamówienia).
Jak sprzedawać w Belgii po francusku?
Marketplace jest jeden dla obu krajów, osobny szablon nie jest potrzebny. Dla nowych kart podaj język fr-BE w polu „Język kart” i w polu „Wersja API (parametry platformy)” szablonu eksportu: fr-BE|1-2.
Produkt zniknął z Bol.com — czy Elbuz go usunie?
Nie. Pozycja zostanie z ostatnią ceną i stanem, usuń ją ręcznie (ponowny przebieg).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → nowy szablon typu „Bol.com”
- Inne wejścia
- Słowniki → Operacje → Eksport danych — szablon dla cen i stanów
- Uprawnienia
- okno „Import danych” w uprawnieniach grup
- Co przygotować
- Client ID i Client secret z Seller Dashboard Bol.com
Bol.com sprzedaje tylko klientom w Holandii i Belgii. Sprzedawca zarejestrowany w innym kraju trafia na marketplace tylko na zaproszenie Bol.com i przez certyfikowanego partnera integracyjnego. Trzeba to ustalić z Bol.com przed podłączeniem do Elbuz: bez aktywnego konta sprzedawcy kluczy w panelu nie będzie.
Powiązane tematy
- Jeśli potrzebujesz ogólnej mechaniki importu — harmonogram, przerwanie, kategorie techniczne: przegląd importu danych.
- Jeśli chcesz zrozumieć, co ponowny przebieg robi z zamówieniem menedżera: import zamówień przez API.
- Jeśli dopasowujesz kategorie także dla innych marketplace’ów: dopasowanie kategorii do marketplace’ów.
- Jeśli sprzedajesz też w Niemczech lub w Polsce: podłączenie Kaufland.
