plantillas-proyectos/backend/api/v1/modules/a76/invoices/docs/README.MD

Anexo76 — Documentación del Módulo de Facturas

Sistema: SCAII · Aduanasoft Versión: 1.0 · Marzo 2026 Módulos documentados: imports/ · exports/

---

¿Qué es este módulo?

El módulo de facturas gestiona el ciclo completo de las operaciones aduaneras de una empresa maquiladora: la entrada de materiales al país (importaciones) y la salida (exportaciones). Ambos módulos están conectados a través de un ledger de inventario compartido — las importaciones crean saldos, las exportaciones los consumen.

---

Estructura de la documentación

docs/
│
├── README.md                          ← estás aquí
│
├── exports/
│   ├── exports_cu_comprensibles.md    ← casos de uso 
│   └── exports_cu_diagramas.md        ← diagramas de flujo Mermaid
│
└── imports/
    ├── imports_cu_comprensibles.md    ← casos de uso 
    └── imports_cu_diagramas.md        ← diagramas de flujo Mermaid

---

Módulo de Exportaciones

Gestiona la salida de materiales del país. Cada tipo de factura representa un escenario aduanero diferente.

Casos de uso

ID	Caso de uso	Descripción breve	Diagrama
CU-EXP-001	Procesar NODES	Exportación sin descarga de inventario	→
CU-EXP-002	Procesar DONAC	Donación al extranjero con descarga directa	→
CU-EXP-003	Procesar AFIJO	Exportación con descarga e IMD opcional	→
CU-EXP-004	Procesar SCRAP	Exportación de desperdicio con descarga	→
CU-EXP-005	Procesar REEXP	Reexportación desde importaciones definitivas	→
CU-EXP-006	Procesar VEMEX	Venta al extranjero desde régimen especial	→
CU-EXP-007	Revertir NODES	Deshacer sin efectos en inventario	→
CU-EXP-008	Revertir con descarga	Devolver saldos y cancelar registros del ledger	→
CU-EXP-009	Reversión bloqueada por exportación	Bloqueo cuando otra exportación usa los saldos	→
CU-EXP-010	Reversión bloqueada por IMD	Bloqueo cuando existe una IMD generada	→

Resumen rápido por tipo

Tipo	Descarga inventario	Genera IMD	Requiere procedencia
NODES	No	No	—
DONAC	Sí	No	—
AFIJO	Sí	Solo con cambio de régimen	TEM (si CR)
SCRAP	Sí	Solo con cambio de régimen	TEM (si CR)
REEXP	Sí	No	DEF obligatoria
VEMEX	Sí	No	DEF obligatoria

---

Módulo de Importaciones

Gestiona la entrada de materiales al país. Las importaciones temporales (TEM) son la base del inventario que las exportaciones consumen.

Casos de uso

ID	Caso de uso	Descripción breve	Diagrama
CU-IMP-001	Procesar TEM	Entrada temporal, genera saldos de inventario	→
CU-IMP-002	Procesar DEF	Entrada definitiva con IVA, sin saldos	→
CU-IMP-003	Procesar MEX	Compra nacional con IVA, sin saldos	→
CU-IMP-004	Procesar TEM + PROSEC	TEM con permisos de Regla Octava	→
CU-IMP-005	Revertir TEM	Anular saldos, restaurar cupos PROSEC	→
CU-IMP-006	Revertir DEF o MEX	Deshacer sin efectos en inventario	→
CU-IMP-007	Reversión bloqueada	Bloqueo cuando exportaciones usan los saldos	→

Resumen rápido por tipo

Tipo	Genera saldo inventario	Calcula IVA	Regla Octava
TEM	Sí	No	Opcional
DEF	No	Sí	No
MEX	No	Sí	No

---

Cómo se conectan importaciones y exportaciones

Importación TEM procesada
        │
        │  crea movimientos ENTRADA en el ledger
        │  (un registro por partida principal)
        ▼
   Ledger de inventario (a24.balance_movement)
        │
        │  las exportaciones consultan saldos disponibles
        │  usando criterio PEPS — más antiguo primero
        ▼
Exportación procesa (DONAC, AFIJO, SCRAP, REEXP, VEMEX)
        │
        │  inserta movimientos CONSUMO
        │  reduce el saldo disponible
        ▼
   Si se revierte la exportación → inserta RETORNO
   Si se revierte la importación → inserta ANULACIÓN DE ENTRADA
   El ledger nunca se borra — solo se agregan registros

Regla de orden para reversiones: Siempre deben revertirse primero las exportaciones y luego la importación. El sistema lo garantiza mediante bloqueos automáticos.

---

Estados de una factura

PENDIENTE  ──[Procesar]──▶  PROCESADA  ──[Revertir]──▶  REVERTIDA
                                │
                                │  si hay bloqueos activos
                                ▼
                          BLOQUEADA (no es un estado real,
                          el sistema rechaza la operación
                          con un mensaje de error)

---

Glosario

Término	Significado
TEM	Importación Temporal — material que entra para ser procesado y reexportado
DEF	Importación Definitiva — material que entra pagando impuestos completos
MEX	Compra a proveedor mexicano
IMD	Importación Definitiva generada automáticamente por un cambio de régimen
NODES	Exportación sin descarga de saldos (No Descarga)
AFIJO	Exportación de material transformado, con descarga de TEM
DONAC	Donación al extranjero con descarga de inventario
SCRAP	Exportación de desperdicio o chatarra
REEXP	Reexportación de material importado definitivamente
VEMEX	Venta al extranjero desde régimen especial (IMMEX / zona franca)
PEPS	Primero en Entrar, Primero en Salir — criterio de consumo de inventario
PROSEC	Programa de Promoción Sectorial — beneficio arancelario para maquiladoras
Regla Octava	Mecanismo de la Ley Aduanera que permite importar con arancel preferencial bajo un permiso PROSEC
Ledger a24	Registro histórico de todos los movimientos de inventario — solo escritura, nunca se borra
Cambio de régimen	Conversión de material temporal a definitivo, requiere generación de IMD