Adrian Flores Cortes 569eaeb5a4 docs: Add MAI-009 (Facturación) and MAI-010 (Liquidaciones) specifications

MAI-009 Facturación Transporte (31 SP):
- README, REQUERIMIENTOS (7 RF), RESUMEN-EPICA
- 5 User Stories: generación factura, recargos, CFDI/Carta Porte,
  conciliación/pagos, estados de cuenta

MAI-010 Liquidaciones (31 SP):
- README, REQUERIMIENTOS (6 RF), RESUMEN-EPICA
- 5 User Stories: esquemas pago, cálculo por viaje, viáticos,
  deducciones, generar/autorizar liquidación

Part of Phase 2 - P0 Critical Modules specification

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 02:05:03 -06:00

14 KiB

Raw Blame History

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

14 KiB Raw Blame History