Integracje / bol.com
Portale i marketplace
Integracja AI: bol.com
Podłączamy bol.com Retailer API v10 i czytamy zamówienia z polem shipmentDeadline z Leveringsbelofte, wiadomości kupujących i zwroty ze standaryzowaną listą returnReason. Asystent pilnuje deadlinów wysyłki, pisze odpowiedzi po niderlandzku i zestawia wskaźniki Prestaties, zanim platforma wyśle ostrzeżenie.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie bol.com włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyorderId, orderPlacedDateTime i shipmentDeadline wynikający z Leveringsbelofte
AsystentUkłada dzienny plan wysyłki posortowany po deadlinie i wysyła alert, gdy do terminu zostały mniej niż cztery godziny bez numeru śledzenia.
CzytamyreturnReason ze standaryzowanej listy (defect, wrong product, too large i kilkanaście innych wartości)
AsystentSprawdza, czy wniosek wymaga odpowiedzi w ciągu 48 godzin, i przygotowuje projekt pisma do wysłania przez API.
CzytamymessageBody i dane kupującego z billingDetails.firstName wraz z powiązanym orderId
AsystentPisze odpowiedź po niderlandzku, zwracając się do kupującego po imieniu z informacją o numerze śledzenia lub aktualnym statusie paczki.
CzytamyofferId, stockOnHand i status oferty: published, in_review albo not_published
AsystentSygnalizuje, gdy oferta traci status published lub zapas spada do zera, zanim platforma ukryje ją w wynikach wyszukiwania.
Czytamyannuleringspercentage, percentaje te laat verstuurd, track-en-tracepercentage i retouren afgehandeld op tijd
AsystentPorównuje codziennie z progami platformy i wysyła poranną informację do managera, gdy wskaźnik zbliża się do granicy ostrzeżenia.
CzytamyPliki PDF z rozliczeniami prowizji i wypłat, pobierane z verkoper.bol.com dwa razy w miesiącu
AsystentPrzetwarza pobrany plik PDF: wyciąga sumy prowizji, zestawia z liczbą zamówień i pokazuje rozliczenie za dany okres.
CzytamyNazwa produktu, EAN i parametry techniczne dostępne w karcie oferty na bol.com
AsystentPisze lub poprawia opis po niderlandzku zgodnie ze strukturą atrybutów wymaganą przez platformę, bez dosłownego tłumaczenia z polskiego.
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Które zamówienia na bol.com muszą wyjść dziś przed godziną 14:00?”
- „Czy któryś z holenderskich kupujących czeka na odpowiedź ponad dobę?”
- „Jak wygląda wskaźnik terminowości na bol.com w tym tygodniu?”
- „Jak odpowiedzieć kupującemu po niderlandzku, który pisze, że nie dostał paczki?”
Co się zmienia
Firma sprzedaje na holenderskim i belgijskim rynku bez opóźnionych wysyłek i nie traci widoczności w wynikach bol.com przez zaniedbane wskaźniki Prestaties.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
bol.com to marketplace działający w Holandii i Belgii, na którym kupujący zamawiają produkty online. Polska firma sprzedaje tu bez otwierania lokalnego sklepu i dociera do konsumentów w obu krajach. Platforma prowadzi sprzedawcę przez cztery obszary: zamówienia z terminami wysyłki, wiadomości od kupujących po niderlandzku, zwroty i panel wskaźników Prestaties.
Wszystkie dane sprzedaży platforma trzyma w swojej chmurze i udostępnia przez Retailer API v10. Zamówienia, oferty, zwroty i wiadomości są dostępne przez API na bieżąco. Zestawienia finansowe, czyli prowizje i wypłaty, bol.com generuje dwa razy w miesiącu jako plik PDF do ręcznego pobrania z panelu verkoper.bol.com: tego API nie daje.
Gdzie to działa najlepiej
Manager magazynu
Czwartek, 14:00. W kolejce czeka 23 zamówienia bol.com z różnymi terminami shipmentDeadline. Trzy mają deadline dziś o 17:00, dwa kolejne jutro rano. Magazyn nie wie, które z nich mają już numer śledzenia.
Z asystentem: AI pokazuje posortowaną listę: najpilniejsze na górze, z zaznaczeniem, które nie mają jeszcze trackingCode. Manager wie od razu, co pakować teraz, a co może poczekać do jutra.
Pracownik obsługi klienta
Kupujący z Holandii pisze na bol.com, że zamówiona szafka dotarła z uszkodzonym rogiem i pyta, co zrobić. Wiadomość jest po niderlandzku. Pracownik nie mówi po holendersku i nie wie, ile ma czasu na odpowiedź.
Z asystentem: AI odczytuje wiadomość, pobiera dane zamówienia i przygotowuje projekt odpowiedzi po niderlandzku z numerem zamówienia i propozycją zwrotu. Pracownik sprawdza treść i zatwierdza jednym kliknięciem.
Właściciel firmy
Poniedziałek rano. W weekend wypadły trzy opóźnienia wysyłki przez problem w magazynie. Właściciel nie wie, jak to wpłynęło na wskaźnik percentaje te laat verstuurd i czy konto jest już w strefie ostrzeżenia platformy.
Z asystentem: AI zestawia aktualny stan Prestaties, pokazuje zmianę percentaje te laat verstuurd i sygnalizuje, czy wskaźnik zbliżył się do progu. Właściciel reaguje, zanim platforma wyśle oficjalne ostrzeżenie.
Jak się łączymy
Łączymy się z bol.com przez Retailer API v10, REST/JSON z OAuth 2.0. Klucze Client ID i Client Secret firma generuje samodzielnie w dashboardzie verkoper.bol.com, w sekcji API keys. Zamówienia, zwroty i wiadomości czytamy w trybie odczytu. Potwierdzenie wysyłki i odpowiedź do kupującego wysyłamy przez API po zatwierdzeniu przez pracownika lub na podstawie ustawionej reguły.
Portal z bazą i plikami stoi na serwerze klienta. Do modelu AI trafia polecenie i te fragmenty danych, które są potrzebne do konkretnej odpowiedzi: treść wiadomości kupującego, dane zamówienia, aktualne wartości wskaźników. Klucze API do bol.com przechowujemy zaszyfrowane w bazie portalu, bez zapisywania w plikach tekstowych ani logach.
Czego potrzebujemy od Was
- Aktywne konto sprzedawcy na verkoper.bol.com z włączonym dostępem do sekcji API keys.
- Klucze API: Client ID i Client Secret wygenerowane przez firmę w dashboardzie bol.com.
- Adres e-mail lub kanał komunikatora, na który AI ma wysyłać alerty o terminach wysyłki.
- Osoba odpowiedzialna za akceptację odpowiedzi AI w pierwszym etapie wdrożenia.
- Dostęp do panelu sprzedawcy do ręcznego pobierania zestawień finansowych PDF.
Czego asystent nie robi
- Nie wysyła odpowiedzi do kupującego bez przeglądu przez pracownika w pierwszych dwóch tygodniach wdrożenia.
- Nie potwierdza wysyłki w API bol.com bez numeru śledzenia przekazanego przez system magazynowy lub wpisanego ręcznie.
- Nie pobiera zestawień finansowych automatycznie: bol.com nie udostępnia ich przez API, tylko jako PDF do ręcznego pobrania.
- Nie obsługuje samodzielnie reklamacji i sporów: te przypadki kieruje do pracownika z pełnym kontekstem zamówienia.
Częste pytania
Czy AI może automatycznie potwierdzać wysyłki w bol.com po ich nadaniu?
Tak, pod warunkiem że numer śledzenia trafi do portalu z systemu magazynowego albo zostanie wpisany przez pracownika. AI wysyła go do endpointu /retailer/shipments przez API. Bez numeru śledzenia potwierdzenie nie jest wysyłane, bo platforma wymaga go razem z datą nadania przesyłki.
Co się dzieje, gdy kupujący pisze o reklamacji, a nie o statusie przesyłki?
Reklamacje AI oznacza jako wymagające uwagi człowieka i nie odpowiada na nie automatycznie. Pracownik dostaje powiadomienie z treścią wiadomości i danymi zamówienia. Do obsługi samodzielnej AI kieruje tylko proste pytania: status wysyłki, potwierdzenie przyjęcia zwrotu, pytanie o dostępność.
Jak integracja działa, gdy firma sprzedaje na bol.com tylko w sezonie?
Połączenie API działa niezależnie od wolumenu zamówień. W martwym sezonie AI nadal czyta nowe wiadomości i monitoruje Prestaties, bo platforma liczy wskaźniki nawet przy niskiej aktywności. Zawieszenie sprzedaży nie zatrzymuje monitoringu konta.
Czy sami możemy zdecydować, które kategorie wiadomości AI obsługuje sama?
Tak. Przez pierwsze dwa tygodnie wszystkie odpowiedzi przechodzą przez akceptację pracownika. Potem firma ustala kategorie do obsługi automatycznej: typowo status wysyłki, potwierdzenie przyjęcia zwrotu i pytania o dostępność. Reklamacje i spory zawsze trafiają do człowieka.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Inne programy: portale i marketplace
bol.com jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.