Total contra reembolso
Sepa exactamente cuánto debe cobrar el mensajero al entregar: una mercancía de 120, un envío de 15 y una tasa contra reembolso de 5 suman 140 a cobrar, con un subtotal de 135 de pedido y envío. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Valor de la mercancía
- 120
- Envío
- 15
- Cargo por contrareembolso
- 5
- Mercancía más envío
- 135
- Total a cobrar
- 140
El pago contra reembolso (COD) sigue siendo un método de pago importante en muchos mercados de comercio electrónico: el cliente paga cuando llega el paquete y el mensajero debe conocer el importe exacto a cobrar. Esa cifra no es solo el precio del producto: suele incluir el envío y una tasa o recargo COD que el comercio o el transportista aplica por gestionar el efectivo o la tarjeta en la puerta. Esta calculadora de total contra reembolso acepta el valor de la mercancía, el envío y la tasa COD, y devuelve el total a cobrar por el mensajero y un subtotal de mercancía más envío para que albaranes de almacén, recordatorios SMS y manifiestos COD se mantengan coherentes. Use cualquier unidad monetaria que ya controle; la herramienta no convierte divisas: solo suma importes no negativos y redondea a dos decimales para totales monetarios estables.
Qué es un total COD y por qué mercancía, envío y tasa van separados
El total contra reembolso —también llamado importe a cobrar por el mensajero o cantidad a recaudar— es el dinero que el agente de entrega debe recibir del destinatario antes de entregar el paquete. Los comercios suelen desglosar ese total en tres líneas contables. El valor de la mercancía es el subtotal de productos: la suma de precios de artículos tras descuentos a nivel de producto, pero antes del envío y de los recargos del método de pago.
El envío es el cargo de transporte o entrega que el cliente aceptó pagar, y puede ser cero bajo umbrales de envío gratuito. La tasa COD es un cargo extra por aceptar el pago en la entrega: algunos transportistas facturan una tarifa fija de cobro, otros un porcentaje de la factura, y algunos comercios la absorben pero siguen mostrando cero por transparencia. Mantener las tres entradas separadas importa para la contabilidad y la comunicación con el cliente.
Los equipos financieros imputan la mercancía a ingresos, el envío a ingreso de flete o contrapartida de gasto, y las tasas COD a ingresos de procesamiento de pagos o recuperación de costes del transportista. Los agentes de soporte necesitan el mismo desglose cuando un cliente pregunta por qué el mensajero pidió más que el precio del producto en la ficha. Operativamente, el total a cobrar es lo que va en la carta de porte, el resguardo COD y el SMS que dice «tenga preparada la cantidad X».
No inventa una tasa COD a partir de una tabla de porcentajes: usted pasa la tasa que ya calculó con su contrato o tarifa de transportista, lo que mantiene el extremo determinista y libre de reglas de política ocultas.
Dónde aporta valor una calculadora de total contra reembolso
Los equipos de operaciones de comercio electrónico usan una calculadora de total contra reembolso al imprimir manifiestos COD para que cada bulto salga del almacén con el mismo importe a cobrar que el cliente vio en el checkout. Los marketplaces y los vendedores multi-almacén necesitan un oráculo determinista que sume mercancía, envío y tasa COD de la misma forma en tienda, OMS y APIs de última milla.
Los bots de soporte de call center y WhatsApp pueden recalcular el total a cobrar cuando un comprador discute lo que pidió el mensajero, sin abrir una hoja de cálculo. Los analistas de finanzas y logística concilian los ficheros de remesas del transportista con el historial de pedidos reejecutando los tres componentes con la misma fórmula en lugar de reconstruir totales pegados. La validación fallida no consume saldo.
Documente cómo obtiene la tasa COD en sus procedimientos, guarde la moneda junto a cada pedido y obtendrá importes de cobro reproducibles para albaranes, auditorías de SLA y workers en el borde sin montar un motor de pagos completo propio.
Qué puede hacer con ella
Checkout y recordatorios SMS
Muestre el total a cobrar por el mensajero tras sumar envío y recargo COD para que el comprador prepare el importe correcto antes de la entrega.
Preguntas frecuentes
¿Cómo se calcula el total contra reembolso?
Todos los importes usan las mismas unidades monetarias que usted suministra.
¿Esta herramienta calcula la tasa COD a partir de un porcentaje?
No. Pase la tasa que ya calculó con su transportista o política. La calculadora solo suma valor de mercancía, envío y esa tasa para que los resultados sigan siendo deterministas.
¿Qué moneda debo usar?
Cualquier moneda única que su pedido ya use. El extremo no convierte divisas ni adjunta un código de moneda; formatee los números en su interfaz con sus propias reglas locales.
¿El envío o la tasa contra reembolso pueden ser cero?
Sí. Ponga cero en el envío cuando el pedido no pague transporte y cero en la tasa cuando el pago contra reembolso no le cueste nada al cliente o lo asuma usted. No se aceptan importes negativos.
¿Por qué el mensajero cobra más que el precio del producto?
Porque el importe a cobrar suele sumar a la mercancía el envío y la tasa contra reembolso. Con una mercancía de 120, un envío de 15 y una tasa de 5, el mensajero cobra 140, no 120.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"goods_value": 120,
"shipping": 15,
"cod_fee": 5
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.cod_total",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Qué es un total COD y por qué mercancía, envío y tasa van separados
Esta calculadora implementa la suma estándar total_collect igual a goods_value más shipping más cod_fee, y también devuelve goods_plus_shipping para que las etiquetas muestren «pedido y entrega» aparte del recargo de pago.
Contrato de entrada, campos de respuesta y validación
Los importes extremadamente grandes por encima de un billón en magnitud absoluta se rechazan por fuera de rango. Una cadena formula breve reexpresa la regla para mostrarla junto al resultado. Combine la respuesta con su propio código de moneda y formato local; este extremo nunca convierte divisas ni aplica tipos impositivos —IVA, GST y aranceles deben incorporarse a las entradas si forman parte del efectivo que el repartidor recauda. Envíe un cuerpo JSON con tres números finitos no negativos obligatorios: goods_value (subtotal de mercancía del pedido), shipping (cargo de flete o entrega; use cero para envío gratis) y cod_fee (tasa o recargo contra reembolso; use cero cuando el COD es gratis). Cada campo puede llegar como número JSON o como cadena numérica; campos ausentes, cadenas vacías, valores no finitos y negativos fallan con invalid_input nombrando el campo, y esos fallos no se facturan. En caso de éxito el cuerpo repite las tres entradas redondeadas a dos decimales, informa goods_plus_shipping como goods_value más shipping, y total_collect como goods_plus_shipping más cod_fee —el importe que el mensajero debe cobrar. Ejemplo: mercancía ciento veinte, envío quince, tasa COD cinco produce goods_plus_shipping ciento treinta y cinco y total_collect ciento cuarenta. Se aceptan alias como order_value, freight y collection_fee por comodidad. Mantenga las peticiones pequeñas, fije los totales a dos decimales en las pruebas y reutilice el mismo módulo en navegador y API para que las vistas previas gratuitas coincidan byte a byte con la automatización de prepago en cada resguardo COD.
Dónde aporta valor una calculadora de total contra reembolso
Como la implementación es parse puro de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red de salida.
Casos de integración
Albaranes y manifiestos COD
Imprima mercancía, envío, tasa COD y total_collect en cada resguardo para que repartidores y clientes vean la misma cifra a cobrar.
Conciliación de remesas
Reejecute los componentes del pedido con total_collect = goods + shipping + COD fee al cruzar liquidaciones del transportista con los pedidos.
Preguntas técnicas
¿Pueden ser cero el envío o la tasa COD?
Sí. Use shipping 0 para entrega gratuita y cod_fee 0 cuando no cobre recargo de cobro. Los negativos se rechazan como invalid_input.
¿Cuánto cuesta la calculadora de total contra reembolso?
La herramienta en el navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada correcta; la entrada inválida no se factura.