# Modulo: Inventory (Inventario)

**Odoo Module:** stock
**Version:** 1.1
**Categoria:** Supply Chain/Inventory
**Es Aplicacion:** Si

---

## 1. Descripcion General

El modulo **stock** es el sistema de gestion de inventario y almacenes de Odoo.
Gestiona movimientos de stock, albaranes, ubicaciones, cantidades y reglas de procura.

### Funcionalidades Principales:
- **Movimientos de Stock (stock.move):** Transferencia de productos entre ubicaciones
- **Albaranes/Transferencias (stock.picking):** Agrupacion de movimientos
- **Almacenes (stock.warehouse):** Configuracion multi-almacen con flujos personalizables
- **Ubicaciones (stock.location):** Estructura jerarquica de almacenamiento
- **Cantidades (stock.quant):** Registro preciso de inventario
- **Reglas (stock.rule):** Automatizacion de reposicion
- **Lotes/Numeros de Serie (stock.lot):** Trazabilidad de productos
- **Descartes (stock.scrap):** Gestion de mermas

---

## 2. Dependencias

### 2.1 Dependencias Explicitas (manifest)

| Modulo | Tipo | Descripcion |
|--------|------|-------------|
| product | Requerido | Gestion de productos |
| barcodes_gs1_nomenclature | Requerido | Nomenclatura codigos de barras |
| digest | Requerido | Resumenes por correo |

### 2.2 Dependencias Implicitas

| Modelo Externo | Campo | Modulo Origen |
|---------------|-------|---------------|
| res.partner | partner_id | base |
| res.company | company_id | base |
| res.users | user_id | base |
| product.product | product_id | product |
| uom.uom | product_uom | uom |

---

## 3. Modelos Principales

### 3.1 Stock Core

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| stock.move | Movimientos de stock | stock_move.py |
| stock.move.line | Lineas de operacion | stock_move_line.py |
| stock.picking | Albaranes/Transferencias | stock_picking.py |
| stock.location | Ubicaciones | stock_location.py |
| stock.warehouse | Almacenes | stock_warehouse.py |
| stock.quant | Cantidades de stock | stock_quant.py |

### 3.2 Reglas y Automatizacion

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| stock.rule | Reglas de procura | stock_rule.py |
| stock.route | Rutas de almacen | stock_route.py |
| stock.orderpoint | Puntos de reorden | stock_orderpoint.py |
| stock.putaway.rule | Reglas de ubicacion | stock_putaway_rule.py |

### 3.3 Trazabilidad

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| stock.lot | Lotes/Numeros de serie | stock_lot.py |
| stock.package | Paquetes | stock_package.py |
| stock.scrap | Descartes/Mermas | stock_scrap.py |

### 3.4 Configuracion

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| stock.picking.type | Tipos de operacion | stock_picking_type.py |
| stock.storage.category | Categorias de almacenamiento | stock_storage_category.py |
| product.removal | Estrategias de extraccion | product_removal.py |

---

## 4. Tipos de Operacion (picking_type_code)

| Tipo | Descripcion | Uso |
|------|-------------|-----|
| incoming | Recepciones | Entradas de proveedor |
| outgoing | Envios | Salidas a cliente |
| internal | Transferencias internas | Entre ubicaciones |

---

## 5. Tipos de Ubicacion (usage)

| Tipo | Descripcion | Virtual |
|------|-------------|---------|
| supplier | Proveedores | Si |
| customer | Clientes | Si |
| internal | Interna fisica | No |
| view | Virtual/Jerarquica | Si |
| inventory | Ajustes de inventario | Si |
| production | Produccion | Si |
| transit | Transito | Si |

---

## 6. Pasos de Recepcion (reception_steps)

| Paso | Descripcion | Ubicaciones |
|------|-------------|-------------|
| one_step | Recibir y almacenar | Stock |
| two_steps | Recibir, luego almacenar | Input → Stock |
| three_steps | Recibir, QC, almacenar | Input → QC → Stock |

---

## 7. Pasos de Entrega (delivery_steps)

| Paso | Descripcion | Ubicaciones |
|------|-------------|-------------|
| ship_only | Entrega directa | Stock |
| pick_ship | Recoger, luego enviar | Stock → Output |
| pick_pack_ship | Recoger, empacar, enviar | Stock → Pack → Output |

---

## 8. Hooks de Ciclo de Vida

| Hook | Funcion | Descripcion |
|------|---------|-------------|
| pre_init_hook | - | Antes de instalacion |
| post_init_hook | _assign_default_mail_template_picking_id | Asigna plantilla correo |
| uninstall_hook | - | Al desinstalar |

---

## 9. Estadisticas del Modulo

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

---

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