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>
243 lines
13 KiB
Markdown
243 lines
13 KiB
Markdown
# 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*
|