Poczta Polska przez e-Nadawca API: od etykiety do przekazania zbioru

Co musisz mieć po stronie Poczty Polskiej

e-Nadawca to system Poczty Polskiej do przygotowywania przesyłek, a WebAPI to jego interfejs dla integracji. Według opisu WebAPI e-Nadawcy droga do integracji zaczyna się od rejestracji w e-Nadawcy i podpisania umowy z Pocztą Polską. Sprawdzono 11 września 2026 r.

Przed połączeniem przygotuj:

• umowę na nadawanie przesyłek, czyli Pocztex albo paczki pocztowe, z przypisanym urzędem nadania,
• konto w e-Nadawcy z dostępem do WebAPI, najlepiej osobnego użytkownika tylko dla NavyFlame; jeśli konto nie ma dostępu do WebAPI, włącza go opiekun umowy,
• rachunek do pobrań, jeśli wysyłasz za pobraniem.

Środowisko testowe e-Nadawcy ma osobne konta, więc konto produkcyjne w nim nie zadziała. Ten sam opis WebAPI podaje, że po 30 dniach e-Nadawca sugeruje zmianę hasła, ale jej nie wymusza. Jeśli hasło zmienisz, wpisz nowe także w NavyFlame, inaczej nadawanie przestanie działać.

Integracja jest w wersji Beta. Kod działa, ale pełnej próby na żywym koncie WebAPI sprzedawcy jeszcze nie zamknęliśmy. Zacznij od kilku przesyłek, zanim przeniesiesz na nią całą wysyłkę.

Połączenie z NavyFlame

1. W panelu Integracje kliknij Konfiguruj przy Poczcie Polskiej i wpisz login oraz hasło użytkownika e-Nadawcy. W polu Środowisko zostaw Produkcja.
2. Kliknij Testuj połączenie. NavyFlame zaloguje się do e-Nadawcy i pokaże urzędy nadania z Twojej umowy razem z ich numerami PNI. Bez przypisanego urzędu e-Nadawca odrzuca każdą przesyłkę.
3. Przy jednym urzędzie nic nie ustawiasz. Przy kilku otwórz konfigurację ponownie po zapisaniu i wybierz z listy urząd, w którym oddajesz paczki.
4. Uzupełnij rachunek do pobrań i wybierz domyślną usługę, czyli tę, którą nadajesz najczęściej.

Reguły wysyłki rozpoznają Pocztę Polską w nazwie metody dostawy z marketplace'u, na przykład „Pocztex” albo „paczka pocztowa”. Usługę bierzemy z reguły, a gdy reguła jej nie wskazuje, z domyślnej usługi integracji.

Usługi: Pocztex i paczka pocztowa

Integracja obsługuje cztery usługi krajowe:

Placówkę dla Pocztex z odbiorem w punkcie wyszukasz w formularzu przesyłki po mieście albo kodzie pocztowym. Według strony paczki pocztowej paczka waży do 10 kg. Gabaryt A to długość do 60 cm, szerokość do 50 cm i wysokość do 30 cm, a gabaryt B obejmuje paczki, w których choć jeden wymiar jest większy, przy czym najdłuższy nie przekracza 150 cm. Wariant priorytetowy ma planowane doręczenie w trzy dni robocze po nadaniu, ekonomiczny w pięć. Sprawdzono 11 września 2026 r. Gabaryt NavyFlame dobiera na podstawie wymiarów paczki.

Etykieta od razu, zbiór na koniec dnia

To najważniejsza różnica między Pocztą Polską a większością kurierów. e-Nadawca dzieli nadanie na dwa kroki: przesyłka trafia najpierw do bufora, czyli zbioru przesyłek przygotowywanych do nadania, a potem cały zbiór przekazuje się Poczcie Polskiej. Opis WebAPI podkreśla, że zbiór trzeba przekazać tego samego dnia, w którym dodano do niego przesyłki. Sprawdzono 11 września 2026 r.

W NavyFlame wygląda to tak:

1. Etykieta od razu. Każda przesyłka trafia do dzisiejszego zbioru NavyFlame w e-Nadawcy i od razu dostaje numer oraz etykietę w PDF. Drukujesz ją pojedynczo, zbiorczo z listy przesyłek albo przez PrintNode.
2. Zbiór pod kontrolą. W module Wysyłki, w zakładce Nadawanie i druk, sekcja „Zbiór Poczty Polskiej (e-Nadawca)” pokazuje, ile przesyłek czeka w dzisiejszym zbiorze.
3. Przekazanie jednym przyciskiem. Zanim oddasz paczki, klikasz „Przekaż zbiór do Poczty Polskiej” i potwierdzasz. To moment nadania, a datą nadania staje się dzień przekazania.
4. Anulowanie do przekazania. Do tej chwili każdą przesyłkę możesz anulować. Po przekazaniu e-Nadawca już na to nie pozwala.

Dlaczego NavyFlame nie przekazuje zbioru sam? Przekazanie ustala datę nadania, a paczka oddana w innym dniu niż data na przesyłce może zostać odrzucona w placówce. Tylko Ty wiesz, kiedy paczki faktycznie wyjeżdżają.

Zbioru z poprzedniego dnia e-Nadawca już nie przyjmie. Panel pokaże takie zbiory, a przyciskiem „Usuń zbiory z poprzednich dni” je usuniesz. Przesyłki trzeba wtedy utworzyć ponownie. NavyFlame celowo nie zmienia daty starego zbioru, bo e-Nadawca nadałby wtedy nowe numery przesyłkom, których numery dostali już kupujący i marketplace. NavyFlame dotyka wyłącznie zbiorów, które sam utworzył, więc przesyłki przygotowane ręcznie w aplikacji e-Nadawcy zostają nietknięte.

Śledzenie i podjazd kuriera

Statusy przesyłek pobieramy z usługi śledzenia Poczty Polskiej i pokazujemy na osi czasu zamówienia. Śledzenie zaczyna się od pierwszego skanu Poczty Polskiej, a nie od przekazania zbioru. Numer przesyłki wraca do zamówienia na marketplace, na przykład na Allegro. Jak zamienić statusy w powiadomienia dla klienta, opisuje poradnik o automatycznym trackingu przesyłek.

Domyślnie NavyFlame korzysta z ogólnodostępnego konta usługi śledzenia. Na stronie usługi śledzenia Poczta Polska opisuje to konto jako przeznaczone do jednorazowych zapytań, a przy częstych zapytaniach prosi o kontakt w sprawie własnego konta. Sprawdzono 11 września 2026 r. Jeśli masz takie konto, wpisz jego login i hasło w integracji.

Kuriera Pocztex po paczki zamawiasz w module Wysyłki, w zakładce Nadawanie i druk: wybierasz dzień, przedział godzin, liczbę paczek i ich szacowaną masę. Kurier przyjeżdża pod adres z profilu Twojego konta e-Nadawcy.

Ograniczenia, o których warto wiedzieć

• Tylko przesyłki krajowe. Integracja nie nadaje przesyłek zagranicznych.
• Zbiór nie przekazuje się sam. Jeśli zapomnisz go przekazać, następnego dnia przesyłki trzeba będzie utworzyć od nowa.
• Hasło e-Nadawcy. Po zmianie hasła w e-Nadawcy wpisz nowe w NavyFlame.

Lista kontrolna pierwszego dnia

Kiedy Poczta Polska opłaca się sklepowi bardziej niż kurier albo paczkomat, omawia poradnik Poczta Polska dla sklepu internetowego. Przy pobraniach przyda się też tekst o przesyłkach za pobraniem.

Najczęściej zadawane pytania