222 lines
10 KiB
Markdown
222 lines
10 KiB
Markdown
# US-PURCH-005: Recibir Material en Almacén
|
|
|
|
**Épica:** MAI-004 - Compras e Inventarios
|
|
**Sprint:** 12
|
|
**Story Points:** 5
|
|
**Prioridad:** Alta
|
|
|
|
---
|
|
|
|
## Historia de Usuario
|
|
|
|
**Como** Almacenista
|
|
**Quiero** registrar la recepción de materiales contra órdenes de compra
|
|
**Para** actualizar el inventario y validar que lo recibido coincide con lo ordenado
|
|
|
|
---
|
|
|
|
## Criterios de Aceptación
|
|
|
|
### AC1: Registrar Entrada de Material
|
|
```
|
|
Almacenista José García inicia sesión
|
|
Va a: Almacén → Recepciones → [+ Nueva Recepción]
|
|
|
|
┌──────────────────────────────────────────────────────┐
|
|
│ RECEPCIÓN DE MATERIAL │
|
|
├──────────────────────────────────────────────────────┤
|
|
│ Almacén: [Fracc. Los Pinos ▼] │
|
|
│ Fecha: 07/Dic/2025 │
|
|
│ │
|
|
│ Orden de Compra: * │
|
|
│ [🔍 Buscar OC... ] o escanear código QR │
|
|
│ │
|
|
│ → Busca: "OC-2025-00145" │
|
|
│ │
|
|
│ ✓ OC-2025-00145 encontrada │
|
|
│ Proveedor: Materiales del Norte │
|
|
│ Fecha entrega esperada: 07/Dic/2025 ✓ A tiempo │
|
|
│ Status: Enviada │
|
|
│ │
|
|
│ MATERIALES ORDENADOS │
|
|
│ ┌────────────┬────────┬────────┬──────────┬────────┐│
|
|
│ │ Material │Ordenado│Recibido│ Aceptado │Rechazad││
|
|
│ ├────────────┼────────┼────────┼──────────┼────────┤│
|
|
│ │Cemento CPC │ 120 ton│[80]ton │ [80] ton │[0] ton ││
|
|
│ │ │ │ │ │ ││
|
|
│ │Grava 3/4" │ 85 m³ │[85]m³ │ [85] m³ │[0] m³ ││
|
|
│ │ │ │ │ │ ││
|
|
│ │Arena │ 100 m³ │[100]m³ │ [97] m³ │[3] m³ ││
|
|
│ │ Motivo rechazo: [Material húmedo, mala calidad ]││
|
|
│ └────────────┴────────┴────────┴──────────┴────────┘│
|
|
│ │
|
|
│ Documentos del proveedor: │
|
|
│ Remisión: [R-12345 ] │
|
|
│ Factura: [Pendiente ▼] (puede ser posterior) │
|
|
│ Guía transporte: [GT-9876 ] │
|
|
│ │
|
|
│ Transportista: [Transportes Rápidos SA] │
|
|
│ │
|
|
│ Fotos/evidencias: [📸 Subir fotos] (opcional) │
|
|
│ │
|
|
│ Observaciones: │
|
|
│ [Entrega parcial de cemento (80 de 120 ton). ]│
|
|
│ [Arena con humedad, se rechazaron 3 m³. ]│
|
|
│ [Pendiente recibir 40 ton de cemento. ]│
|
|
│ │
|
|
│ [Guardar] [Completar Recepción] │
|
|
└──────────────────────────────────────────────────────┘
|
|
|
|
Validaciones:
|
|
- Cantidad recibida ≤ ordenada
|
|
- Aceptado + Rechazado = Recibido
|
|
- Si hay rechazados, motivo obligatorio
|
|
```
|
|
|
|
### AC2: Actualización Automática de Inventario
|
|
```
|
|
Al guardar recepción:
|
|
|
|
1. Se crea movimiento: ENT-2025-00234
|
|
|
|
2. Actualización de stock:
|
|
|
|
ANTES:
|
|
┌────────────┬────────┬────────┬────────┐
|
|
│ Material │ Stock │ Costo │ Valor │
|
|
├────────────┼────────┼────────┼────────┤
|
|
│ Cemento │ 40 ton │ $4,200 │$168,000│
|
|
│ Grava │ 20 m³ │ $380 │ $7,600 │
|
|
│ Arena │ 15 m³ │ $290 │ $4,350 │
|
|
└────────────┴────────┴────────┴────────┘
|
|
|
|
DESPUÉS (automático):
|
|
┌────────────┬────────┬────────┬────────┐
|
|
│ Material │ Stock │ Costo │ Valor │
|
|
├────────────┼────────┼────────┼────────┤
|
|
│ Cemento │120 ton │ $4,267*│$512,040│
|
|
│ Grava │105 m³ │ $384* │$40,320 │
|
|
│ Arena │112 m³ │ $293* │$32,816 │
|
|
└────────────┴────────┴────────┴────────┘
|
|
*Costo promedio ponderado
|
|
|
|
3. Actualización de OC:
|
|
OC-2025-00145
|
|
Status: pending → partially_received (80/120 cemento)
|
|
|
|
Cemento CPC 30R:
|
|
Ordenado: 120 ton
|
|
Recibido: 80 ton (66.7%)
|
|
Pendiente: 40 ton
|
|
Próxima entrega: Por confirmar
|
|
|
|
4. Lotes PEPS creados:
|
|
Cemento - Lote ENT-2025-00234 - 80 ton @ $4,280
|
|
Grava - Lote ENT-2025-00234 - 85 m³ @ $390
|
|
Arena - Lote ENT-2025-00234 - 97 m³ @ $285
|
|
```
|
|
|
|
### AC3: Manejo de Rechazos y Devoluciones
|
|
```
|
|
Si hay material rechazado (3 m³ de arena):
|
|
|
|
1. Se registra en recepción con motivo
|
|
2. Se genera alerta para Compras:
|
|
|
|
⚠️ MATERIAL RECHAZADO EN RECEPCIÓN
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
OC: OC-2025-00145
|
|
Proveedor: Materiales del Norte
|
|
Almacén: Fracc. Los Pinos
|
|
|
|
Material: Arena
|
|
Cantidad rechazada: 3 m³
|
|
Motivo: Material húmedo, mala calidad
|
|
|
|
Recibió: José García (Almacenista)
|
|
Fecha: 07/Dic/2025
|
|
|
|
Acción requerida:
|
|
→ Contactar proveedor
|
|
→ Solicitar reposición
|
|
→ Considerar para evaluación del proveedor
|
|
|
|
3. Email automático a Compras
|
|
4. Se registra en historial del proveedor
|
|
5. Afecta calificación del proveedor
|
|
```
|
|
|
|
### AC4: Comprobante de Recepción
|
|
```
|
|
Sistema genera comprobante imprimible:
|
|
|
|
╔══════════════════════════════════════════════════════╗
|
|
║ COMPROBANTE DE RECEPCIÓN DE MATERIALES ║
|
|
║ ENT-2025-00234 ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ Almacén: Fracc. Los Pinos ║
|
|
║ Fecha: 07 de Diciembre de 2025 ║
|
|
║ Hora: 10:30 AM ║
|
|
║ ║
|
|
║ ORDEN DE COMPRA: OC-2025-00145 ║
|
|
║ Proveedor: Materiales del Norte SA de CV ║
|
|
║ Remisión: R-12345 ║
|
|
║ Transportista: Transportes Rápidos SA ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ Material │ Ordenado │ Recibido │ Status ║
|
|
╠═════════════════╪══════════╪══════════╪═════════════╣
|
|
║ Cemento CPC 30R │ 120 ton │ 80 ton │ ⚠️ Parcial ║
|
|
║ Grava 3/4" │ 85 m³ │ 85 m³ │ ✓ Completo ║
|
|
║ Arena │ 100 m³ │ 97 m³ │ ⚠️ Rechazos ║
|
|
║ │ │ │ 3 m³ ║
|
|
╠═════════════════╧══════════╧══════════╧═════════════╣
|
|
║ OBSERVACIONES: ║
|
|
║ • Entrega parcial de cemento (80 de 120 ton) ║
|
|
║ • Arena con humedad, rechazados 3 m³ ║
|
|
║ • Pendiente recibir 40 ton de cemento ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ Recibió: José García (Almacenista) ║
|
|
║ ║
|
|
║ Firma: _____________________ ║
|
|
║ ║
|
|
║ Entregó: ___________________ ║
|
|
║ (Transportista) ║
|
|
╚══════════════════════════════════════════════════════╝
|
|
|
|
[Imprimir] [Enviar por Email] [Descargar PDF]
|
|
```
|
|
|
|
---
|
|
|
|
## Notas Técnicas
|
|
|
|
### Backend
|
|
- Trigger automático para actualizar stock (PEPS)
|
|
- Cálculo de costo promedio ponderado
|
|
- Actualizar status de OC en base a % recibido
|
|
- Generar alertas si hay rechazos
|
|
- Event: `inventory.material_received` para integraciones
|
|
|
|
### Frontend
|
|
- Lectura QR/código de barras para OC
|
|
- Captura de fotos con cámara del dispositivo
|
|
- Cálculo en tiempo real de aceptado/rechazado
|
|
- Firma digital del transportista (canvas)
|
|
|
|
---
|
|
|
|
## Definición de Hecho (DoD)
|
|
|
|
- [ ] Registro de recepción vinculado a OC
|
|
- [ ] Entrada parcial y completa
|
|
- [ ] Registro de rechazos con motivo
|
|
- [ ] Actualización automática de stock (PEPS)
|
|
- [ ] Actualización de status de OC
|
|
- [ ] Comprobante de recepción imprimible
|
|
- [ ] Alertas por rechazos
|
|
- [ ] Tests de cálculo de costos promedio
|
|
|
|
---
|
|
|
|
**Referencias:** RF-PURCH-002, RF-PURCH-003, ET-PURCH-002, ET-PURCH-003
|