Recargo combustible envío
Convierta la tarifa base y el porcentaje de combustible vigente en el importe a facturar: una base de 48,5 al 12,5 % suma un recargo de 6,06 y deja un flete total de 54,56. Usted aporta ambas cifras; no se consulta ninguna tabla. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Tarifa base
- 48,5
- Recargo (%)
- 12,5
- Importe del recargo
- 6,06
- Flete total
- 54,56
Los transportistas y las redes de paquetería publican recargos de combustible como porcentaje del cargo base de transporte, de modo que el importe que factura a un cliente nunca es solo la tarifa de lista del mapa de zonas. Los equipos de operaciones, los vendedores de marketplaces y los brókers de flete necesitan un único paso determinista que convierta una tarifa base conocida y el porcentaje de combustible vigente en el importe del recargo y el total de flete todo incluido.
Cómo un recargo de combustible en porcentaje convierte la tarifa base en flete total
Un recargo de combustible se expresa casi siempre como porcentaje del cargo base de transporte o envío para un nivel de servicio, franja de peso y zona de destino concretos.
Si la cotización del transportista o su tarifa muestra una base de cuarenta y ocho coma cinco unidades monetarias y el factor de combustible publicado es del doce coma cinco por ciento, el importe del recargo es base por porcentaje dividido entre cien, y el cargo total de flete es base más ese recargo—o de forma equivalente base por uno más el porcentaje entre cien.
Hacer las cuentas a mano es sencillo para un solo paquete y penoso al conciliar una factura semanal con cientos de líneas, cada una con base distinta y la misma tabla semanal de combustible. Esta capacidad implementa exactamente esa identidad en dos pasos sin consulta a la red del transportista y sin tabla dependiente de la fecha: usted aporta la tarifa base que ya conoce y el porcentaje de recargo que aplica al periodo que está tarifando.
Las salidas monetarias se redondean half-up a dos decimales para que intermedios en coma flotante como seis coma cero seis dos cinco pasen a seis coma cero seis en el recargo y cincuenta y cuatro coma cinco seis en el total, alineados con la contabilidad y las líneas de factura habituales.
Dónde ayuda calcular el recargo por combustible
Las plataformas de comercio electrónico usan una calculadora de recargo de combustible para que el checkout y las herramientas de back-office muestren el flete aterrizado alineado con los boletines semanales del transportista sin codificar una constante nueva cada lunes. Los operadores logísticos de terceros y los brókers de flete necesitan un oráculo determinista para correos de cotización, tarifas y comprobaciones de margen cuando la misma base aparece bajo tablas de combustible distintas por región o servicio.
Mantenga la base y el porcentaje como únicas entradas, fije los campos monetarios redondeados en las pruebas y obtendrá totales de flete reproducibles para marketplaces, plugins WMS y workers en el borde sin montar un motor de tarifación completo propio.
Qué puede hacer con ella
Checkout y visualización del envío aterrizado
Muestre a compradores o clientes B2B el cargo de flete todo incluido aplicando el porcentaje de combustible vigente del transportista a la tarifa base cotizada antes del pago.
Líneas de factura y auditoría del transportista
Reconstruya el recargo y el flete total de cada línea base al conciliar facturas semanales del transportista con la tabla de combustible publicada para ese periodo.
Correos de cotización y tarifas
Genere cotizaciones de bróker o 3PL que listen tarifa base, importe del recargo de combustible y flete total a partir de un único porcentaje compartido entre muchos SKU.
Preguntas frecuentes
¿Consulta tablas de combustible del transportista en vivo?
No. Usted aporta el porcentaje que aplica al periodo que está tarifando.
¿Cómo se calcula el recargo por combustible de un envío?
Multiplique la tarifa base por el porcentaje de combustible y divida entre cien; después sume ese importe a la base para obtener el total. Una base de 100 al 8 % da un recargo de 8, que luego se suma a la base.
¿Cómo se redondean el recargo y el total?
Ambos se redondean a dos decimales, con la mitad hacia arriba, como en las líneas de factura habituales. Por eso una base de 48,5 al 12,5 % muestra un recargo de 6,06 y un flete total de 54,56.
¿La tarifa base o el porcentaje pueden ser cero?
Sí. Cualquiera de los dos en cero da un recargo de cero, y el total coincide con la base. No se aceptan valores negativos, y el porcentaje de combustible no puede superar el mil por ciento.
¿Escribo 12,5 o una fracción decimal para un 12,5 %?
Escriba 12,5. La cifra de combustible se interpreta como porcentaje de la tarifa base, tal como la publican los transportistas en sus tablas, así que no hace falta convertirla antes a decimal.
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/fuel-surcharge \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_rate":48.5,"surcharge_percent":12.5}'const res = await fetch("https://api.kit.forhosting.com/ecom/fuel-surcharge", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_rate": 48.5,
"surcharge_percent": 12.5
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/fuel-surcharge",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_rate": 48.5,
"surcharge_percent": 12.5
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/fuel-surcharge", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_rate":48.5,"surcharge_percent":12.5}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_rate":48.5,"surcharge_percent":12.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/fuel-surcharge", 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
{
"base_rate": 48.5,
"surcharge_percent": 12.5
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.fuel_surcharge",
"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
Esta calculadora de recargo de combustible en envíos acepta la tarifa base de envío y el porcentaje de recargo, multiplica la base por el porcentaje entre cien para el importe del recargo, lo suma a la base para el flete total y redondea los campos monetarios a dos decimales por el método half-up para que facturas y clientes API coincidan. Base cero o porcentaje cero se permiten y dan recargo nulo; las entradas negativas fallan con invalid_input y no se facturan.
Cómo un recargo de combustible en porcentaje convierte la tarifa base en flete total
La respuesta devuelve las entradas enviadas, surcharge_amount y total_freight, y una cadena formula breve que puede mostrar en la interfaz o en el registro de auditoría junto a las cifras.
Contrato de entrada, forma de la respuesta y validación
La tarifa base tiene tope de un billón de unidades monetarias y el porcentaje de recargo de mil por ciento para que una automatización descontrolada no desborde las rutas de visualización. Una base de cien con ocho por ciento da recargo ocho y total ciento ocho. Las peticiones inválidas no se facturan. Envíe un cuerpo JSON con POST y dos números finitos no negativos obligatorios: base_rate, el importe de envío o flete antes del combustible (también aceptado con los alias shipping_rate, rate, base_shipping_rate y freight_base); y surcharge_percent, el porcentaje de combustible, por ejemplo doce coma cinco para el doce coma cinco por ciento (alias fuel_surcharge_percent, percent, fuel_percent y surcharge_pct). Cada campo puede llegar como número JSON o como cadena numérica; cadenas vacías, campos ausentes, valores no finitos y negativos fallan con invalid_input indicando el campo. En éxito el cuerpo incluye base_rate y surcharge_percent como números normalizados, surcharge_amount y total_freight como dinero half-up a dos decimales, y formula que reescribe la identidad. Ejemplo: base_rate cuarenta y ocho coma cinco y surcharge_percent doce coma cinco dan surcharge_amount seis coma cero seis y total_freight cincuenta y cuatro coma cinco seis. Combine este endpoint con su propio paso de tarifa por zona o peso dimensional si aún debe derivar la base; esta calculadora solo aplica el porcentaje de combustible cuando la base ya se conoce.
Dónde una API de recargo de combustible en envíos aporta valor
Sustitutos de hojas de cálculo y automatizaciones low-code llaman a la API para que finanzas pueda repreciar envíos históricos al auditar una línea de factura en disputa que usó el factor de combustible del mes pasado. 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 saliente.
Preguntas técnicas
¿Cómo se calcula el recargo de combustible de un envío?
Envíe base_rate y surcharge_percent no negativos. La API devuelve surcharge_amount = base_rate × surcharge_percent / 100 y total_freight = base_rate + surcharge_amount, con dinero redondeado half-up a dos decimales.
¿Qué unidades debo usar para base_rate?
Cualquier unidad monetaria coherente (USD, EUR, etc.). La calculadora es agnóstica a la unidad: multiplica y redondea; no convierte monedas ni consulta tablas del transportista.
¿Puede surcharge_percent ser cero o superar 100?
Cero está permitido y produce recargo nulo. Valores por encima de 100 se admiten hasta 1000 para tablas temporales extremas; un porcentaje negativo se rechaza con invalid_input.
¿Cuánto cuesta la calculadora de recargo de combustible en envíos?
La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada correcta; la entrada inválida no se factura.