Calcule cuánto falta para obtener envío gratis
La calculadora del umbral de envío gratis convierte dos importes del pedido en una respuesta útil: cuánto debe añadir el comprador para cumplir el requisito.
Ejecutar — gratis
Introduzca el total actual del carrito y el umbral de la tienda; el resultado será la diferencia pendiente. Si el carrito ya alcanza o supera el objetivo, devuelve cero sin tratarlo como un error. Puede usar el cálculo en avisos del carrito, mensajes de pago, atención al cliente, experimentos e informes.
Calcule el gasto pendiente a partir de dos importes
Indique el total actual de los artículos en current_total y el valor mínimo exigido en free_shipping_threshold. La calculadora resta el primero del segundo y entrega la diferencia como amount_needed. Por ejemplo, un carrito de 42.50 con un umbral de 60 necesita 17.50 más. Ambos datos deben ser números finitos y no negativos, expresados en la misma moneda y con el mismo criterio contable. Su aplicación debe decidir previamente si los descuentos, impuestos, tarjetas regalo o productos excluidos forman parte del total válido. La capacidad no solicita un código de moneda porque la resta es igual para todas, pero su interfaz debe presentar el resultado con el símbolo y los decimales correctos. No consulta catálogos, no convierte divisas y no altera los valores mediante una política de redondeo oculta.
Gestione los carritos que ya cumplen el requisito
Cuando el carrito alcanza o supera el umbral, amount_needed vale cero. Es un resultado correcto, no un error. Así, su proceso puede mostrar un incentivo únicamente cuando el valor sea positivo y confirmar el envío gratis cuando sea cero. La regla cubre la coincidencia exacta, los pedidos superiores al objetivo y un umbral de cero. Se rechazan campos ausentes, cadenas, valores nulos, negativos, infinitos o no numéricos, ya que no representan importes válidos. Esta distinción es importante: cero describe un carrito válido que no necesita más gasto; un error de entrada indica que el sistema remitente incumplió el contrato. Como la operación es determinista, las mismas cifras siempre producen la misma salida, tanto en la tienda como en validaciones del servidor, pruebas automatizadas, flujos de eventos o herramientas de soporte.
Convierta el resultado en un mensaje útil
Use el número devuelto como cálculo y aplique después las reglas de presentación y venta de su negocio. Una diferencia positiva puede convertirse en «Añada 12.00 más para obtener envío gratis», con el formato monetario y regional correspondiente. Un cero puede activar «Ya tiene envío gratis». Antes de ejecutar la calculadora, obtenga current_total solo de los productos válidos para la promoción. Algunas tiendas excluyen artículos voluminosos, productos digitales, impuestos, propinas o gastos de entrega; otras evalúan el subtotal antes de los cupones. Mantener esas reglas fuera de esta capacidad evita atribuirle conocimientos de un catálogo que no ha recibido. Para análisis, registre el umbral y el total junto con la diferencia. La API cuesta $0.002 por solicitud y la versión del navegador utiliza el mismo cálculo puro, lo que facilita auditarlo, probarlo e integrarlo.
Qué puede hacer con ella
Avisos de progreso en el carrito
Muestre al comprador el gasto válido exacto que falta para acceder al envío gratuito.
Comprobaciones durante el pago
Convierta el total y el umbral en una diferencia coherente, siempre igual o mayor que cero.
Respuestas de atención al cliente
Ofrezca a los agentes un cálculo rápido y repetible cuando alguien pregunte por qué aún paga el envío.
Preguntas frecuentes
¿Qué ocurre si el carrito ya cumple el requisito?
La calculadora devuelve amount_needed con valor cero. Alcanzar o superar el umbral es un resultado correcto, no un error.
¿La calculadora incluye impuestos o descuentos?
Utiliza current_total tal como usted lo envía. Aplique antes las reglas de impuestos, descuentos, productos válidos y exclusiones de su tienda.
¿Puedo utilizar cualquier moneda?
Sí. Ambos valores deben usar la misma moneda y el mismo criterio contable. Su aplicación debe dar al resultado el formato monetario adecuado.
¿Qué datos se rechazan?
Se rechazan importes ausentes, cadenas, valores nulos, negativos, infinitos y valores que no sean numéricos.
¿Cuánto cuesta un cálculo por API?
Cada solicitud de API cuesta $0.002. La versión para navegador ejecuta gratuitamente el mismo cálculo determinista.
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/free-shipping-threshold-gap \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"current_total":42.5,"free_shipping_threshold":60}'const res = await fetch("https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"current_total": 42.5,
"free_shipping_threshold": 60
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"current_total": 42.5,
"free_shipping_threshold": 60
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"current_total":42.5,"free_shipping_threshold":60}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"current_total":42.5,"free_shipping_threshold":60}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/free-shipping-threshold-gap", 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
{
"current_total": 42.5,
"free_shipping_threshold": 60
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.free_shipping_threshold_gap",
"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. |