Presupuesto de compras

La validación fallida—presupuesto ausente, listas vacías, precios negativos—se rechaza como invalid_input y no se factura.

Cómo se calculan el saldo restante y el exceso de presupuesto

El endpoint también informa el porcentaje de presupuesto usado cuando el presupuesto es mayor que cero, de modo que un carrito de treinta sobre un tope de cien muestra un treinta por ciento usado sin forzar a los clientes a recalcular ratios. El redondeo fijo a doce decimales en campos monetarios mantiene estables los goldens del navegador y de la API entre runtimes sin ruido de coma flotante en sumas simples.

Contrato de entrada, forma de la respuesta y errores

Cada línea puede ser un número suelto tratado como precio, o un objeto con price obligatorio y name opcional. Las listas de más de quinientas líneas se rechazan para acotar el trabajo pure-parse. Envíe por POST un cuerpo JSON con dos campos obligatorios: budget, un número finito mayor o igual que cero, e items, un array no vacío de líneas del carrito. Price también acepta alias habituales como cost o amount; el campo de lista acepta alias cart, prices, lines y list. Budget acepta alias limit, max, total_budget y allowance para reutilizar vocabulario de otras herramientas de dinero. En caso de éxito el cuerpo devuelve el presupuesto, el recuento de artículos, cada línea con nombre estable, precio redondeado y restante acumulado tras esa línea, más total_spent, remaining, over_budget, over_amount, within_budget, percent_used, una cadena de fórmula, un mensaje legible y pasos ordenados para hojas de trabajo. Ejemplo: presupuesto cien con leche a one point four nine, pan a two point two five, huevos a three point eight y manzanas a two point nine nine produce total gastado ten point five three y restante eighty-nine point four seven con over_budget false. Si el mismo presupuesto se empareja con líneas que suman más de cien, over_budget es true y over_amount indica cuánto se pasó del límite—sigue siendo una respuesta correcta, no un error, porque superar el presupuesto es la pregunta que responde el rastreador. Presupuesto ausente, items vacíos, números no finitos o precios negativos fallan con invalid_input nombrando el campo y no se facturan.

Dónde aporta valor un rastreador de presupuesto de compras

Las apps del hogar y las listas de la compra compartidas usan un rastreador de presupuesto para que los compañeros de piso vean el saldo al marcar artículos sin abrir una hoja de cálculo. Los kioscos de demostración retail y los sandboxes de formación POS necesitan un oráculo determinista de fondos restantes que nunca llame a APIs de precios en vivo. Mantenga las peticiones pequeñas, fije los totales redondeados en las pruebas y obtendrá saldos reproducibles para listas móviles, plugins LMS y workers en el borde sin montar una contabilidad propia. Los cursos de finanzas personales asignan ejercicios de carrito frente a presupuesto; una API con restante acumulado ordenado tras cada línea permite calificar qué adición superó el límite primero. Scripts de automatización que construyen menús semanales pueden enviar totales de ingredientes y detener reposición cuando over_budget pasa a true. Como la implementación es pure parse de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente.