234 lines
12 KiB
Markdown
234 lines
12 KiB
Markdown
# US-PURCH-004: Aprobar y Generar Orden de Compra
|
|
|
|
**Épica:** MAI-004 - Compras e Inventarios
|
|
**Sprint:** 12
|
|
**Story Points:** 8
|
|
**Prioridad:** Alta
|
|
|
|
---
|
|
|
|
## Historia de Usuario
|
|
|
|
**Como** Gerente de Compras
|
|
**Quiero** generar órdenes de compra formales desde cotizaciones aprobadas
|
|
**Para** formalizar el pedido con el proveedor y tener trazabilidad del proceso
|
|
|
|
---
|
|
|
|
## Criterios de Aceptación
|
|
|
|
### AC1: Generar OC desde Cotización
|
|
```
|
|
Flujo:
|
|
1. Comparativo de cotizaciones muestra:
|
|
"Materiales del Norte - Score 82.0"
|
|
[Generar Orden de Compra]
|
|
|
|
2. Sistema pre-llena formulario OC:
|
|
|
|
┌──────────────────────────────────────────────────────┐
|
|
│ ORDEN DE COMPRA │
|
|
├──────────────────────────────────────────────────────┤
|
|
│ Folio: OC-2025-00145 (automático) │
|
|
│ Fecha: 20/Nov/2025 │
|
|
│ │
|
|
│ PROVEEDOR │
|
|
│ Materiales del Norte SA de CV │
|
|
│ RFC: MAT901010XXX │
|
|
│ Contacto: Ana López - 81-1234-5678 │
|
|
│ ana.lopez@materialesdn.com │
|
|
│ │
|
|
│ PROYECTO Y ENTREGA │
|
|
│ Proyecto: Fracc. Los Pinos │
|
|
│ Entregar en: │
|
|
│ Av. Los Pinos #100, Col. Valle Verde │
|
|
│ Monterrey, N.L. CP 64000 │
|
|
│ Fecha entrega: [07/Dic/2025] │
|
|
│ │
|
|
│ MATERIALES │
|
|
│ ┌──────────────┬──────┬─────┬────────┬──────────┐ │
|
|
│ │ Descripción │ Cant │ Unid│ P.U. │ Total │ │
|
|
│ ├──────────────┼──────┼─────┼────────┼──────────┤ │
|
|
│ │ Cemento CPC │ 120 │ ton │ $4,280 │ $513,600 │ │
|
|
│ │ Grava 3/4" │ 85 │ m³ │ $390 │ $33,150 │ │
|
|
│ │ Arena │ 100 │ m³ │ $285 │ $28,500 │ │
|
|
│ └──────────────┴──────┴─────┴────────┴──────────┘ │
|
|
│ │
|
|
│ Subtotal: $575,250 │
|
|
│ IVA 16%: $92,040 │
|
|
│ TOTAL: $667,290 │
|
|
│ │
|
|
│ CONDICIONES │
|
|
│ Forma de pago: 30 días fecha factura │
|
|
│ ☑ Incluye descarga en obra │
|
|
│ Garantía: [30] días │
|
|
│ │
|
|
│ Condiciones especiales: │
|
|
│ [Precio incluye transporte. Descarga en horario ]│
|
|
│ [de 8am a 5pm de lunes a viernes. ]│
|
|
│ │
|
|
│ [Vista Previa PDF] [Aprobar y Enviar] │
|
|
└──────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
### AC2: Vista Previa y Aprobación
|
|
```
|
|
PDF generado (Vista previa):
|
|
|
|
╔══════════════════════════════════════════════════════╗
|
|
║ CONSTRUCTORA XYZ ║
|
|
║ RFC: CON850101XXX ║
|
|
║ Av. Principal #123, Monterrey, N.L. ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ ║
|
|
║ ORDEN DE COMPRA ║
|
|
║ OC-2025-00145 ║
|
|
║ ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ Fecha: 20 de Noviembre de 2025 ║
|
|
║ ║
|
|
║ PROVEEDOR: ║
|
|
║ Materiales del Norte SA de CV ║
|
|
║ RFC: MAT901010XXX ║
|
|
║ Contacto: Ana López ║
|
|
║ Tel: 81-1234-5678 ║
|
|
║ ║
|
|
║ PROYECTO: ║
|
|
║ Fraccionamiento Los Pinos ║
|
|
║ ║
|
|
║ ENTREGAR EN: ║
|
|
║ Av. Los Pinos #100 ║
|
|
║ Col. Valle Verde, Monterrey, N.L. ║
|
|
║ CP: 64000 ║
|
|
║ ║
|
|
║ FECHA DE ENTREGA REQUERIDA: 07/Dic/2025 ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ # │ Descripción │Cant│Unid│ P.U. │ Total ║
|
|
╠═══╪════════════════════╪════╪════╪═══════╪═════════╣
|
|
║ 1 │ Cemento CPC 30R │120 │ton │$4,280 │$513,600 ║
|
|
║ 2 │ Grava 3/4" │ 85 │m³ │$390 │$33,150 ║
|
|
║ 3 │ Arena │100 │m³ │$285 │$28,500 ║
|
|
╠═══╧════════════════════╧════╧════╧═══════╧═════════╣
|
|
║ Subtotal: $575,250 ║
|
|
║ IVA 16%: $92,040 ║
|
|
║ TOTAL: $667,290 ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ CONDICIONES: ║
|
|
║ • Forma de pago: 30 días fecha factura ║
|
|
║ • Entrega: LAB (libre a bordo) en obra ║
|
|
║ • Incluye descarga en horario de 8am a 5pm ║
|
|
║ • Garantía: 30 días ║
|
|
╠══════════════════════════════════════════════════════╣
|
|
║ ║
|
|
║ Autorizado por: ║
|
|
║ ║
|
|
║ _______________________ ║
|
|
║ Gerente de Compras ║
|
|
║ Fecha: _______________ ║
|
|
╚══════════════════════════════════════════════════════╝
|
|
|
|
[⬇️ Descargar] [📧 Enviar Email] [← Editar] [✓ Aprobar]
|
|
```
|
|
|
|
### AC3: Envío y Seguimiento de OC
|
|
```
|
|
Al aprobar OC-2025-00145:
|
|
|
|
1. Status cambia: pending → approved
|
|
2. Email automático al proveedor:
|
|
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
De: compras@constructoraxyz.com
|
|
Para: ana.lopez@materialesdn.com
|
|
Asunto: Orden de Compra OC-2025-00145
|
|
|
|
Estimada Ana López,
|
|
|
|
Adjuntamos orden de compra OC-2025-00145
|
|
por $667,290 (IVA incluido).
|
|
|
|
Materiales:
|
|
- Cemento CPC 30R: 120 ton
|
|
- Grava 3/4": 85 m³
|
|
- Arena: 100 m³
|
|
|
|
Fecha entrega: 07/Dic/2025
|
|
Lugar: Fracc. Los Pinos, Monterrey
|
|
|
|
Por favor confirmar recepción de esta orden.
|
|
|
|
Saludos,
|
|
Constructora XYZ
|
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
Adjunto: OC-2025-00145.pdf
|
|
|
|
3. Registro en timeline:
|
|
20/Nov 09:30 - OC creada
|
|
20/Nov 09:45 - OC aprobada
|
|
20/Nov 09:46 - Email enviado a proveedor
|
|
```
|
|
|
|
### AC4: Dashboard de OCs Activas
|
|
```
|
|
┌──────────────────────────────────────────────────────┐
|
|
│ ÓRDENES DE COMPRA ACTIVAS │
|
|
│ │
|
|
│ Filtros: [Todos los status ▼] [Nov 2025 ▼] │
|
|
│ │
|
|
│ Status: │
|
|
│ 🟡 Pendientes: 3 │
|
|
│ 🟢 Aprobadas: 8 │
|
|
│ 📦 En tránsito: 5 │
|
|
│ ✅ Recibidas: 12 │
|
|
├──────────────────────────────────────────────────────┤
|
|
│ Código │Proveedor │Monto │Entrega│Status││
|
|
├─────────────┼─────────────┼─────────┼───────┼──────┤│
|
|
│OC-2025-00145│Materiales DN│$667,290 │07/Dic │🟢 Env││
|
|
│ Cemento, Grava, Arena │ │ │ ││
|
|
│ │
|
|
│OC-2025-00144│Cemex │$522,000 │05/Dic │📦 Trá││
|
|
│ Cemento CPC 30R (120 ton)│ │ │ ││
|
|
│ ⚠️ Entrega parcial: 80 ton recibidas ││
|
|
│ │
|
|
│OC-2025-00143│Aceros SA │$450,000 │01/Dic │⏰ Ret││
|
|
│ Varilla 3/8" fy=4200 │ │ │ ││
|
|
│ ⚠️ 2 días de retraso ││
|
|
└──────────────────────────────────────────────────────┘
|
|
|
|
Acciones por OC:
|
|
[👁 Ver] [📄 PDF] [📧 Reenviar] [✏️ Editar] [❌ Cancelar]
|
|
```
|
|
|
|
---
|
|
|
|
## Notas Técnicas
|
|
|
|
### Backend
|
|
- Generación PDF con jsPDF o Puppeteer
|
|
- Numeración secuencial con locks de BD
|
|
- Email transaccional con SendGrid/AWS SES
|
|
- Webhook para confirmación de lectura (opcional)
|
|
|
|
### Frontend
|
|
- Vista previa PDF en modal
|
|
- Editor rich-text para condiciones
|
|
- Drag & drop para reordenar items
|
|
- Firma digital (futuro)
|
|
|
|
---
|
|
|
|
## Definición de Hecho (DoD)
|
|
|
|
- [ ] Generación de OC desde cotización
|
|
- [ ] Numeración secuencial OC-YYYY-NNNNN
|
|
- [ ] Vista previa PDF
|
|
- [ ] Envío automático por email
|
|
- [ ] Dashboard de OCs con filtros
|
|
- [ ] Timeline de seguimiento
|
|
- [ ] Cancelación de OC con motivo
|
|
- [ ] Tests de generación PDF
|
|
|
|
---
|
|
|
|
**Referencias:** RF-PURCH-002, ET-PURCH-002
|