# Règle de retrait automatique

> Safecube retire automatiquement une expédition du suivi par webhooks quand elle a été livrée avec une preuve de livraison et que tous ses événements datent d'au moins 7 jours, ou quand un nouveau voyage du même conteneur est détecté.

Une expédition suivie par un endpoint de webhook Safecube reste active jusqu'à ce qu'elle soit retirée manuellement. Les numéros d'expédition, et surtout les numéros de conteneur, peuvent être réutilisés rapidement : Safecube retire donc aussi des expéditions automatiquement, pour vous éviter de recevoir des données qui ne sont plus pertinentes, comme celles d'un voyage plus récent du même conteneur. Chaque retrait automatique déclenche l'event `shipment.auto.removed`, dont le payload contient la raison du retrait.

## Cas 1 : expédition livrée et inactive depuis plus de 7 jours

Safecube retire une expédition automatiquement quand toutes les conditions suivantes sont réunies :

- le `shippingStatus` de l'expédition est `DELIVERED` ;
- une preuve de livraison (POD) est détectée dans les données ;
- chaque événement des conteneurs date d'au moins 7 jours.

::callout{type="warning"}
Une expédition sans preuve de livraison détectée n'est jamais retirée automatiquement par cette règle.
::

Par exemple :

- une expédition laissée en `IN_TRANSIT` par la compagnie maritime n'est **pas** retirée automatiquement ;
- si un nouvel événement daté d'il y a 3 jours est reçu, l'expédition reste suivie au moins 4 jours de plus.

## Cas 2 : nouveau voyage détecté

Safecube retire aussi une expédition quand il détecte qu'un nouveau voyage a commencé, c'est-à-dire quand toutes les conditions suivantes sont réunies :

- la date au nouveau port de chargement (POL) est postérieure à la date au port de déchargement (POD) précédent ;
- le code UN/LOCODE du nouveau POL diffère du précédent, ou les deux valent `null` ;
- le code UN/LOCODE du nouveau POD diffère du précédent, ou les deux valent `null`.

Vous ne recevez ainsi que les données du voyage en cours, et aucune activité d'expédition périmée ou sans rapport.

## Objet de la règle

Les règles de retrait automatique ne sont **pas** conçues pour limiter la durée de suivi de vos expéditions ni pour réduire la facturation. Elles évitent les mises à jour de webhooks issues de voyages futurs, sans rapport, qui utilisent le même numéro d'expédition ou de conteneur.

Pour surveiller vos expéditions suivies, utilisez [`GET /easy-shipment`](/fr/api/webhooks/reference/easy-shipment/easy-shipment-get). Pour retirer des expéditions manuellement, utilisez [`DELETE /easy-shipment`](/fr/api/webhooks/reference/easy-shipment/easy-shipment-delete). La page [Consommation des expéditions](/fr/api/webhooks/guides/shipment-usage) explique quand retirer vous-même des expéditions.
