# US-MAI009-004: Gestionar conciliación y pagos **ID:** US-MAI009-004 **Módulo:** MAI-009 (Facturación Transporte) **Prioridad:** Media **Story Points:** 5 --- ## Historia de Usuario **Como** encargado de cobranza **Quiero** registrar los pagos recibidos y conciliar facturas **Para** mantener actualizado el estado de la cartera y detectar diferencias --- ## Criterios de Aceptación ### CA-001: Registrar pago total **Dado** que recibí un pago que cubre el total de la factura **Cuando** registro el pago **Entonces** la factura se marca como PAGADA y el saldo queda en 0 ### CA-002: Registrar pago parcial **Dado** que recibí un pago menor al saldo **Cuando** registro el pago parcial **Entonces** la factura se marca como PARCIAL y se actualiza el saldo pendiente ### CA-003: Pagos múltiples por factura **Dado** que una factura tiene saldo pendiente **Cuando** registro nuevos pagos **Entonces** se acumulan hasta liquidar el total ### CA-004: Comparar cotizado vs facturado **Dado** que quiero conciliar **Cuando** consulto una factura **Entonces** veo comparativo de: monto cotizado, monto facturado, diferencia ### CA-005: Generar nota de crédito/débito **Dado** que hay diferencias que ajustar **Cuando** genero una nota **Entonces** se crea el documento fiscal correspondiente ### CA-006: Dashboard de conciliación **Dado** que quiero ver el resumen **Cuando** accedo al dashboard **Entonces** veo: facturas con diferencias, notas pendientes, montos por conciliar --- ## Mockup / UI ``` ┌─────────────────────────────────────────────────────────────────┐ │ REGISTRAR PAGO ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Factura: A-00456 │ │ Cliente: Distribuidora ABC S.A. de C.V. │ │ Total factura: $55,338.96 MXN │ │ Pagos anteriores: $0.00 │ │ Saldo pendiente: $55,338.96 MXN │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ DATOS DEL PAGO │ │ │ │ Fecha de pago: [2026-01-30] │ │ Monto: [$55,338.96] [☑ Pago total] │ │ │ │ Forma de pago: [03 - Transferencia electrónica ▼] │ │ Banco: [BBVA ▼] │ │ Referencia: [REF-2026-01-30-001 ] │ │ │ │ Comprobante: [📎 Seleccionar archivo] │ │ │ │ Notas: │ │ [Transferencia recibida a las 14:30 ]│ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ RESUMEN │ │ Total factura: $55,338.96 │ │ Pago a registrar: -$55,338.96 │ │ Nuevo saldo: $0.00 ✓ │ │ │ │ [Cancelar] [Registrar Pago] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Historial de Pagos ``` ┌─────────────────────────────────────────────────────────────────┐ │ HISTORIAL DE PAGOS - Factura A-00456 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Total factura: $55,338.96 | Pagado: $55,338.96 | Saldo: $0.00 │ │ Estado: ✅ PAGADA │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ | Fecha | Monto | Forma | Referencia | │ │ |------------|------------|--------------|---------------| │ │ | 30-ene-26 | $55,338.96 | Transferencia| REF-2026-001 | │ │ | | | BBVA | [Ver comp.] | │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ [Exportar historial] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Conciliación ``` ┌─────────────────────────────────────────────────────────────────┐ │ CONCILIACIÓN │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Periodo: [Enero 2026 ▼] Cliente: [Todos ▼] │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ RESUMEN │ │ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌────────────┐ │ │ │ $1.2M │ │ $1.18M │ │ $1.1M │ │ $80K │ │ │ │ Cotizado │ │ Facturado │ │ Cobrado │ │ Pendiente │ │ │ └────────────┘ └────────────┘ └────────────┘ └────────────┘ │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ FACTURAS CON DIFERENCIAS │ │ │ │ | Factura | Cliente | Cotizado | Facturado | Dif | │ │ |---------|-------------|------------|------------|--------| │ │ | A-00445 | Comercial X | $45,000.00 | $43,500.00 | -$1,500| │ │ | | | Recargo no aplicado | [Ver] | │ │ |---------|-------------|------------|------------|--------| │ │ | A-00448 | Mayorista Y | $28,000.00 | $29,400.00 | +$1,400| │ │ | | | Detention agregado | [Ver] | │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ NOTAS PENDIENTES DE EMITIR │ │ │ │ | Tipo | Factura | Monto | Motivo | Acción | │ │ |---------|---------|----------|------------------|--------| │ │ | Crédito | A-00445 | $1,500 | Recargo omitido | [Emitir]| │ │ │ │ [Exportar reporte] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Nota de Crédito ``` ┌─────────────────────────────────────────────────────────────────┐ │ EMITIR NOTA DE CRÉDITO ✕ │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Factura relacionada: A-00445 │ │ Cliente: Comercial XYZ S.A. de C.V. │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ TIPO DE NOTA │ │ (●) Nota de crédito (a favor del cliente) │ │ ( ) Nota de débito (a cargo del cliente) │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ CONCEPTOS │ │ │ │ Descripción: [Ajuste por recargo no aplicado en factura orig.]│ │ Monto: [$1,500.00] │ │ IVA: ☑ Incluir IVA ($240.00) │ │ Total nota: $1,740.00 │ │ │ │ Motivo: [Descuento por error en cálculo ▼] │ │ │ │ ───────────────────────────────────────────────────────────── │ │ │ │ [Cancelar] [Generar y Timbrar] │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` --- ## Notas Técnicas - Tabla: `billing.pagos_factura` para registro de pagos - Tabla: `billing.notas_credito_debito` para notas - Vista: `v_conciliacion_facturas` para comparativo - Complemento de pago (CFDI 4.0) si método es PPD - Integración opcional con bancos para conciliación automática --- ## Definición de Done - [ ] Registro de pagos totales y parciales - [ ] Historial de pagos por factura - [ ] Actualización de estado de factura - [ ] Comparativo cotizado vs facturado - [ ] Generación de notas de crédito/débito - [ ] Dashboard de conciliación - [ ] Tests de registro de pagos