Przejdź do głównej zawartości

InPost API

Globe Pickup Points integruje się z InPost Poland przez API ShipX. Dzięki tej integracji możesz:

  • Eksportować zamówienia do InPostu bezpośrednio z Shopify
  • Drukować etykiety wysyłkowe w Shopify
  • Wysyłać do Paczkomatów InPost i PaczkoPunktów w Polsce
  • Wysyłać przez InPost Kurier na adresy w Polsce, także ekspresowo z doręczeniem do 10:00, 12:00 lub 17:00
  • Przyjmować płatności za pobraniem w PLN
  • Śledzić przesyłki na stronie śledzenia InPost

Potrzebujesz konta InPost w Managerze Paczek (manager.paczkomaty.pl) z uzupełnionymi danymi firmy i danymi do faktury. InPost Kurier standard i express wymagają umowy kurierskiej z InPostem. Na koncie prepaid wysyłaj przesyłki kurierskie usługą InPost Kurier C2C.

  1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Kliknij Dodaj integrację przewoźnika i wybierz InPost Poland.
  2. Wprowadź Token API ShipX i ID organizacji. Token wygenerujesz w Managerze Paczek w zakładce Moje konto → API. ID organizacji to numer widoczny obok tokenu.
  3. Wybierz Środowisko: Produkcyjne dla prawdziwych przesyłek albo Programistyczne z tokenem z sandboxa InPost (sandbox-manager.paczkomaty.pl).
  4. W polu Jak nadajesz paczki InPost wybierz sposób przekazywania paczek:
    • Odbiór przez kuriera z mojego adresu: kurier InPost odbiera paczki w ramach stałego odbioru uzgodnionego z InPostem albo odbioru zleconego w Managerze Paczek.
    • Nadaję w dowolnym Paczkomacie lub PaczkoPunkcie
    • Nadaję w PaczkoPunkcie
    • Dostarczam paczki do oddziału InPost
  5. W polu Gabaryt paczki wybierz gabaryt dla przesyłek paczkomatowych i InPost Kurier C2C. Zobacz Gabaryty paczek.
  6. W polu Usługa kurierska dla zamówień bez Paczkomatu wybierz InPost Kurier standard (umowa kurierska) lub InPost Kurier C2C (konto prepaid). Produkt AUTO używa tej usługi dla zamówień bez punktu InPost.
  7. Wypełnij pola Domyślna długość paczki w milimetrach, Domyślna szerokość paczki w milimetrach i Domyślna wysokość paczki w milimetrach. InPost Kurier standard i express wymagają wymiarów paczki.
  8. Wypełnij dane nadawcy albo zostaw wszystkie pola puste, a na etykiecie wydrukują się dane Twojego konta InPost (Manager Paczek, Moje konto → Dane). Jeśli je wypełniasz, wypełnij wszystkie: Nazwa firmy nadawcy, Nazwa nadawcy, Ulica nadawcy, Numer domu nadawcy, Miasto nadawcy, Kod pocztowy nadawcy, Telefon nadawcy i Email nadawcy. Telefon nadawcy to 9-cyfrowy polski numer, z prefiksem +48 lub bez niego.
  9. Skonfiguruj opcje realizacji i tagowania według potrzeb:
    • Automatycznie realizuj zamówienia: Nigdy, Tak, wyślij email z numerem śledzenia lub Tak, nie wysyłaj emaila. Po włączeniu tej opcji Globe po eksporcie realizuje zamówienie z numerem śledzenia InPost, przewoźnikiem InPost i linkiem do strony śledzenia.
    • Automatycznie oznaczaj zamówienia numerem śledzenia dodaje numer śledzenia jako tag zamówienia.
    • Własny tag po eksporcie dodaje wybrany przez Ciebie tag po każdym udanym eksporcie.

Produkt w GlobeDostawa
InPost (Paczkomat if selected, otherwise courier to the address)Do punktu InPost wybranego przez klienta w kasie, w przeciwnym razie kurierem na adres usługą z ustawień
InPost Paczkomat or PaczkoPunkt (pickup point)Do punktu InPost wybranego w kasie
InPost Kurier standard (address)Kurierem na adres, wymagana umowa kurierska
InPost Kurier C2C (address, prepaid account)Kurierem na adres
InPost Kurier express by 10:00, 12:00 or 17:00 (address)Kurierem ekspresowym na adres, wymagana umowa kurierska

InPost włącza usługi osobno dla każdego konta. Jeśli usługa nie jest włączona na Twoim koncie, Globe poinformuje Cię o tym, zanim cokolwiek wyśle. Poproś InPost o jej włączenie albo wybierz inny produkt.

Przesyłek kurierskich nie można przekazać opcją Nadaję w dowolnym Paczkomacie lub PaczkoPunkcie, a przesyłek InPost Kurier C2C nie można dostarczyć do oddziału InPost. Odbiór przez kuriera i nadanie w PaczkoPunkcie działają dla każdej usługi.


Możesz eksportować zamówienia do InPostu i drukować etykiety wysyłkowe bezpośrednio z Shopify, masowo lub pojedynczo. Cały proces tworzenia etykiet opisujemy w artykule Tworzenie etykiet wysyłkowych.

Eksport zamówienia tworzy jedną przesyłkę InPost. InPost potwierdza przesyłkę w ciągu kilku sekund i nadaje jej numer śledzenia. Przesyłki można śledzić pod adresem https://inpost.pl/sledzenie-przesylek?number=<tracking number>. Na każdej etykiecie jako numer referencyjny widnieje numer zamówienia Shopify.

Jeśli InPost nie potwierdzi przesyłki na czas, Globe ją anuluje i nic nie zostanie wysłane. Potwierdzonej przesyłki nie można już anulować przez API.

Globe pobiera etykiety z InPostu przy każdym drukowaniu, więc możesz je później wydrukować ponownie.

Integracja nie synchronizuje statusów dostawy z powrotem do Shopify.


Przesyłki paczkomatowe i InPost Kurier C2C nadajesz w wybranym gabarycie, do 25 kg:

GabarytNazwa w Globe
AMały (A, 8 × 38 × 64 cm)
BŚredni (B, 19 × 38 × 64 cm)
CDuży (C, 41 × 38 × 64 cm)
DBardzo duży (D, 50 × 50 × 80 cm, tylko InPost Kurier C2C)

InPost nalicza opłatę według gabarytu, a paczka musi zmieścić się w skrytce Paczkomatu. InPost Kurier standard i express używają zamiast tego domyślnych wymiarów w milimetrach i przyjmują paczki do 50 kg. Globe sprawdza wagę przesyłki przed eksportem.


Globe przekazuje do InPostu nazwę punktu, na przykład KRA010 dla Paczkomatu lub POP-WAW364 dla PaczkoPunktu. InPost doręcza tylko do punktów w Polsce. Klient wybiera punkt w kasie. Jak udostępnić punkty InPost w kasie, opisujemy w artykule Dodawanie przewoźników z punktami odbioru. Globe przyjmuje też Paczkomaty InPost w Polsce wybrane z listy punktów Packety.

Zamówienie z punktem z sieci innego przewoźnika nie zostanie wyeksportowane. Wybierz punkt InPost akcją Zmodyfikuj punkt odbioru albo użyj produktu kurierskiego.

InPost wysyła kod odbioru na e-mail i telefon klienta, więc zamówienia do punktu wymagają obu tych danych. Numer telefonu może być polski albo zagraniczny z kodem kraju, na przykład +420 777 123 456.


InPost obsługuje płatność za pobraniem tylko w PLN. Globe dodaje do każdej przesyłki pobraniowej ubezpieczenie co najmniej na kwotę pobrania, bo tego wymaga InPost. Zamówienie w innej walucie nie zostanie wyeksportowane: wyślij je innym przewoźnikiem albo, jeśli zamówienie jest już opłacone, ustaw w panelu tworzenia etykiety pole Kwota pobrania na 0.


Etykiety InPost można drukować w następujących formatach:

FormatEtykiety
A6 (10x15 cm)Jedna etykieta na stronę
A4Etykiety paczkomatowe na arkuszach A4, do czterech na arkusz; etykiety kurierskie pozostają w formacie A6

Etykiety dla kilku zamówień są łączone w jeden plik PDF. Jeśli InPost nie zwróci niektórych etykiet, Globe wydrukuje pozostałe i poinformuje Cię, których przesyłek brakuje.


ProblemRozwiązanie
InPost settings are incompleteKomunikat wymienia brakujące ustawienia. Uzupełnij je w ustawieniach przewoźnika.
InPost rejected the API tokenSprawdź Token API ShipX w ustawieniach przewoźnika. To token z Managera Paczek (Moje konto → API).
InPost did not accept organization … for this API tokenSprawdź ID organizacji. Jest widoczne obok tokenu w Managerze Paczek.
… is not enabled on your InPost accountPoproś InPost o włączenie usługi albo wybierz inny produkt InPost.
InPost Kurier standard and express need an InPost courier contractNa koncie prepaid wybierz InPost Kurier C2C.
… parcels cannot be handed over at …Wybierz inną opcję w polu Jak nadajesz paczki InPost albo inny produkt InPost. Zobacz Produkty.
Order … has no InPost Paczkomat or PaczkoPunktZamówienie nie ma punktu InPost albo jego punkt należy do sieci innego przewoźnika. Wybierz punkt InPost akcją Zmodyfikuj punkt odbioru albo użyj produktu kurierskiego.
InPost Poland delivers within Poland onlyInPost Poland wysyła tylko na adresy i do punktów w Polsce. Wyślij zamówienie innym przewoźnikiem.
InPost cannot use the receiver's phone number …InPost przyjmuje polski numer (9 cyfr, z +48 lub bez) albo numer z kodem kraju z listy krajów InPost, na przykład +420 777 123 456. Popraw telefon w adresie wysyłki zamówienia i utwórz etykietę ponownie.
Order … has no e-mail addressInPost wysyła kod odbioru na e-mail i telefon klienta. Dodaj e-mail do zamówienia.
InPost Kurier needs street, house number, postcode and cityPopraw adres w Shopify i utwórz etykietę ponownie.
… needs the parcel dimensionsWypełnij w ustawieniach przewoźnika pola Domyślna długość paczki w milimetrach, Domyślna szerokość paczki w milimetrach i Domyślna wysokość paczki w milimetrach.
Order … weighs … kgJeśli waga jest błędna, popraw pole Waga przesyłki (kg) w panelu tworzenia etykiety. W przeciwnym razie użyj innego produktu lub przewoźnika.
InPost collects cash on delivery only in PLNWyślij zamówienie innym przewoźnikiem albo, jeśli zamówienie jest już opłacone, ustaw pole Kwota pobrania na 0.
InPost does not accept new shipments for this account (debt collection)Opłać ostatnią fakturę InPost albo doładuj konto prepaid w Managerze Paczek.
InPost did not confirm the shipment … so Globe cancelled itNic nie zostało wysłane. Utwórz etykietę ponownie za kilka minut.
… Check … before creating the label againInPost nie potwierdził przesyłki na czas albo Globe nie mógł odczytać odpowiedzi, ale przesyłka może istnieć. Zanim ponownie wyeksportujesz zamówienie, sprawdź Manager Paczek.
Brak etykiety w pliku PDFGlobe drukuje pozostałe etykiety i wymienia brakujące przesyłki. Wydrukuj ponownie później albo pobierz etykietę w Managerze Paczek.