VulCode

Integracja InPost ShipX: paczkomaty i etykiety

Klient wybiera Paczkomat na mapie w koszyku, Twój system tworzy przesyłkę i etykietę przez API ShipX, a status paczki wraca do zamówienia sam, z webhooków InPostu.

Kurierzy i wysyłka
Lista przesyłek InPost do nadania dziś w panelu sklepu: zamówienia z Paczkomatem docelowym, sposób nadania i statusy
Wybór Paczkomatu na mapie w koszyku sklepu na telefonie

Od wyboru Paczkomatu do statusu w zamówieniu

Cała droga przesyłki w integracji z InPostem. Każdy krok to inna część API.

Ttwojsklep.pl
Wybierz Paczkomat
Najbliżej, 350 mEXA01M, ul. Przykładowa 12wybrany
600 mEXA07M, al. Pokazowa 7
750 mEXA12M, ul. Testowa 3
Odbiorę w EXA01M
Ttwojsklep.pl
Zamówienie #20447
Statusnoweprzygotowana
OdbiórPaczkomat EXA01M
Szczegóły przesyłki
PPocztatwojsklep.pl
Twoja firmaZamówienie #20447 przyjęte. Odbiór w Paczkomacie EXA01M.
Twoja firmaZamówienie #20447 jest nadane. Odbierzesz je w Paczkomacie EXA01M.
Śledź paczkę
Panel sklepudziś
Zamówienia z dostawą do Paczkomatu
ZamówienieOdbiorcaPaczkomatStatus
#20447Klient 11EXA01Mnadana
#20446Klient 10EXA12Mprzygotowana
#20441Klient 05EXA15Mnadana
#20440Klient 04EXA01Mdo odbioru
#20438Klient 02EXA07Mdo odbioru
#20447Klient 11EXA01M
noweprzygotowanaetykieta PDFnadanastored_by_sender

  1. KlientWybiera punkt na mapie Geowidget w koszyku.Panel sklepuKod Paczkomatu zapisuje się przy zamówieniu.Pod spodemGeowidget oddaje punkt zdarzeniem onpoint. Mapie wystarcza publiczny token, osobny od tokena ShipX.

  2. KlientWidzi w panelu klienta, że paczka jest przygotowana.Panel sklepuPrzesyłka ma etykietę PDF i sposób nadania.Pod spodemPOST przesyłki do ShipX. Błąd walidacji wraca z kluczem i opisem, więc obsługa wie, co poprawić.

  3. KlientDostaje wiadomość, że paczka jest nadana.Panel sklepuStatus zamówienia zmienia się na nadana.Pod spodemWebhook shipment_status_changed, np. ze statusem stored_by_sender.

Sposoby nadania w ShipX

Przesyłka w API ma wskazany sposób nadania. Od niego zależy, jak paczka trafi do InPostu. Dostępne sposoby zależą od usługi przesyłki.

Twój magazyn
Przesyłka z ShipX ze sposobem nadania i etykietą.

  • Paczkomat

    parcel_locker

    Nadanie w Paczkomacie.

    Kiedy wybieramyMały sklep, który sam zanosi paczki.

  • Dowolny Paczkomat albo PaczkoPunkt

    any_point

    Nadanie w dowolnym Paczkomacie albo PaczkoPunkcie.

    Kiedy wybieramyGdy nadający chce elastyczności.

  • Punkt Obsługi Przesyłek

    pop

    Nadanie w Punkcie Obsługi Przesyłek.

    Kiedy wybieramyPaczki, które nie mieszczą się w skrytce.

  • Kurier z magazynu

    dispatch_order

    Zlecenie odbioru, czyli zamówienie kuriera.

    Kiedy wybieramyMagazyn z większą liczbą paczek dziennie.

  • Oddział InPost

    branch

    Dostarczenie do Oddziału InPost.

    Kiedy wybieramyDuże wolumeny według umowy.

Sieć InPost
Sortownia i trasa do Paczkomatu odbiorcy.

Status paczki w Twoim systemie

InPost ma długą listę statusów. W panelu klienta skracamy je do kilku, które klient rozumie, a pełny status zostaje w dzienniku.

  1. Przygotowana

    Przesyłka utworzona w ShipX, etykieta gotowa. Webhook shipment_confirmed.

    Zdarzenie InPostu: shipment_confirmed
  2. Nadana

    Paczka w Paczkomacie nadawczym albo odebrana przez kuriera, np. status stored_by_sender.

    #20441
    EXA15M, Klient 05
    Zdarzenie InPostu: np. stored_by_sender
  3. W drodze

    Paczka w sortowni i w trasie. Klient dostaje informację z panelu i od InPostu.

  4. Do odbioru

    W Paczkomacie odbiorczym. To moment, o którym klient chce wiedzieć najbardziej.

    #20447
    EXA01M, Klient 11
  5. Odebrana

    Odebrana przez klienta. Zamówienie można zamknąć.

    #20438
    EXA07M, Klient 02
Dziennik integracji InPost w panelu sklepu: webhooki od InPostu, odczytany status przesyłki i to, co zrobił sklep

Skąd panel zna status

Każdą zmianę przynosi webhook od InPostu. Dziennik integracji pokazuje, co przyszło i co sklep z tym zrobił.

  1. Zdarzenia z dokumentacji

    InPost wysyła m.in. shipment_confirmed, shipment_status_changed i offers_prepared. Integracja przyjmuje je z zakresu 91.216.25.0/24.

  2. Pełny status zostaje w dzienniku

    Status InPostu, np. stored_by_sender, zapisujemy w dzienniku, a klient widzi krótszą nazwę: nadana.

  3. Jedno zdarzenie, trzy skutki

    Nowy status w panelu klienta, wpis w historii zamówienia i wiadomość do klienta.

Wyjście z drogi: nieodebrana w terminie, zwrot do nadawcy. Paczka nieodebrana wraca. Panel pokazuje to obsłudze, zanim klient zapyta.

Wtyczka, agregator czy ShipX bezpośrednio

InPost ma listę platform zintegrowanych ze swoimi usługami. Kod piszemy tam, gdzie jej nie wystarcza.

Skala wysyłki
  1. Mały sklep na platformie
    Wtyczka platformy albo agregator, np. Furgonetka czy Apaczka, z mapą punktów w koszyku.
    Na tym etapie
    • KiedySklep działa na platformie z listy InPostu.
    • PrzewoźnicyWysyłasz kilkoma przewoźnikami i chcesz jednego panelu.
    • NadanieNadanie w Paczkomacie. Mały sklep, który sam zanosi paczki.
    Sposób nadania w ShipX
    parcel_locker
  2. Sklep albo magazyn na zamówienie
    Integracja z API ShipX i Geowidgetem w Twoim kodzie, z webhookami statusów.
    Na tym etapie
    • KiedySklep albo magazyn jest napisany na zamówienie.
    • PanelStatusy paczek mają być w Twoim panelu klienta.
    • NadanieNadanie w dowolnym Paczkomacie albo PaczkoPunkcie. Nadanie w Punkcie Obsługi Przesyłek.
    Sposób nadania w ShipX
    any_pointpop
  3. Magazyn z większą liczbą paczek dziennie
    Kuriera po paczki zamawiasz z panelu sklepu, przez zlecenie odbioru w ShipX.
    Na tym etapie
    • KiedyPotrzebujesz zleceń odbioru i własnych reguł nadawania.
    • NadanieZlecenie odbioru, czyli zamówienie kuriera.
    Sposób nadania w ShipX
    dispatch_order
  4. Duże wolumeny według umowy
    Dostarczenie do Oddziału InPost.
    Na tym etapie
    • UmowaDo API ShipX potrzebne jest konto w Managerze Paczek z danymi firmy, a token API wygenerujesz dopiero po uzupełnieniu w nim danych do faktury. Warunki usług zależą od Twojej umowy z InPostem.
    • NadanieDostępne sposoby zależą od usługi przesyłki.
    Sposób nadania w ShipX
    branch
Na skali nie ma progów w liczbach paczek, bo warunki usług zależą od Twojej umowy z InPostem.

Zanim pierwsza paczka pójdzie z API

Szczegóły z dokumentacji InPostu, które blokują start, jeśli ktoś o nich zapomni.

Zapytanie albo ustawienieWedług dokumentacji InPostuCo robi integracjaPrzed startem
Zapytanie albo ustawienieGET /api/inpost/webhookInPost sprawdza adres przy zapisie webhooka
Według dokumentacji InPostuOdpowiedź HTTP 200
Co robi integracja200, adres zapisany w Managerze Paczek
Obsłużone przed startem
Zapytanie albo ustawienie91.216.25.14Webhook z zakresu InPostu
Według dokumentacji InPostuPrzyjęty
Co robi integracja200, status trafia do zamówienia
Obsłużone przed startem
Zapytanie albo ustawienie203.0.113.7Webhook spoza 91.216.25.0/24
Według dokumentacji InPostuOdrzucony
Co robi integracjaOdrzucony, wpis w dzienniku
Obsłużone przed startem
Zapytanie albo ustawieniesandbox-api-shipx-pl.easypack24.netToken z produkcyjnego Managera Paczek
Według dokumentacji InPostuNie działa, sandbox ma osobne konto
Co robi integracjaOsobny token i identyfikator organizacji dla sandboxa
Obsłużone przed startem
Zapytanie albo ustawienieparcel_lockerPierwsza przesyłka do Paczkomatu
Według dokumentacji InPostuWymaga środków na koncie, w sandboxie wirtualnych
Co robi integracjaKonto zasilone przed pierwszą partią przesyłek
Obsłużone przed startem

5 sprawdzeń przed pierwszą paczką z API

Najczęstsze pytania o integrację z InPost

Odpowiedzi o umowie z InPostem, mapie Paczkomatów, statusach i wycenie.

Czytaj dalej

Inni przewoźnicy i miejsca, w których wysyłka łączy się z resztą sklepu.

Ile paczek wysyłasz dziennie?

Napisz, gdzie powstają zamówienia i jak dziś nadajesz paczki. Odpowiemy w godzinę z pytaniami i wyceną integracji.