Flujo de Negocio: Purchase (Compras)
Modulo: purchase
Modelo Principal: purchase.order
Aplica Workflow: Si
1. Estados de Orden de Compra (state)
| Estado |
Nombre UI |
Descripcion |
Siguiente |
| draft |
RFQ |
Solicitud de cotizacion inicial |
sent, to approve, purchase |
| sent |
RFQ Sent |
RFQ enviada al proveedor |
to approve, purchase |
| to approve |
To Approve |
Pendiente de aprobacion |
purchase, cancel |
| purchase |
Purchase Order |
Orden confirmada |
(cancel via unlock) |
| cancel |
Cancelled |
Orden cancelada |
draft |
2. Diagrama de Transiciones
┌──────────────────┐
│ DRAFT │
│ (RFQ) │
└────────┬─────────┘
│
┌──────────────────┼──────────────────┐
│ │ │
action_rfq_send() button_confirm() button_confirm()
│ (sin aprobacion) (con aprobacion)
▼ │ │
┌──────────────────┐ │ │
│ SENT │ │ │
│ (RFQ Sent) │ │ │
└────────┬─────────┘ │ │
│ │ │
│ button_confirm() │ │
│ │ │
└───────────────────┼──────────────────┤
│ │
▼ ▼
(monto < limite) (monto >= limite)
│ │
│ ┌────────┴────────┐
│ │ TO APPROVE │
│ │ (Pendiente) │
│ └────────┬────────┘
│ │
│ button_approve()
│ │
└────────┬─────────┘
│
▼
┌──────────────────────────────┐
│ PURCHASE │
│ (Purchase Order) │
│ │
│ - Genera recepciones (stock)│
│ - Habilita facturacion │
│ - locked = True (opcional) │
└──────────────┬───────────────┘
│
button_cancel()
(requiere unlock)
│
▼
┌──────────────────┐
│ CANCEL │
│ (Cancelled) │
└────────┬─────────┘
│
button_draft()
│
▼
┌──────────────────┐
│ DRAFT │
│ (Reabierta) │
└──────────────────┘
3. Flujo Completo de Compra
1. CREACION (draft)
└─ Usuario crea purchase.order
└─ Selecciona proveedor (partner_id)
└─ Agrega lineas con productos y cantidades
└─ state = 'draft'
2. ENVIO RFQ (opcional)
└─ action_rfq_send()
└─ Envia correo al proveedor
└─ state = 'sent'
3. CONFIRMACION
└─ button_confirm() llamado
3a. SIN DOBLE VALIDACION:
└─ _approval_allowed() = True
└─ button_approve() ejecutado automatico
└─ state = 'purchase'
3b. CON DOBLE VALIDACION (monto > limite):
└─ _approval_allowed() = False
└─ state = 'to approve'
└─ Requiere gerente
4. APROBACION (si aplica)
└─ button_approve()
└─ Verifica permisos
└─ state = 'purchase'
└─ date_approve = now()
5. RECEPCION (integracion stock)
└─ Genera stock.picking automaticamente
└─ Operario recibe productos
└─ qty_received actualizado en lineas
6. FACTURACION
└─ Proveedor envia factura
└─ Vincula factura con PO
└─ qty_invoiced actualizado
└─ invoice_status = 'invoiced'
4. Metodos de Transicion
| Metodo |
De Estado |
A Estado |
Descripcion |
| button_confirm() |
draft/sent |
to approve/purchase |
Confirma orden |
| button_approve() |
to approve |
purchase |
Aprueba orden |
| button_cancel() |
* (no purchase locked) |
cancel |
Cancela |
| button_draft() |
cancel |
draft |
Vuelve a borrador |
| action_rfq_send() |
draft |
sent |
Envia RFQ |
| button_unlock() |
purchase |
purchase (unlocked) |
Desbloquea |
5. Reglas de Negocio
| ID |
Regla |
Validacion |
Mensaje |
| R1 |
Proveedor requerido |
partner_id presente |
Proveedor requerido |
| R2 |
Lineas requeridas |
order_line no vacio |
Agregue al menos una linea |
| R3 |
Producto valido |
product_id empresa compatible |
Producto de otra empresa |
| R4 |
Cantidad positiva |
product_qty > 0 |
Cantidad debe ser positiva |
| R5 |
Aprobacion limite |
amount_total vs limite |
Requiere aprobacion |
6. Flujo de Doble Validacion
CONFIGURACION (res.config.settings)
│
├─ po_lock = 'lock' | 'edit'
├─ po_double_validation = 'one_step' | 'two_step'
└─ po_double_validation_amount = monto_limite
│
│
EVALUACION EN button_confirm()
│
├─ _approval_allowed():
│ │
│ ├─ Si po_double_validation == 'one_step':
│ │ └─ return True (sin aprobacion)
│ │
│ └─ Si po_double_validation == 'two_step':
│ └─ return amount_total < limite
│ OR user tiene permiso manager
│
└─ Resultado:
├─ True → state = 'purchase'
└─ False → state = 'to approve'
7. Integracion con Stock
CONFIRMACION (state → purchase)
│
├─ Genera stock.picking automaticamente
│ └─ picking_type_id = Recepciones
│ └─ partner_id = Proveedor
│ └─ location_dest_id = Stock
│
├─ Por cada purchase.order.line:
│ └─ Crea stock.move
│ └─ product_id
│ └─ product_uom_qty = product_qty
│ └─ purchase_line_id = line.id
│
RECEPCION (en stock)
│
├─ Operario valida picking
├─ stock.move → done
└─ purchase.order.line.qty_received actualizado
8. Integracion con Facturacion
CREACION DE FACTURA
│
├─ Desde PO: action_create_invoice()
│ └─ Crea account.move tipo 'in_invoice'
│ └─ Vincula lineas de factura con POL
│
├─ Desde Factura entrante:
│ └─ purchase.bill.line.match
│ └─ Matching automatico o manual
│
ACTUALIZACION
│
├─ qty_invoiced calculado de lineas factura
├─ invoice_status recalculado:
│ ├─ 'no' = nada que facturar
│ ├─ 'to invoice' = pendiente
│ └─ 'invoiced' = todo facturado
9. Acciones Automaticas
| Trigger |
Accion |
Condicion |
| button_confirm |
Generar nombre secuencial |
Si name = 'New' |
| button_approve |
Establecer date_approve |
Siempre |
| button_approve |
Crear recepciones stock |
Si integracion activa |
| Linea modificada |
Recalcular totales |
Siempre |
| Recepcion stock |
Actualizar qty_received |
Automatico |
10. Permisos por Estado
| Estado |
Editable |
Grupos |
| draft |
Si |
purchase.group_purchase_user |
| sent |
Si |
purchase.group_purchase_user |
| to approve |
Parcial |
purchase.group_purchase_manager |
| purchase |
No (locked) |
purchase.group_purchase_manager (unlock) |
| cancel |
No |
purchase.group_purchase_user (reopen) |
11. Flujo de Estados de Facturacion
PO CONFIRMADA (state = purchase)
│
├─ invoice_status = 'no'
│ └─ Nada recibido aun
│
├─ Recepcion parcial:
│ └─ qty_received > 0
│ └─ invoice_status = 'to invoice'
│
├─ Factura parcial:
│ └─ qty_invoiced < qty_received
│ └─ invoice_status = 'to invoice'
│
└─ Todo facturado:
└─ qty_invoiced >= qty_received
└─ invoice_status = 'invoiced'
Referencias:
- purchase_order.py: button_confirm, button_approve, button_cancel
- Integracion stock: purchase_stock/
- Integracion account: account_move.py
cb4c0681d3