Podczas korzystania z naszego interfejsu API w celu tworzenia, modyfikowania lub aktualizowania zamówień możesz otrzymać komunikat o błędzie, ponieważ informacje mogą być w niewłaściwym formacie lub zasób, który chcesz sparować, jeszcze nie istnieje. W takim przypadku radzimy sprawdzić plik (głównie JSON), który wysłałeś do Shippeo.
Lista możliwych błędów
Poniżej znajduje się lista możliwych komunikatów o błędach wraz z ich wyjaśnieniem i możliwymi kolejnymi krokami.
Komunikat | Objaśnienie | Następne kroki | |
Związane z uwierzytelnianiem |
{ "detail": "Invalid credentials" ("Nieprawidłowe dane uwierzytelniające"), "status": 401, "source": { "pointer": "/" } } |
Podana kombinacja nazwy użytkownika i hasła jest nieprawidłowa. | Sprawdź dwukrotnie wprowadzone dane lub zresetuj hasło użytkownika interfejsu API. Administrator Twojego konta na Shippeo może Ci pomóc(więcej informacji tutaj). |
{ "detail": "Token {{shipperTokend}} jest nieprawidłowy", "status": 401, "source": { "pointer": "/" } } |
Przesłany token jest nieprawidłowy. | Sprawdź dwukrotnie wprowadzony token lub poproś o nowy token. | |
{ "detail": "Expired JWT Token", "status": 401, "code": "TOKEN_EXPIRED_EXCEPTION", "source": { "pointer": "/" }, "title": "Token wygasł" } |
Przesłany przez Ciebie token stracił ważność. |
Poproś o nowy token, ponieważ ten nie jest już ważny. Dla przypomnienia, token API to:
Można je odświeżać maksymalnie raz dziennie. |
|
Związane z formatem |
{ "detail": "Otrzymano nieprawidłowy komunikat json", "status": 400, "source": { "pointer": "/" } } |
Wysłany komunikat JSON jest nieprawidłowy. |
Proszę sprawdzić wiadomość, którą próbujesz wysłać, ponieważ ten JSON nie jest zasadniczo poprawny. Przykłady można znaleźć w naszej dokumentacji API. |
{ "detail": "Ta wartość jest zbyt długa. Powinien on mieć nie więcej niż 35 znaków.", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up/name" } } |
Wartość dodana dla określonego pola jest zbyt długa. |
Sprawdź pole wskazywane przez sekcję "wskaźnik" w komunikacie i skróć wartość tak, aby była mniejsza niż wskazane znaki. |
|
{ "errors": [ { "detail": "Ta wartość nie powinna być pusta.", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up/name" } } ]} |
W wiadomości brakuje wartości dla określonego pola. |
Sprawdź pole wskazane w komunikacie przez sekcję "wskaźnik" i wprowadź wartość, ponieważ pole to nie może być puste. |
|
{ "detail": "Ta wartość jest zbyt krótka. Powinien mieć co najmniej 1 znak.", "status": 400, "source": { "pointer": "/shipment/orders[0]/handling_units[1]/ tracking_code" } } |
Wartość dodana dla określonego pola jest zbyt długa. |
Sprawdź pole wskazywane przez sekcję "wskaźnik" w komunikacie i wydłuż wartość tak, aby była większa niż wskazane znaki. |
|
Związane z Agencją | {"errors":[{"detail": "nie udało się znaleźć żadnej agencji z podanymi informacjami", "status": 400,"source":{"pointer": "\"\"przewoźnik"} | Agencja, do której zamówienie zostało skierowane, nie istnieje lub ma inne oznaczenie | Skontaktuj się z przedstawicielem firmy Shippeo. Należy pamiętać o dołączeniu: pliku JSON, nazwy przewoźnika, referencji przewoźnika, którego używasz. |
{"errors":[{"detail": "Agency already charter", "status":400, "source":{"pointer":"}]} | Zlecenie to zostało już przydzielone agencji. |
|
|
{"errors":[{"detail": "Nie znaleziono agencji dla pola situation_justification.charter .agency"}} | Agencja, której nadano order, nie istnieje lub ma inne oznaczenie. | Skontaktuj się z przedstawicielem firmy Shippeo. Należy pamiętać o dołączeniu: pliku JSON, nazwy przewoźnika i numeru referencyjnego przewoźnika, którego używasz. | |
Zamówienia związane z
|
{"errors":[{"detail": "This value should not be null.", "status":400, "source":{"pointer":"/situation_justification /charter/agency/id"}]}. |
Wartość w pliku ma wartość 0, co jest niedozwolone. | Należy sprawdzić, czy w pliku JSON nie ma wartości równej 0. |
{"errors":[{"detail": "Ta wartość jest zbyt krótka. Powinien mieć 1 znak lub więcej.", "status":400, "source":{"pointer":"\", "order/id"}}. |
Wartość w pliku nie zawiera żadnych informacji. | Należy sprawdzić, czy w pliku JSON nie ma wartości, które nie zawierają żadnych informacji. | |
{"errors":[{"detail": "Order reference not found.", "status": 400, "source":{"pointer":"\"/order"}]} |
Nie znaleziono odnośnika do zamówienia. |
Sprawdź na swoim koncie Shippeo, czy zamówienie istnieje. |
|
{"errors":[{"detail": "Order not found with filters : "OrderById(id= "xxxxxx"), NotArchivedOrd", "status":400, "source":{"pointer":"\"\".}}} |
Zlecenie nie może zostać znalezione przy użyciu tych filtrów. |
Ten błąd może mieć różne przyczyny, ale głównym powodem jest to, że to zamówienie nie jest już aktywne, a zatem nie można go zaktualizować. W związku z tym możesz sprawdzić dane zamówienie w Shippeo, aby dowiedzieć się, czy jest ono nadal realizowane. Jeśli tak jest, zapraszamy do kontaktu z naszym zespołem pomocy technicznej Shippeo. |
|
{"errors":[{"detail": "Zamówienie nie może być sparowane z tym samym środkiem", "status": 400, "source":{"pointer": “\/pair\/mean\/id”}}]} | Zlecenie zostało już połączone z tym samym zasobem. | W tym przypadku nie jest wymagane żadne działanie, ponieważ zlecenia zostały już skojarzone z odpowiednim zasobem. | |
{"errors":[{"detail": "Nie można wykonać akcji na zakończonym zamówieniu", "status": 400, "source":{"pointer":"}]} | Zamówienie jest już zamknięte. | W tym przypadku nie jest wymagane żadne działanie, ponieważ zamknięte zlecenie nie może być już aktualizowane. | |
{"errors":[{"detail": "ExternalId jest już używany w tej organizacji", "status":400, "source":{"pointer":"\", "canonical_external_id"}]} |
Identyfikator zamówienia jest już używany dla innego zamówienia. |
Identyfikator/referencja zamówienia musi być unikalny w środowisku Shippeo wśród aktywnych zamówień. W tym przypadku można:
|
|
{"errors":[{"detail": "The action xxx has already been executed.", "status":409, "code": "ACTION_ ALREADY_EXECUTED", "source":{"pointer":"}, "title": "Action already executed"}]} | Działanie zostało już wykonane. |
Nie jest wymagane żadne działanie z Twojej strony, ponieważ czynność, którą próbujesz wykonać, została już wykonana w Shippeo. |
|
{ "detail": "Dostawa jest przed załadunkiem", "status": 400, "source": { "pointer": "/shipment/orders[0]". } } |
Szczelina na dostawy jest ustawiana przed szczeliną załadunkową. |
Należy sprawdzić zamówienie i upewnić się, że termin dostawy nie został zaplanowany przed załadunkiem. |
|
{ "detail": "Teoretyczna data rozpoczęcia jest po teoretycznej dacie zakończenia", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up" } } |
Koniec szczeliny czasowej załadunku lub dostawy jest wcześniejszy niż początek szczeliny czasowej załadunku lub dostawy. |
Należy sprawdzić zamówienie i upewnić się, że koniec szczeliny załadunku lub dostawy nie jest wcześniejszy niż początek odpowiedniej szczeliny. |
|
{ "detail": "This value is not a valid datetime.", "status": 400, "source": { "pointer": "/" } } |
Format daty nie jest prawidłowy. |
Należy sprawdzić format daty przesłany w pliku JSON. Dla przypomnienia, format daty musi być zgodny z normą ISO 8601, np.
|
|
Związane z zasobami | {"title": "Środek nie może być znaleziony ani utworzony", "szczegół": "Niektórych informacji może brakować lub mogą być niedokładne", "status": 400, "source": {"pointer": "/"} | Zasób (średni) musi być wcześniej utworzony w Shippeo. |
Upewnij się, że tablica rejestracyjna przesłana w pliku JSON jest prawidłowa. Następnie skontaktuj się z osobą kontaktową Shippeo, podając kontakt do podwykonawcy w CC oraz następujące informacje:
Uwaga: Możliwe jest tworzenie zasobów podczas tworzenia zlecenia. Więcej informacji na ten temat można znaleźć w tym artykule. |
{"errors":[{"detail": "A deactivated mean cannot be paired", "status":400, "source":{"pointer":"\"/pair"}}}. | Zasób (średnia) nie jest aktywny na Twoim koncie Shippeo. |
Jako przewoźnik lub spedytor korzystający z własnej floty Upewnij się, że zasób jest aktywny na Twoim koncie Shippeo:
Jako załadowca, który dobiera się w pary z przewoźnikiem: Skontaktuj się ze swoim przewoźnikiem, prosząc go o wykonanie powyższej akcji. |
|
{ "detail": "Etykieta jest już używana w tej organizacji", "status": 400, "source": { "pointer": "\"/label" } | Etykieta zasobu już istnieje dla tej organizacji. |
Sprawdź na liście zasobów, czy ta nazwa nie istnieje już w Shippeo, aby uniknąć duplikatów. Jeśli nie jest to duplikat, lecz inny zasób, należy zmienić jego nazwę na inną. |
|
Miejsce / Adres związany |
{ "detail": "Należy podać informacje o istniejącym miejscu lub nowym miejscu", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up" } } |
Miejsce/adres załadunku lub dostawy nie istnieje. |
Sprawdź zamówienie i upewnij się, że miejsce/adres do załadunku i dostawy istnieje w środowisku Shippeo oraz że używasz poprawnej nazwy. Więcej o tym, jak tworzyć miejsca/adresy w Shippeo, można przeczytać tutaj. |
{ "detail": "Załadunek i dostawa nie mogą odnosić się do tego samego miejsca", "status": 400, "source": { "pointer": "/shipment/orders[0]". } } |
Miejsce/adres załadunku i dostawy jest takie samo. |
Należy sprawdzić zamówienie i upewnić się, że miejsce załadunku i dostawy/adres są różne. |
|
{ "detail": "Miejsce jest wyłączone i nie można z niego korzystać.", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up" } } |
Miejsce/adres załadunku lub dostawy jest nieaktywne. |
Należy sprawdzić zamówienie i upewnić się, że miejsce/adres załadunku i dostawy jest aktywnym adresem w Shippeo. |
|
Towary związane |
{ "errors": [ { "detail": "Invalid packing qualifier provided : [TR], available values are [PX, PD, PE, PC, NA]", "status": 400, "source": { "pointer": "/shipment/orders[0]/packing[0]/type" } } ]} |
Użyty kwalifikator opakowania jest nieprawidłowy. |
Prosimy o sprawdzenie wiadomości i upewnienie się, że kwalifikator opakowania dla wymienionych towarów jest jednym z poniższych: PX, PD, PE, PC, NA |
{ "detail": "nie można było znaleźć niestandardowego kwalifikatora opakowania z podanymi informacjami", "status": 400, "source": { "pointer": "/shipment/orders[0]/handling_units[0]/ custom_packaging_qualifier" } } |
Użyty kwalifikator opakowania niestandardowego jest nieprawidłowy. |
Sprawdź swoją wiadomość i użyty kwalifikator niestandardowy. Jeśli potrzebujesz dodatkowych kwalifikatorów do pakowania niestandardowego dla swojego konta Shippeo, skontaktuj się ze swoim opiekunem klienta. |
Czy Twojego błędu nie ma na liście?
Jeśli napotkasz inny komunikat o błędzie, którego nie ma na liście lub coś jest dla Ciebie niewystarczająco jasne, skontaktuj się z naszym zespołem pomocy technicznej, klikając przycisk "Wyślij zgłoszenie" na górnym pasku tej strony.