ForHosting KIT · Utilidades de desarrollo

Calculadora de tarifa de manipulación de pedidos

La calculadora de tarifas de manipulación combina un importe fijo con un porcentaje del subtotal del pedido y muestra tanto el cargo completo como el total de pago.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Resulta útil cuando los costes de embalaje, administración, preparación especial o cumplimiento no se cubren con un único método. Introduzca el subtotal y uno o ambos componentes para obtener un desglose transparente, con importes redondeados a dos decimales antes de incorporarlos a una tienda, presupuesto, factura o flujo de pago.

Indique el subtotal y los dos componentes

Comience con el subtotal anterior a la tarifa de manipulación. Debe ser el importe de productos o servicios al que su política aplica el porcentaje; no incluya la propia tarifa, pues el cálculo se acumularía indebidamente. Introduzca después el cargo fijo destinado, por ejemplo, a embalaje, documentación o preparación de almacén. Por último, escriba el porcentaje como porcentaje y no como fracción decimal: use 4.5 para cuatro coma cinco por ciento, no 0.045. Cualquiera de los componentes puede ser cero, por lo que también se admiten políticas exclusivamente fijas o porcentuales. Los valores deben ser no negativos y el porcentaje no puede superar 100. Mantener separados ambos componentes facilita explicar el resultado al cliente, comprobar la configuración de la plataforma y evitar que el cargo fijo se incluya por error en la base porcentual.

Comprenda el cálculo y el redondeo

La herramienta multiplica primero el subtotal por la tarifa porcentual dividida entre 100. Ese importe se redondea a dos decimales, como suele exigirse para cargos monetarios en el pago. A continuación suma la tarifa fija y vuelve a redondear el cargo de manipulación conjunto. El total final resulta de sumar dicho cargo al subtotal original. La respuesta conserva el subtotal normalizado, la tarifa fija, el porcentaje, el importe porcentual, el cargo total y el total del pedido. Así, una integración puede mostrar un solo cargo sin perder los datos necesarios para pruebas y conciliaciones. El cálculo no incorpora impuestos, envío, descuentos, propinas, comisiones de pago ni conversión de divisas. Aplique esos conceptos por separado y en el orden que establezcan su sistema y la normativa correspondiente.

Use el resultado de forma segura en el pago

Utilice la calculadora como un paso determinista después de definir el subtotal elegible y antes de presentar el resumen final. Una tienda puede ejecutarla cuando cambie el carrito, el equipo de operaciones puede probar una nueva tabla de cargos y el área administrativa puede contrastar pedidos terminados. Como no hay red, estado guardado, aleatoriedad ni dependencia de la fecha, una misma entrada siempre devuelve el mismo resultado. Conserve los valores de entrada junto al desglose si necesita justificar un cargo histórico. Antes de publicar la política, compruebe cómo ordena su plataforma descuentos, envío, impuestos y tarifas, porque esta función opera únicamente sobre el subtotal proporcionado. Muestre además el cargo antes de que el cliente confirme el pago y emplee una descripción clara. La API cuesta $0.002 por solicitud; en el navegador se ejecuta el mismo cálculo puro sin remitir los datos a terceros.

Configurar el pago de una tienda

Obtenga el cargo conjunto exacto para reproducir una política de importe fijo más porcentaje.

Probar una tabla de tarifas

Compare cargos con subtotales representativos antes de publicar una nueva política operativa.

Conciliar pedidos completados

Recalcule el importe previsto a partir de los datos registrados y compárelo con el pedido.

¿Qué subtotal debo introducir?

Use el importe que su política define como base porcentual, antes de añadir este cargo. La inclusión de descuentos, envío o impuestos depende de su sistema.

¿Puedo calcular solo una tarifa fija?

Sí. Establezca percentage_fee en cero u omítalo; el cargo será igual a la tarifa fija.

¿Cómo se tratan las fracciones de céntimo?

El importe porcentual se redondea a dos decimales antes de sumarlo a la parte fija. El cargo y el total también se redondean.

¿Incluye impuestos o envío?

No. Solo calcula la manipulación sobre el subtotal facilitado; los demás ajustes se calculan aparte.

¿Cuánto cuesta la API?

La API cuesta $0.002 por solicitud. La versión del navegador ejecuta localmente el mismo cálculo determinista.

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.

POSThttps://api.kit.forhosting.com/ecom/handling-fee

¿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.

curl -X POST https://api.kit.forhosting.com/ecom/handling-fee \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subtotal":125.5}'
{
  "subtotal": 125.5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ecom.handling_fee",
  "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.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →