ec43d9c6cd
Modules documented: - MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US - MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA - MAI-008 (Incidencias): 3 US (18 SP) - MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA - MAI-012 (Combustible): 3 US (18 SP) - MAI-013 (Mantenimiento): 3 US (18 SP) - MAI-014 (Carriers): 3 US (18 SP) - MAI-015 (Portal): 3 US (18 SP) - MAE-016 (Carta Porte): 10 US - MAE-017 (HOS): 3 US (16 SP) - MAE-018 (Reportes): 3 US (18 SP) Phase 2+3 complete: 13 modules, 50+ User Stories Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
139 lines
6.5 KiB
Markdown
139 lines
6.5 KiB
Markdown
# RESUMEN-EPICA.md - MAE-016 Carta Porte CFDI
|
|
|
|
**Epica:** EPIC-MAE-016 | **Version:** 1.0.0 | **Actualizado:** 2026-01-27
|
|
|
|
---
|
|
|
|
## Datos de la Epica
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **ID** | EPIC-MAE-016 |
|
|
| **Nombre** | Carta Porte CFDI |
|
|
| **Modulo** | MAE-016 |
|
|
| **Fase** | Fase 2 - MAE (Modulos Aplicacion Extendidos) |
|
|
| **Prioridad** | Alta |
|
|
| **Total Story Points** | 50 |
|
|
| **Historias de Usuario** | 10 |
|
|
| **Estado** | Backlog |
|
|
| **Schema BD** | compliance |
|
|
| **DDL** | `database/ddl/08-compliance-schema-ddl.sql` |
|
|
|
|
---
|
|
|
|
## Objetivo de la Epica
|
|
|
|
Implementar la generacion, validacion, timbrado y administracion del CFDI con complemento Carta Porte version 3.1, conforme a la normativa del SAT, para cumplir con la obligacion fiscal de documentar el transporte de bienes y mercancias en territorio nacional. El modulo debe automatizar la construccion del complemento a partir de los datos operativos del viaje, integrarse con PAC para el timbrado digital y ofrecer funcionalidades de descarga, cancelacion y expediente fiscal.
|
|
|
|
---
|
|
|
|
## Valor de Negocio
|
|
|
|
1. **Cumplimiento fiscal obligatorio:** Evita multas y decomiso de mercancias por falta del complemento Carta Porte durante el traslado.
|
|
2. **Automatizacion operativa:** Elimina la captura manual de datos fiscales al construir el complemento desde los datos del viaje (ubicaciones, mercancias, operador, unidad).
|
|
3. **Trazabilidad fiscal:** Cada viaje queda vinculado a su UUID de CFDI, XML, PDF y QR, creando un expediente fiscal auditable.
|
|
4. **Reduccion de errores:** Las validaciones previas al timbrado detectan datos faltantes o incorrectos antes de enviar al PAC, evitando rechazos y cancelaciones innecesarias.
|
|
5. **Disponibilidad en ruta:** El operador porta el documento en formato digital (PDF/QR) incluso sin conectividad, cumpliendo con los requerimientos de inspeccion en carretera.
|
|
|
|
---
|
|
|
|
## Alcance
|
|
|
|
### Incluido
|
|
|
|
- Generacion del complemento Carta Porte 3.1 para CFDI de Ingreso y CFDI de Traslado
|
|
- Nodos XML: Ubicaciones (origen/destino), Mercancias, FiguraTransporte, Autotransporte
|
|
- Validacion de campos obligatorios contra catalogos SAT
|
|
- Integracion con PAC (Finkok, Facturapi, SW Sapien) para timbrado y cancelacion
|
|
- Generacion de PDF con representacion impresa y codigo QR
|
|
- Cancelacion con motivos 01, 02, 03, 04 y UUID de sustitucion
|
|
- Expediente fiscal por viaje (UUID, XML, PDF, QR)
|
|
- Disponibilidad offline del PDF/XML/QR en app movil
|
|
- Reporte fiscal mensual de CFDI emitidos/cancelados
|
|
|
|
### Excluido
|
|
|
|
- Complemento Carta Porte para transporte maritimo, aereo o ferroviario (solo autotransporte federal)
|
|
- Integracion directa con el portal del SAT para consulta de estatus
|
|
- Generacion de CFDI sin complemento Carta Porte (cubierto en MAI-009)
|
|
- Comercio exterior avanzado (solo se soporta fraccion arancelaria y pedimentos como campos informativos)
|
|
|
|
---
|
|
|
|
## Historias de Usuario
|
|
|
|
| ID | Titulo | SP | Prioridad | Dependencias |
|
|
|----|--------|----|-----------|--------------|
|
|
| US-MAE016-001 | Generar carta porte desde viaje | 8 | P0 | MAI-005 (Viaje despachado) |
|
|
| US-MAE016-002 | Validar datos obligatorios SAT | 5 | P0 | US-MAE016-001 |
|
|
| US-MAE016-003 | Timbrar CFDI con PAC | 8 | P0 | US-MAE016-002 |
|
|
| US-MAE016-004 | Descargar PDF de carta porte | 3 | P1 | US-MAE016-003 |
|
|
| US-MAE016-005 | Cancelar CFDI con motivo | 5 | P1 | US-MAE016-003 |
|
|
| US-MAE016-006 | Consultar expediente fiscal | 3 | P1 | US-MAE016-003 |
|
|
| US-MAE016-007 | Agregar mercancias transportadas | 5 | P0 | US-MAE016-001 |
|
|
| US-MAE016-008 | Registrar figuras de transporte | 5 | P1 | US-MAE016-001 |
|
|
| US-MAE016-009 | Configurar datos autotransporte federal | 5 | P1 | US-MAE016-001 |
|
|
| US-MAE016-010 | Generar reporte fiscal mensual | 3 | P2 | US-MAE016-003 |
|
|
|
|
### Distribucion por Prioridad
|
|
|
|
| Prioridad | Historias | Story Points | Porcentaje |
|
|
|-----------|-----------|--------------|------------|
|
|
| P0 (Critico) | 4 | 26 | 52% |
|
|
| P1 (Importante) | 5 | 21 | 42% |
|
|
| P2 (Deseable) | 1 | 3 | 6% |
|
|
|
|
---
|
|
|
|
## Dependencias Externas
|
|
|
|
| Dependencia | Tipo | Modulo/Sistema | Descripcion |
|
|
|-------------|------|----------------|-------------|
|
|
| Viaje despachado | Interna | MAI-005 Despacho | Se requiere un viaje con datos operativos completos |
|
|
| Datos de flota | Interna | MAI-011 Gestion de Flota | Placas, permisos SCT, configuracion vehicular, licencias |
|
|
| Datos de OT | Interna | MAI-003 Ordenes de Transporte | Mercancias, ubicaciones origen/destino |
|
|
| Factura transporte | Interna | MAI-009 Facturacion | El CFDI de Ingreso se vincula con la factura |
|
|
| PAC (Finkok/Facturapi/SW) | Externa | Proveedor timbrado | API de timbrado, cancelacion y consulta de estatus |
|
|
| Catalogos SAT | Externa | SAT | Catalogos oficiales de claves para Carta Porte 3.1 |
|
|
| CSD (Certificado Sello Digital) | Externa | SAT | Certificado .cer y llave .key del contribuyente |
|
|
|
|
---
|
|
|
|
## Riesgos
|
|
|
|
| Riesgo | Probabilidad | Impacto | Mitigacion |
|
|
|--------|--------------|---------|------------|
|
|
| Cambio de version del complemento por el SAT | Media | Alto | Parametrizar version en DDL (campo version_carta_porte), estructura modular del XML |
|
|
| Rechazo de timbrado por datos invalidos | Alta | Medio | Validacion exhaustiva previa al envio, mensajes de error claros |
|
|
| Indisponibilidad del PAC | Baja | Alto | Soportar multiples PAC con failover automatico |
|
|
| Catalogos SAT desactualizados | Media | Medio | Proceso de actualizacion periodica de catalogos, versionamiento |
|
|
| Cancelacion rechazada por el SAT | Media | Medio | Informar al usuario el estatus de cancelacion y opciones disponibles |
|
|
|
|
---
|
|
|
|
## Criterios de Aceptacion de la Epica
|
|
|
|
1. Se puede generar una carta porte desde cualquier viaje despachado con datos completos
|
|
2. Las validaciones detectan todos los campos obligatorios faltantes segun el tipo de CFDI
|
|
3. El timbrado con al menos un PAC (Finkok o Facturapi) funciona correctamente
|
|
4. El PDF generado incluye todos los datos del complemento Carta Porte y codigo QR
|
|
5. La cancelacion envia correctamente los motivos 01-04 al PAC
|
|
6. El expediente fiscal muestra UUID, XML, PDF y estado del CFDI por viaje
|
|
7. El operador puede descargar el PDF/XML desde la app para consulta offline
|
|
8. El reporte fiscal mensual lista todos los CFDI con filtros por tipo, estado y fecha
|
|
|
|
---
|
|
|
|
## Metricas de Exito
|
|
|
|
| Metrica | Objetivo |
|
|
|---------|----------|
|
|
| Tasa de timbrado exitoso al primer intento | > 95% |
|
|
| Tiempo promedio de generacion y timbrado | < 10 segundos |
|
|
| CFDI cancelados por errores del sistema | < 2% |
|
|
| Cobertura de viajes con carta porte | 100% de viajes que lo requieren |
|
|
|
|
---
|
|
|
|
*EPIC-MAE-016 Carta Porte CFDI - ERP Transportistas v1.0.0 - Sistema SIMCO v4.0.0*
|