erp-transportistas-v2/docs/02-definicion-modulos/MAI-014-carriers/historias-usuario/US-MAI014-001.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

5.5 KiB

US-MAI014-001: Registrar y validar carrier

ID: US-MAI014-001 Modulo: MAI-014 (Carriers) Prioridad: Alta Story Points: 5


Historia de Usuario

Como carrier manager Quiero registrar carriers con su documentacion Para tener un pool de terceros validados para subcontratar


Criterios de Aceptacion

CA-001: Registrar datos del carrier

Dado que tengo un nuevo carrier potencial Cuando lo registro Entonces capturo datos fiscales, contacto, bancarios y operativos

CA-002: Cargar documentos obligatorios

Dado que el carrier debe tener documentos vigentes Cuando completo el registro Entonces cargo permiso SCT, poliza y constancia fiscal

CA-003: Validar vigencias

Dado que los documentos tienen fecha de vencimiento Cuando el sistema verifica Entonces alerta si estan proximos a vencer o vencidos

CA-004: Aprobar o rechazar carrier

Dado que revise la documentacion Cuando decido Entonces puedo aprobar (activo) o rechazar con motivo

CA-005: Bloquear si documento vence

Dado que un documento expiro Cuando el job verifica Entonces el carrier pasa a estado BLOQUEADO


Mockup / UI

+----------------------------------------------------------+
| REGISTRAR CARRIER                                     X  |
+----------------------------------------------------------+
|                                                          |
|  DATOS FISCALES                                         |
|                                                          |
|  RFC: [TRA990101AB1                ]                    |
|  Razon social: [Transportes del Norte SA de CV       ] |
|  Regimen fiscal: [General de ley personas morales  v]  |
|                                                          |
|  Domicilio fiscal:                                      |
|  [Av. Industrial 500, Parque Ind. Monterrey         ]  |
|  CP: [64000   ]  Ciudad: [Monterrey, NL            ]   |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CONTACTO                                               |
|                                                          |
|  Contacto comercial: [Roberto Garza Martinez        ]  |
|  Telefono: [81 1234 5678    ]  Email: [rgarza@...   ]  |
|                                                          |
|  Contacto operativo: [Mario Lopez                   ]  |
|  Telefono: [81 8765 4321    ]  Email: [mlopez@...   ]  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DATOS BANCARIOS                                        |
|                                                          |
|  Banco: [BBVA                     v]                   |
|  CLABE: [012580001234567890]                           |
|  Beneficiario: [Transportes del Norte SA de CV      ]  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CAPACIDADES OPERATIVAS                                 |
|                                                          |
|  Tipos de equipo:                                       |
|  [x] Caja seca 53'                                     |
|  [x] Caja refrigerada                                  |
|  [ ] Plataforma                                        |
|  [ ] Tanque                                            |
|                                                          |
|  Cobertura: [Nacional               v]                 |
|  Unidades disponibles: [15     ]                       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DOCUMENTOS                                             |
|                                                          |
|  | Documento          | Archivo    | Vigencia   | Est ||
|  |--------------------|------------|------------|-----||
|  | Constancia fiscal  | [Cargar]   | -          | -   ||
|  | Permiso SCT*       | [Cargar]   | [________] | -   ||
|  | Poliza seguro*     | [Cargar]   | [________] | -   ||
|  | Opinion 32-D       | [Cargar]   | [________] | -   ||
|                                                          |
|  * Documento obligatorio                               |
|                                                          |
|  [Cancelar]                        [Guardar Carrier]   |
|                                                          |
+----------------------------------------------------------+

Estados del Carrier

Estado Puede asignarse Descripcion
PENDIENTE No En revision
ACTIVO Si Documentos OK
BLOQUEADO No Documento vencido
SUSPENDIDO No Por desempeno
INACTIVO No Baja voluntaria

Notas Tecnicas

  • Tabla: carriers.carriers
  • Tabla: carriers.documentos_carrier
  • Tabla: carriers.contactos_carrier
  • Job: check-carrier-documents.job.ts (diario)
  • Validar RFC con SAT (opcional)

Definicion de Done

  • Formulario de registro completo
  • Carga de documentos obligatorios
  • Validacion de vigencias
  • Estados del carrier
  • Bloqueo automatico por vencimiento
  • Alertas de documentos por vencer
  • Tests de registro y validacion