Files
plantillas-proyectos/backend/api/v1/modules/a76/invoices/docs
2026-04-09 08:27:59 -06:00
..
2026-04-09 08:27:59 -06:00

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 No
AFIJO Solo con cambio de régimen TEM (si CR)
SCRAP Solo con cambio de régimen TEM (si CR)
REEXP No DEF obligatoria
VEMEX 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 No Opcional
DEF No No
MEX No 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