Today Automate logo

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

Ciężarówka i paczki, symbol przesyłek kurierskich

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.

Lista z zaznaczonymi pozycjami, symbol sprawdzonych przesyłek

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.

Niebieskie koła zębate, symbol połączonych systemów

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.

    1. BaseLinker
    2. ShipX
    3. dopasowanie po numerze
    4. rozliczenie
    Czytaj case study →
  • Ten sam magazyn: dashboard dla pakowania

    Na ekranach w magazynie widać zamówienia do spakowania przed odbiorem kuriera, z osobnym terminem dla InPostu.

    1. BaseLinker
    2. dashboard
    3. zespół pakowania
    Czytaj case study →

Jak pracujemy

  1. Konsultacja

    Ustalamy, które organizacje ShipX należą do Twojej umowy, jakie usługi wysyłasz i co ma wyjść w raporcie.

  2. Token i organizacje

    Token z Managera Paczek wpisujesz w panelu. Test połączenia pokazuje organizacje tokenu i liczbę przesyłek w każdej.

  3. Integracja

    Pobieranie przesyłek, zapis gabarytów, dopasowanie do paczek z BaseLinkera i uwagi przy przesyłkach bez pary.

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

  • Logo Baselinker

    BaseLinker API

    Paczki zamówień i numery przesyłek do dopasowania. BaseLinker API →

  • Logo n8nLogo Make

    n8n lub Make

    Dane do rozliczenia albo powiadomienia dalej, bez własnego serwera. n8n → Make →

  • Logo PythonLogo Django

    Python i Django

    Pobieranie, dopasowanie i harmonogram nocnych przebiegów.

  • Logo Next.js

    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

  1. Odpisujemy w ciągu 1 dnia roboczego.
  2. Umawiamy 30-minutową rozmowę.
  3. Przygotowujemy propozycję i wycenę.

pole wymagane

Administratorem Twoich danych jest Today Group spółka z ograniczoną odpowiedzialnością (KRS 0001253446, NIP 9542911671). Użyjemy ich tylko po to, żeby odpowiedzieć na Twoje zapytanie. Podstawą jest nasz uzasadniony interes, czyli odpowiedź na Twoje zapytanie (art. 6 ust. 1 lit. f RODO). Masz prawo dostępu do danych, ich poprawienia, usunięcia i sprzeciwu. Szczegóły są w polityce prywatności.

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?

InPost w BaseLinkerze i przez ShipX API
SposóbDo czego służyCzego nie da
Integracja InPost w BaseLinkerzeetykiety do zamówień i numer przesyłki w zamówieniupełnej listy przesyłek z konta przewoźnika
ShipX APIwszystkie przesyłki organizacji, gabaryty, statusy, anulowaniainformacji, do którego klienta należy przesyłka
Oba razemkontrola: paczka z BaseLinkera potwierdzona przez przewoźnikawymaga 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

  1. Pobranie przesyłek z organizacji z ostatnich dni, w stałej kolejności, żeby nowe przesyłki nie przesuwały stron w trakcie pobierania.
  2. Kontrola kompletności: liczba pobranych przesyłek musi być równa liczbie z odpowiedzi API, inaczej pobranie kończy się błędem.
  3. Zapis gabarytu i usługi: paczkomat A, B, C albo kurier, liczba paczek w przesyłce, status.
  4. Dopasowanie po numerze przesyłki do paczki z BaseLinkera. Numer zamówienia z referencji tylko wyjaśnia brak pary.
  5. Raport per klient z uwagą przy każdej przesyłce bez pary, bez klienta albo anulowanej.
Szkice się nie liczą. Przesyłka bez numeru to oferta albo szkic, który nigdy nie został kupiony. Nie zapisujemy jej i nie liczymy klientowi.

Gabaryty paczkomatów InPost w ShipX API

Szablony paczkomatowe ShipX (stan na listopad 2026, wg dokumentacji InPost)
Szablon w APIGabarytWymiaryWaga
smallA8 x 38 x 64 cmdo 25 kg
mediumB19 x 38 x 64 cmdo 25 kg
largeC41 x 38 x 64 cmdo 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.