Automatyczne nadawanie przesyłek InPost w systemie do obsługi zamówień

Etykiety, zlecenia odbioru i potwierdzenia nadania

Po utworzeniu przesyłek przychodzi czas na fizyczne nadanie. Tu również automatyzacja oszczędza najwięcej czasu, bo zamiast pobierać pliki pojedynczo, magazyn drukuje etykiety seryjnie, w kolejności pakowania.

• Etykiety – API pozwala pobrać etykiety dla maksymalnie 100 przesyłek w jednym zapytaniu; dla przesyłek jednej usługi zwracany jest jeden plik.

• Format – PDF sprawdza się na zwykłej drukarce, ZPL lub EPL na drukarkach termicznych; najczęściej używa się formatu A6.

• Zlecenie odbioru – przez API można zamówić podjazd kuriera po przesyłki w statusie „confirmed”, wskazując adres odbioru.

• Potwierdzenie nadania – dla przesyłek utworzonych w API można wygenerować manifest (potwierdzenie nadania) dla zlecenia odbioru albo dla wskazanych przesyłek.

Jeśli nadajesz w Paczkomatach, a nie przez kuriera, zlecenie odbioru nie jest potrzebne – paczki z etykietami zanosisz do wybranego automatu lub PaczkoPunktu. Kiedy który wariant ma więcej sensu, porównujemy w tekście Nadawanie w Paczkomacie czy odbiór przez kuriera. Wybór drukarki i konfigurację wydruku opisujemy w artykule o drukowaniu etykiet w BaseLinkerze.

Wykres – automatyczne nadawanie przesyłki InPost krok po kroku, od zamówienia do statusów. [#chart:ip54]

Statusy przesyłek i komunikacja z klientem

Drugą połową automatyzacji są statusy. API ShipX udostępnia listę statusów przesyłek, np. przyjęcie w oddziale, wydanie do doręczenia, gotowość do odbioru w Paczkomacie czy zwrot do nadawcy. Zmiany statusów można odbierać przez webhook – adres podaje się w Managerze Paczek, w ustawieniach organizacji w zakładce API – albo odpytywać zasób śledzenia. Według FAQ dokumentacji API pozwala sprawdzać statusy przesyłek do 45 dni wstecz, a zapytanie o śledzenie dotyczy jednej przesyłki naraz – przy dużej liczbie paczek webhooki są więc wygodniejsze niż ciągłe odpytywanie.

Dla sklepu oznacza to, że zamówienie może samo zmienić status na „wysłane”, gdy paczka zostanie nadana, a na „dostarczone”, gdy klient ją odbierze. Do tego można podpiąć automatyczne wiadomości: numer przesyłki po nadaniu, przypomnienie o odbiorze, informację o zwrocie. Jak to wygląda w Base, opisujemy w tekście o śledzeniu przesyłek w Base.

[#uwaga] Webhooki InPost są wysyłane z określonej puli adresów IP, a adres URL musi odpowiadać kodem HTTP 200 na zapytanie GET. Jeśli serwer sklepu ma zaporę lub filtrowanie ruchu, powiadomienia mogą nie docierać, a zamówienia „utkną” w statusie sprzed nadania. Przy wdrożeniu sprawdź to na środowisku testowym.

Przy projektowaniu automatyzacji warto wiedzieć, które statusy są dla sklepu najważniejsze. W dokumentacji ShipX znajdziesz pełną listę, a w praktyce najczęściej wykorzystuje się kilka z nich:

• confirmed – przesyłka opłacona, ma numer i etykietę; moment na wydruk i pakowanie.

• collected_from_sender / taken_by_courier – paczka odebrana od nadawcy; dobry moment na zmianę statusu zamówienia na „wysłane”.

• ready_to_pickup – przesyłka czeka w Paczkomacie lub punkcie; klient dostaje powiadomienie od InPost.

• delivered – przesyłka odebrana; można zamknąć zamówienie i np. poprosić o opinię.

• returned_to_sender – zwrot do nadawcy; sygnał, by skontaktować się z klientem i zaplanować magazyn.

Gdzie ustawić automatyzację: system do zamówień czy własna integracja

Automatyczne nadawanie można zbudować na kilka sposobów. Wybór zależy od liczby kanałów sprzedaży, zasobów technicznych i tego, czy InPost ma być jedynym przewoźnikiem. Poniżej zestawienie, które pomaga podjąć decyzję.

Dla sklepów sprzedających w kilku kanałach najczęściej wygrywa system do obsługi zamówień: zamówienia z każdego źródła trafiają w jedno miejsce, a reguły wysyłki i statusy działają tak samo. Własna integracja ma sens przy nietypowych procesach albo gdy firma ma już rozbudowany system ERP – wtedy warto przeczytać tekst Integracja Base z ERP – kiedy jest potrzebna i jak ją zaplanować. O tym, jak przebiega i ile trwa wdrożenie systemu, piszemy w artykule Wdrożenie BaseLinkera – ile trwa, ile kosztuje i od czego zacząć, a o samej integracji InPost z panelem – w tekście BaseLinker InPost – Paczkomaty i nadawanie przesyłek z panelu Base.

[#checklista] Przed uruchomieniem automatycznego nadawania: token i ID organizacji wklejone w systemie; dane firmy i rachunek do pobrań uzupełnione w Managerze Paczek; gabaryty przypisane do produktów; reguły dla każdej metody dostawy ustawione; drukarka skonfigurowana do formatu etykiet; test utworzenia, wydruku i anulowania przesyłki wykonany; osoba odpowiedzialna za kontrolę pierwszych faktur wyznaczona.

Plan wdrożenia automatycznego nadawania krok po kroku

1. Zbierz wymagania – metody dostawy w sklepie i na marketplace’ach, usługi dodatkowe, miejsca nadania, liczba paczek dziennie.

2. Uporządkuj dane produktów – waga, gabaryt lub wymiary opakowania, produkty wysyłane wyłącznie kurierem.

3. Połącz konto InPost – token i ID organizacji z Managera Paczek, uzupełnione dane firmy i rachunek do pobrań.

4. Ustaw reguły – usługa według metody dostawy, gabaryt według produktu, pobranie i ochrona według zamówienia.

5. Przetestuj na środowisku testowym – utworzenie przesyłki, pobranie etykiety, anulowanie przed opłaceniem.

6. Uruchom na części zamówień – np. tylko dla jednego kanału sprzedaży przez kilka dni.

7. Dodaj statusy i powiadomienia – gdy tworzenie przesyłek działa bez błędów.

8. Kontroluj faktury – przez pierwsze tygodnie sprawdzaj, czy nie pojawiają się dopłaty za błędne gabaryty.

Testy warto robić na osobnym koncie w środowisku sandbox – dokumentacja ShipX podaje, że dane produkcyjne tam nie działają, a śledzenie statusów jest wyłączone. Więcej o testowaniu przeczytasz w osobnym artykule naszej serii o sandboksie ShipX.

Wykres – kiedy automatyzacja nadawania przesyłek InPost się opłaca, a kiedy wystarczy ręczna obsługa. [#chart:ip54b]

Najczęstsze problemy i jak je rozwiązać

Komunikaty błędów API, takie jak „validation_failed” czy „debt_collection”, opisuje dokumentacja ShipX. Jeśli łączysz InPost z systemem do obsługi zamówień, większość z nich zobaczysz w logach integracji jako czytelny komunikat. Przy własnej integracji warto od początku zapisywać odpowiedzi API, bo bez tego diagnozowanie problemów trwa znacznie dłużej.

Najczęściej zadawane pytania

Czy do automatyzacji wysyłek InPost potrzebna jest umowa?

Do tworzenia przesyłek przez API wystarczy konto w Managerze Paczek z wygenerowanym tokenem – przesyłki paczkomatowe działają także na koncie bez umowy, rozliczanym z salda. Usługi kurierskie dla firm wymagają umowy kurierskiej. Szczegóły warunków zawsze potwierdź z InPost.

Czy mogę automatycznie nadawać paczki z kilku kanałów sprzedaży?

Tak, jeśli zamówienia z wszystkich kanałów trafiają do jednego systemu, który łączy się z InPost. Wtedy reguły wysyłki działają tak samo dla sklepu i marketplace’ów. Pamiętaj tylko o usługach specyficznych dla kanału, np. Allegro Paczkomaty InPost.

Jak szybko po utworzeniu przesyłki pojawia się numer do śledzenia?

Numer pojawia się po potwierdzeniu przesyłki, bo API działa asynchronicznie. Zwykle następuje to krótko po utworzeniu, ale system powinien obsłużyć sytuację, w której numer nie jest dostępny od razu – odpytując przesyłkę lub korzystając z webhooków.

Czy automatyzacja eliminuje dopłaty za gabaryt?

Zmniejsza ich ryzyko, jeśli gabaryty są poprawnie przypisane do produktów. Reguła wybierze wtedy właściwy szablon przesyłki. Jeśli jednak dane produktów są błędne, automatyzacja powieli ten błąd na wszystkich paczkach, dlatego warto je sprawdzić przed startem.

Czy mogę anulować przesyłkę utworzoną przez API?

Według dokumentacji ShipX anulować można przesyłkę, która nie została jeszcze opłacona, czyli w statusie „created”, „offers_prepared” lub „offer_selected”. Przesyłki w statusie „confirmed” nie da się anulować przez API.

Od czego zacząć, jeśli dziś nadaję wszystko ręcznie?

Od uporządkowania danych produktów i połączenia konta InPost z systemem do obsługi zamówień. Potem uruchom automatyczne tworzenie przesyłek i seryjny wydruk etykiet. Statusy i powiadomienia dołóż, gdy podstawy będą działać bez błędów.

Podsumowanie

Automatyczne nadawanie przesyłek InPost to połączenie kilku elementów: dobrych danych produktów, reguł wyboru usługi i gabarytu, integracji przez API ShipX, seryjnego drukowania etykiet i obsługi statusów. Każdy z nich można wdrażać etapami, ale najwięcej zyskujesz, gdy działają razem i zamówienie przechodzi od koszyka do odbioru bez ręcznego przepisywania danych.

Wdrażamy i obsługujemy wysyłki InPost – od połączenia konta po reguły, etykiety i statusy. Jako certyfikowany partner wdrożeń Base ustawiamy proces tak, by magazyn tylko pakował, a system zajmował się resztą. Sprawdź, jak wygląda wdrożenie Base z automatyzacją wysyłek.