Aller au contenu
Sections de la documentation

Codes d'erreur

La Container Tracking API signale deux sortes d'échec. Une réponse 200 avec un message d'erreur signifie que l'API a joint la compagnie maritime, mais que celle-ci n'a renvoyé aucune donnée de suivi. Une réponse 400, 405 ou 500 signifie que l'API n'a pas pu interroger la compagnie maritime du tout.

Réponses 200 sans données de suivi

Une réponse 200 avec l'un de ces messages signifie que la compagnie maritime a été détectée et a répondu, mais que sa réponse ne contient aucune donnée de suivi.

Statut HTTPMessageSignification
200SEALINE_HASNT_PROVIDE_INFOLa requête a abouti. La compagnie maritime a répondu que rien n'a été trouvé pour cette expédition.
200SEALINE_CANCELED_SHIPMENTLa requête a abouti. L'expédition est annulée.

SEALINE_HASNT_PROVIDE_INFO est souvent temporaire : relancez la requête plus tard, la plupart de ces expéditions renvoient des résultats une fois que la compagnie maritime publie leurs données.

Réponses 400, 405 et 500

Une réponse 400, 405 ou 500 signifie que l'API n'a pas pu obtenir les informations auprès de la compagnie maritime. Une requête qui se termine par l'une de ces erreurs n'est pas facturée.

Statut HTTPMessageSignification
400BAD_REQUESTDes paramètres obligatoires manquent dans la requête.
400Param: shipmentNumber cannot be null or emptyLe paramètre shipmentNumber est absent ou vide.
400WRONG_NUMBERLe numéro de conteneur, de connaissement ou de booking est invalide.
400WRONG_SEALINELe code SCAC du transporteur est invalide.
400WRONG_TYPELe type d'expédition est invalide.
400Cannot convert value: {value} into request type: BooleanUn paramètre booléen, comme route ou ais, a reçu une valeur autre que true ou false.
400SEALINE_NO_RESPONSEUne erreur est survenue pendant l'exécution de la requête : la compagnie maritime ne répond pas.
400SEALINE_TEMPORARY_DISABLEDLa compagnie maritime est temporairement désactivée. Réessayez plus tard.
400AUTO_CANT_DETECT_SEALINELa compagnie maritime n'a pas pu être détectée automatiquement. Renseignez le paramètre sealine.
400AUTO_CANT_DETECT_TYPELe type d'expédition n'a pas pu être détecté automatiquement. Renseignez le paramètre shipmentType.
400AUTO_CANT_FIND_INFOAucune information n'a pu être détectée automatiquement pour ce numéro. Renseignez les paramètres sealine et shipmentType.
400SEALINE_NOT_SUPPORTEDLe code SCAC n'est pas pris en charge. GET /sealines liste les compagnies maritimes prises en charge et leurs codes SCAC.
400TYPE_NOT_SUPPORTED_FOR_SEALINELa compagnie maritime ne prend pas en charge ce type d'expédition. GET /sealines liste les types acceptés par chaque compagnie.
400WRONG_PARAMETERSLes paramètres de la requête sont invalides.
400SEALINE_UNDER_MAINTENANCELa compagnie maritime est en maintenance. Réessayez plus tard.
405Method POST is not allowedL'endpoint a été appelé avec une méthode HTTP qu'il n'accepte pas.
500An unexpected error has occurredUne erreur inattendue est survenue côté serveur.

Réagir à une erreur

Quand une requête échoue, relancez-la, et renseignez les paramètres facultatifs que vous connaissez — le code SCAC sealine avant tout, puis le shipmentType. L'endpoint GET /sealines renvoie les compagnies maritimes prises en charge, leurs codes SCAC et les types d'expédition que chacune accepte.

Pour tester la façon dont une intégration gère ces erreurs, les expéditions de test gratuites ZZZZ0000001 (AUTO_CANT_DETECT_SEALINE) et ZZZZ0000002 (SEALINE_HASNT_PROVIDE_INFO) les renvoient à chaque requête. La page Sandbox et expéditions de test liste toutes les expéditions de test.