# Consommation des expéditions

> Safecube facture chaque expédition suivie par un endpoint de webhook, au mois, jusqu'à son retrait ; retirez les expéditions livrées et celles qui ne peuvent pas être suivies, vérifiez la validité des nouvelles et faites un nettoyage mensuel pour éviter les dépassements.

Le système de suivi par webhooks de Safecube suit une expédition depuis son ajout à un endpoint jusqu'à son retrait, par vous ou automatiquement selon la [règle de retrait automatique](/fr/api/webhooks/guides/auto-removal-policy). Chaque expédition suivie est facturée. Vérifiez régulièrement la liste des expéditions suivies pour éviter une surfacturation ; les pratiques ci-dessous y aident.

## Retirer les anciennes expéditions

Ne suivez une expédition que tant que vous avez besoin de ses mises à jour. Selon votre cas d'usage, arrêtez après :

- son arrivée au port de déchargement ;
- sa sortie du terminal (gate out) ;
- le moment où vous êtes certain qu'aucun autre mouvement n'aura lieu.

Pour retirer des expéditions de la liste suivie, utilisez [`DELETE /easy-shipment`](/fr/api/webhooks/reference/easy-shipment/easy-shipment-delete).

Supprimer l'endpoint lui-même, avec [`DELETE /endpoint/{endpoint_id}`](/fr/api/webhooks/reference/endpoints/endpoint-delete), retire aussi de la liste suivie toutes les expéditions qui lui sont rattachées.

::callout{type="warning"}
Désactiver un endpoint, avec [`PATCH /endpoint/{endpoint_id}`](/fr/api/webhooks/reference/endpoints/endpoint-patch), met les notifications en pause mais n'arrête pas le suivi : Safecube continue de suivre ses expéditions, et vous ne recevez plus leurs mises à jour.
::

## Retirer les expéditions inutiles

Safecube commence à suivre une expédition dès son ajout à un endpoint, et envoie l'event `shipment.added.to.endpoint` quand il reçoit les premières informations de suivi. Pour certaines expéditions, aucune information n'arrive jamais : la compagnie maritime ne peut pas être détectée automatiquement (réessayez en indiquant la compagnie), le numéro est incorrect, ou la compagnie n'est pas prise en charge. Tant que ces expéditions restent dans la liste de l'endpoint, Safecube continue d'essayer de les suivre, et elles sont facturées.

Safecube envoie l'event `shipment.in.error` quand la première tentative de récupérer les informations d'une expédition échoue. La page [Ajouter des expéditions](/fr/api/webhooks/guides/adding-shipments) détaille chaque code d'erreur.

::callout{type="info"}
Abonnez-vous à `shipment.in.error`. Quand vous le recevez, lisez le message d'erreur et décidez :

- de continuer à suivre l'expédition, ce qui est déconseillé, car une telle expédition risque de n'être jamais trouvée ni retirée automatiquement ;
- de supprimer l'expédition ;
- de supprimer l'expédition et de l'ajouter de nouveau avec des données complétées ou corrigées, comme un numéro corrigé ou la compagnie maritime.
::

## Vérifier la validité des nouvelles expéditions

Les numéros de conteneur sont réutilisés périodiquement. Après une réutilisation, les informations de suivi reçues peuvent concerner un nouveau voyage au lieu du voyage attendu, et être trompeuses ou inutiles.

Indiquer la compagnie maritime garantit que les données viennent de la bonne source. Quand vous recevez l'event `shipment.added.to.endpoint`, comparez aussi les données à vos propres enregistrements, par exemple :

- la compagnie maritime est celle attendue ;
- la date du premier événement correspond à vos enregistrements internes ;
- le port de livraison est celui attendu.

## Nettoyer chaque mois

Les expéditions sont facturées au mois. Une vérification à la fin de chaque mois garantit que vous ne payez que pour des données utiles :

1. Récupérez toutes les expéditions de chaque endpoint avec [`GET /easy-shipment`](/fr/api/webhooks/reference/easy-shipment/easy-shipment-get).
2. Envoyez une requête à la Container Tracking API, [`GET /shipment`](/fr/api/container-tracking/reference/get-shipment-detail), pour chaque expédition ; cela n'entraîne aucun coût supplémentaire. Retirez les expéditions qui renvoient une erreur.
3. Vérifiez que les données de chaque expédition sont toujours exactes, par exemple en comparant la date du premier événement ou le lieu du POD, et retirez les expéditions dont les données ne le sont plus.
