rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ec43d9c6cd
erp-transportistas-v2/docs/02-definicion-modulos/MAE-016-carta-porte/RESUMEN-EPICA.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 
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>
2026-01-27 02:24:35 -06:00

6.5 KiB
Raw Blame History

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