# 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*