Na tej stronie

Informacje ogólne

Tak, w API ShipX jest dostępne środowisko testowe (sandbox) adres środowiska testowego: https://sandbox-api-shipx-pl.easypack24.net.

https://sandbox-manager.paczkomaty.pl/ > zakładka Moje konto > API. Aby wygenerować Token i ID organizacji należy uzupełnić wszystkie dane, łącznie z danymi do faktury w zakładce Moje konto > Dane. Do utworzenia przesyłki paczkomatowej niezbędne są środki na koncie, konto doładujesz wirtualnie w zakładce Płatności.

Tak, gotowe zapytania json można pobrać z linku: [1.3.0] API Informacje ogólne.

Upewnij się, że podałeś poprawny token z zakładki API w https://manager.paczkomaty.pl jeżeli token jest poprawny.

Pamiętaj, aby używać na środowisku produkcyjnym tokenu z https://manager.paczkomaty.pl/auth/login a na środowisku sandbox z https://sandbox-manager.paczkomaty.pl/.

Jeżeli API zwraca błąd 500, skorzystaj z formularza wsparcia integracyjnego https://inpost.pl/formularz-wsparcie i wybierz kategorię Problem z dostępnością systemu.

API zwraca błąd, w momencie gdy wpisane jest błędne id organizacji. Zaloguj się do https://manager.paczkomaty.pl i pobierz id organizacji znajdujące się w zakładce API w https://manager.paczkomaty.pl/auth/login.

Zasób Przesyłka

Tak, jest taka możliwość z wykorzystaniem zasobu batch: [1.6.4] Tworzenie i podgląd wielu przesyłek.

Nie, jeżeli przy tworzeniu paczki nie zostały podane dane nadawcy, zostaną one pobrane z konta API ShipX.

Nie, API ShipX posiada tryb uproszczony, podczas tworzenia paczek należy wskazać serwis, za pomocą którego ma być nadana paczka, a następnie API automatycznie ją opłaca.

Podczas tworzenia paczki pobraniowej należy pamiętać, że paczka musi zostać ubezpieczona minimum na wartość pobrania lub wyższą.

Należy sprawdzić, czy w systemie https://manager.paczkomaty.pl został uzupełniony numer rachunku bankowego. Po uzupełnieniu numeru rachunku, paczki pobraniowe będą tworzyć się prawidłowo.

Nie, dla przesyłek paczkomatowych zostały utworzone szablony, które można wykorzystać, aby wskazać skrytkę, do której powinna zostać umieszczona przesyłka:

Nazwa szablonu

Wymiary

Waga

Gabaryt

small

8 x 38 x 64 cm

do 25 kg

Gabaryt A

medium

19 x 38 x 64 cm

do 25 kg

Gabaryt B

large

41 x 38 x 64 cm

do 25 kg

Gabaryt C

Zalecamy, aby dla paczek kurierskich przekazywać prawidłowe wymiary oraz wagę.

"parcels": {
                "dimensions": {
                "length": "10",
                "width": "10",
                "height": "10",
                "unit": "mm"
            },
            "weight": {
                "amount": "10",
                "unit": "kg"
            }
           },

Aktualizować można tylko przesyłki, które nie zostały jeszcze zakupione, tzn. posiadają status createdoffers_prepared albo offer_selected

Aby anulować przesyłkę w ramach określonej organizacji, użytkownik musi być jej członkiem. Dodatkowym warunkiem jest to, aby przesyłka miała status created lub offers_prepared.

Tak, API ShipX umożliwia tworzenie paczki z usługą Paczka w Weekend: [1.9.0] Paczka w Weekend

Usługa będzie dostępna w określonym oknie czasowym, np. od czwartku od godziny 20:00 do soboty do godziny 13:00. Nie uwzględniamy świąt ani dni wolnych.

  • Etykietę można pobrać dla przesyłki opłaconej — w statusie confirmed lub późniejszym.

  • Aby, pobrać etykietę przesyłki użytkownik musi być jej nadawcą.

Tak, maksymalnie można pobrać etykiety dla 100 przesyłek. [1.6.0] Pobieranie wielu etykiet

Nie, API ShipX obsługuje wyłącznie polskie numery telefonu, należy podać 9 cyfrowy numer telefonu, bez znaków specjalnych oraz numerów kierunkowych np. „+48”.

Jeżeli jesteś klientem postpaid (posiadasz umowę) sprawdź, czy opłaciłeś ostatnią fakturę, a następnie skontaktuj się z opiekunem. Jeżeli natomiast jesteś klientem prepaid (bez umowy) sprawdź, czy posiadasz wystarczającą ilość środków na koncie.

API zwraca błąd, ponieważ próbują Państwo użyć serwisu kurierskiego, który dostępny jest po podpisaniu umowy kurierskiej. Dla kont prepaid dedykowanym serwisem jest kurier C2C “inpost_courier_c2c”.

W przypadku podania nieodpowiedniego serwisu dla metody dostawy (np. serwisu inpost_locker_standard dla metody Allegro Paczkomaty 24/7), usługa SMART nie będzie dostępna.

Na środowisku sandbox, komponent trackingowy jest wyłączony, dlatego też nie ma możliwości sprawdzenia statusu paczki.

Zasób Tracking

Nie ma takiej możliwości, API pozwala na sprawdzenie statusu dla pojedynczej przesyłki.

Tak, API umożliwia śledzenie statusów paczek 45 dni wstecz.

Zasób Statusy

Sposób pobrania listy statusów opisany jest w dokumentacji: [1.2.0] Statusy

Tak, API umożliwia pobranie statusów wraz z ich opisami w języku angielskim. W requeście należy dodać parametr: en_GB.