Integracja InPost - paczkomaty, etykiety i tracking

Integracja InPost z e-commerce - co realnie spina ze sklepem

InPost to dziś domyślna dostawa polskiego kupującego. Paczkomat na rogu, odbiór bez kuriera i powiadomienie SMS - dla wielu sklepów ponad połowa zamówień idzie właśnie tą drogą. Problem zaczyna się po stronie sprzedawcy: każda paczka to wejście do Menedżera Paczek InPost, przepisanie adresu albo numeru paczkomatu z zamówienia, wygenerowanie etykiety, druk i ręczne skopiowanie numeru przesyłki z powrotem do panelu sklepu.

Integracja InPost likwiduje to przepisywanie. NavyFlame pobiera zamówienia z platform sprzedażowych (Allegro, Shopify, WooCommerce i innych), a przy nadaniu woła API InPost z gotowymi danymi: nadawca, odbiorca, numer paczkomatu lub adres do kuriera, wymiary i waga. W odpowiedzi dostaje numer przesyłki oraz etykietę i przykleja oba przy zamówieniu.

Mówiąc wprost: integracja InPost w NavyFlame łączy trzy rzeczy, które dotąd robiłeś osobno. Wybór paczkomatu z zamówienia, generowanie etykiet InPost z danych zamówienia oraz numer śledzenia i statusy wracające do tego samego zamówienia. Wszystko w jednym widoku, bez logowania do panelu kuriera.

Wybór paczkomatu przez klienta - jak trafia do zamówienia

Punkt odbioru wybiera kupujący w momencie zakupu, a sklep musi ten wybór gdzieś zapisać. Sposób zależy od platformy i to ona jest źródłem danych - integracja InPost jedynie je odczytuje.

• Allegro przekazuje wybrany paczkomat w danych dostawy Smart, więc numer punktu (np. WAW01M) trafia do zamówienia automatycznie.
• Shopify i WooCommerce zwykle korzystają z wtyczki mapy paczkomatów InPost, która zapisuje wybrany punkt w polach dostawy zamówienia.
• PrestaShop, Shoper i IdoSell działają analogicznie - moduł InPost dokleja numer paczkomatu do zamówienia po stronie sklepu.

NavyFlame czyta ten numer wprost z zamówienia i przy generowaniu etykiety wysyła go do API InPost. Jeśli zamówienie ma metodę dostawy "kurier InPost", system pomija paczkomat i tworzy etykietę pod adres odbiorcy. Jeden konektor obsługuje oba scenariusze, bo decyduje metoda dostawy zapisana w zamówieniu, a nie ręczny wybór sprzedawcy.

Gdy z jakiegoś powodu numer paczkomatu nie dotrze (na przykład klient wpisał go w komentarzu do zamówienia, a nie w polu adresowym), reguła walidacyjna wyłapuje brak poprawnego kodu i zatrzymuje etykietę, zanim trafi do InPost. To prosta tarcza przed wysłaniem paczki w nieokreślone miejsce.

Automatyczne etykiety InPost z danych zamówienia

Generowanie etykiet InPost to sedno integracji. Zamiast przepisywać dane do Menedżera Paczek, pracujesz na liście zamówień gotowych do wysyłki. Cały proces opisuje automatyzacja wysyłek, a w skrócie wygląda tak:

1. NavyFlame zbiera dane z zamówienia: odbiorcę, numer paczkomatu lub adres, wymiary i wagę paczki, opcje dodatkowe (na przykład pobranie z kwotą).
2. Woła API InPost ShipX z tym zestawem i wybranym gabarytem (A, B lub C).
3. Otrzymuje numer przesyłki i etykietę w PDF lub ZPL (dla drukarek termicznych) i zapisuje oba przy zamówieniu.
4. Zwraca status zamówienia "etykieta gotowa", więc widzisz, co jest już spakowane do druku.

Gabaryt paczki bywa pułapką, bo InPost rozdziela rozmiary A/B/C i etykieta dla złego gabarytu kończy się dopłatą manipulacyjną. W NavyFlame ustawiasz domyślny rozmiar na karcie produktu - przy generowaniu etykiety system sumuje produkty z zamówienia i sam dobiera właściwy gabaryt, zamiast zgadywać.

Etykiety, których nie da się wygenerować (brak numeru paczkomatu, niepoprawny kod pocztowy, brak wagi), trafiają do kolejki błędów z czytelnym opisem. Poprawiasz dane i klikasz ponów - bez wracania do panelu InPost i szukania, który request się nie udał.

Masowe nadawanie InPost - jak działa hurtowy druk etykiet

Sklep, który wysyła 30-100 paczek dziennie, nie nadaje ich pojedynczo. Masowe nadawanie InPost w NavyFlame opiera się na widoku Wysyłki, gdzie filtrujesz zamówienia (na przykład "opłacone, jeszcze niewydane, InPost paczkomat") i zaznaczasz całą partię.

Po kliknięciu Generuj etykiety system woła API InPost równolegle dla wszystkich zaznaczonych zamówień, składa odpowiedzi w jeden plik PDF w kolejności i pokazuje przycisk Pobierz. Drukarka wypluwa partię etykiet, a Ty oklejasz paczki bez przeskakiwania między ekranami. Numery przesyłek zapisują się przy zamówieniach od razu.

Dla porównania z innymi przewoźnikami i wspólnymi regułami wysyłki przyda się szerszy poradnik o integracji kurierów i etykietach wysyłkowych. InPost konfiguruje się tak samo jak pozostali kurierzy - różnią się tylko dane API i tabela gabarytów.

Tracking InPost i statusy z powrotem do zamówienia

Etykieta to dopiero start. Po nadaniu zaczyna się tracking, czyli ścieżka przesyłki od przyjęcia w sortowni aż po odbiór z paczkomatu. NavyFlame pobiera statusy InPost i zapisuje pełną historię przy zamówieniu, a do tego uruchamia dwie reakcje.

Pierwsza to aktualizacja statusu zamówienia na platformie źródłowej. Allegro czy Shopify przyjmują numer przesyłki przez swoje API, więc kupujący widzi w panelu sklepu, że paczka jest w drodze. Druga to mail do klienta z linkiem do śledzenia, wysyłany według szablonu, który możesz dopasować do swojej marki.

Statusy mają konkretne znaczenie i można na nie reagować osobno: "nadana", "w doręczeniu", "umieszczona w paczkomacie - kod odbioru wysłany", "odebrana". Dla każdego z nich ustawiasz inną treść powiadomienia, na przykład przypomnienie po 24 godzinach od umieszczenia w paczkomacie. Cały mechanizm omawia osobny tekst o automatycznym trackingu przesyłek i powiadomieniach.

Historia statusów spina się z zarządzaniem zamówieniami w NavyFlame. Gdy klient pyta "gdzie jest moja paczka", obsługa widzi pełną ścieżkę przy zamówieniu, bez logowania do osobnego panelu InPost. To skraca czas odpowiedzi i odciąża zespół przy szczycie sprzedażowym.

Konfiguracja integracji InPost krok po kroku

Podłączenie InPost zajmuje kilka minut, jeśli masz pod ręką dane z konta firmowego.

1. Pobierz dane API InPost. W panelu InPost ShipX (Menedżer Paczek) wygeneruj token API i odczytaj identyfikator organizacji. To klucze do generowania etykiet i obciążania Twojego konta, więc trzymaj je bezpiecznie.
2. Dodaj konektor w NavyFlame. W sekcji Integracje wybierz InPost, wklej token i identyfikator organizacji, zapisz. System od razu wykona test połączenia i zasygnalizuje, czy konfiguracja działa.
3. Ustaw nadawcę i domyślne opcje. Wprowadź dane nadawcze, domyślny format etykiety (PDF lub ZPL) i rozmiar paczki, jeśli nie definiujesz go per produkt.
4. Przypisz InPost do zamówień regułą wysyłki. Najprostsza reguła to "Allegro Smart - paczkomat InPost", druga warstwa to wagi i wyjątki. Reguły działają potem dla każdego nowego zamówienia bez Twojej decyzji.
5. Przetestuj na jednym zamówieniu. Wygeneruj pojedynczą etykietę, sprawdź numer paczkomatu i gabaryt, dopiero potem przejdź na masowe nadawanie.

Jeśli sprzedajesz pod kilkoma markami albo masz kilka kont InPost, NavyFlame obsługuje wiele instancji tego samego konektora - każde konto z osobną historią i osobnym rozliczeniem. Dane API są szyfrowane w bazie i nie są wyświetlane po zapisaniu, więc nikt z zespołu nie zobaczy pełnych wartości w panelu po wstępnej konfiguracji.

Warto pamiętać, że NavyFlame nie jest brokerem dostaw - łączysz się ze swoim kontem firmowym InPost, więc korzystasz z indywidualnych stawek i własnej umowy. Płacisz InPostowi za faktyczne nadania, a NavyFlame zarabia na subskrypcji, nie na prowizji od przesyłki.

Najczesciej zadawane pytania