ENATIV Logo
ENATIV
Powrót
© 2026 ENATIV
ProjektyOfertaBaza wiedzyKontakt
kontakt@enativ.pl
  1. Baza wiedzy
  2. ›
  3. Integracje
  4. ›
  5. InPost

InPost

Dostawa do Paczkomatu i kurierem w sklepie internetowym: wybór w koszyku, etykiety i statusy przez API.

IntegracjeUżywam od 2025 · Wyróżniony projekt: The Travelling Cows

Kategoria
Integracje
Używam od
2025
Wyróżniony projekt
The Travelling Cows

W praktyce

InPost dokładam do sklepu internetowego, gdy klient ma wybrać dostawę do Paczkomatu albo kurierem. W The Travelling Cows taką dostawę dostał sklep z produktami fizycznymi na Shopify, a zamówienia trafiają też do panelu klienta. Najpierw sprawdzam, co sklep ma zrobić z paczką po zamówieniu.

Czym jest InPost?

InPost to operator przesyłek z siecią automatów Paczkomat i dostawą kurierem. Dla sklepu liczy się to, że klient wybiera przy zamówieniu, gdzie odbierze paczkę, a sklep musi to miejsce przekazać dalej i nadać przesyłkę. W koszyku jest to wybór punktu odbioru albo adresu dla kuriera.

Do integracji służy API ShipX, przez które sklep nadaje paczki, pobiera etykiety i statusy, oraz Geowidget, czyli element do wyboru automatu w koszyku. Dostęp do API chroni autoryzacja OAuth 2.0 z tokenem Bearer. API obejmuje też zwroty i listę punktów odbioru, więc dane o automatach nie muszą pochodzić z własnej bazy.

Odbiór
Paczkomat albo kurier
API
ShipX, autoryzacja OAuth 2.0
Wybór automatu
Geowidget w koszyku
Etykiety
PDF, EPL2 albo ZPL

Jak pracuję z InPost

Zaczynam od pytania, co klient wybiera w koszyku i co sklep robi potem z paczką: nadaje ją, drukuje etykietę, pokazuje status. Od tego zależy, ile z integracji zbuduję własnym kodem.

  1. Wybór w koszyku

    Ustalam, czy klient wybiera automat, czy kuriera. Do wyboru automatu korzystam z Geowidgetu InPost osadzonego w koszyku, więc nie rysuję własnej mapy punktów. Tak zrobiłem w The Travelling Cows.

  2. Przesyłka i etykieta

    Po zamówieniu sklep przekazuje dane do API ShipX, które pozwala nadać paczkę i pobrać etykietę. Zanim cokolwiek wyślę, sprawdzam w dokumentacji, jakich pól wymaga przesyłka. Dane dostępowe trzymam po stronie serwera, w zmiennych środowiskowych, a nie w kodzie strony. W The Travelling Cows użyłem właśnie API ShipX.

  3. Statusy i zamówienia

    Statusy przesyłki można pobierać z API albo odbierać przez webhooki, żeby sklep wiedział, co się z paczką dzieje. W The Travelling Cows zamówienia ze sklepu widać w panelu klienta.

Kiedy tak, a kiedy nie

InPost ma sens, gdy klienci chcą odbierać paczki w automacie albo dostać je kurierem.

Sprawdza się, gdy

  • Sklep z produktami fizycznymi, którego klienci kupują w Polsce.
  • Koszyk, w którym klient wybiera Paczkomat zamiast podawać adres.
  • Sklep, który ma pobierać etykiety i statusy przez API, a nie ręcznie.
  • Platforma z usługami, do której dochodzi sprzedaż produktów fizycznych.

Nie sprawdza się, gdy

  • Sklep z produktami cyfrowymi albo usługami, bez wysyłki.
  • Sprzedaż głównie za granicę, która wymaga innego przewoźnika.
  • Zespół, który nie utrzyma integracji z API przy zmianach po stronie przewoźnika.

Innych kurierów i agregatorów przesyłek nie porównuję z praktyki, bo w swoim projekcie użyłem InPost. Przewoźnika dobieram do tego, gdzie mieszkają Twoi klienci i jak wolą odbierać paczki.

Często zadawane pytania

Tak. InPost udostępnia Geowidget do osadzenia w koszyku, w którym klient wybiera automat, a sklep zapisuje wybrany punkt przy zamówieniu. W The Travelling Cows dostawa jest do Paczkomatu albo kurierem.
Przez API ShipX: sklep nadaje przesyłkę i pobiera etykietę, a statusy sprawdza w API albo dostaje przez webhooki. Dostęp chroni autoryzacja OAuth 2.0 z tokenem Bearer, więc klucze zostają po stronie serwera i nigdy nie trafiają do przeglądarki.
W The Travelling Cows tak: sklep na Shopify w trybie headless ma dostawę InPost, a zamówienia trafiają też do panelu klienta. Sposób połączenia dobieram do projektu: najpierw sprawdzam, czy wystarczy gotowa wtyczka, czy potrzebny jest własny kod.
Integrację trzeba utrzymywać, bo dokumentacja i statusy przewoźnika mogą się zmienić. Dlatego trzymam ją w jednym module i spisuję, jakich pól używa, żeby zmianę po stronie InPost łatwo było namierzyć i poprawić w jednym miejscu. Po każdej takiej zmianie sprawdzam statusy i webhooki na zamówieniu testowym.

Na tej stronie

  • W praktyce
  • Czym jest InPost?
  • Jak pracuję z InPost
  • Kiedy tak, a kiedy nie
  • Często zadawane pytania

Powiązane hasła

  • InPost
  • Shopify
  • KSeF
  • Next.js
  • Payload CMS

Sklep ma wysyłać przez InPost?

Napisz, na jakiej platformie stoi sklep i czy klient ma wybierać Paczkomat. Powiem, co da się zrobić gotową integracją, a co wymaga własnego kodu.

Opisz swój projektZobacz The Travelling Cows