# Codes d'erreur

> La Container Tracking API répond 200 avec un message quand la compagnie maritime ne renvoie aucune donnée de suivi, et 400, 405 ou 500 quand elle ne peut pas interroger la compagnie maritime — les requêtes qui se terminent en 400 ou 500 ne sont pas facturées.

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 HTTP | Message                      | Signification                                                                                     |
| ----------- | ---------------------------- | ------------------------------------------------------------------------------------------------- |
| `200`       | `SEALINE_HASNT_PROVIDE_INFO` | La requête a abouti. La compagnie maritime a répondu que rien n'a été trouvé pour cette expédition. |
| `200`       | `SEALINE_CANCELED_SHIPMENT`  | La 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 HTTP | Message                                                    | Signification                                                                                                                       |
| ----------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `400`       | `BAD_REQUEST`                                              | Des paramètres obligatoires manquent dans la requête.                                                                               |
| `400`       | `Param: shipmentNumber cannot be null or empty`            | Le paramètre `shipmentNumber` est absent ou vide.                                                                                   |
| `400`       | `WRONG_NUMBER`                                             | Le numéro de conteneur, de connaissement ou de booking est invalide.                                                                |
| `400`       | `WRONG_SEALINE`                                            | Le code SCAC du transporteur est invalide.                                                                                          |
| `400`       | `WRONG_TYPE`                                               | Le type d'expédition est invalide.                                                                                                  |
| `400`       | `Cannot convert value: {value} into request type: Boolean` | Un paramètre booléen, comme `route` ou `ais`, a reçu une valeur autre que `true` ou `false`.                                        |
| `400`       | `SEALINE_NO_RESPONSE`                                      | Une erreur est survenue pendant l'exécution de la requête : la compagnie maritime ne répond pas.                                    |
| `400`       | `SEALINE_TEMPORARY_DISABLED`                               | La compagnie maritime est temporairement désactivée. Réessayez plus tard.                                                           |
| `400`       | `AUTO_CANT_DETECT_SEALINE`                                 | La compagnie maritime n'a pas pu être détectée automatiquement. Renseignez le paramètre `sealine`.                                  |
| `400`       | `AUTO_CANT_DETECT_TYPE`                                    | Le type d'expédition n'a pas pu être détecté automatiquement. Renseignez le paramètre `shipmentType`.                               |
| `400`       | `AUTO_CANT_FIND_INFO`                                      | Aucune information n'a pu être détectée automatiquement pour ce numéro. Renseignez les paramètres `sealine` et `shipmentType`.      |
| `400`       | `SEALINE_NOT_SUPPORTED`                                    | Le code SCAC n'est pas pris en charge. `GET /sealines` liste les compagnies maritimes prises en charge et leurs codes SCAC.          |
| `400`       | `TYPE_NOT_SUPPORTED_FOR_SEALINE`                           | La compagnie maritime ne prend pas en charge ce type d'expédition. `GET /sealines` liste les types acceptés par chaque compagnie.   |
| `400`       | `WRONG_PARAMETERS`                                         | Les paramètres de la requête sont invalides.                                                                                        |
| `400`       | `SEALINE_UNDER_MAINTENANCE`                                | La compagnie maritime est en maintenance. Réessayez plus tard.                                                                      |
| `405`       | `Method POST is not allowed`                               | L'endpoint a été appelé avec une méthode HTTP qu'il n'accepte pas.                                                                  |
| `500`       | `An unexpected error has occurred`                         | Une 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`](/fr/api/container-tracking/reference/get-sea-line-details) 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](/fr/api/container-tracking/guides/sandbox) liste toutes les expéditions de test.
