Saltar al contenido principal

TEC-012 — Importación/Exportación

· 2 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

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​

RFEntregable
RF-TEC-012-01Formatos EDI, XML y JSON sobre un modelo canónico único
RF-TEC-012-02Importar productos, proveedores y solicitudes
RF-TEC-012-03Exportar inventario y movimientos
RF-TEC-012-04Validar 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, EDI CCF-EDI 1) es solo la representación.
  • Validación por registro: esquema zod + resolución de referencias por id o nombre/SKU. /validar es un dry-run; /procesar es 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_intercambio con 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 y npm run build limpios.
  • 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.