Calculadora de carbohidratos netos

Esta calculadora de carbohidratos netos acepta gramos de carbohidratos totales, de fibra dietética y de alcoholes de azúcar (polioles), y devuelve un valor determinista net_carbs con la fórmula reescrita para mostrarla. Un total no positivo, fibra o polioles negativos, y combinaciones imposibles en las que la fibra más los alcoholes superan el total fallan con invalid_input en lugar de inventar un resultado negativo.

Qué significan los carbohidratos netos y cómo se aplica la fórmula

La aritmética es deliberadamente simple: net_carbs es igual a total_carbs menos fiber menos sugar_alcohols, con cada cantidad en gramos por ración o por entrada de alimento. Este endpoint implementa esa convención de consumo tal cual, sin estimar índice glucémico, sin convertir unidades y sin adivinar campos ausentes de la etiqueta. Si la fibra más los alcoholes supera el total, la combinación no puede provenir de una etiqueta coherente, así que la tarea falla con invalid_input en lugar de devolver un neto negativo que confunda registros y paneles.

Contrato de entrada, forma de la respuesta y comportamiento de error

Ejemplo: veinticinco gramos de carbohidratos totales, ocho de fibra y cinco de alcoholes de azúcar dan doce gramos de carbohidratos netos. Ejemplo sin polioles: cuarenta de total, diez de fibra y cero de alcoholes dan treinta gramos netos. La validación fallida no se factura. La capacidad no busca productos, no raspa bases de datos ni ajusta medios conteos de marca de ciertos polioles; si su protocolo resta solo la mitad de los alcoholes de azúcar, aplique ese factor antes de llamar o después de recibir la cifra neta bruta. Envíe por POST un cuerpo JSON con tres campos obligatorios: total_carbs, fiber y sugar_alcohols. Cada uno puede llegar como número JSON o como cadena numérica; booleanos, cadenas vacías, NaN e Infinity fallan con invalid_input nombrando el campo. Se aceptan alias por comodidad de transporte: carbs, carbohydrate, total_carbohydrate, carbohydrate_g y carbs_g se asignan a total_carbs; fiber_g, dietary_fiber, fibre y fibre_g a fiber; sugar_alcohols_g, polyols, polyol_g y sugar_alcohol a sugar_alcohols. En caso de éxito el cuerpo devuelve los valores limpios de total_carbs, fiber y sugar_alcohols, el net_carbs calculado, una cadena formula breve y unit en g. Combine el resultado con su propia interfaz de diario, caché de códigos de barras o escalador de recetas; este endpoint solo realiza la aritmética en gramos.

Dónde una calculadora de carbohidratos netos aporta valor real

Las aplicaciones de planificación de comidas y los coaches cetogénicos usan una calculadora de carbohidratos netos para que el usuario pegue las cifras de la etiqueta y se mantenga bajo un presupuesto diario de netos sin errores de hoja de cálculo. Los agregadores de restaurantes y entrega normalizan los macros del proveedor a carbohidratos netos para filtros como menos de diez gramos netos, lo que exige una sola función determinista en lugar de código ad hoc en cada plataforma. Las herramientas de educación sobre glucosa continua y diabetes suelen enseñar a leer etiquetas mostrando total frente a neto lado a lado; una API compartida mantiene idénticos la demo del aula y el backend de producción. Como la implementación es pure parse de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002, sin tokens de modelo ni red saliente. Mantenga las peticiones pequeñas, fije net_carbs esperado en las pruebas y obtendrá resultados reproducibles para clientes móviles, workers serverless e importadores por lotes sin montar su propia base de datos nutricional.