ANOTACIONES CRÍTICAS DE IMPLEMENTACIÓN

Prioridad: ALTA

Problema: Muchos reportes de consumo (ingresos) llegan sin el campo valor_exento separado
Solución: CIFRA debe deducir automáticamente el monto exento usando la fórmula:
```
monto_exento = total_facturado - (base_gravada * tasa_itbis)
```
O alternativamente:
```
monto_exento = total - base_con_18%
```
Comportamiento esperado: Si el usuario no completa el campo valor_exento, CIFRA lo calcula automáticamente basado en subtotal, itbis_facturado y total
Caso de uso: Reportes de empresas mixtas (venden productos exentos y gravados)

Prioridad: ALTA

Ubicación: Campo forma_pago_id en tabla ingresos
Catalogo formas_de_pago: Actualmente tiene: Efectivo, Tarjeta, Nota de Crédito
A agregar: Transferencia (se usa frecuentemente en reportes)
Nota fiscal: En Anexo A de IT-1, “Transferencia” debe mapearse como “Cheque/Transferencia/Depósito”

Prioridad: MEDIA-ALTA

Problema: En algunos reportes el total no coincide sumando las columnas manualmente (suma 607 + suma Consumo ≠ total reportado)
Causa común: Cliente registra pagos con tarjeta pero no los incluye en la columna de tarjeta del Excel
Solución en CIFRA:
- Validar que: efectivo + tarjeta + transferencia + otros_pagos = total_facturado
- Si hay discrepancia, mostrar advertencia clara al usuario indicando el monto faltante
- Permitir al usuario ajustar manualmente si es necesario

Prioridad: MEDIA

Ubicación: Anexo A de IT-1 (sección de resumen de comprobantes)
Requisito: Mostrar el campo cantidad (número de comprobantes por clasificación)
Comportamiento:
- Se calcula automáticamente (contar comprobantes por grupo)
- Pero el usuario debe poder modificarlo manualmente si identifica errores
Caso de uso: Si el sistema cuenta mal por alguna razón, Berit corrige directamente en la interfaz

Prioridad: MEDIA (Post-MVP)

Problema: Cada cliente envía su Excel de consumo en formato diferente
- Algunos ponen “Forma de Pago” como columna arriba (encabezado)
- Otros lo ponen a un lado
- Varían orden de columnas y nombres
Solución propuesta:
- Crear una plantilla estándar de CIFRA en formato de tabla (Excel)
- Clientes copian sus datos dentro de la plantilla estandarizada
- Sistema importa desde la plantilla, no desde reportes clientes (evita caos)
- Alternativa: Configurar “variables” en importación:
  - Indicar qué columna = “Efectivo”, “Tarjeta”, “Total”, “Exento”, etc.
  - Sistema mapea automáticamente

Prioridad: MEDIA

Caso: Cliente reporta consumo con pagos en tarjeta no registrados
Requisito: Cuando Berit sube reporte de consumo y detecta monto en tarjeta, CIFRA debe:
- Agregar automáticamente en campo tarjeta_debito_credito en ingresos
- Actualizar también campo de crédito fiscal (crédito_fiscal) o similar
- Todo en una sola operación, sin requerencia de múltiples ajustes

Prioridad: MEDIA

Escenario: Cliente reporta total que no concuerda ni con efectivo ni con tarjeta ni con otras formas
Comportamiento esperado:
- CIFRA identifica el descuadre
- Marca como “Requiere Revisión Manual”
- Berit puede investigar en el cliente origen
- Opción de ajuste manual con registro de auditoría

📊 RESUMEN DE CAMBIOS A ESTRUCTURA DE DATOS

Cambio	Tabla	Campo	Tipo	Notas
Agregar Transferencia	`formas_de_pago`	—	INSERT	Código “03” o similar
Asegurar cálculo exento	`ingresos`	`valor_exento`	COMPUTED	Fórmula automática
Agregar campo cantidad	`ingresos` o tabla resumen	`cantidad_comprobantes`	INTEGER	Editable
Validación suma pagos	`ingresos`	—	TRIGGER/APP LOGIC	Verificación transversal