Totale pagamento alla consegna
Sappia esattamente quanto deve incassare il corriere alla consegna: merce da 120, spedizione da 15 e commissione per il pagamento alla consegna da 5 fanno 140 da incassare, con un subtotale di 135. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Valore della merce
- 120
- Spedizione
- 15
- Commissione per contrassegno
- 5
- Merce più spedizione
- 135
- Totale da incassare
- 140
Il pagamento alla consegna (COD) resta un metodo di pagamento importante in molti mercati e-commerce: il cliente paga all'arrivo del pacco e il corriere deve conoscere l'importo esatto da incassare. Quella cifra non è solo il prezzo del prodotto — di solito include spedizione e una commissione o sovrapprezzo COD che il commerciante o il vettore addebita per gestire contanti o carta alla porta. Questo calcolatore del totale pagamento alla consegna accetta valore merce, spedizione e commissione COD, poi restituisce il totale da incassare dal corriere e un subtotale merce più spedizione così che bolle di magazzino, promemoria SMS e manifesti COD restino coerenti. Usi qualsiasi unità monetaria che già traccia; lo strumento non converte i cambi — somma solo importi non negativi e arrotonda a due decimali per totali monetari stabili.
Cos'è un totale COD e perché merce, spedizione e commissione restano separati
Il totale pagamento alla consegna — chiamato anche importo da incassare dal corriere o somma da riscuotere — è il denaro che l'agente di consegna deve ricevere dal destinatario prima di consegnare il pacco. I commercianti spesso suddividono quel totale in tre righe contabili. Il valore merce è il subtotale dei prodotti: la somma dei prezzi degli articoli dopo sconti a livello prodotto ma prima di spedizione e sovrapprezzi del metodo di pagamento.
La spedizione è il costo di trasporto o consegna che il cliente ha accettato di pagare, e può essere zero sotto soglie di spedizione gratuita. La commissione COD è un addebito extra per accettare il pagamento alla consegna: alcuni vettori fatturano una tariffa fissa di riscossione, altri una percentuale della fattura, e alcuni commercianti la assorbono pur elencando zero per trasparenza. Tenere le tre entrate separate conta per contabilità e comunicazione con il cliente.
I team finance imputano la merce a ricavi, la spedizione a provento di nolo o contropartita di costo, e le commissioni COD a ricavi di elaborazione pagamenti o recupero costi del vettore. Gli agenti di supporto necessitano dello stesso dettaglio quando un cliente chiede perché il corriere ha chiesto più del prezzo prodotto mostrato sulla scheda. Operativamente, il totale da incassare è ciò che compare sulla lettera di trasporto, sullo scontrino COD e sull'SMS che dice «tenga pronto l'importo X».
Dove un calcolatore del totale pagamento alla consegna crea valore
I team operativi e-commerce usano un calcolatore del totale pagamento alla consegna quando stampano i manifesti COD affinché ogni busta lasci il magazzino con lo stesso importo da incassare che il cliente ha visto al checkout. I bot di supporto di call center e WhatsApp possono ricalcolare il totale da incassare quando un acquirente contesta ciò che il corriere ha chiesto, senza aprire un foglio di calcolo.
Analisti finance e logistica riconciliano i file di rimessa del vettore con lo storico ordini rieseguendo le tre componenti tramite la stessa formula invece di ricostruire totali incollati. La validazione fallita non consuma saldo. Documenti come deriva la commissione COD nei runbook, memorizzi la valuta accanto a ogni ordine e ottenga importi di riscossione riproducibili per bolle di imballo, audit SLA e worker all'edge senza montare un motore di pagamenti completo proprio.
Casi d'uso
Checkout e promemoria SMS
Mostri il totale da incassare dal corriere dopo aver sommato spedizione e sovrapprezzo COD affinché l'acquirente prepari l'importo corretto prima della consegna.
Domande frequenti
Come si calcola il totale pagamento alla consegna?
Tutti gli importi usano le stesse unità monetarie che Lei fornisce.
Questo strumento calcola la commissione COD da una percentuale?
No. Passi la commissione già calcolata dal vettore o dalla policy. Il calcolatore somma solo valore merce, spedizione e quella commissione affinché i risultati restino deterministici.
La spedizione o la commissione possono essere zero?
Sì. Inserisca zero per la spedizione quando l’ordine non paga il trasporto e zero per la commissione quando il pagamento alla consegna non costa nulla al cliente o lo assorbe lei. Gli importi negativi non sono accettati.
Perché il corriere chiede più del prezzo del prodotto?
Perché l’importo da incassare di solito aggiunge alla merce la spedizione e la commissione per il pagamento alla consegna. Con merce da 120, spedizione da 15 e commissione da 5, il corriere incassa 140, non 120.
Quale valuta devo usare?
Quella che usa già, purché i tre importi siano nella stessa valuta. Il calcolatore non converte tra valute: somma gli importi e arrotonda il risultato a due decimali.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"goods_value": 120,
"shipping": 15,
"cod_fee": 5
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.cod_total",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Cos'è un totale COD e perché merce, spedizione e commissione restano separati
Questo calcolatore implementa la somma standard total_collect uguale a goods_value più shipping più cod_fee, e restituisce anche goods_plus_shipping così le etichette possono mostrare «ordine e consegna» separati dal sovrapprezzo di pagamento. Non inventa una commissione COD da una tabella di percentuali: Lei passa la commissione già calcolata dal contratto o dal listino del vettore, il che mantiene l'endpoint deterministico e privo di regole di policy nascoste.
Contratto di ingresso, campi di risposta e validazione
Importi estremamente grandi oltre un bilione in magnitudine assoluta vengono respinti come fuori intervallo. Una breve stringa formula riafferma la regola per la visualizzazione accanto al risultato. Invii un corpo JSON con tre numeri finiti non negativi obbligatori: goods_value (subtotale merce dell'ordine), shipping (nolo o costo di consegna; usi zero per spedizione gratuita) e cod_fee (commissione o sovrapprezzo pagamento alla consegna; usi zero quando il COD è gratuito). Ogni campo può arrivare come numero JSON o come stringa numerica; campi mancanti, stringhe vuote, valori non finiti e negativi falliscono con invalid_input nominando il campo, e tali fallimenti non vengono fatturati. In caso di successo il corpo riecheggia le tre entrate arrotondate a due decimali, riporta goods_plus_shipping come goods_value più shipping, e total_collect come goods_plus_shipping più cod_fee — l'importo che il corriere deve incassare. Esempio: merce centoventi, spedizione quindici, commissione COD cinque produce goods_plus_shipping centotrentacinque e total_collect centoquaranta. Abbini la risposta al proprio codice valuta e formattazione locale; questo endpoint non converte mai valute né applica aliquote fiscali — IVA, GST e dazi devono essere incorporati nelle entrate se fanno parte del contante che il rider riscuote. Alias come order_value, freight e collection_fee sono accettati per comodità. Mantenga le richieste piccole, fissi i totali a due decimali nei test e riusi lo stesso modulo in browser e API affinché le anteprime gratuite coincidano byte per byte con l'automazione prepagata su ogni scontrino COD.
Dove un calcolatore del totale pagamento alla consegna crea valore
Marketplace e venditori multi-magazzino necessitano di un oracolo deterministico che sommi merce, spedizione e commissione COD allo stesso modo su vetrina, OMS e API dell'ultimo miglio. Poiché l'implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita.
Casi di integrazione
Bolle di imballo e manifesti COD
Stampi merce, spedizione, commissione COD e total_collect su ogni scontrino così rider e clienti vedono la stessa cifra da incassare.
Riconciliazione delle rimesse
Riesegua i componenti dell'ordine con total_collect = goods + shipping + COD fee quando allinea i file di liquidazione del vettore agli ordini.
Domande tecniche
Spedizione o commissione COD possono essere zero?
Sì. Usi shipping 0 per consegna gratuita e cod_fee 0 quando non addebita un sovrapprezzo di riscossione. I negativi vengono respinti come invalid_input.
Quale valuta devo usare?
Qualsiasi valuta unica che l'ordine già usa. L'endpoint non converte i cambi né allega un codice valuta; formatti i numeri nella sua interfaccia con le sue regole di localizzazione.
Quanto costa il calcolatore del totale pagamento alla consegna?
Lo strumento nel browser è gratuito. Le richieste API usano saldo prepagato KIT a $0.002 per chiamata riuscita; l'input non valido non viene fatturato.