TEC-012 — Importación/Exportación
· 2 min de lectura
Implementación de la mejora TEC-012 (Importación/Exportación), dentro de 6.3 Integración. El módulo pasa de importar solo Excel/CSV (cargas masivas de solicitudes) a intercambiar datos en EDI, XML y JSON, con validación previa e informe de errores por registro.
📋 Alcance
| RF | Entregable |
|---|---|
| RF-TEC-012-01 | Formatos EDI, XML y JSON sobre un modelo canónico único |
| RF-TEC-012-02 | Importar productos, proveedores y solicitudes |
| RF-TEC-012-03 | Exportar inventario y movimientos |
| RF-TEC-012-04 | Validar la estructura e informar los errores encontrados |
⚙️ Cómo funciona
- Modelo canónico + 3 códecs: el intercambio habla siempre de una lista de registros; el
formato (JSON, XML con
saxes, EDICCF-EDI 1) es solo la representación. - Validación por registro: esquema zod + resolución de referencias por id o nombre/SKU.
/validares un dry-run;/procesares parcial y reutiliza los servicios de dominio (ProductosService,ProveedoresService,SolicitudesService) sin duplicar reglas. - Exportación en streaming de inventario y movimientos en los 3 formatos, sin importes cifrados (TEC-007).
- Historial de importaciones en
intercambios/detalle_intercambiocon descarga de errores.
🗄️ Base de datos
Migración 033-create-intercambio con intercambios (cabecera) y detalle_intercambio
(registro a registro, con datos jsonb y mensaje_error).
🔐 Seguridad
- Importar (validar/procesar) y descargar errores: Administrador y Almacenista.
- Exportar y consultar historial: también Auditor y Auxiliar de inventario.
- Las exportaciones omiten los importes cifrados sujetos a visibilidad por rol.
✅ Verificación
- 19 pruebas nuevas de API (3 códecs + servicio) y 3 de web.
- Suite API completa 702 pruebas / 0 fallos; suite web 54 pruebas / 0 fallos;
tsc, ESLint ynpm run buildlimpios. - Integración real 24/24 OK: valida productos en JSON/XML/EDI, procesa proveedores en los 3 formatos, comprueba el procesamiento parcial, exporta inventario y movimientos sin importes, rechaza archivos mal formados y registra el historial.
