Saltar al contenido principal

Cargas masivas e Intercambio — pruebas unitarias de validación y formatos

Solicitudes masivas (/cargas-masivas, SOL-006) carga lotes de solicitudes desde Excel/CSV y Importación / Exportación (/intercambio, TEC-012) intercambia datos en JSON, XML y EDI. Ahora suman 47 casos de prueba entre ambas.

1. Qué se cubre​

Solicitudes masivas — src/__tests__/cargas-masivas-gestion.test.tsx (23 casos)​

BloqueQué fija
HistorialArchivo, estado, total/creadas/errores, proceso de contratación, fecha y «Ver filas»; vacío cuando no hay cargas y tolerancia a fallos del listado
ArchivoAcciones bloqueadas sin archivo, nombre y tamaño en KB al elegirlo, refresco del historial
Validación previaDry-run con validarArchivoCarga, resumen válidas/total, aviso de filas con error y tabla de errores por fila; error del servidor y bloqueo mientras valida
ProcesamientoCarga completada y parcial con su mensaje, proceso de contratación recortado (o indefinido), apertura del detalle, error del servidor
Detalle y erroresResumen por fila (solicitud creada o mensaje de error), descarga de errores solo cuando hay filas fallidas, error al cargar el detalle
Plantilla y tourDescarga de la plantilla oficial con su error; recorrido guiado disponible o no

Intercambio — src/__tests__/intercambio-gestion.test.tsx (24 casos)​

BloqueQué fija
CargaEspera del catálogo, error con reintento y las tres secciones con recursos y formatos del backend
ImportaciónPlantilla por recurso/formato, aviso sin archivo, validación con y sin errores por registro, error de validación y estado «Validando…»
ProcesamientoImportación completada o parcial con su mensaje, recarga del historial, descarga de errores de la importación y error del servidor
ExportaciónInventario con almacén y «solo bajo mínimo», movimientos con tipo, sin tipo, error y estado «Generando…»
HistorialFila con recurso, formato, resultado n/m, estado y acción de errores; sin archivo ni fallidos; vacío; filtro por estado; paginación por cursor; descarga de errores; error del listado

2. Patrón de las pruebas​

  • Se mockean las funciones de api/cargas-masivas y api/intercambio, el toast de sonner y el contexto de tour; el resto de la pantalla se monta real.
  • Los archivos se simulan con File y fireEvent.change sobre el input[type=file].
  • Hay dos etiquetas «Recurso» y «Formato» en Intercambio (importar y exportar): se distinguen por posición con getAllByLabelText(...)[0|1].
  • El detalle de una carga y el historial se comprueban con within(fila) para no confundir textos repetidos entre tarjetas y tablas.

3. Cómo verificarlo​

cd ccf-almacen-web
npx jest src/__tests__/cargas-masivas-gestion.test.tsx src/__tests__/intercambio-gestion.test.tsx
# Test Suites: 2 passed, 2 total
# Tests: 47 passed, 47 total

npx tsc --noEmit y npx eslint pasan sin errores.

Archivos clave​

  • ccf-almacen-web/src/__tests__/cargas-masivas-gestion.test.tsx — suite de solicitudes masivas.
  • ccf-almacen-web/src/__tests__/intercambio-gestion.test.tsx — suite de importación/exportación.
  • ccf-almacen-web/src/pages/cargas-masivas.tsx.
  • ccf-almacen-web/src/components/intercambio/intercambio-dashboard.tsx.
  • ccf-almacen-web/src/api/cargas-masivas.ts y src/api/intercambio.ts — contratos mockeados.