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
Włączanie integracji z API InPost
Dział zatytułowany „Włączanie integracji z API 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.
- 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.
- 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.
- Wybierz Środowisko: Produkcyjne dla prawdziwych przesyłek albo Programistyczne z tokenem z sandboxa InPost (sandbox-manager.paczkomaty.pl).
- 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
- W polu Gabaryt paczki wybierz gabaryt dla przesyłek paczkomatowych i InPost Kurier C2C. Zobacz Gabaryty paczek.
- 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.
- 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.
- 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
+48lub bez niego. - 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.
Produkty
Dział zatytułowany „Produkty”| Produkt w Globe | Dostawa |
|---|---|
| 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.
Eksportowanie i drukowanie etykiet
Dział zatytułowany „Eksportowanie i drukowanie etykiet”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.
Gabaryty paczek
Dział zatytułowany „Gabaryty paczek”Przesyłki paczkomatowe i InPost Kurier C2C nadajesz w wybranym gabarycie, do 25 kg:
| Gabaryt | Nazwa w Globe |
|---|---|
| A | Mały (A, 8 × 38 × 64 cm) |
| B | Średni (B, 19 × 38 × 64 cm) |
| C | Duży (C, 41 × 38 × 64 cm) |
| D | Bardzo 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.
Punkty odbioru
Dział zatytułowany „Punkty odbioru”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.
Płatność za pobraniem (COD)
Dział zatytułowany „Płatność za pobraniem (COD)”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.
Drukowanie etykiet
Dział zatytułowany „Drukowanie etykiet”Etykiety InPost można drukować w następujących formatach:
| Format | Etykiety |
|---|---|
| A6 (10x15 cm) | Jedna etykieta na stronę |
| A4 | Etykiety 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.
Rozwiązywanie problemów
Dział zatytułowany „Rozwiązywanie problemów”| Problem | Rozwiązanie |
|---|---|
InPost settings are incomplete | Komunikat wymienia brakujące ustawienia. Uzupełnij je w ustawieniach przewoźnika. |
InPost rejected the API token | Sprawdź Token API ShipX w ustawieniach przewoźnika. To token z Managera Paczek (Moje konto → API). |
InPost did not accept organization … for this API token | Sprawdź ID organizacji. Jest widoczne obok tokenu w Managerze Paczek. |
… is not enabled on your InPost account | Poproś InPost o włączenie usługi albo wybierz inny produkt InPost. |
InPost Kurier standard and express need an InPost courier contract | Na 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 PaczkoPunkt | Zamó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 only | InPost 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 address | InPost wysyła kod odbioru na e-mail i telefon klienta. Dodaj e-mail do zamówienia. |
InPost Kurier needs street, house number, postcode and city | Popraw adres w Shopify i utwórz etykietę ponownie. |
… needs the parcel dimensions | Wypeł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 … kg | Jeś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 PLN | Wyś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 it | Nic nie zostało wysłane. Utwórz etykietę ponownie za kilka minut. |
… Check … before creating the label again | InPost 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 PDF | Globe drukuje pozostałe etykiety i wymienia brakujące przesyłki. Wydrukuj ponownie później albo pobierz etykietę w Managerze Paczek. |