ForHosting KIT · Utilidades de desarrollo

Dividir efectivo en billetes y monedas

Esta calculadora de denominaciones encuentra una forma exacta de componer un total con los billetes y monedas que usted indique.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Minimiza el número de piezas físicas sin presuponer una moneda nacional ni recurrir al habitual método voraz para dar cambio. Introduzca el importe y las denominaciones, incluidos los valores decimales de las monedas. El resultado muestra cada denominación con la cantidad necesaria, informa del número total de piezas y rechaza claramente los importes que no pueden formarse con exactitud.

Introduzca el importe y las denominaciones que puede utilizar

Empiece por el importe total que necesita preparar y, después, indique los valores disponibles de billetes y monedas. La calculadora es independiente de la divisa: valores como 20, 10, 5, 1, 0.25 y 0.10 sirven para una moneda decimal, mientras que otro conjunto puede representar vales, fichas o una caja a la que le falten ciertas denominaciones. Los importes y valores admiten hasta dos decimales; así, el cálculo se realiza de forma exacta en la unidad monetaria menor y no acumula desviaciones de coma flotante. Cada denominación debe ser positiva y única. El resultado ordena los valores de mayor a menor e incluye una cantidad para cada uno, también cero cuando no hace falta usarlo. De este modo puede copiarlo fácilmente en una hoja de caja, una lista de preparación, un plan de retirada o un registro de conciliación. Se presupone una provisión ilimitada de cada denominación: la lista indica qué valores existen, no cuántas piezas tiene usted en ese momento.

Por qué el resultado usa realmente el mínimo de piezas

En muchos sistemas monetarios cotidianos parece suficiente aplicar una regla sencilla: tomar repetidamente la mayor denominación que no supere el importe pendiente. Ese método voraz es rápido, pero no funciona con todos los conjuntos. Las fichas poco habituales, los cupones de eventos, las monedas extranjeras o una caja sin valores comunes pueden hacer que una combinación que empiece por valores menores use menos piezas. Esta calculadora emplea programación dinámica. Evalúa los subtotales alcanzables y registra el menor número de piezas capaz de producir cada uno; después reconstruye una combinación exacta para el total solicitado. Como todos los valores se convierten primero en unidades monetarias menores enteras, las comparaciones son exactas para entradas de dos decimales. Si varias combinaciones comparten el mínimo, el orden determinista favorece primero las denominaciones mayores, por lo que una misma entrada siempre devuelve el mismo desglose. El cálculo está acotado para preservar la rapidez del navegador y la API; si combina valores extremadamente pequeños con un total muy grande, puede superar el límite de trabajo normalizado publicado y se rechazará en lugar de ejecutarse sin un límite razonable.

Interprete los fallos de coincidencia exacta y use bien el resultado

No siempre existe una solución exacta. Si todas las denominaciones disponibles son múltiplos de cinco céntimos, por ejemplo, ningún número de piezas permite formar un importe acabado en tres céntimos. La calculadora comunica esta situación como un error de entrada, en vez de devolver una cantidad cercana, redondear el total silenciosamente o inventar una denominación. Esta diferencia es esencial en conciliaciones de caja, paquetes de cambio preparados y pagos controlados, donde quedarse ligeramente por debajo o por encima sigue siendo incorrecto. Una respuesta correcta contiene el importe normalizado, el número total mínimo de piezas y el desglose por denominación. Se conservan las cantidades cero para que la salida refleje todo el conjunto suministrado y pueda alinearse con un formulario de inventario. Antes de aplicar el plan, recuerde que el algoritmo considera ilimitada la provisión de cada valor. Si su caja contiene cantidades limitadas, compare las cantidades propuestas con las existencias; esta capacidad no resuelve el problema distinto del inventario acotado. El mismo cálculo determinista funciona en el navegador y mediante la API por $0.002 por solicitud.

Preparar sobres de pagos en efectivo

Convierta cada pago exacto en una lista con el mínimo de piezas usando solo las denominaciones autorizadas.

Planificar la reposición de una caja

Obtenga una mezcla compacta para un importe objetivo cuando solo se empleen ciertos valores de billetes y monedas.

Distribuir vales o fichas de eventos

Use un conjunto de valores no convencional y detecte los importes que esas fichas no pueden representar exactamente.

¿Encuentra siempre el menor número de billetes y monedas?

Sí. Examina subtotales alcanzables mediante programación dinámica y devuelve una combinación exacta con el mínimo total de piezas.

¿Puedo usar denominaciones decimales para las monedas?

Sí. Tanto el importe como las denominaciones admiten hasta dos decimales, por ejemplo 0.25 o 0.05.

¿Qué ocurre si el importe no puede formarse exactamente?

La solicitud devuelve un error de entrada que explica que las denominaciones indicadas no forman el importe exacto. Nunca redondea a un total cercano.

¿La calculadora considera las cantidades limitadas de mi caja?

No. Se considera que existe una provisión ilimitada de cada denominación incluida. Las existencias no forman parte de esta capacidad.

¿Por qué puede diferir el resultado de elegir primero el valor mayor?

El método voraz de mayor a menor puede ser subóptimo con valores personalizados. Esta calculadora prueba combinaciones y garantiza el mínimo de piezas.

¿Cuánto cuesta una solicitud de API?

Cada solicitud de API cuesta $0.002. La misma calculadora determinista puede usarse gratis en el navegador.

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/travel2/currency-cash-denomination-split

¿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/travel2/currency-cash-denomination-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":18.85,"denominations":[10,5,2,1,0.25,0.1,0.05]}'
{
  "amount": 18.85,
  "denominations": [
    10,
    5,
    2,
    1,
    0.25,
    0.1,
    0.05
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel2.currency_cash_denomination_split",
  "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_denominations100
max_normalized_amount250000
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 →