ForHosting KIT · Utilidades de desarrollo

Calculadora de sellos postales

Esta calculadora de sellos postales encuentra una combinación práctica cuyo valor total alcanza o supera el franqueo requerido.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

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.

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.

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

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/date/postage-stamp-count

¿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/date/postage-stamp-count \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_postage":2.73,"denomination":0.68}'
{
  "total_postage": 2.73,
  "denomination": 0.68
}
{
  "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.

Por solicitud$0.002

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

max_amount100000
max_denominations20
max_decimal_places3
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 →