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.
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.
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.
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
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.