Recepción de mercancía — pruebas unitarias de cantidades y acta
· 3 min de lectura
La pantalla Operaciones › Compras › Recepciones (/recepciones) registra la llegada
física contra una orden de compra confirmada, separa lo recibido en buen estado de lo dañado
o rechazado y genera el acta para firma (COM-005, TEC-014). Ahora tiene 28 casos de prueba.
1. Qué se cubre
ccf-almacen-web/src/__tests__/recepciones-gestion.test.tsx (28 casos):
| Bloque | Qué fija |
|---|---|
| Listado | Espera, error con mensaje del servidor, vacío, aviso y bloqueo cuando no hay órdenes confirmadas, número/orden/proveedor/líneas/estado/fecha y referencias de respaldo (OC 21, —) |
| Filtros y paginación | Filtro por estado con reinicio a página 1, paginación en servidor y recarga |
| Detalle | Datos de la entrega (estado, fecha, guía, transportista, placa, quién registró), observaciones, líneas con OK/dañado/rechazado e inspección, «Excede lo ordenado» y ausencias con «—» |
| Nueva recepción | Órdenes confirmadas en el selector, precarga de líneas desde la orden, error al cargar, orden sin productos, validación de cantidades (total > 0 y ≤ ordenado) y payload completo con guía, transporte, observaciones y resultado de inspección |
| Cierre del formulario | Éxito con su mensaje y cierre, error del servidor conservando el diálogo, botón deshabilitado mientras registra y «Cancelar» sin mutar |
| Cambio de estado | Estado por defecto Completada, nuevo estado con motivo recortado, éxito, error y «Volver» |
| Acta | Genera el acta y abre el diálogo de firma, error del servidor y botón deshabilitado mientras genera |
| Tour | Sin proveedor no se pinta; con motor inicia recepciones |
2. Patrón de las pruebas
- Se mockean los hooks de compras y de firmas,
getOrdenCompraById, el diálogo de firma (con un doble que solo muestra el documento recibido), eltoasty el contexto de tour. - Las mutaciones se resuelven invocando
onSuccess/onErrordesde el mock demutate. - Las cantidades se localizan por sus
aria-label(Cantidad recibida OK de GUA-1,Cantidad dañada de …,Resultado de inspección de …), que es el contrato accesible real de la tabla editable. - El cuerpo de las líneas se comprueba celda a celda para no depender del orden del DOM.
3. Cómo verificarlo
cd ccf-almacen-web
npx jest src/__tests__/recepciones-gestion.test.tsx
# Test Suites: 1 passed, 1 total
# Tests: 28 passed, 28 total
npx tsc --noEmit y npx eslint pasan sin errores.
Archivos clave
ccf-almacen-web/src/__tests__/recepciones-gestion.test.tsx— suite de la página.ccf-almacen-web/src/pages/recepciones.tsx— listado, registro, detalle y estados.ccf-almacen-web/src/hooks/use-compras.ts— consultas y mutaciones de la recepción.ccf-almacen-web/src/models/compras.entity.ts— estados, inspección ytotalLineaRecepcion.
