Contre-remboursement (COD)
Comprendre le Cash on Delivery dans Swaloo et la séparation entre montant marchandises, frais de livraison et total à collecter.
Contre-remboursement (COD)
Le contre-remboursement (COD, Cash on Delivery) désigne le montant que le chauffeur encaisse auprès du destinataire au moment de la livraison. Swaloo distingue clairement le prix des marchandises des frais de livraison, et calcule le total réellement à collecter.
Trois notions à distinguer
| Notion | Champ | Définition |
|---|---|---|
| Montant marchandises | codAmount | Valeur des biens à encaisser pour le compte de l'expéditeur |
| Frais de livraison | deliveryFee | Coût du transport, calculé via la tarification |
| Total à collecter | getTotalCodToCollect() | Somme effectivement demandée au destinataire |
Comment Swaloo calcule le total à collecter
Le total à collecter auprès du destinataire est déterminé ainsi :
- Cas standard :
total = codAmount + deliveryFee. - Livraison gratuite (
isFreeDelivery = true) ou absence de frais :total = codAmount(les frais ne sont pas répercutés au destinataire). - Colis « historique » (
codIncludesDelivery = true) : lecodAmountinclut déjà les frais de livraison ; le total est donc égal aucodAmounttel quel. Cet indicateur concerne les anciennes données, antérieures à la séparation marchandises / frais.
Si aucun montant COD n'est défini, il n'y a rien à collecter (livraison sans contre-remboursement).
La séparation marchandises / frais permet à l'expéditeur de savoir exactement quelle part lui revient (les marchandises) et quelle part correspond au service de livraison de Swaloo.
Surcharge manuelle du montant
Dans certains cas, le montant à encaisser doit être ajusté. Swaloo prévoit deux champs :
| Champ | Rôle |
|---|---|
codAmountOverride | Montant imposé manuellement, qui prévaut sur le calcul automatique |
codAmountOverrideReason | Justification de la surcharge |
Lorsque le montant calculé pour l'encaissement est déterminé (computeCodAmount()), une surcharge éventuelle (codAmountOverride) est prioritaire ; à défaut, Swaloo retient la valeur déclarée des marchandises.
Renseignez toujours une raison lorsque vous surchargez un montant COD : elle assure la traçabilité et facilite la réconciliation.
Lien avec l'encaissement
À la livraison, le total à collecter est encaissé par le chauffeur, puis enregistré dans son portefeuille. Le détail de ce flux (crédit du portefeuille chauffeur, rémunération, commission plateforme, réconciliation) est décrit dans Portefeuilles & transactions.