📦 Przesyłki InPost z danymi przewoźnika
Integracja InPost ShipX API
Przesyłki z Twojej organizacji w InPost ShipX trafiają do Twojego systemu z gabarytem, usługą i statusem. Łączymy je z paczkami z BaseLinkera po numerze przesyłki, więc wiesz, ile paczkomatów A, B, C i ile przesyłek kurierskich wysłał każdy klient.
Integracja InPost ShipX API w skrócie
Integracja InPost ShipX API to połączenie konta InPost (organizacji w Managerze Paczek) z Twoim systemem przez API, dzięki któremu przesyłki paczkomatowe i kurierskie, ich gabaryty i statusy są widoczne bez eksportów z panelu. W naszym wdrożeniu ShipX służy do kontroli: przesyłki z konta przewoźnika porównujemy z paczkami z BaseLinkera i rozliczamy klientów magazynu.
Dopasowanie po numerze przesyłki.
Para z paczką z BaseLinkera powstaje tylko wtedy, gdy zgadza się numer. Numer zamówienia z referencji tylko wyjaśnia brak pary.
Gabaryt i usługa przy każdej przesyłce.
Paczkomat A, B albo C, przesyłka kurierska i liczba paczek w przesyłce.
Pełne pobranie albo błąd.
Liczba pobranych przesyłek musi się zgadzać z liczbą, którą podaje API. Niepełne pobranie widać na ekranie.
Token po stronie serwera.
Dostęp wpisuje administrator, a token nigdy nie wraca do przeglądarki.
Paczki InPost bez eksportu z Managera
Dziś: Eksport z Managera Paczek i liczenie w arkuszu
Po wdrożeniu: Przesyłki z ShipX API pobierane co noc i na żądanie
Dziś: Nie wiadomo, do którego klienta należy przesyłka
Po wdrożeniu: Przesyłka połączona z paczką z BaseLinkera, a przez nią z klientem
Dziś: Gabaryt sprawdzany ręcznie przy fakturze
Po wdrożeniu: Paczkomat A, B, C albo kurier zapisany przy przesyłce
Dziś: Anulowana etykieta liczy się jak wysłana
Po wdrożeniu: Anulowana etykieta osobno, z uwagą, jeśli paczka jest w BaseLinkerze
Dziś: Niepełne pobranie wygląda jak pełne
Po wdrożeniu: Liczba pobranych przesyłek porównana z liczbą z API
Każda przesyłka z konta InPost kończy przypisana do klienta albo z uwagą, co trzeba sprawdzić.
Co łączymy z InPost ShipX
Zakres ustalamy na konsultacji. Najczęściej obejmuje te elementy.
Przesyłki organizacji.
Lista przesyłek z jednej albo kilku organizacji, do których ma dostęp token, z numerem, referencją, usługą, statusem i datą utworzenia.
Gabaryt i rodzaj przesyłki.
Szablon small, medium albo large jako paczkomat A, B albo C. Przesyłka kurierska z kilkoma paczkami liczy się po sztukach.
Dopasowanie do BaseLinkera.
Numer przesyłki z ShipX łączymy z numerem paczki w BaseLinkerze, po normalizacji: wielkie litery, bez spacji.
Raport per klient.
Tabela klient na paczkomat A, B, C i kurier, uwaga przy każdej przesyłce bez pary i eksport do Excela.
Tworzenie przesyłek i etykiet.
Gdy etykiet nie robi BaseLinker ani inny system, możemy tworzyć przesyłki przez ShipX z Twojej aplikacji.
Kontrola błędów.
Ponowienie przy chwilowym błędzie API, komunikat przy niepełnym pobraniu i data ostatniego udanego pobrania na ekranie.
InPost ShipX w naszych wdrożeniach
Firma fulfillment: rozliczanie paczek z kurierami
Przesyłki z konta InPost porównane z paczkami z BaseLinkera. Raport klient na paczkomat A, B, C i kurier, z uwagą przy każdej przesyłce bez pary.
- BaseLinker
- ShipX
- dopasowanie po numerze
- rozliczenie
Ten sam magazyn: dashboard dla pakowania
Na ekranach w magazynie widać zamówienia do spakowania przed odbiorem kuriera, z osobnym terminem dla InPostu.
- BaseLinker
- dashboard
- zespół pakowania
Jak pracujemy
Konsultacja
Ustalamy, które organizacje ShipX należą do Twojej umowy, jakie usługi wysyłasz i co ma wyjść w raporcie.
Token i organizacje
Token z Managera Paczek wpisujesz w panelu. Test połączenia pokazuje organizacje tokenu i liczbę przesyłek w każdej.
Integracja
Pobieranie przesyłek, zapis gabarytów, dopasowanie do paczek z BaseLinkera i uwagi przy przesyłkach bez pary.
Test i uruchomienie
Porównanie z eksportem z Managera Paczek przesyłka po przesyłce, potem nocne pobieranie i opieka po wdrożeniu.
Czego nie robimy
- Nie przypinamy przesyłki do zamówienia po samym numerze referencyjnym, odbiorcy czy dacie.
- Nie liczymy szkiców bez numeru przesyłki jako wysłanych paczek.
- Nie tworzymy drugi raz etykiet, które już robi BaseLinker. ShipX służy wtedy do kontroli.
- Nie trzymamy tokenu ShipX w przeglądarce, w kodzie ani w repozytorium.
Narzędzia
InPost ShipX API
Przesyłki, organizacje, statusy i szablony gabarytów.
Manager Paczek InPost
Token, ID organizacji i adres webhooka w zakładce API.
BaseLinker API
Paczki zamówień i numery przesyłek do dopasowania. BaseLinker API →
n8n lub Make
Dane do rozliczenia albo powiadomienia dalej, bez własnego serwera. n8n → Make →
Python i Django
Pobieranie, dopasowanie i harmonogram nocnych przebiegów.
Next.js
Panel z raportem per klient, uwagami i eksportem do Excela.
Opisz, co chcesz połączyć z InPostem
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak uzyskać token do InPost ShipX API?
Token generujesz w Managerze Paczek InPost, w zakładce Moje konto, API. Tam jest też ID organizacji. Token przekazuje się w nagłówku Authorization jako Bearer. Środowisko testowe (sandbox) ma osobny Manager Paczek i osobny token, który nie działa na produkcji.
Czym jest organizacja w InPost ShipX?
Organizacja to w ShipX firma z podpisaną umową z InPostem, a przesyłki są zapisane w jej obrębie. Jeden token może mieć dostęp do kilku organizacji. Dlatego przy wdrożeniu najpierw sprawdzamy, które organizacje widzi token i które z nich należą do Twojej umowy.
Jakie są wymiary paczkomatu A, B i C w ShipX?
Według dokumentacji ShipX (stan na listopad 2026) gabaryt A to 8 x 38 x 64 cm, B to 19 x 38 x 64 cm, a C to 41 x 38 x 64 cm, każdy do 25 kg. W API odpowiadają im szablony small, medium i large. Standardowa przesyłka kurierska ma zamiast szablonu prawdziwe wymiary i wagę.
Jak policzyć paczki InPost per klient?
Trzeba połączyć przesyłki z ShipX z zamówieniami, w których jest klient. W naszym wdrożeniu przesyłka z ShipX łączy się z paczką z BaseLinkera po numerze przesyłki, a klient pochodzi z zamówienia w BaseLinkerze. Wynik to tabela klient na paczkomat A, B, C i kurier, a przesyłka bez pary dostaje uwagę z powodem.
Czy InPost ShipX API ma webhooki?
Tak. Adres webhooka ustawiasz w Managerze Paczek, w zakładce Moje konto, API. InPost wysyła na niego zdarzenia, m.in. utworzenie przesyłki z numerem i zmianę statusu. Adres musi odpowiadać kodem 200 na zapytanie GET.
Jak długo ShipX zwraca tracking przesyłki?
Według dokumentacji InPost tracking jest dostępny przez 45 dni od utworzenia przesyłki, a w środowisku testowym statusy nie są zwracane wcale. Daty nadania i doręczenia warto więc zapisywać u siebie, zamiast odpytywać tracking po miesiącu.
Czy ShipX API zastąpi integrację InPost w BaseLinkerze?
Nie musi. Gdy etykiety tworzy BaseLinker, ShipX daje drugi widok: przesyłki od strony przewoźnika, także te utworzone poza BaseLinkerem. W naszym wdrożeniu BaseLinker jest źródłem liczby paczek, a ShipX ją potwierdza. Opisujemy to w case study rozliczania paczek.
Co daje integracja z InPost ShipX API?
Integracja z ShipX daje Ci przesyłki InPost od strony przewoźnika: co zostało kupione na Twoim koncie, w jakim gabarycie, jaką usługą i w jakim statusie. Bez niej te dane są tylko w Managerze Paczek, a do rozliczeń trzeba je eksportować i liczyć w arkuszu.
Najwięcej daje to firmom, które wysyłają paczki za kilku klientów z jednego konta InPost, np. magazynom fulfillment. Manager Paczek pokazuje numer przesyłki i referencję, ale nie wie, którego klienta to paczka. Tę informację ma system zamówień, więc integracja łączy jedno z drugim.
ShipX API czy integracja InPost w BaseLinkerze?
| Sposób | Do czego służy | Czego nie da |
|---|---|---|
| Integracja InPost w BaseLinkerze | etykiety do zamówień i numer przesyłki w zamówieniu | pełnej listy przesyłek z konta przewoźnika |
| ShipX API | wszystkie przesyłki organizacji, gabaryty, statusy, anulowania | informacji, do którego klienta należy przesyłka |
| Oba razem | kontrola: paczka z BaseLinkera potwierdzona przez przewoźnika | wymaga dopasowania po numerze przesyłki |
W naszym wdrożeniu BaseLinker jest źródłem prawdy o liczbie paczek, bo każde zamówienie tam jest, niezależnie od konta wysyłki. ShipX potwierdza paczki z kont, do których mamy dostęp. Więcej o drugiej stronie tego połączenia przeczytasz na stronie BaseLinker API.
Jak policzyć paczki InPost per klient z ShipX API
- Pobranie przesyłek z organizacji z ostatnich dni, w stałej kolejności, żeby nowe przesyłki nie przesuwały stron w trakcie pobierania.
- Kontrola kompletności: liczba pobranych przesyłek musi być równa liczbie z odpowiedzi API, inaczej pobranie kończy się błędem.
- Zapis gabarytu i usługi: paczkomat A, B, C albo kurier, liczba paczek w przesyłce, status.
- Dopasowanie po numerze przesyłki do paczki z BaseLinkera. Numer zamówienia z referencji tylko wyjaśnia brak pary.
- Raport per klient z uwagą przy każdej przesyłce bez pary, bez klienta albo anulowanej.
Gabaryty paczkomatów InPost w ShipX API
| Szablon w API | Gabaryt | Wymiary | Waga |
|---|---|---|---|
| small | A | 8 x 38 x 64 cm | do 25 kg |
| medium | B | 19 x 38 x 64 cm | do 25 kg |
| large | C | 41 x 38 x 64 cm | do 25 kg |
Przesyłka paczkomatowa ma w ShipX wagę i wymiary szablonu, a nie prawdziwe, dlatego w rozliczeniu liczy się sam gabaryt. Przesyłka kurierska ma prawdziwe wymiary i wagę, a w kraju może mieć kilka paczek w jednej przesyłce. Wtedy liczymy każdą paczkę osobno.
Bezpieczeństwo tokenu ShipX
Token ShipX daje dostęp do przesyłek organizacji, więc trzymamy go po stronie serwera. W panelu wpisuje go tylko administrator, wartość nie wraca do przeglądarki, a przycisk testu wykonuje jedno lekkie zapytanie i pokazuje organizacje tokenu. Do rozwoju używamy środowiska testowego InPost z osobnym tokenem.

