Échanges

Un échange permet de livrer un nouveau colis au destinataire tout en récupérant l'ancien. C'est un cas particulier de retour, de type exchange.

Comment fonctionne un échange

Lorsqu'un échange est initié sur une expédition (action réservée aux dispatchers, ROLE_DISPATCHER), Swaloo :

1. Crée une nouvelle expédition (Shipment) qui reprend le destinataire, la priorité, le poids, la taille de colis et le point de collecte de l'expédition d'origine. Son numéro de suivi reprend celui de l'original suffixé par -EXC.
2. Lie les deux expéditions entre elles via le champ linkedShipment : chacune pointe vers l'autre.
3. Marque l'expédition d'origine avec le type de retour Échange (ReturnType::EXCHANGE).
4. Crée une tâche de type RETURN sur l'expédition d'origine pour ramener l'ancien colis.

Concrètement, le nouveau colis part vers le destinataire pendant que l'ancien fait le chemin inverse vers l'expéditeur.

La tâche de retour (TaskType::RETURN)

L'échange s'appuie sur une tâche de retour, identique à celle utilisée pour tout autre retour. Son type est RETURN (libellé « Retour à l'expéditeur »). Elle suit la logique d'adresse et de fenêtre de livraison décrite dans Règles automatiques : adresse de retour déterminée par la politique ou le point de collecte d'origine, livraison programmée sous 24 heures.

La preuve de retour (ReturnProof)

Lorsque le colis est effectivement ramené, le livreur capture une preuve de retour (ReturnProof), sur le modèle de la preuve de livraison. Elle contient :

La preuve de retour se dépose via POST /shipments/{id}/return-proof et peut être créée par un livreur (ROLE_DRIVER) ou un dispatcher (ROLE_DISPATCHER). Un marchand peut la consulter pour ses propres expéditions.

Voir aussi : Types de retour | Règles automatiques