Saltar al contenido principal

COM-005 Recepción de Mercancía (Fase 2)

Implementación completa de la recepción de mercancía: registrar la llegada física contra una orden de compra, validar productos y cantidades, generar automáticamente la entrada al inventario por lo recibido en buen estado, registrar diferencias/daños/rechazos parciales y actualizar el estado de la OC.

Qué cambió y por qué​

Las órdenes de compra (COM-002) llegaban hasta el estado recibida, pero no existía el paso operativo real: contar y recepcionar lo que llega del proveedor. Las entidades recepciones_mercancia/detalle_recepcion estaban declaradas pero sin servicio, controlador ni migración. Ahora existe el flujo completo y trazable.

Impacto​

  • Recepción completa: ingresa al inventario todo lo recibido en buen estado.
  • Recepción parcial/con novedades: lo dañado/rechazado se registra y no entra al stock.
  • Inventario consistente: un solo movimiento entrada por la cantidad OK, dentro de una transacción.
  • OC sincronizada: al recepcionar, la orden pasa a recibida y se actualizan sus cantidades recibidas.

Regla inviolable​

cantidad_recibida_ok + cantidad_danada + cantidad_rechazada ≤ cantidad_ordenada (CHECK en BD + validación en servicio).

Archivos clave​

  • Backend: src/domains/reorden/entities/recepcion-mercancia.entity.ts, detalle-recepcion.entity.ts, dto/crear-recepcion.dto.ts, actualizar-recepcion.dto.ts, cambiar-estado-recepcion.dto.ts, services/recepcion-mercancia.service.ts, recepcion-mercancia.controller.ts, reorden.module.ts.
  • Migración: src/database/migrations/025-create-recepcion-mercancia.ts.
  • Pruebas: src/domains/reorden/services/recepcion-mercancia.service.spec.ts.
  • Frontend: src/models/compras.entity.ts, src/api/compras.ts, src/hooks/use-compras.ts, src/pages/recepciones.tsx, src/pages/ordenes-compra.tsx, src/components/layouts/sidebar/sidebar-option.ts.
  • Framework: ARCHITECTURE.md (ADR-017), DATABASE_SCHEMA.md (§26, relaciones, historial, migraciones).
  • Wiki: docs/mejoras/com-005-recepcion-mercancia.md, docs/manuales/compras/recepcion-mercancia.md.

Verificación​

  • npm run build EXIT 0 (API NestJS).
  • npx eslint en los archivos nuevos: sin errores.
  • npm run migration:run → CreateRecepcionMercancia1780000000012 aplicada (tablas recepciones_mercancia + detalle_recepcion + índices + CHECKs).
  • npx jest src/domains/reorden → 27/27 verdes (8 nuevos de COM-005: validación RF-02, entrada selectiva RF-03, secuencia de número de recepción).
  • Frontend: npx tsc --noEmit EXIT 0; next lint sin warnings; next build genera las rutas /recepciones y /ordenes-compra; npx jest → 7/7 verdes.