Integracja sklepu B2B z hurtownią krok po kroku — kiedy plik CSV wystarczy, a kiedy trzeba API

Kiedy hurtownia uruchamia sklep B2B albo portal zamówień dla klientów, pojawia się pytanie, które często zadaje się za późno. Dopiero po wdrożeniu, kiedy stany magazynowe w sklepie zaczynają się rozjeżdżać z rzeczywistością. Jak dane o produktach, cenach i dostępności mają trafiać z systemu magazynowego hurtowni do sklepu, żeby klient nie zamawiał czegoś, czego akurat nie ma na stanie, i nie widział ceny sprzed trzech tygodni.

Dwa podejścia do tego samego problemu

Pierwsze podejście to integracja plikowa: system hurtowni eksportuje plik CSV albo XML z listą produktów, cen i stanów, a sklep importuje go w ustalonych odstępach, na przykład co godzinę albo raz dziennie w nocy. Drugie podejście to integracja przez API: sklep pyta system hurtowni bezpośrednio o dane, w momencie kiedy są potrzebne, na przykład kiedy klient wchodzi na stronę produktu albo składa zamówienie, więc dane są aktualne w danej chwili, nie sprzed ostatniego importu.

Różnica brzmi technicznie, ale ma bardzo praktyczne konsekwencje: dla kosztu wdrożenia, dla tego, jak szybko dane się aktualizują, i dla tego, co się dzieje, kiedy coś pójdzie nie tak.

Kiedy plik wystarczy

Integracja plikowa sprawdza się dobrze przy mniejszym katalogu: kilkuset, może kilku tysiącach pozycji, i przy cenach, które nie zmieniają się co godzinę. Jeśli stany magazynowe wystarczy odświeżać kilka razy dziennie, a nie w czasie rzeczywistym, cykliczny import w nocy albo co kilka godzin jest rozwiązaniem prostszym do wdrożenia i tańszym w utrzymaniu niż stałe połączenie API.

Zaletą pliku jest też odporność na awarie: jeśli system hurtowni ma chwilową przerwę techniczną, sklep dalej działa na ostatnio zaimportowanych danych, tylko nieco nieaktualnych, zamiast przestać pokazywać produkty w ogóle. To ważne w branżach, gdzie klient nie oczekuje stanu magazynowego co do sztuki w danej sekundzie. Wystarczy mu wiedzieć, że produkt „jest dostępny" albo „jest na zamówienie".

Wadą jest właśnie to opóźnienie. Jeśli towar sprzeda się w całości między jednym importem a drugim, sklep przez kilka godzin pokazuje produkt jako dostępny, mimo że go nie ma: co przy zamówieniach B2B, gdzie klient kupuje na produkcję, a nie pod wpływem impulsu, bywa bardziej problematyczne niż w sklepie konsumenckim.

Kiedy potrzebne jest API

Integracja przez API ma sens tam, gdzie stany magazynowe zmieniają się często i szybko: duży katalog, wysoka rotacja, kilka kanałów sprzedaży jednocześnie (sklep B2B, sprzedaż telefoniczna, zamówienia od innych hurtowni), które wszystkie czerpią z tego samego magazynu. W takiej sytuacji import co godzinę nie wystarcza, bo w ciągu godziny stan mógł się zmienić kilkukrotnie, a klient w sklepie zobaczyłby dane, które już nie są prawdziwe w momencie kliknięcia „zamów".

API ma sens też przy cenach ustalanych indywidualnie dla klienta. Jeśli każdy klient widzi inny cennik zależny od swojego konta, sprawdzanie tego w czasie rzeczywistym przez zapytanie do systemu jest prostsze niż generowanie osobnego pliku cen dla każdego klienta z osobna, co przy stu kilkudziesięciu klientach szybko robi się nieporęczne.

Koszt tego rozwiązania jest wyższy: zarówno wdrożenia (trzeba zaprojektować i przetestować komunikację między systemami, obsłużyć sytuacje, kiedy jeden z systemów nie odpowiada), jak i utrzymania, bo stałe połączenie wymaga monitorowania, czy działa poprawnie.

Jak wygląda to w praktyce krok po kroku

Niezależnie od wybranego podejścia, wdrożenie integracji przebiega podobnie. Najpierw ustalenie, jakie dane w ogóle mają się synchronizować: sam stan magazynowy i cena to minimum, ale często dochodzą też opisy, zdjęcia, kategorie, dostępne warianty. Później wybór częstotliwości albo trybu. Cykliczny import co ile czasu, albo połączenie na żywo. Następnie mapowanie danych: nazwy pól w systemie hurtowni rzadko pokrywają się jeden do jednego z polami w sklepie, więc trzeba ustalić, co odpowiada czemu (na przykład indeks magazynowy hurtowni jako SKU w sklepie).

Kluczowy, często pomijany krok to obsługa błędów: co się dzieje, kiedy import się nie powiedzie, kiedy produkt zniknie z jednego systemu, a wciąż istnieje w drugim, kiedy cena przyjdzie jako wartość ujemna przez błąd w eksporcie. Integracja, która działa tylko w idealnych warunkach, w praktyce zawodzi przy pierwszej nietypowej sytuacji, a te zdarzają się regularnie przy większej skali danych.

Które rozwiązanie wybrać na start

Jeśli katalog jest niewielki, a ceny stabilne, zaczęcie od integracji plikowej jest rozsądne: pozwala uruchomić sklep szybciej i taniej, a przejście na API zawsze można zrobić później, kiedy skala rzeczywiście tego wymaga. Zaczynanie od razu od pełnej integracji API przy małym katalogu bywa przeinwestowaniem. Kosztuje więcej, niż realnie zwraca na tym etapie.

Odwrotnie jest przy dużym katalogu z częstymi zmianami cen i kilkoma kanałami sprzedaży jednocześnie. Tam plikowa integracja szybko staje się wąskim gardłem, a rozbieżności między stanem w sklepie a rzeczywistością generują więcej problemów (reklamacje, anulowane zamówienia) niż kosztowałoby wdrożenie API od razu.

Dobranie właściwego podejścia do skali i specyfiki hurtowni to jedna z tych decyzji, które trudno cofnąć bez dodatkowego kosztu, dlatego warto ją przeanalizować przed wyborem dostawcy sklepu, nie po. Automatyzacje i integracje pokazują, jak dobieramy rozwiązanie do konkretnego przypadku, zamiast proponować jeden standardowy wariant każdej hurtowni.