# Ajouter des expéditions

> Ajouter une expédition à un endpoint de webhook Safecube déclenche shipment.added.to.endpoint, shipment.in.error ou aucun event ; chaque issue, et chaque code d'erreur de shipment.in.error, appelle une action précise.

Ajouter une expédition à un endpoint de webhook Safecube, avec [`POST /easy-shipment-asynchronous`](/fr/api/webhooks/reference/easy-shipment/easy-shipment-add-async), a trois issues possibles : l'endpoint reçoit un event `shipment.added.to.endpoint`, un event `shipment.in.error`, ou aucun event. Chaque issue appelle une action différente.

::callout{type="info"}
Pour être prévenu de chaque issue, abonnez l'endpoint aux events `shipment.added.to.endpoint` et `shipment.in.error`.
::

## Cas 1 : shipment.added.to.endpoint reçu

L'expédition a bien été ajoutée. Utilisez le payload de cet event comme données de suivi initiales de l'expédition.

## Cas 2 : shipment.in.error reçu

L'expédition a été ajoutée à l'endpoint, et Safecube continue de la suivre tant qu'elle reste dans la liste des expéditions de l'endpoint. Le payload de l'event contient l'erreur détectée. L'action dépend de cette erreur.

### Erreurs de saisie

- `WRONG_NUMBER`
- `WRONG_SEALINE`
- `WRONG_TYPE`
- `SEALINE_NOT_SUPPORTED`
- `TYPE_NOT_SUPPORTED_FOR_SEALINE`

Le numéro d'expédition, la compagnie maritime ou le type d'expédition envoyé est incorrect ou non pris en charge. Supprimez l'expédition, puis ajoutez-la de nouveau avec le numéro, la compagnie ou le type corrigé.

### Erreurs de détection automatique

- `AUTO_CANT_DETECT_SEALINE`
- `AUTO_CANT_DETECT_TYPE`
- `AUTO_CANT_FIND_INFO`

Les informations envoyées ne suffisaient pas, et Safecube n'a pas pu détecter automatiquement les données manquantes. Supprimez l'expédition, puis ajoutez-la de nouveau avec plus de détails, comme la compagnie maritime ou le type d'expédition.

### Problèmes côté compagnie maritime

- `SEALINE_UNDER_MAINTENANCE`
- `SEALINE_TEMPORARY_DISABLED`
- `SEALINE_NO_RESPONSE`

Safecube a du mal à récupérer les données auprès de la compagnie maritime. Gardez l'expédition dans la liste : Safecube continue d'essayer de récupérer ses données.

### Aucune donnée de suivi disponible

- `SEALINE_HASNT_PROVIDE_INFO`

Safecube a contacté la compagnie maritime, mais aucune donnée de suivi n'est encore disponible. Gardez l'expédition dans la liste : Safecube continue de chercher des mises à jour.

### Annulation de l'expédition

- `SEALINE_CANCELED_SHIPMENT`

La compagnie maritime a annulé l'expédition. Supprimez-la de la liste et contactez la compagnie pour en savoir plus.

## Cas 3 : aucun event reçu

Quand l'endpoint ne reçoit ni `shipment.added.to.endpoint` ni `shipment.in.error`, l'expédition n'a pas été ajoutée à l'endpoint. Deux raisons sont possibles :

- **L'expédition est déjà suivie** : vérifiez si elle figure dans la liste des expéditions suivies renvoyée par [`GET /easy-shipment`](/fr/api/webhooks/reference/easy-shipment/easy-shipment-get).
- **Erreur interne** : ajoutez de nouveau l'expédition 5 minutes plus tard. Si le problème persiste, [contactez l'équipe Safecube](https://app.safecube.ai/contact).
