↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    InPost w Elbuz: przesyłki do paczkomatu i kurierem przez ShipX API

    5 min czytaniaZaktualizowano

    Elbuz tworzy przesyłkę InPost prosto z zamówienia: paczkomat dobiera się z adresu klienta, numer śledzenia sam trafia do zamówienia, a etykietę drukujesz z karty.

    Kiedy to się przyda:

    • Klienci wybierają paczkomat na stronie lub w marketplace — kod punktu z adresu zamówienia sam trafia do formularza.
    • Zamówienia płatne przy odbiorze — kwota pobrania jest brana z zamówienia.
    • Paczka nie mieści się w paczkomacie — ten sam rekord wyśle ją kurierem InPost na adres.
    • Musisz wiedzieć, gdzie jest paczka — co 10 minut status InPost odświeża się w zamówieniu i w rejestrze „Przesyłki”.

    Od czego zacząć: utwórz token ShipX w Managerze Paczek → wpisz go razem z ID organizacji w Elbuz.

    Co potrafi InPost w Elbuz

    • Przesyłka z zamówienia — do paczkomatu lub kurierem, z pobraniem i deklarowaną wartością.
    • Dobór paczkomatu — po kodzie punktu w adresie zamówienia albo z list „Województwo” → „Miejscowość” → „Punkt InPost”.
    • Etykieta PDF — z karty zamówienia i z rejestru „Przesyłki”, bez logowania do Managera Paczek.
    • Statusy paczek — co 10 minut; zamówienie w wybranych statusach samo przechodzi na Twój status.

    Jak podłączyć InPost: token ShipX i ID organizacji

    Skąd wziąć token ShipX i ID organizacji

    Token daje Elbuz dostęp do Twojej organizacji w InPost: przesyłek, etykiet i punktów. Tworzy się go w Managerze Paczek.

    1. Zaloguj się do Managera Paczek i otwórz „Moje Konto”.
    2. Sprawdź, czy dane firmy i dane do faktury są uzupełnione: bez nich token się nie utworzy.
    3. Na karcie API rozwiń „API ShipX” i kliknij „Generuj”. Do samych paczkomatów numer umowy nie jest potrzebny; do kuriera InPost poprosi o numer klienta z umowy kurierskiej.
    4. Skopiuj token przyciskiem „Pokaż token”. ID organizacji znajdziesz na karcie „Ustawienia organizacji”.

    Instrukcja InPost krok po kroku, z ilustracjami — instrukcja konfiguracji API ShipX (PDF).

    Gdzie wpisać token w Elbuz

    Gdzie: „Usługi zewnętrzne i integracje” → grupa „Dostawa” → InPost.

    1. Włącz „Aktywność”.
    2. Wklej token w pole „Token”. Zapisany klucz jest pokazywany jako kropki; puste pole go nie kasuje.
    3. Wpisz „ID organizacji” w bloku „Parametry InPost (ShipX)”. Bez niego przesyłka się nie utworzy.
    4. Wybierz „Sposób nadawania przesyłek”: „Paczkomat”, „Odbiór przez kuriera (dispatch order)” lub „Punkt nadania (POP)”. Przy „Domyślnie (z umowy)” InPost weźmie sposób z umowy.
    Formularz podłączenia InPost: przełącznik Aktywność, pole Token i blok Parametry InPost (ShipX)
    1Token
    2ID organizacji
    3Sposób nadawania przesyłek
    4Środowisko testowe
    1. Token — tu wpisuje się token organizacji; po zapisaniu jest pokazywany jako kropki.
    2. ID organizacji — identyfikator z konta w Managerze Paczek.
    3. Sposób nadawania przesyłek — jak przekazujesz paczki; domyślny wynika z umowy.
    4. Środowisko testowe — przełącznik do testów na środowisku testowym InPost.

    Formularz zapisuje się sam przy każdej zmianie pola, przycisku „Zapisz” nie ma. Token nie jest sprawdzany przy zapisie: błąd klucza pokaże dopiero pierwszy list przewozowy.

    „Środowisko testowe (sandbox)” przełącza Elbuz na piaskownicę ShipX. Token do niej jest osobny, z Sandbox Managera; paczki z piaskownicy nigdzie nie jadą.

    Listę paczkomatów Elbuz pobiera sam, klucz nie jest do tego potrzebny. Tabela „Słowniki przewoźnika” w rekordzie pokazuje, ile jest punktów i kiedy je zaktualizowano; aktualizacja odbywa się co noc.

    Jak wysłać zamówienie przez InPost

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

    Formularz bierze odbiorcę, kwotę i wagę z zamówienia. Tobie zostaje sprawdzenie punktu, gabarytu i pobrania.

    Okno tworzenia listu przewozowego InPost do zamówienia 37123: paczkomat, odbiorca, gabaryt B, dostawa zwrotna i przycisk tworzenia listu
    1Sposób wysyłki
    2Punkt InPost
    3Gabaryt paczki
    4Dostawa zwrotna (odbiorca)
    5Przycisk tworzenia listu przewozowego
    1. Sposób wysyłki — wybrany jest Paczkomat.
    2. Punkt InPost — listy województw, miejscowości i punktów odbioru.
    3. Gabaryt paczki — gabaryty A, B i C; wybrany jest B.
    4. Dostawa zwrotna (odbiorca) — kwota pobrania od odbiorcy.
    5. Utwórz list przewozowy — wysyła żądanie do InPost.

    Paczkomat: punkt i gabaryt

    Elbuz szuka kodu paczkomatu w adresie zamówienia (w postaci KRA01A lub POP-WAW762) i sprawdza go w słowniku InPost. Jeśli go znajdzie, w formularzu są już wybrane województwo, miasto i punkt.

    Jeśli nie znajdzie — wybierz punkt z list „Województwo” → „Miejscowość” → „Punkt InPost”. Na liście są tylko działające punkty, które wydają paczki.

    Gabaryty paczki do paczkomatu
    GabarytWymiary z opakowaniemWaga
    A8 × 38 × 64 cmdo 25 kg
    B (domyślnie)19 × 38 × 64 cmdo 25 kg
    C41 × 38 × 64 cmdo 25 kg

    Do paczkomatu telefon i e-mail odbiorcy są obowiązkowe: na nie InPost wysyła kod odbioru. Elbuz skraca telefon do 9 cyfr, odrzucając prefiks +48.

    Kurier InPost na adres

    Wybierz „Kurier InPost”: zamiast punktu pojawi się blok „Adres” („Miejscowość”, „Kod pocztowy”, „Ulica”, „Nr domu”) i wymiary „Długość, cm”, „Szerokość, cm”, „Wysokość, cm”. Bez wymiarów Elbuz przekaże 30 × 20 × 10 cm.

    Kurier InPost na umowie przyjmuje paczkę do 50 kg, z najdłuższym bokiem do 120 cm i sumą boków do 220 cm. Odbiorca — tylko w Polsce.

    Pobranie i deklarowana wartość

    „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ł w polu „Kwota, zł”.

    Pobranie do paczkomatu — do 5 000 zł. InPost przelewa pieniądze na rachunek z umowy lub z Managera Paczek w ciągu pięciu dni roboczych od zapłaty.

    „Deklarowana wartość, zł” — kwota, na jaką InPost ubezpiecza paczkę, według swojego cennika.

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

    1. Elbuz sprawdza, czy w zamówieniu nie ma jeszcze numeru: podwójne kliknięcie nie utworzy drugiego listu.
    2. Wysyła przesyłkę do InPost i czeka do 12 sekund na numer śledzenia: InPost nie nadaje go od razu.
    3. Zapisuje numer w polu „Numer listu przewozowego”, a link „Utwórz list przewozowy” znika z karty.

    Jeśli w ciągu 12 sekund numeru nie ma, do zamówienia trafi wewnętrzny numer przesyłki InPost — krótka liczba. Statusy i druk działają także z nim.

    Formularz zapamiętuje wpisane dane w zamówieniu: po zamknięciu okna wartości zostają. Listy przewozowe do kilku zamówień naraz — przyciskiem „Utwórz list przewozowy (dostawa)” na liście zamówień; punkt jest brany z adresu, gabaryt — B.

    Druk etykiety i anulowanie

    „Drukuj” przy numerze w podglądzie listu przewozowego albo „Drukuj list przewozowy” w „Przesyłkach” otwiera etykietę PDF. Elbuz pobiera ją z InPost sam: token nie trafia do przeglądarki, logowanie do Managera Paczek nie jest potrzebne.

    Etykiety InPost drukują się pojedynczo: kilka jednym przyciskiem — tylko w Nova Poshta.

    Anulować ani zmienić przesyłki InPost z Elbuz nie można. Anuluj ją w Managerze Paczek, a numer w polu zamówienia „Numer listu przewozowego” wyczyść ręcznie — wtedy list przewozowy można utworzyć ponownie.

    Jak Elbuz śledzi paczkę InPost

    Co 10 minut Elbuz pyta InPost o stan paczek — do 100 listów przewozowych na przebieg, najpierw te, które najdłużej nie były sprawdzane. Nazwę statusu InPost podaje po polsku, tak jak na swojej stronie: „Umieszczona w automacie Paczkomat (odbiorczym).”.

    Kody InPost z tabeli poniżej Elbuz sam wpisuje w oknie „Statusy dostawy” rekordu InPost — na ich podstawie w „Przesyłkach” pojawia się stan „W punkcie odbioru”, „Doręczona” lub „Odmowa”. Kod spoza tabeli daje stan „Nieznany”. Jak oznaczyć statusy zamówienia, które zmieniają się same, opisuje artykuł o statusach przewoźnika.

    Kody InPost do okna „Statusy dostawy”
    Status dostawy ElbuzKody InPostStan w „Przesyłkach”
    Oczekiwanie od nadawcycreated, confirmedUtworzona
    Zebranedispatched_by_sender, taken_by_courier, dispatched_by_sender_to_pokUtworzona
    W drodzeadopted_at_sorting_center, sent_from_sorting_center, adopted_at_target_branchW drodze
    Wydany kurierowiout_for_delivery, out_for_delivery_to_addressW drodze
    W miejscu docelowymready_to_pickup, ready_to_pickup_from_pok, pickup_reminder_sentW punkcie odbioru
    DostarczonodeliveredDoręczona
    Odrzucenierejected_by_receiver, returned_to_sender, pickup_time_expiredOdmowa

    Kody wpisuje się po przecinku w kolumnie „Kod (nazwa) na stronie (API)”; komórka mieści do 80 znaków, więc wpisuj główne kody, a nie wszystkie 53.

    Okno „Statusy dostawy” dla InPost: kody statusów przewoźnika przypisane do każdego statusu dostawy
    1Kod (nazwa) na stronie (API)
    2W miejscu docelowym
    3Dostarczono
    1. Kod (nazwa) na stronie (API) — kody statusów InPost, które Elbuz przypisuje do każdego statusu dostawy.
    2. W miejscu docelowym — paczka czeka na odbiór: ready_to_pickup, ready_to_pickup_from_pok i pickup_reminder_sent.
    3. Dostarczono — do tego statusu przypisany jest tylko kod delivered.

    Elbuz odpytuje paczkę, dopóki zamówienie nie ma 60 dni albo dopóki jest w wybranym statusie; kod ze stanu „Doręczona” kończy odpytywanie wcześniej. Status zamówienia, dostawy i płatności zmienia się tylko w zamówieniach w wybranych statusach, w pozostałych odświeża się jedynie stan paczki.

    W paczkomacie paczka czeka 48 godzin, w PaczkoPunkcie — 72. Po 36 godzinach InPost przypomina odbiorcy, a jeśli paczka nie zostanie odebrana, wraca do nadawcy.

    W „Przesyłkach” przycisk „Śledź na stronie przewoźnika” otwiera stronę inpost.pl/sledzenie-przesylek z numerem paczki, a „SMS do odbiorcy” — okno wiadomości do klienta.

    Scenariusze

    Codzienne zamówienia do paczkomatów

    Klient wybiera paczkomat na stronie, kod punktu przychodzi w adresie zamówienia. Zaznacz zamówienia na liście → „Utwórz list przewozowy (dostawa)”: listy tworzą się zbiorczo z gabarytem B. Etykiety drukuj z „Przesyłek”.

    Zamówienia za pobraniem

    Zamówienie nieopłacone, płatność przy odbiorze — formularz sam ustawia „Pieniądze” i kwotę zamówienia. Gdy klient odbierze paczkę, w „Przesyłkach” stan zmieni się na „Doręczona”, a InPost przeleje pieniądze zgodnie z umową.

    Duża paczka kurierem

    Wybierz „Kurier InPost”, sprawdź adres, wpisz wagę i wymiary. Pamiętaj o limicie kuriera: do 50 kg i 220 cm sumy boków.

    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 InPost nie ma tokenu albo „Aktywność” jest wyłączona Wpisz token i włącz rekord (gdzie wpisać token)
    „Error: organization_id is required (API settings)” Nie wpisano ID organizacji Weź je w Managerze Paczek, karta „Ustawienia organizacji” (skąd je wziąć)
    „Error: email is required for recipient (parcel locker)” W zamówieniu nie ma e-maila odbiorcy, a paczkomat go wymaga Wpisz e-mail w pole „E-mail” formularza (paczkomat)
    „Error: target_point is required (parcel locker)” Punkt nie jest wybrany, a kod paczkomatu w adresie nie został rozpoznany Wybierz „Województwo” → „Miejscowość” → „Punkt InPost” (paczkomat)
    Listy „Województwo” i „Punkt InPost” są puste Słownik punktów nie był aktualizowany od ponad trzech dni Napisz do wsparcia Elbuz: bez słownika nie wybierzesz paczkomatu
    W „Przesyłkach” stan „Nieznany” InPost zwrócił kod, którego nie ma w tabeli, albo kod został usunięty ze „Statusów dostawy” Dopisz kod do właściwego statusu (statusy)

    Najczęstsze pytania

    Ile kosztuje integracja z InPost?

    Elbuz nie pobiera opłat za przesyłki, etykiety ani statusy. Za przesyłki płacisz InPost według jego cennika lub umowy.

    Czy potrzebna jest umowa z InPost?

    Do paczkomatów token tworzy się na koncie Managera Paczek z danymi firmy. Do kuriera InPost wymaga numeru klienta z umowy kurierskiej (token ShipX).

    Dlaczego w zamówieniu jest krótka liczba, a nie numer śledzenia?

    InPost nie zdążył nadać numeru w ciągu 12 sekund, więc Elbuz zapisał wewnętrzny numer przesyłki. Statusy i druk działają także z nim (po utworzeniu).

    Czy można zamówić kuriera InPost z Elbuz?

    Nie, przycisku zamówienia kuriera dla InPost nie ma. Sposób przekazywania paczek ustawia „Sposób nadawania przesyłek” w rekordzie InPost; odbiór przez kuriera zamawia się w Managerze Paczek.

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

    Nie, Elbuz tworzy przesyłki InPost tylko do odbiorców w Polsce.

    Statusy przychodzą po polsku — czy tak ma być?

    Tak, nazwę statusu podaje InPost. Stan w „Przesyłkach” i Twój status dostawy Elbuz pokazuje w języku interfejsu, według kodu (kody InPost).

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa → InPost
    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 — „Tworzenie listu przewozowego”; paczki — „Przesyłki”
    Przygotuj
    konto w Managerze Paczek z danymi firmy; do kuriera — umowę z InPost
    1. Utwórz token ShipX i weź ID organizacjiManager Paczek
    2. Wpisz token i ID organizacjiUsługi zewnętrzne i integracje → InPost
    3. Wpisz kody InPost w „Statusy dostawy”Tamże, „Ustawienia powiadomień”
    4. Utwórz przesyłkęKarta zamówienia, sekcja „Dostawa”
    5. Wydrukuj etykietęPodgląd listu przewozowego lub „Przesyłki”

    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