# Modulo: Sales (Ventas)

**Odoo Module:** sale
**Version:** 1.2
**Categoria:** Sales/Sales
**Es Aplicacion:** No (es modulo base de ventas)

---

## 1. Descripcion General

El modulo **sale** es el nucleo del sistema de ventas de Odoo.
Gestiona cotizaciones, ordenes de venta, y su integracion con facturacion.

### Funcionalidades Principales:
- **Ordenes de Venta (sale.order):** Gestion completa del ciclo de venta
- **Cotizaciones:** Creacion y envio a clientes
- **Firma Online:** Requerimiento de firma digital
- **Pago Online:** Integracion con pasarelas de pago
- **Integracion Facturacion:** Generacion automatica de facturas
- **Equipos de Venta:** Asignacion a equipos comerciales

---

## 2. Dependencias

### 2.1 Dependencias Explicitas (manifest)

| Modulo | Tipo | Descripcion |
|--------|------|-------------|
| sales_team | Requerido | Equipos de venta |
| account_payment | Requerido | Pagos y portal |
| utm | Requerido | Tracking de marketing |

### 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 |
| crm.team | team_id | sales_team |
| payment.transaction | transaction_ids | payment |

---

## 3. Modelos Principales

### 3.1 Ventas Core

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| sale.order | Orden de venta | sale_order.py |
| sale.order.line | Linea de orden | sale_order_line.py |

### 3.2 Wizards

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| sale.advance.payment.inv | Crear factura | sale_make_invoice_advance.py |
| sale.order.discount | Aplicar descuento | sale_order_discount.py |
| sale.mass.cancel.orders | Cancelacion masiva | mass_cancel_orders.py |

### 3.3 Extensiones

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| account.move | Extension factura | account_move.py |
| payment.transaction | Transacciones | payment_transaction.py |
| crm.team | Extension equipo | crm_team.py |
| product.template | Extension producto | product_template.py |

---

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

| Estado | Nombre UI | Descripcion | Siguiente |
|--------|-----------|-------------|-----------|
| draft | Quotation | Cotizacion inicial | sent, sale, cancel |
| sent | Quotation Sent | Cotizacion enviada | sale, cancel |
| sale | Sales Order | Orden confirmada | cancel |
| cancel | Cancelled | Orden cancelada | draft |

---

## 5. Estados de Facturacion (invoice_status)

| Estado | Descripcion |
|--------|-------------|
| upselling | Oportunidad de upselling |
| invoiced | Totalmente facturado |
| to invoice | Pendiente de facturar |
| no | Nada que facturar |

---

## 6. Opciones de Confirmacion

| Opcion | Descripcion |
|--------|-------------|
| require_signature | Requiere firma online |
| require_payment | Requiere pago online |
| prepayment_percent | Porcentaje de anticipo |

---

## 7. Integraciones

### 7.1 Con Inventario (sale_stock)
- Genera albaranes de envio
- Reserva stock automaticamente
- Actualiza cantidades entregadas

### 7.2 Con Contabilidad (account)
- Genera facturas de cliente
- Multiples metodos de facturacion
- Anticipo y factura final

### 7.3 Con Pagos (payment)
- Pasarelas de pago online
- Links de pago
- Transacciones vinculadas

---

## 8. Grupos de Seguridad

| Grupo | Permiso |
|-------|---------|
| group_sale_salesman | Vendedor |
| group_sale_salesman_all_leads | Ver todas oportunidades |
| group_sale_manager | Gerente de ventas |
| group_warning_sale | Ver advertencias |

---

## 9. Hooks de Ciclo de Vida

| Hook | Descripcion |
|------|-------------|
| post_init_hook | _post_init_hook - configuracion inicial |

---

## 10. Estadisticas del Modulo

| Metrica | Valor |
|---------|-------|
| Archivos de modelos | 15+ |
| Modelos principales | 2 |
| Lineas de codigo estimadas | 25,000+ |
| Complejidad | ALTA |

---

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