# Modulo: Purchase (Compras)

**Odoo Module:** purchase
**Version:** 1.2
**Categoria:** Supply Chain/Purchase
**Es Aplicacion:** Si

---

## 1. Descripcion General

El modulo **purchase** gestiona el ciclo completo de compras de Odoo.
Desde solicitudes de cotizacion (RFQ) hasta ordenes de compra confirmadas.

### Funcionalidades Principales:
- **Ordenes de Compra (purchase.order):** Gestion completa del ciclo de compra
- **Solicitudes de Cotizacion (RFQ):** Envio y seguimiento de solicitudes
- **Aprobacion de Compras:** Flujo de aprobacion configurable
- **Integracion con Facturacion:** Vinculo con facturas de proveedor
- **Integracion con Inventario:** Generacion automatica de recepciones
- **Terminos de Pago:** Configuracion por proveedor

---

## 2. Dependencias

### 2.1 Dependencias Explicitas (manifest)

| Modulo | Tipo | Descripcion |
|--------|------|-------------|
| account | Requerido | Facturacion y contabilidad |

### 2.2 Dependencias Implicitas

| Modelo Externo | Campo | Modulo Origen |
|---------------|-------|---------------|
| res.partner | partner_id | base |
| res.company | company_id | base |
| res.currency | currency_id | base |
| product.product | product_id | product |
| account.move | invoice_ids | account |
| account.fiscal.position | fiscal_position_id | account |
| account.payment.term | payment_term_id | account |

---

## 3. Modelos Principales

### 3.1 Compras Core

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| purchase.order | Orden de compra | purchase_order.py |
| purchase.order.line | Linea de orden | purchase_order_line.py |
| purchase.bill.line.match | Matching de facturas | purchase_bill_line_match.py |

### 3.2 Extensiones

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| res.partner | Extension proveedor | res_partner.py |
| res.company | Config empresa | res_company.py |
| product.product | Extension producto | product.py |
| product.template | Extension plantilla | product.py |

---

## 4. Estados de Orden de Compra (state)

| Estado | Nombre UI | Descripcion | Siguiente |
|--------|-----------|-------------|-----------|
| draft | RFQ | Solicitud de cotizacion | 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 (solo desbloquear) |
| cancel | Cancelled | Orden cancelada | draft |

---

## 5. Estados de Facturacion (invoice_status)

| Estado | Descripcion |
|--------|-------------|
| no | Nada que facturar |
| to invoice | Pendiente de facturar |
| invoiced | Completamente facturado |

---

## 6. Flujo de Aprobacion

| Condicion | Comportamiento |
|-----------|----------------|
| Sin doble validacion | draft → purchase directo |
| Con doble validacion | draft → to approve → purchase |
| Monto sobre limite | Requiere aprobacion gerente |

---

## 7. Integraciones

### 7.1 Con Inventario (stock)
- Genera albaranes de recepcion automaticamente
- Vincula movimientos con lineas de compra
- Actualiza cantidades recibidas

### 7.2 Con Contabilidad (account)
- Genera facturas de proveedor
- Reconcilia con ordenes de compra
- Aplica posiciones fiscales

---

## 8. Grupos de Seguridad

| Grupo | Permiso |
|-------|---------|
| group_purchase_user | Usuario de compras |
| group_purchase_manager | Gerente de compras |
| group_warning_purchase | Ver advertencias |

---

## 9. Estadisticas del Modulo

| Metrica | Valor |
|---------|-------|
| Archivos de modelos | 8 |
| Modelos principales | 3 |
| Lineas de codigo estimadas | 15,000+ |
| Complejidad | MEDIA |

---

**Referencias:**
- Fuente: `addons/purchase/`
- Manifest: `addons/purchase/__manifest__.py`