Aller au contenu
Sections de la documentation

Ajouter des expéditions

Ajouter une expédition à un endpoint de webhook Safecube, avec POST /easy-shipment-asynchronous, 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.

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.
  • Erreur interne : ajoutez de nouveau l'expédition 5 minutes plus tard. Si le problème persiste, contactez l'équipe Safecube.