Messages d'erreur possibles lors de l'utilisation de l'API

{ "detail": "Invalid credentials", "status": 401, "source": { "pointer": "/" } }

{ "detail": "The token \"{{shipperTokend}}\" is invalid", "status": 401, "source": { "pointer": "/" } }

{ "detail": "Expired JWT Token", "status": 401, "code": "TOKEN_EXPIRED_EXCEPTION", "source": { "pointer": "/" }, "title": "Token has expired" }

Veuillez demander un nouveau token car ce token n'est plus valide.

Pour rappel, un token API est :

• Valable 15 jours dans l'environnement de production.
• Valable pour 2 jours dans l'environnement de test.

Il peut être actualisé au maximum une fois par jour.

{ "detail": "Invalid json message received", "status": 400, "source": { "pointer": "/" } }

Veuillez vérifier le message que vous essayez d'envoyer, car ce JSON n'est généralement pas valide. Vous trouverez des exemples dans notre documentation API.

{ "detail": "This value is too long. It should have 35 characters or less.", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up/name" } }

Vérifiez le champ indiqué par la section "pointer" dans le message et abrégez la valeur pour qu'elle soit inférieure aux caractères indiqués.

{ "errors": [ { "detail": "This value should not be blank.", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up/name" } } ]}

Vérifiez le champ indiqué par la section "pointer" dans le message et entrez une valeur car ce champ ne peut pas être vide.

{ "detail": "This value is too short. It should have 1 character or more.", "status": 400, "source": { "pointer": "/shipment/orders[0]/handling_units[1]/ tracking_code" } }

Vérifiez le champ indiqué par la section "pointer" dans le message et allongez la valeur pour qu'elle soit supérieure aux caractères indiqués.

{ "detail":"This value is not a valid phone number.","status":400,"code":"validator.phone_number.invalid_phone_number_error","source":{"pointer":"\/shipment\/orders[0]\/notification_contacts[0]\/communication_number" } }

Si le numéro de téléphone ne peut pas être fourni, veuillez supprimer toute la section notificationContacts, sinon la commande ne sera pas créée correctement.

{ "detail": "This value is not a valid email address.","status": 400,"code":"validator.email.strict_check_failed_error","source": {"pointer": "/shipment/orders[0]/notification_contacts[0]/email" } }

Si l'adresse électronique ne peut pas être fournie, veuillez supprimer toute la section notificationContacts, sinon la commande ne sera pas créée correctement.

{ "detail": "Container reference format is invalid.", "status": 400, "code": "", "source": { "pointer": "/shipment/container/reference/reference" } }

Veuillez vérifier si la référence du conteneur est composée de quatre lettres suivies de sept chiffres.

{ "detail": "Carrier identifier value \"agy-bim-carrier-orders-out-shippeo\" is not a valid SCAC.", "status": 400, "code": "7b3497f3-d5f9-4c9d-9503-a97a638e6b55", "source": { "pointer": "/shipment//carrier/identifier" } }

Veuillez vérifier que la référence du SCAC est composée de 4 lettres. Ex: ABCD

{"errors":[{"detail": "no agency could be found with the given information","status": 400,"source":{"pointer": "\/shipment\/ carrier"}}

{"errors":[{"detail": "Agency already charter","status":400,"source":{"pointer":"\/"}}]}

1. Connectez-vous à Shippeo et recherchez la commande.
2. Recherchez la commande et cliquez sur la page de détails de la commande.
3. Vérifiez dans la chronologie quand la commande a été attribuée et à quelle agence.
4. Consultez votre équipe EDI pour savoir ce qui a déclenché ce message.

{"errors":[{"detail": "Agency not found for field situation_justification.charter .agency"}}

Relatif à l'ordre

{“errors”:[{“detail”: “This value should not be null.“, ”status”:400,“source”:{“pointer”:“\/situation_justification\ /charter\/agency\/id”}}]}

{“errors”:[{“detail”: “This value is too short. It should have 1 character or more.“,”status”:400,“source”:{“pointer”:“\/order\/id”}}]}

{“errors”:[{“detail”: “Order reference not found.“,”status”: 400, “source”:{“pointer”:“\/order”}}]}

{“errors”:[{“detail”: “Order not found with filters : "OrderById(id= "xxxxxx"), NotArchivedOrd“, ”status”:400,“source”:{“pointer”:“\/order\/id”}}]}

L'ordre ne peut pas être trouvé avec ces filtres.

Cette erreur peut avoir différentes raisons, mais la principale est que cette commande n'est plus active et qu'il n'est donc plus possible de la mettre à jour. Par conséquent, vous pouvez vérifier la commande en question dans Shippeo pour voir si la commande est toujours en cours. Si c'est le cas, nous vous invitons à contacter notre équipe de support Shippeo.

 {“errors”:[{“detail”: “Order can not be pair with the same mean,” “status”: 400, “source”:{“pointer”: “\/pair\/mean\/id”}}]}

 {“errors”:[{“detail”: “Can not perform an action on a finished order,” “status”: 400, “source”:{“pointer”:“\/“}}]}

 {“errors”:[{“detail”: “The externalId is already used in this organization,” “status”:400, “source”:{“pointer”:“\/canonical_external_id”}}]}

L'ID/référence de la commande doit être unique dans l'environnement Shippeo parmi les commandes actives. Dans ce cas, vous pouvez :

• Clôturez la commande avec la même référence dans Shippeo.
• Ou bien modifier la référence de l'ordre.

{"errors":[{"detail":"The action xxx has already been executed.", "status":409,"code":"ACTION_ ALREADY_EXECUTED",  "source":{"pointer":"\/"},"title":"Action already executed"}]}

Aucune action n'est requise de votre part, car l'action que vous essayez d'effectuer a déjà été exécutée dans Shippeo.

{ "detail": "Delivery is before load", "status": 400, "source": { "pointer": "/shipment/orders[0]" } }

Veuillez vérifier la commande et vous assurer que le créneau de livraison n'est pas planifié avant le chargement.

{ "detail": "Theoretical start date is after theoretical end date", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up" } }

Veuillez vérifier la commande et vous assurer que la fin du créneau de chargement ou de livraison n'est pas antérieure au début du créneau correspondant.

{"detail": "Order not found with filters : "OrderByEDIReference(EDIReference="{{ediReference}}"), UnfinishedOrder({"ordr":"orderEvents"})","status": 404,"code": "","source": {"pointer": "/shipment/orders[0]"}}

La référence EDI de l'ordre n'a pas été trouvée.

Ou il n'existe pas d'ordre actif avec cette référence EDI

Vérifiez votre compte Shippeo pour voir si une commande active existe.

{ "detail": "This value is not a valid datetime.", "status": 400, "source": { "pointer": "/" } }

Veuillez vérifier le format de la date que vous avez envoyé dans votre fichier JSON.

Pour rappel, le format de la date doit être conforme à la norme ISO 8601, par exemple:

• 2019-10-09T08:10:42Z
• 2019-10-09T08:10:42+02:00

{"detail": "Order not found with external reference \"C0026037\"","status": 400,"code": "","source": {"pointer": "/shipment/orders[0]"}}

La référence de l'ordre n'a pas été trouvée.

Ou il n'existe pas d'ordre actif avec cette référence.

Vérifiez votre compte Shippeo pour voir si une commande active existe.

{"detail": "the order external reference is already used"","status": 400,"code": "","source": {"pointer": "/shipment/orders[3]"}}

Une référence d'ordre existe sur la plateforme Shippeo, ce qui bloque la création.

Ou il y a une référence d'ordre en double dans le payload d'Order-in transmis.

{"title": "Mean can neither be found or created", "detail": "Some information might be missing or inaccurate", "status": 400, "source": {"pointer": "/"}

Assurez-vous que la plaque d'immatriculation envoyée dans le JSON est correcte. Contactez ensuite votre contact Shippeo avec votre contact sous-traitant en CC et les informations suivantes :

1. JSON
2. Sous-traitant
3. Plaque d'immatriculation

Note: Il est possible de créer des ressources lors de la création de la commande. Consultez cet article pour en savoir plus.

{"errors":[{"detail":"A deactivated mean cannot be paired","status":400,"source":{"pointer":"\/pair"}}]}

En tant que transporteur ou expéditeur utilisant sa propre flotte

assurez-vous que la ressource est active dans votre compte Shippeo :

1. Connectez-vous à Shippeo.
2. Cliquez sur vos initiales dans le coin droit et choisissez "Admin".
3. Cliquez sur "Ressources"
4. Cochez la case "Toutes les ressources" à côté de la barre de recherche.
5. Cherchez la ressource en question
6. Vérifiez si la ressource est active ou désactivée.

• Si la ressource est désactivée, vous pouvez la modifier et activer à nouveau le curseur situé dans le coin supérieur droit.
• Si la ressource est active, veuillez contacter notre équipe d'assistance en lui fournissant ces informations.

En tant qu'expéditeur qui appaire pour le compte de son transporteur :

Veuillez contacter votre transporteur pour lui demander de prendre les mesures susmentionnées.

{ "detail": "The label is already used in this organization", "status": 400, "source": { "pointer": "\/label" }

Veuillez vérifier la liste des ressources pour voir si ce nom existe déjà dans Shippeo afin d'éviter les doublons. S'il ne s'agit pas d'un doublon mais d'une ressource différente, veuillez mettre à jour le nom.

{ "detail": "An existing place or a new place informations must be provided", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up" } }

Veuillez vérifier la commande et vous assurer que le lieu/l'adresse pour le chargement et la livraison existe dans l'environnement Shippeo et que vous utilisez le bon nom. Pour en savoir plus sur la création de lieux/adresses dans Shippeo, cliquez ici.

{ "detail": "Loading and Delivery cannot reference the same place", "status": 400, "source": { "pointer": "/shipment/orders[0]" } }

Veuillez vérifier la commande et vous assurer que le lieu de chargement et l'adresse de livraison sont différents.

{ "detail": "Place is deactivated and cannot be used.", "status": 400, "source": { "pointer": "/shipment/orders[0]/pick_up" } }

Veuillez vérifier la commande et vous assurer que le lieu/l'adresse de chargement et de livraison est une adresse active dans Shippeo.

{ "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" } } ]}

Veuillez vérifier votre message et vous assurer que le qualificatif d'emballage pour les marchandises mentionnées est l'un des suivants : PX, PD, PE, PC, NA

{ "detail": "no custom packaging qualifier could be found with the given information", "status": 400, "source": { "pointer": "/shipment/orders[0]/handling_units[0]/ custom_packaging_qualifier" } }

Veuillez vérifier votre message et le qualificatif personnalisé utilisé. Si vous avez besoin de qualificatifs d'emballage personnalisés supplémentaires pour votre compte Shippeo, veuillez contacter votre gestionnaire de compte.

{ "message": "Quota exceeded! You reached the limit of X requests per X month", "http_status_code": 429 }

Veuillez vérifier pourquoi vous avez envoyé autant d'appels pour déclencher cette erreur.