↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    Poczta Polska w Elbuz: przesyłki Pocztex przez e-Nadawca

    5 min czytaniaZaktualizowano

    Elbuz tworzy przesyłkę Poczty Polskiej (Pocztex Kurier) z zamówienia przez e-Nadawca: paczka trafia do Twojego zbioru, numer od razu zapisuje się w zamówieniu, a etykietę drukujesz z karty.

    Kiedy to się przyda:

    • Wysyłasz kurierem Pocztex na adres — odbiorca i adres są brane z zamówienia.
    • Klient płaci przy odbiorze — kwota pobrania pochodzi z zamówienia, rachunek do przelewu podajesz raz.
    • Masz dużo paczek dziennie — kuriera Poczty Polskiej zamawiasz z podglądu listu przewozowego.
    • Musisz wiedzieć, gdzie jest paczka — status odświeża się w zamówieniu i w rejestrze „Przesyłki”.

    Od czego zacząć: utwórz użytkownika WebAPI w e-Nadawcy → wpisz login i hasło w Elbuz.

    Co potrafi Poczta Polska w Elbuz

    • Przesyłki Pocztex Kurier — na adres lub do punktu odbioru, z pobraniem na rachunek.
    • Etykieta PDF — z karty zamówienia i z rejestru „Przesyłki”, dopóki zbiór nie został przekazany.
    • Zamówienie kuriera — na podany dzień i godziny.
    • Statusy paczek — co 10 minut; zamówienie w oznaczonych statusach samo przechodzi do Twojego statusu.

    Jak podłączyć Pocztę Polską: użytkownik WebAPI e-Nadawcy

    Czego potrzebujesz od Poczty Polskiej

    Elbuz działa przez WebAPI Elektronicznego Nadawcy (e-Nadawca). Poczta Polska wymaga do niego rejestracji i umowy.

    1. Zarejestruj się na e-nadawca.poczta-polska.pl i podpisz umowę z Pocztą Polską.
    2. W e-Nadawcy otwórz „Ustawienia” → „Lista użytkowników” i utwórz dla Elbuz użytkownika z uprawnieniami do nadawania przesyłek.
    3. Zapisz jego login i hasło: wpiszesz je w Elbuz.

    Po 30 dniach e-Nadawca zaleca zmianę hasła. Po zmianie zaktualizuj je również w Elbuz. Aby zmiana nie była obowiązkowa dla integracji, poproś Pocztę Polską o takie ustawienie dla Twojego konta.

    Gdzie wpisać dostęp w Elbuz

    Gdzie: „Usługi zewnętrzne i integracje” → grupa „Dostawa” → „Poczta Polska (Pocztex)”.

    1. Włącz „Aktywność”.
    2. Login użytkownika WebAPI wpisz w „Użytkownik”, hasło — w „Hasło”.
    3. Wybierz „Domyślny gabaryt Pocztex”.
    4. Do pobrań wpisz „Rachunek do pobrania (NRB)”.
    5. „Numer zbioru” zostaw pusty, jeśli paczki mają trafiać do aktywnego zbioru.
    Formularz podłączenia Poczty Polskiej (Pocztex): pola logowania do e-Nadawcy, parametry Pocztex i blok „Nadawca”
    1Użytkownik i hasło
    2Rachunek do pobrania (NRB)
    3Numer zbioru
    4Login usługi śledzenia
    5Podpowiedź do bloku „Nadawca”
    1. „Użytkownik” i „Hasło” — login i hasło WebAPI Elektronicznego Nadawcy.
    2. „Rachunek do pobrania (NRB)” — rachunek, na który wpływają pobrania.
    3. „Numer zbioru” — zostaw puste, aby używać aktywnego zbioru.
    4. „Login usługi śledzenia Poczty Polskiej” — własny dostęp do śledzenia wielu zamówień.
    5. „Nadawca” — gdy blok jest pusty, e-Nadawca bierze adres z profilu nadawcy.

    Bloku „Nadawca” nie musisz wypełniać: wtedy e-Nadawca bierze adres z profilu nadawcy. Elbuz przekazuje własny adres tylko wtedy, gdy wpisano nazwę firmy i kod pocztowy. Do zamówienia kuriera potrzebne są nazwa, kod pocztowy, miejscowość i ulica.

    Formularz zapisuje się sam przy każdej zmianie pola. Login i hasło nie są sprawdzane przy zapisie: błąd pokaże pierwszy list przewozowy.

    „Środowisko testowe (sandbox)” przełącza Elbuz na testowy serwer e-Nadawcy. Login i hasło są tam inne niż w środowisku produkcyjnym.

    Gabaryt paczki

    Gabaryty Pocztex Kurier
    GabarytMaksymalne wymiaryWaga
    S9 × 40 × 65 cmdo 20 kg
    M (domyślnie)20 × 40 × 65 cmdo 20 kg
    L42 × 40 × 65 cmdo 20 kg
    XL60 × 60 × 70 cmdo 20 kg
    2XLsuma boków do 250 cm, długość do 120 cmdo 50 kg, powyżej 30 kg — z dopłatą

    Gabaryt z rekordu przewoźnika formularz listu przewozowego wstawia sam. Dla paczki o innym rozmiarze wybierz go w formularzu w polu „Gabaryt (maks. wymiary, cm)” — rekordu przewoźnika nie trzeba zmieniać.

    Jak wysłać zamówienie Pocztex

    Gdzie: karta zamówienia → „Sposób dostawy” = „Poczta Polska (Pocztex)” → sekcja „Dostawa” → „Utwórz list przewozowy” („Edytuj list przewozowy”, jeśli formularz był już otwierany).

    Formularz bierze z zamówienia nazwisko, imię, telefon, e-mail, kod pocztowy, miejscowość i ulicę. Obowiązkowe są nazwisko lub imię, telefon, kod pocztowy, miejscowość i ulica; bez wagi Elbuz przekaże 1 kg. Odbiorca — tylko w Polsce.

    Okno listu przewozowego Poczty Polskiej (Pocztex) z odbiorcą, adresem, parametrami przesyłki i pobraniem
    1Blok adresu
    2Id punktu odbioru
    3Gabaryt paczki
    4Pobranie
    5Utwórz list przewozowy
    1. Adres — blok do doręczenia kurierem na adres odbiorcy.
    2. „Punkt odbioru Poczty Polskiej (id)” — wypełnij, aby wysłać paczkę do punktu zamiast na adres.
    3. Gabaryt — rozmiar tej paczki, domyślnie z rekordu przewoźnika.
    4. „Dostawa zwrotna (odbiorca)” — przy wybranym „Pieniądze” odbiorca płaci kwotę przy odbiorze.
    5. „Utwórz list przewozowy” — wysyła zgłoszenie do Poczty Polskiej.

    Dostawa do punktu odbioru

    Aby paczka czekała na klienta w punkcie, wpisz liczbowe id punktu w polu „Punkt odbioru Poczty Polskiej (id)”. Słownika punktów Poczty Polskiej w Elbuz nie ma: id przychodzi z zamówieniem albo wpisujesz je ręcznie.

    Punkty to placówki Poczty Polskiej, automaty Pocztex i sklepy sieci Żabka, Groszek, Lewiatan, ABC i innych. Paczka czeka w placówce 7 dni od awizowania, w punkcie — 3 dni, w automacie — 72 godziny. Potem wraca do nadawcy na jego koszt.

    Pobranie

    „Dostawa zwrotna (odbiorca)” jest ustawiona na „Pieniądze”, jeśli zamówienie nie jest opłacone, a płatność następuje przy odbiorze. Kwota to suma zamówienia bez przeliczania waluty: jeśli zamówienie nie jest w złotych, wpisz kwotę w zł ręcznie. Pieniądze trafiają na rachunek NRB z rekordu przewoźnika.

    Maksymalna kwota pobrania zależy od Twojej umowy, w punktach i automatach — od limitu punktu. Sklepy partnerskie nie przyjmują pobrań: tylko placówki Poczty Polskiej i automaty Pocztex.

    Co się dzieje po kliknięciu „Utwórz list przewozowy”

    1. Elbuz sprawdza, czy w zamówieniu nie ma jeszcze numeru i czy obowiązkowe pola są wypełnione.
    2. Dodaje przesyłkę do aktywnego zbioru e-Nadawcy albo do zbioru o numerze z rekordu przewoźnika.
    3. Zapisuje numer przesyłki w polu „Numer listu przewozowego” — Poczta Polska zwraca go od razu.

    Numer zamówienia Elbuz przekazuje jako numer klienta do przesyłki (do 25 znaków); „Opis przesyłki” nie trafia do e-Nadawcy.

    Zbiór: bez niego paczka nie wyjedzie

    Zbiór to zestaw przesyłek przygotowanych do nadania. Elbuz tylko dodaje do niego paczki, a przekazać zbiór poczcie musisz w e-Nadawcy: „Przekaż dane do Poczty” → „Przekaż zbiory”.

    Dopóki zbiór nie zostanie przekazany, Poczta Polska nie wie o paczce. Datą nadania jest dzień przekazania zbioru, więc przekazuj go w dniu nadania paczek.

    Druk etykiety i usuwanie

    „Drukuj” przy numerze w podglądzie listu przewozowego albo „Drukuj list przewozowy” w „Przesyłkach” otwiera etykietę PDF. Elbuz sam znajduje przesyłkę w zbiorze po numerze i pobiera etykietę.

    Po przekazaniu zbioru Elbuz już nie znajdzie etykiety — drukuj ją w e-Nadawcy.

    Usunąć przesyłki z Elbuz nie można. Usuń ją ze zbioru w e-Nadawcy przed przekazaniem i wyczyść numer w polu „Numer listu przewozowego” — wtedy list przewozowy można utworzyć ponownie.

    Jak zamówić kuriera Poczty Polskiej

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → blok „Zamówienie kuriera”.

    1. Sprawdź „Datę odbioru” — domyślnie to najbliższy dzień roboczy.
    2. Podaj „Odbiór od” i „do” albo zostaw puste — wtedy zgłoszenie pójdzie na 08:00–20:00. e-Nadawca przyjmuje tylko 08:00–20:00 albo dwugodzinne okna od 08:00–10:00 do 18:00–20:00, nie wcześniej niż od bieżącej godziny.
    3. Podaj „Liczba paczek, szt.” i „Waga całkowita, kg”, kliknij „Zamów kuriera”.

    Adres odbioru to blok „Nadawca” rekordu przewoźnika. Numeru zgłoszenia Poczta Polska nie zwraca: w oknie pojawi się „Kurier zamówiony”, a potwierdzenie poczta wysyła na e-mail z bloku „Nadawca”, jeśli jest wpisany. Wynik zapisuje się w dzienniku zamówienia.

    Jak Elbuz śledzi paczkę

    Co 10 minut Elbuz pyta usługę śledzenia Poczty Polskiej o każdy numer osobno i bierze ostatnie zdarzenie: kod i nazwę po polsku. Usługa widzi tylko paczki ze zdarzeniem z ostatnich 30 dni.

    Bez własnego dostępu Elbuz korzysta z ogólnego dostępu Poczty Polskiej do pojedynczych zapytań. Przy dużej liczbie zamówień zamów własny dostęp formularzem „Wniosek o utworzenie konta WSDL/SOAP” na stronie usługi śledzenia. Login wpisz w „Login usługi śledzenia Poczty Polskiej”, hasło — w „Token”.

    Kody zdarzeń z tabeli poniżej Elbuz sam wpisuje w oknie „Statusy dostawy” rekordu Poczty Polskiej — na ich podstawie „Przesyłki” pokazują stan paczki. Kod spoza tabeli daje stan „Nieznany”. Jak działają okna kodów, opisuje artykuł o statusach przewoźnika.

    Kody zdarzeń Poczty Polskiej do okna „Statusy dostawy”
    Status dostawy ElbuzKody Poczty PolskiejCo oznacza
    W drodzeP_NADpaczka nadana
    W miejscu docelowymP_A, P_KWDpozostawiono awizo; gotowa do odbioru w placówce
    DostarczonoP_D, P_OWP, P_OWUdoręczona; odebrana w punkcie; odebrana w placówce
    OdrzucenieP_ZZPzwrot z punktu

    Pełna lista kodów — w liście zdarzeń Poczty Polskiej (PDF). Poczta zaleca dopasowywać właśnie kody: nazwy zdarzeń mogą się zmieniać.

    „Śledź na stronie przewoźnika” w „Przesyłkach” otwiera stronę wyszukiwania poczta-polska.pl/sledzenie-przesylek: Poczta Polska nie publikuje linku z numerem, więc numer wpisuje się w pole ręcznie. Tam paczkę śledzi też klient.

    Scenariusze

    Zwykły dzień wysyłek

    W ciągu dnia twórz listy przewozowe z zamówień i drukuj etykiety. Wieczorem przekaż zbiór w e-Nadawcy i zamów kuriera z podglądu dowolnego listu przewozowego z tego dnia.

    Zamówienie płatne przy odbiorze

    Raz wpisz rachunek NRB w rekordzie przewoźnika. Potem dla nieopłaconego zamówienia z płatnością przy odbiorze formularz sam ustawia „Pieniądze” i kwotę zamówienia.

    Co zrobić, gdy coś pójdzie nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” W rekordzie nie ma hasła albo wyłączono „Aktywność” Wpisz login i hasło WebAPI (gdzie wpisać)
    „Error: login/password is required (API settings)” W rekordzie wypełniono tylko „Token” albo brakuje loginu Wpisz login i hasło WebAPI (gdzie wpisać)
    „Error: bank account for COD is required (API settings)” Wybrano „Pieniądze”, a w rekordzie nie ma rachunku do pobrań Wpisz „Rachunek do pobrania (NRB)” (pobranie)
    „Error: postcode is required for recipient” (albo city, street) W zamówieniu brakuje kodu pocztowego, miejscowości lub ulicy Uzupełnij adres w formularzu (wysyłka)
    „Error: ‹opis› (‹numer błędu›)” e-Nadawca nie przyjął przesyłki; przyczyna jest w opisie Popraw dane zgodnie z treścią błędu i utwórz list przewozowy ponownie
    Na karcie wydruku „e-Nadawca: shipment … is not in the buffer (already sent?)” Zbiór został już przekazany poczcie Wydrukuj etykietę w e-Nadawcy (druk)
    W „Przesyłkach” stan „Nieznany” Kody Poczty Polskiej nie są wpisane w „Statusy dostawy” Wpisz kody z tabeli (statusy)

    Najczęstsze pytania

    Ile kosztuje integracja z Pocztą Polską?

    Elbuz nic nie pobiera za przesyłki, etykiety ani statusy. Za paczki płacisz Poczcie Polskiej zgodnie z umową.

    Numer jest w zamówieniu, a paczka stoi w miejscu — dlaczego?

    Najczęściej zbiór nie został przekazany poczcie: do tego momentu Poczta Polska nie widzi paczki. Przekaż go w e-Nadawcy (zbiór).

    Czy można wybrać gabaryt dla pojedynczej paczki?

    Tak: w formularzu listu przewozowego — pole „Gabaryt (maks. wymiary, cm)”. Domyślnie jest tam gabaryt z rekordu przewoźnika (gabaryt).

    Czy do śledzenia potrzebny jest osobny dostęp?

    Nie, bez niego działa ogólny dostęp Poczty Polskiej. Własny dostęp zamów, jeśli paczek jest dużo (statusy).

    Czy można wysłać Pocztex za granicę?

    Nie, Elbuz tworzy przesyłki Pocztex Kurier tylko dla odbiorców w Polsce.

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa → Poczta Polska (Pocztex)
    Inne wejścia
    Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
    Uprawnienia
    podłączenie — „API i tokeny dostępu”; list przewozowy i kurier — „Tworzenie listu przewozowego”; paczki — „Przesyłki”
    Przygotuj
    umowę z Pocztą Polską, konto e-Nadawcy, numer rachunku do pobrań
    1. Utwórz użytkownika WebAPIe-Nadawca
    2. Wpisz login, hasło, rachunek i gabarytUsługi zewnętrzne i integracje → Poczta Polska
    3. Utwórz przesyłkęKarta zamówienia, sekcja „Dostawa”
    4. Przekaż zbiór poczciee-Nadawca
    5. Zamów kurieraPodgląd listu przewozowego

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo