Integracja z operatorem logistycznym potrafi trwać tydzień albo kwartał. Różnicę robi zwykle nie technologia, lecz decyzja podjęta na pierwszym spotkaniu: czy potrzebujemy pełnej integracji API, czy wystarczy wymiana plików.
Kiedy CSV jest wystarczający
Wymiana plików ma złą prasę, ale przy wolumenie do kilkuset przesyłek dziennie i jednym oknie nadania na dobę działa bez zarzutu. Wdrożenie zamyka się w dwóch dniach, nie wymaga zasobów developerskich po stronie sklepu i jest odporne na chwilowe awarie sieci.
- stały harmonogram nadań,
- brak potrzeby statusów w czasie rzeczywistym,
- jeden magazyn, jeden format etykiety.
Kiedy API zwraca się od pierwszego dnia
Jeśli klient końcowy ma widzieć okna dostaw na checkoucie, a obsługa klienta statusy bez logowania do panelu operatora — wymiana plików przestaje wystarczać. API daje trzy rzeczy, których CSV nie da: dostępność slotów w momencie zakupu, status przesyłki w Twoim systemie i możliwość zmiany zlecenia po jego utworzeniu.
Zasada kciuka: jeśli klient końcowy ma zobaczyć efekt integracji, potrzebujesz API.
Plan na trzy dni
Dzień 1 — środowisko testowe, uwierzytelnienie, pierwsza przesyłka próbna i etykieta. Dzień 2 — mapowanie statusów na te używane w Twoim sklepie oraz obsługa błędów: brak adresu, zły kod pocztowy, przekroczone gabaryty. Dzień 3 — test wolumenowy, webhooki statusowe i przejście na produkcję z ograniczonym ruchem.
Trzy pułapki
- Statusy „na wyrost”. Mapuj tylko te, które realnie zmieniają zachowanie Twojego zespołu.
- Brak idempotencji. Ponowne wysłanie tego samego zlecenia nie może tworzyć drugiej przesyłki.
- Testy tylko na happy path. Połowa zgłoszeń po wdrożeniu dotyczy adresów, których nie da się zwalidować.
Niezależnie od wybranej drogi warto zapisać w umowie, kto odpowiada za utrzymanie integracji po stronie operatora i w jakim czasie reaguje na zgłoszenia. To jedno zdanie oszczędza wiele tygodni.
