Devoluciones de stock — pruebas unitarias del flujo completo
· 2 min de lectura
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):
| Bloque | Qué fija |
|---|---|
| Listado | Carga, 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ón | Estado, almacén y solicitud de origen; reinicio a página 1; meta del API y navegación Anterior/Siguiente |
| Exportación | Excel y PDF con los filtros activos, descarga del blob y aviso si falla |
| Alta | Almacé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 |
| Transiciones | Recibir 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/onErrorpara comprobar avisos y cierre de diálogos. - Los
Selectse eligen por su nombre visible y las cantidades por los idscantidad-N; las filas se acotan conwithin. - La descarga se prueba con espías de
URL.createObjectURLy 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.
