ForHosting KIT · Finances et argent

Total paiement à la livraison

Sachez exactement ce que le coursier doit encaisser à la porte : des biens à 120, une livraison à 15 et des frais de paiement à la livraison de 5 font 140 à encaisser, avec un sous-total de 135. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Valeur des marchandises: 120
Expédition: 15
Frais de paiement à la livraison: 5

Vous obtenez

Marchandises plus expédition: 135
Total à encaisser: 140

Le paiement à la livraison (COD) reste un mode de paiement majeur sur de nombreux marchés e-commerce : le client paie à l'arrivée du colis, et le coursier doit connaître le montant exact à encaisser. Ce chiffre n'est pas seulement le prix du produit — il inclut souvent la livraison et des frais ou une majoration COD que le marchand ou le transporteur facture pour gérer espèces ou carte à la porte. Ce calculateur de total paiement à la livraison accepte la valeur des biens, les frais de livraison et les frais COD, puis renvoie le total à encaisser par le coursier et un sous-total biens plus livraison afin que bons d'entrepôt, rappels SMS et manifestes COD restent cohérents. Utilisez toute unité monétaire que vous suivez déjà ; l'outil ne convertit pas les devises — il additionne seulement des montants non négatifs et arrondit à deux décimales pour des totaux monétaires stables.

Ce qu'est un total COD et pourquoi biens, livraison et frais sont séparés

Le total paiement à la livraison — aussi appelé montant à encaisser par le coursier ou somme à collecter — est l'argent que l'agent de livraison doit recevoir du destinataire avant de remettre le colis. Les marchands décomposent souvent ce total en trois lignes comptables. La valeur des biens est le sous-total marchandise : la somme des prix d'articles après remises au niveau produit, mais avant livraison et majorations liées au mode de paiement.

La livraison est le frais de transport ou d'acheminement que le client a accepté de payer, et peut être zéro sous des seuils de livraison gratuite. Les frais COD sont un supplément pour accepter le paiement à la livraison : certains transporteurs facturent un forfait de collecte, d'autres un pourcentage de la facture, et certains marchands l'absorbent tout en affichant zéro par transparence. Garder les trois entrées séparées compte pour la comptabilité et la communication client.

Les équipes finance passent les biens en revenus, la livraison en produit de fret ou contre-dépense, et les frais COD en revenu de traitement des paiements ou récupération de coûts transporteur. Les agents support ont besoin du même découpage lorsqu'un client demande pourquoi le coursier a réclamé plus que le prix produit affiché sur la fiche. Opérationnellement, le total à encaisser figure sur la lettre de transport, le bordereau COD et le SMS qui dit « préparez le montant X ».

Il n'invente pas de frais COD à partir d'une table de pourcentages : vous fournissez les frais déjà calculés selon votre contrat ou grille transporteur, ce qui garde le point d'accès déterministe et sans règles de politique cachées.

Où un calculateur de total paiement à la livraison apporte de la valeur

Les équipes opérations e-commerce utilisent un calculateur de total paiement à la livraison lors de l'impression des manifestes COD afin que chaque colis quitte l'entrepôt avec le même montant à encaisser que le client a vu au checkout. Les bots de support centre d'appels et WhatsApp peuvent recalculer le total à encaisser lorsqu'un acheteur conteste ce que le coursier a demandé, sans ouvrir un tableur.

Les analystes finance et logistique rapprochent les fichiers de remise transporteur de l'historique des commandes en rejouant les trois composantes via la même formule plutôt qu'en reconstruisant des totaux collés. Une validation en échec ne consomme pas de solde. Documentez comment vous dérivez les frais COD dans les runbooks, stockez la devise à côté de chaque commande, et vous obtenez des montants d'encaissement reproductibles pour bons d'emballage, audits SLA et workers en périphérie sans monter un moteur de paiements complet.

Cas d’usage

Checkout et rappels SMS

Affichez le total à encaisser par le coursier après ajout de la livraison et de la majoration COD pour que l'acheteur prépare le bon montant avant la livraison.

Questions fréquentes

Comment le total paiement à la livraison est-il calculé ?

Tous les montants utilisent les mêmes unités monétaires que vous fournissez.

Cet outil calcule-t-il les frais COD à partir d'un pourcentage ?

Non. Fournissez les frais déjà calculés selon votre transporteur ou votre politique. Le calculateur additionne seulement valeur des biens, livraison et ces frais pour que les résultats restent déterministes.

Quelle devise dois-je utiliser ?

Toute devise unique déjà utilisée par votre commande. Le point d'accès ne convertit pas le change ni n'attache de code devise ; formatez les nombres dans votre interface selon vos règles locales.

La livraison ou les frais de paiement à la livraison peuvent-ils être nuls ?

Oui. Saisissez zéro pour la livraison quand la commande ne paie pas le transport, et zéro pour les frais quand le paiement à la livraison ne coûte rien au client ou que vous les prenez en charge. Les montants négatifs sont refusés.

Pourquoi le coursier demande-t-il plus que le prix du produit ?

Parce que la somme à encaisser ajoute en général la livraison et les frais de paiement à la livraison aux biens. Avec des biens à 120, une livraison à 15 et des frais de 5, le coursier encaisse 140, et non 120.

Outils associés

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/ecom/cod-total

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/ecom/cod-total \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"goods_value":120,"shipping":15,"cod_fee":5}'

const res = await fetch("https://api.kit.forhosting.com/ecom/cod-total", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "goods_value": 120,
    "shipping": 15,
    "cod_fee": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ecom/cod-total",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "goods_value": 120,
    "shipping": 15,
    "cod_fee": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/cod-total", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"goods_value":120,"shipping":15,"cod_fee":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"goods_value":120,"shipping":15,"cod_fee":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/cod-total", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "goods_value": 120,
  "shipping": 15,
  "cod_fee": 5
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.cod_total",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Ce qu'est un total COD et pourquoi biens, livraison et frais sont séparés

Ce calculateur implémente la somme standard total_collect égale à goods_value plus shipping plus cod_fee, et renvoie aussi goods_plus_shipping pour que les étiquettes montrent « commande et livraison » à part de la majoration de paiement.

Contrat d'entrée, champs de réponse et validation

Les montants extrêmement grands au-delà d'un billion en magnitude absolue sont rejetés hors plage. Une courte chaîne formula reformule la règle pour l'affichage à côté du résultat. Associez la réponse à votre propre code devise et format local ; ce point d'accès ne convertit jamais les devises ni n'applique de taux d'imposition — TVA, GST et droits doivent être intégrés aux entrées s'ils font partie de l'espèces que le livreur encaisse. Envoyez un corps JSON avec trois nombres finis non négatifs obligatoires : goods_value (sous-total marchandise de la commande), shipping (frais de fret ou de livraison ; utilisez zéro pour la livraison gratuite) et cod_fee (frais ou majoration paiement à la livraison ; utilisez zéro lorsque le COD est gratuit). Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; champs manquants, chaînes vides, valeurs non finies et négatifs échouent avec invalid_input en nommant le champ, et ces échecs ne sont pas facturés. En cas de succès le corps répète les trois entrées arrondies à deux décimales, rapporte goods_plus_shipping comme goods_value plus shipping, et total_collect comme goods_plus_shipping plus cod_fee — le montant que le coursier doit encaisser. Exemple : biens cent vingt, livraison quinze, frais COD cinq produit goods_plus_shipping cent trente-cinq et total_collect cent quarante. Des alias tels que order_value, freight et collection_fee sont acceptés par commodité. Gardez les requêtes compactes, figez les totaux à deux décimales dans les tests et réutilisez le même module dans le navigateur et l'API pour que les aperçus gratuits correspondent octet par octet à l'automatisation prépayée sur chaque bordereau COD.

Où un calculateur de total paiement à la livraison apporte de la valeur

Les places de marché et vendeurs multi-entrepôts ont besoin d'un oracle déterministe qui additionne biens, livraison et frais COD de la même façon sur la vitrine, l'OMS et les API du dernier kilomètre. Comme l'implémentation est parse pur de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.

Cas d'intégration

Bons d'emballage et manifestes COD

Imprimez biens, livraison, frais COD et total_collect sur chaque bordereau pour que livreurs et clients voient le même montant à encaisser.

Rapprochement des remises

Rejouez les composantes de commande via total_collect = goods + shipping + COD fee lors du croisement des règlements transporteur avec les commandes.

Questions techniques

La livraison ou les frais COD peuvent-ils être nuls ?

Oui. Utilisez shipping 0 pour une livraison gratuite et cod_fee 0 lorsque vous ne facturez pas de majoration de collecte. Les négatifs sont rejetés comme invalid_input.

Combien coûte le calculateur de total paiement à la livraison ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce qu'est un total COD et pourquoi biens, livraison et frais sont séparés

Où un calculateur de total paiement à la livraison apporte de la valeur

Cas d’usage

Checkout et rappels SMS

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Ce qu'est un total COD et pourquoi biens, livraison et frais sont séparés

Contrat d'entrée, champs de réponse et validation

Où un calculateur de total paiement à la livraison apporte de la valeur

Cas d'intégration

Bons d'emballage et manifestes COD

Rapprochement des remises

Questions techniques

merci