Comprobador de líneas de factura y total de IVA

Ayudas a pequeñas empresas, autónomos y asistentes financieros a detectar errores en facturas antes de que el dinero se mueva: un total de línea que no equivale a cantidad x precio, un importe de impuesto calculado sobre la base incorrecta, una tasa que no es una de las que usas, una línea de envío gravada con una tasa de otro país, la misma factura introducida dos veces, una nota de crédito sin ID de IVA. Recalculas todo desde las líneas, comparas con lo que dice la factura y devuelves un informe de discrepancias sobre el que alguien pueda actuar. Compruebas la aritmética y la coherencia según las reglas que el usuario te da. No decides qué tasa de impuesto aplica legalmente, si el impuesto es debido o qué campos exige la ley; dilo en cada informe y remite a un contable o a la autoridad fiscal para esas cuestiones. ## Archivos en esta habilidad - `scripts/invoice_check.py` - carga un JSON de facturas (cabecera, líneas, totales declarados, desglose de impuestos opcional) o un CSV plano de líneas de artículos (una fila por línea, agrupado por número de factura y vendedor); recalcula el neto de línea, el impuesto y el bruto con aritmética Decimal, redondeo de impuesto por línea o por factura, half-up o half-even, precios sin impuestos o con impuestos incluidos, descuentos de línea y de factura; reporta hallazgos IV01-IV13 y una tabla de líneas por factura (solo biblioteca estándar de Python 3.8+) - `references/checks-and-codes.md` - cada código de hallazgo, su gravedad y qué hacer al respecto - `references/tax-math-and-rounding.md` - las fórmulas, métodos de redondeo, descuentos, notas de crédito y tolerancia - `templates/discrepancy-report.md` - el informe para enviar al proveedor, cliente o contable - `examples/invoices.json` - cinco facturas de compra de un estudio de diseño: una limpia, una con una línea incorrecta, una tasa no listada, una línea duplicada y un desajuste de tasa por categoría, una factura de nube con cantidades fraccionarias y una fecha de vencimiento anterior a la fecha de la factura, una entrada duplicada y una nota de crédito sin ID de IVA - `examples/vat-rules.json` - reglas de ejemplo: tasas permitidas 20/10/0, una lista de categoría a tasa, redondeo por línea, campos obligatorios (reemplaza las tasas con las tuyas) - `examples/invoice-lines.csv` - dos facturas de venta propias del estudio como exportación de líneas de artículos, una con un error de impuesto, una línea omitida de los totales, un comprador faltante y una moneda que cambia a mitad de factura - `examples/invoice-report.md` - la salida real del verificador sobre invoices.json ## Flujo de trabajo ### 1. Recopila las facturas y las reglas Pide las facturas como exportación (CSV de herramienta contable, JSON de factura electrónica) o pega las líneas; un archivo puede contener un lote completo. Luego pide las reglas: las tasas de impuesto que el negocio usa realmente, cualquier categoría de artículo con su propia tasa (de su contable, no tuya), si los precios son sin impuestos o con impuestos incluidos, cómo redondea la herramienta el impuesto (por línea o por factura), los decimales de la moneda y qué campos de cabecera deben llevar sus facturas. Escríbelas en un JSON de reglas como `examples/vat-rules.json`. ### 2. Ejecuta el verificador ``` python3 scripts/invoice_check.py examples/invoices.json --rules examples/vat-rules.json --today 2026-11-03 python3 scripts/invoice_check.py examples/invoice-lines.csv --rules examples/vat-rules.json python3 scripts/invoice_check.py batch.json --rules rules.json --json python3 scripts/invoice_check.py --self-test ``` Salida 0 = sin hallazgos altos, 1 = hallazgos altos, 2 = entrada incorrecta. Sin shell, recalcula a mano con `references/tax-math-and-rounding.md`: neto de cada línea = round(cantidad x precio unitario x (1 - descuento)), impuesto = round(neto x tasa), luego suma por tasa y compara con los totales declarados. ### 3. Lee el resultado - Altos primero: IV02/IV03 (una línea es incorrecta), IV05 (los totales no cuadran), IV04 (una tasa no en tu lista), IV07 (mismo número de factura dos veces), IV01 (sin número, fecha, cantidad o precio). No pagues ni envíes estos. - Medios: desajustes de tasa por categoría, líneas duplicadas, líneas negativas en una factura normal, fechas de vencimiento anteriores a la fecha de la factura, IDs de IVA o nombres de comprador faltantes, una cabecera que cambia entre filas CSV. - Bajos/informativos: diferencias de método de redondeo (IV06) y decimales extra (IV12) - generalmente explicables, anótalos. - Un total incorrecto a menudo viene de una línea incorrecta: corrige la línea, luego vuelve a ejecutar antes de reportar el total. ### 4. Decide y redáctalo Para cada factura: OK para pagar/enviar, pide una factura corregida o nota de crédito, o verifica internamente (entrada duplicada, regla incorrecta). Completa `templates/discrepancy-report.md` con la línea, los importes declarados y recalculados y la corrección exacta que necesitas. Mantén un tono factual: "línea 1: 250 x 0.38 = 95.00, facturado 98.00". ### 5. Entrega Devuelve los veredictos por factura, los informes de discrepancia, una lista de preguntas para el contable (tasas, campos obligatorios) y cualquier cambio de reglas para la próxima vez (por ejemplo, cambiar a redondeo por factura si eso es lo que hace el sistema del proveedor). ## Ejemplo de resultado En `examples/invoices.json` 2 de 5 facturas no deben pagarse tal como están. Brightline Print 2026/0877 factura 250 tarjetas de visita a 0.38 como 98.00 en lugar de 95.00 (IV02), grava el envío al 18%, que no está en las tasas del estudio (IV04), repite la línea de flyer (IV07) y grava el catering al 20% donde la lista del estudio dice 10% (IV04, medio); sus totales son 3.00 neto / 0.60 impuesto demasiado altos (IV05). Northwind INV-2026-1041 se introdujo dos veces (IV07, alto). El impuesto de CloudNest de 7.38 es redondeo por factura en lugar de 7.39 por línea (IV06 informativo, dentro de tolerancia) pero su fecha de vencimiento es anterior a la fecha de la factura; la nota de crédito de Brightline no tiene ID de IVA del vendedor. La factura limpia de Northwind pasa. ## Reglas - Recalcula desde las líneas; nunca confíes en un total declarado, y reporta la primera línea incorrecta antes que los totales que rompe. - Usa solo las tasas y categorías que el usuario te da. Si te preguntan qué tasa aplica, di que es una cuestión fiscal para su contable o autoridad fiscal. - Usa aritmética decimal exacta y el método de redondeo del usuario; una diferencia de redondeo de 0.01 no es un error a menos que sus reglas digan lo contrario. - Trata los duplicados como "posibles": muestra ambas facturas y deja que el usuario confirme. - Nunca cambies una factura tú mismo; pide al emisor una factura corregida o una nota de crédito. - Mantén los datos de factura privados: no los pegues en herramientas públicas ni los compartas más allá de las personas que lo necesiten.