Calculadora de sellos postales
Esta calculadora de sellos postales encuentra una combinación práctica cuyo valor total alcanza o supera el franqueo requerido.
Ejecutar — gratis
Indique el importe y una denominación para obtener un recuento rápido, o añada otras denominaciones si dispone de sellos variados. El resultado muestra el número de sellos, el importe cubierto, cualquier exceso inevitable y un desglose por denominación. Los cálculos emplean unidades monetarias enteras escaladas, no comparaciones aproximadas de coma flotante, por lo que son deterministas y útiles para expediciones, oficinas de correo y flujos automatizados.
Indique el franqueo y los sellos de los que dispone
Comience con el franqueo total indicado por su transportista, servicio postal o programa de envíos. Después introduzca el valor del sello principal que desea utilizar. Si todos sus sellos tienen el mismo valor, esos dos datos bastan: la calculadora determina la cantidad mínima cuyo total cubre el franqueo requerido. Si dispone de varios valores, inclúyalos como denominaciones adicionales. La herramienta considera reutilizable cada denominación, por lo que presupone una cantidad ilimitada de sellos de cada valor. Los importes pueden tener hasta tres decimales, lo que admite divisas y productos postales con una precisión superior al céntimo. Use siempre la misma moneda para el franqueo y las denominaciones; la calculadora procesa valores numéricos, no tipos de cambio. Las denominaciones duplicadas se unifican. Un franqueo requerido de cero devuelve cero sellos, mientras que todas las denominaciones deben ser positivas, ya que un sello nulo o negativo no permite formar una combinación válida.
Cómo se elige la mejor combinación
El primer objetivo es minimizar el sobrepago. La calculadora busca el menor total alcanzable que sea igual o superior al franqueo requerido. Por tanto, una combinación exacta siempre prevalece sobre otra que pague de más, aunque necesite más sellos. Una vez encontrado el menor total pagable, el segundo objetivo es emplear el mínimo número de sellos para obtenerlo. Este orden refleja la decisión habitual al preparar un envío: primero evitar desperdiciar franqueo y después reducir la cantidad de sellos que hay que manipular y pegar. Internamente, todos los valores se convierten en enteros escalados antes de evaluar las combinaciones. Por ejemplo, los importes con dos decimales se tratan como centésimas enteras. Así se impide que los errores binarios de coma flotante conviertan una coincidencia monetaria exacta en un pequeño déficit aparente. La búsqueda es determinista, está acotada, no usa la red y ofrece el mismo desglose en el navegador y mediante la API.
Interprete el resultado y aplíquelo con seguridad
El resultado distingue cuatro datos útiles. El número de sellos indica cuántas piezas físicas contiene la combinación seleccionada. El franqueo requerido repite el objetivo normalizado para facilitar comparaciones posteriores. El total de franqueo es la suma del valor facial de los sellos recomendados y el sobrepago es la diferencia respecto al objetivo. El desglose solo enumera las denominaciones utilizadas junto con sus cantidades. Antes de enviar, confirme que el importe introducido coincide todavía con la tarifa del transportista y que cada sello es válido para el servicio, destino, clase postal y fecha correspondientes. Esta calculadora realiza operaciones aritméticas; no consulta tarifas postales actuales, comprueba restricciones regionales, reserva franqueo ni imprime etiquetas. También presupone disponibilidad ilimitada de cada denominación. Si sus existencias son limitadas, ejecútela únicamente con valores que pueda aportar en cantidad suficiente y verifique el recuento físico al preparar el envío. Las integraciones automatizadas pueden usar la misma respuesta determinista para instrucciones de expedición por $0.002 por solicitud.
Qué puede hacer con ella
Preparar un sobre
Calcule el mínimo de sellos del mismo valor que cubre una carta y conozca el exceso antes de pegarlos.
Combinar distintas denominaciones
Aproveche varios valores de una colección dando prioridad al menor exceso de franqueo posible.
Automatizar instrucciones de correo
Convierta una tarifa proporcionada por el transportista en un desglose repetible para expediciones u oficinas.
Preguntas frecuentes
¿Cuánto cuesta la calculadora?
Puede ejecutarla gratis en el navegador. Cada solicitud a la API cuesta $0.002.
¿Qué ocurre si una denominación no permite obtener el importe exacto?
La calculadora elige el menor total alcanzable por encima del requisito y después minimiza el número de sellos.
¿Puedo combinar sellos de distintos valores?
Sí. Indique una denominación principal y añada los demás valores disponibles en additional_denominations.
¿Por qué todas las denominaciones deben ser positivas?
Una denominación nula o negativa no aporta franqueo válido y hace imposible optimizar el recuento, por lo que se rechaza.
¿La calculadora consulta las tarifas postales actuales?
No. Introduzca un requisito obtenido del transportista o servicio postal; esta capacidad solo calcula combinaciones.
¿Tiene en cuenta una cantidad limitada de sellos?
No. Se presupone que cada denominación indicada está disponible sin límite de cantidad.
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/date/postage-stamp-count \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"total_postage":2.73,"denomination":0.68}'const res = await fetch("https://api.kit.forhosting.com/date/postage-stamp-count", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"total_postage": 2.73,
"denomination": 0.68
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/postage-stamp-count",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"total_postage": 2.73,
"denomination": 0.68
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/postage-stamp-count", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"total_postage":2.73,"denomination":0.68}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"total_postage":2.73,"denomination":0.68}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/postage-stamp-count", 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
{
"total_postage": 2.73,
"denomination": 0.68
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.postage_stamp_count",
"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.
Límites
max_amount | 100000 |
max_denominations | 20 |
max_decimal_places | 3 |
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. |