Saltar al contenido principal

Recepción de mercancía — pruebas unitarias de cantidades y acta

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):

BloqueQué fija
ListadoEspera, 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ónFiltro por estado con reinicio a página 1, paginación en servidor y recarga
DetalleDatos 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 estadoEstado por defecto Completada, nuevo estado con motivo recortado, éxito, error y «Volver»
ActaGenera el acta y abre el diálogo de firma, error del servidor y botón deshabilitado mientras genera
TourSin 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), el toast y el contexto de tour.
  • Las mutaciones se resuelven invocando onSuccess/onError desde el mock de mutate.
  • 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 y totalLineaRecepcion.