COM-005 Recepción de Mercancía (Fase 2)
· 2 min de lectura
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
entradapor la cantidad OK, dentro de una transacción. - OC sincronizada: al recepcionar, la orden pasa a
recibiday 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 buildEXIT 0 (API NestJS).npx eslinten los archivos nuevos: sin errores.npm run migration:run→CreateRecepcionMercancia1780000000012aplicada (tablasrecepciones_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 --noEmitEXIT 0;next lintsin warnings;next buildgenera las rutas/recepcionesy/ordenes-compra;npx jest→ 7/7 verdes.
