Consommation des expéditions
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. 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.
Supprimer l'endpoint lui-même, avec DELETE /endpoint/{endpoint_id}, retire aussi de la liste suivie toutes les expéditions qui lui sont rattachées.
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 détaille chaque code d'erreur.
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 :
- Récupérez toutes les expéditions de chaque endpoint avec
GET /easy-shipment. - Envoyez une requête à la Container Tracking API,
GET /shipment, pour chaque expédition ; cela n'entraîne aucun coût supplémentaire. Retirez les expéditions qui renvoient une erreur. - 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.