Règle de retrait automatique
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
shippingStatusde l'expédition estDELIVERED; - une preuve de livraison (POD) est détectée dans les données ;
- chaque événement des conteneurs date d'au moins 7 jours.
Par exemple :
- une expédition laissée en
IN_TRANSITpar 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. Pour retirer des expéditions manuellement, utilisez DELETE /easy-shipment. La page Consommation des expéditions explique quand retirer vous-même des expéditions.