Saltar al contenido principal

Devoluciones de stock — pruebas unitarias del flujo completo

La pantalla Operaciones › Inventarios › Devoluciones (/devoluciones) registra el ingreso de productos devueltos a una bodega y suma stock solo al recibir las líneas en buen estado. Ahora tiene 25 casos de prueba que cubren listado, filtros, exportación, alta con estados por producto y las transiciones recibir/cancelar.

1. Qué se cubre​

ccf-almacen-web/src/__tests__/devoluciones-gestion.test.tsx (25 casos):

BloqueQué fija
ListadoCarga, error con mensaje del servidor, vacío, código/almacén/solicitud/líneas/estados/fecha, badge por estado de producto (Bueno × 2, Dañado × 1), acciones solo en pendientes, recargar y modo offline
Filtros y paginaciónEstado, almacén y solicitud de origen; reinicio a página 1; meta del API y navegación Anterior/Siguiente
ExportaciónExcel y PDF con los filtros activos, descarga del blob y aviso si falla
AltaAlmacén y producto obligatorios; motivo obligatorio (mín. 5) cuando hay solicitud; cantidad y estados por línea; observaciones; línea duplicada rechazada; agregar/quitar líneas; estado «Registrando…»; error del servidor; cancelación
TransicionesRecibir con la explicación de qué estados mueven stock; cancelar; Volver sin ejecutar; error del servidor

2. Patrón de las pruebas​

  • Se monta la página real y se mockean los hooks (useDevoluciones, useCreateDevolucion, useAccionDevolucion, almacenes e inventario), la descarga de reportes, conectividad, tour y avisos.
  • Las mutaciones se resuelven invocando onSuccess/onError para comprobar avisos y cierre de diálogos.
  • Los Select se eligen por su nombre visible y las cantidades por los ids cantidad-N; las filas se acotan con within.
  • La descarga se prueba con espías de URL.createObjectURL y del clic del ancla.

3. Cómo verificarlo​

cd ccf-almacen-web
npx jest src/__tests__/devoluciones-gestion.test.tsx
# Test Suites: 1 passed, 1 total
# Tests: 25 passed, 25 total

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

Archivos clave​

  • ccf-almacen-web/src/__tests__/devoluciones-gestion.test.tsx — suite de la página.
  • ccf-almacen-web/src/pages/devoluciones.tsx — listado, filtros, alta y transiciones.
  • ccf-almacen-web/src/api/devoluciones.ts — contrato y descarga de reportes.