569eaeb5a4
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>
13 KiB
13 KiB
RESUMEN-EPICA.md - MAI-009: Facturación de Transporte
Código: MAI-009 Nombre: Facturación de Transporte Version: 1.0.0 Fecha: 2026-01-27
Valor de Negocio
Problema
Las empresas transportistas pierden dinero por:
- Facturación tardía (servicios olvidados, efectivo atrasado)
- Recargos no capturados (fuel, detention) = ingreso perdido
- Errores en timbrado que retrasan cobranza
- Falta de visibilidad en cartera (quién debe, cuánto, hace cuánto)
- Expedientes incompletos que dificultan cobranza
Solución
Un módulo de facturación que:
- Genera facturas automáticamente desde viajes cerrados
- Calcula y aplica recargos según reglas configuradas
- Timbra CFDI con Carta Porte en un clic
- Genera expediente completo (factura + POD + evidencias)
- Proporciona visibilidad de cartera y aging
Beneficios Esperados
| Beneficio | Métrica | Impacto |
|---|---|---|
| Facturación rápida | -80% tiempo de facturación | Flujo de efectivo |
| Recargos capturados | +15% ingresos por recargos | Rentabilidad |
| Menos errores | -90% rechazos de CFDI | Productividad |
| Cobranza efectiva | -10 días DSO | Capital de trabajo |
Actores y Stakeholders
Usuarios Primarios
| Actor | Responsabilidad | Frecuencia |
|---|---|---|
| Facturador | Genera y emite facturas | Diaria |
| Contador | Revisa, concilia, registra pagos | Diaria |
| Cobranza | Seguimiento de cartera | Diaria |
Usuarios Secundarios
| Actor | Interés |
|---|---|
| Gerente Finanzas | Reportes de facturación y cobranza |
| Cliente | Recibe facturas, consulta estado de cuenta |
| Auditor | Revisión de expedientes fiscales |
Flujo Principal
┌─────────────────────────────────────────────────────────────────┐
│ VIAJES CERRADOS (con POD) │
│ (Listos para facturar desde MAI-007) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 1. SELECCIONAR VIAJES (Facturador) │
│ │
│ Cliente: [Distribuidora ABC ▼] │
│ Periodo: [01-ene-2026] al [15-ene-2026] │
│ │
│ ☑ VJE-0120 | CDMX→GDL | $12,500 | POD: 2026-01-05 ✓ │
│ ☑ VJE-0125 | CDMX→MTY | $18,200 | POD: 2026-01-08 ✓ │
│ ☑ VJE-0128 | CDMX→GDL | $12,500 | POD: 2026-01-12 ✓ │
│ ☐ VJE-0130 | GDL→TIJ | $25,000 | POD: Pendiente ⚠ │
│ │
│ Total seleccionado: 3 viajes | $43,200 │
│ │
│ [Generar Factura] │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. BORRADOR DE FACTURA │
│ │
│ Factura: BORRADOR (sin serie/folio) │
│ Cliente: Distribuidora ABC S.A. de C.V. │
│ RFC: DAB850101XXX │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ CONCEPTOS │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ #1 | Servicio de transporte CDMX→GDL │ │
│ │ Viaje: VJE-0120 | Caja seca 53' │ │
│ │ Cantidad: 1 | P.U.: $12,500.00 | Importe: $12,500 │ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ #2 | Servicio de transporte CDMX→MTY │ │
│ │ Viaje: VJE-0125 | Caja seca 53' │ │
│ │ Cantidad: 1 | P.U.: $18,200.00 | Importe: $18,200 │ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ #3 | Servicio de transporte CDMX→GDL │ │
│ │ Viaje: VJE-0128 | Caja seca 53' │ │
│ │ Cantidad: 1 | P.U.: $12,500.00 | Importe: $12,500 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ [+ Agregar concepto] Subtotal: $43,200.00 │
│ │
│ [Calcular Recargos] │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. RECARGOS APLICADOS │
│ │
│ RECARGOS AUTOMÁTICOS: │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ #4 | Fuel Surcharge (8%) │ │
│ │ Sobre viajes 1-3 │ │
│ │ Cantidad: 1 | P.U.: $3,456.00 | Importe: $3,456 │ │
│ ├─────────────────────────────────────────────────────────┤ │
│ │ #5 | Detention en descarga (VJE-0125) │ │
│ │ 3 hrs extra @ $350/hr │ │
│ │ Cantidad: 3 | P.U.: $350.00 | Importe: $1,050 │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ RESUMEN │
│ Subtotal servicios: $43,200.00 │
│ Subtotal recargos: $4,506.00 │
│ Subtotal: $47,706.00 │
│ IVA (16%): $7,632.96 │
│ ───────────────────────────────────────── │
│ TOTAL: $55,338.96 MXN │
│ │
│ [Editar] [Vista previa PDF] [Timbrar CFDI] │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 4. CFDI TIMBRADO │
│ │
│ ✓ FACTURA TIMBRADA EXITOSAMENTE │
│ │
│ Serie: A | Folio: 00456 │
│ UUID: 6ba7b810-9dad-11d1-80b4-00c04fd430c8 │
│ Fecha timbrado: 2026-01-27 14:32:15 │
│ │
│ ───────────────────────────────────────────────────────────── │
│ │
│ EXPEDIENTE DIGITAL │
│ 📄 A-00456.pdf (Factura) [Descargar] │
│ 📄 A-00456.xml (CFDI) [Descargar] │
│ 📄 POD-VJE-0120.pdf [Descargar] │
│ 📄 POD-VJE-0125.pdf [Descargar] │
│ 📄 POD-VJE-0128.pdf [Descargar] │
│ │
│ [Descargar todo ZIP] [Enviar al cliente] │
│ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ FACTURA EMITIDA │
│ → Pendiente de pago │
│ → Visible en portal cliente │
└─────────────────────────────────────────────────────────────────┘
Criterios de Éxito
Funcionales
- Facturación por viaje/embarque/OT configurable
- Cálculo automático de recargos
- Timbrado CFDI con Carta Porte
- Expediente digital completo
- Registro de pagos y aging
- Estados de cuenta por cliente
Técnicos
- Integración con 2 PACs
- Failover automático
- Almacenamiento de XML 5 años
- Performance <5 segundos generación
Negocio
- <3 días entre POD y factura
- >95% recargos capturados
- <2% facturas rechazadas
- DSO <45 días
Riesgos y Mitigaciones
| Riesgo | Probabilidad | Impacto | Mitigación |
|---|---|---|---|
| PAC no disponible | Media | Alto | Segundo PAC de respaldo |
| Error en Carta Porte | Media | Alto | Validación previa al timbrado |
| Datos fiscales incorrectos | Media | Medio | Validación de RFC |
| Recargos no aplicados | Alta | Alto | Cálculo automático obligatorio |
Dependencias
Prerequisitos
- MAI-007 (POD): Viajes cerrados con POD
- MAI-002 (Tarifas): Tarifas y recargos configurados
- MAE-016 (Carta Porte): Complemento fiscal
- erp-core/partners: Datos fiscales
Habilita
- erp-core/financial: Contabilidad
- MAI-015 (Portal): Consulta de facturas
Story Points Estimados
| Historia | Complejidad | SP |
|---|---|---|
| US-MAI009-001 | Alta | 8 |
| US-MAI009-002 | Media | 5 |
| US-MAI009-003 | Alta | 8 |
| US-MAI009-004 | Media | 5 |
| US-MAI009-005 | Media | 5 |
| Total | 31 |
Épica MAI-009 - ERP Transportistas - Sistema SIMCO v4.0.0