Introducción
En Odoo, los modelos son la plantilla que organiza y guarda la información en la base de datos. Todo dato de la empresa —presupuestos, facturas, clientes, productos— se almacena dentro de un modelo que define su forma y relaciones.
Tener claro cómo funcionan los modelos es imprescindible tanto para desarrolladores como para consultores funcionales. Son la columna vertebral de la arquitectura de datos: determinan campos, vínculos entre objetos y la lógica de negocio que gobierna el comportamiento de la aplicación.
Aquí vamos a centrarnos en uno de los modelos más usados en el módulo de Ventas: sale.order.line. Si trabajas en personalizaciones, integraciones o en la configuración de precios y facturación, acabarás tratando con este modelo a menudo.
¿Qué es el modelo sale.order.line?
El modelo sale.order.line representa cada posición dentro de un presupuesto o pedido. Cada registro suele corresponder a un artículo con su cantidad, precio y las tasas aplicables.
Pertenece al módulo de ventas (sale) y hereda funcionalidades como analytic.mixin para que los costes puedan asociarse a proyectos o partes de tiempo. Cuando se añade un producto a un presupuesto, se crea una línea sale.order.line vinculada al pedido padre.
El núcleo del modelo está definido en el módulo sale, y otros módulos lo amplían mediante herencia de modelos. Por ejemplo, extensiones relacionadas con stock o margen añaden campos y cálculos específicos sin duplicar la estructura base.
Campos clave del modelo
A continuación tienes los campos más relevantes de sale.order.line. Conocerlos facilita gestionar presupuestos, entregas y facturación correctamente.
1. order_id
Tipo: Many2one (sale.order). Obligatorio. Apunta al pedido principal y mantiene la relación entre la línea y su pedido. Si se elimina el pedido, sus líneas también se borran (cascade).
2. sequence
Tipo: Integer. Valor por defecto 10. Determina el orden de presentación de las líneas en un pedido, útil para ordenar secciones, notas y artículos.
3. company_id
Tipo: Many2one (res.company). Proviene del pedido (order_id). Se usa en reglas multiempresa y para controles de acceso.
4. currency_id
Tipo: Many2one (res.currency). Relacionado desde order_id. Define la moneda para los importes de la línea, asegurando precios correctos.
5. order_partner_id
Tipo: Many2one (res.partner). Relacionado desde order_id. Representa al cliente; influye en reglas de tarifa y fiscalidad.
6. salesman_id
Tipo: Many2one (res.users). Relacionado desde order_id. Usuario vendedor, utilizado en comisiones e informes.
7. state
Tipo: Selection. Trae el estado del pedido desde order_id (draft, sent, sale, done, cancel). Determina qué campos son editables.
8. display_type
Tipo: Selection. Valores: line_section o line_note. Marca la línea como cabecera de sección o nota en lugar de una línea de producto; los campos de producto quedan vacíos.
9. is_downpayment
Tipo: Boolean. Indica si la línea es un anticipo; los anticipos se facturan por separado.
10. is_expense
Tipo: Boolean. True cuando la línea procede de un gasto o factura de proveedor; útil para imputar costes a proyectos.
11. product_id
Tipo: Many2one (product.product). El producto que se vende. El dominio limita a productos vendibles; obligatorio en líneas de producto.
12. product_template_id
Tipo: Many2one (product.template). Calculado a partir de product_id. Lo usa el configurador para elegir variantes.
13. name
Tipo: Text. Descripción de la línea. Se genera desde el producto y atributos personalizados, e incluye detalles de la variante cuando procede.
14. product_uom_qty
Tipo: Float. Obligatorio. Cantidad pedida; valor por defecto 1.0. Puede verse influida por el packaging.
15. product_uom
Tipo: Many2one (uom.uom). Unidad de medida. Por defecto se toma del producto; afecta cantidades y precios.
16. tax_id
Tipo: Many2many (account.tax). Impuestos aplicados a la línea. Se calculan según producto y posición fiscal.
17. price_unit
Tipo: Float. Obligatorio. Precio unitario por unidad de medida. Se obtiene de la tarifa o del producto, pero puede sobrescribirse.
18. discount
Tipo: Float. Porcentaje de descuento aplicado sobre el price_unit antes de impuestos.
19. price_subtotal
Tipo: Monetary. Subtotal sin impuestos. Calculado a partir de cantidad, precio unitario y descuento.
20. price_tax
Tipo: Float. Importe total de impuestos. Se calcula desde el subtotal y los impuestos aplicables.
21. price_total
Tipo: Monetary. Total con impuestos. Es el importe que se utiliza para la facturación.
22. product_packaging_id
Tipo: Many2one (product.packaging). Packaging opcional (por ejemplo, caja de 12). Puede condicionar la cantidad a vender.
23. customer_lead
Tipo: Float. Plazo en días entre la confirmación del pedido y el envío; se usa para calcular la fecha de entrega.
24. qty_delivered
Tipo: Float. Cantidad entregada. Se actualiza desde movimientos de stock o manualmente; sirve en facturación parcial.
25. qty_invoiced
Tipo: Float. Cantidad ya facturada. Se calcula a partir de las líneas de factura vinculadas.
26. qty_to_invoice
Tipo: Float. Cantidad pendiente de facturar; se obtiene restando lo facturado de lo entregado o pedido.
27. invoice_status
Tipo: Selection. Valores: upselling, invoiced, to invoice, no. Indica el estado de facturación de la línea.
28. invoice_lines
Tipo: Many2many (account.move.line). Vínculo con las líneas de factura generadas a partir de esta línea de venta; importante para trazabilidad.
29. create_date
Tipo: Datetime. Fecha de creación del registro. Gestionada automáticamente por Odoo.
30. write_date
Tipo: Datetime. Fecha de la última modificación; útil para auditorías y seguimiento.
Uso del modelo en procesos comerciales
1. Presupuesto y pedido
Cuando un comercial prepara un presupuesto añade productos; cada producto crea una línea en sale.order.line donde se ven cantidad, precio, descuento y total. El presupuesto se confirma y pasa a pedido cuando el cliente lo acepta.
2. Tarifas y descuentos
Las tarifas se aplican a nivel de línea. price_unit y discount se calculan según reglas de la tarifa (pricelist), que pueden incluir descuentos por volumen o condiciones por cliente.
3. Entrega y facturación
Al registrar entregas se actualiza qty_delivered. La facturación puede realizarse por entregas parciales o de forma global; invoice_status indica qué queda pendiente de facturar.
4. Proyectos y servicios
En productos de servicio, las líneas pueden enlazarse a tareas y hojas de horas. La mezcla con analytic.mixin permite imputar costes y analizar rentabilidad por proyecto.
5. Comercio electrónico y portal
En una tienda online, cada artículo en el carrito se materializa como una línea de venta al crear el pedido. El configurador de producto utiliza product_template_id y atributos personalizados para seleccionar variantes.
Cómo amplían los desarrolladores este modelo
Los desarrolladores amplían sale.order.line con varios patrones; la herencia de modelos de Odoo es la técnica principal.
Herencia de modelo
Usa _inherit = 'sale.order.line' para extender el modelo: añadir campos, sobrescribir métodos o añadir restricciones. Mantener los cambios en un módulo separado facilita futuras actualizaciones.
Añadir campos
Declara nuevos campos en tu modelo heredado usando el tipo adecuado: Char, Many2one, Boolean, Integer, Text, Selection, etc. Piensa en la dependencia por compañía en escenarios multiempresa.
Extensiones en Python
Sobrescribe compute o write (por ejemplo, _compute_price_unit o _compute_price_subtotal) y llama a super() cuando corresponda. Ten cuidado con campos calculados y sus dependencias para evitar bucles o cálculos incorrectos.
Odoo Studio
Odoo Studio permite crear campos sin programar, ideal para cambios rápidos. Para lógica compleja o para mantener compatibilidad en upgrades, es mejor desarrollar módulos personalizados.
Buenas prácticas
- Usa display_type para crear secciones y notas en lugar de simularlas con líneas de producto; así evitas distorsionar informes y validaciones.
- Al integrar vía API, crea las líneas vinculándolas al order_id o usando los comandos correctos en order_line_ids del sale.order para mantener la coherencia de relaciones.
- Respeta las restricciones SQL: una línea de producto debe incluir product_id y product_uom; una línea que actúa como sección o nota debe llevar display_type.
- Para precios personalizados, prioriza reglas de tarifa (pricelists). Solo sobreescribe métodos de cálculo cuando la lógica requerida no pueda expresarse con las tarifas estándar.
- Ante nuevos campos personalizados, utiliza prefijos (por ejemplo, x_ o el prefijo del módulo) para evitar conflictos con futuras versiones de Odoo.
Errores habituales
- Crear líneas sin order_id. Como order_id es obligatorio, las líneas siempre deben crearse en el contexto de un pedido para mantener integridad referencial.
- Confundir product_id y product_template_id. Para líneas de producto define product_id; product_template_id se usa en procesos de configurador y selección de variantes.
- Modificar price_unit o discount después de facturar. Cambios en precio cuando qty_invoiced > 0 pueden generar inconsistencias contables y reconciliaciones problemáticas.
- Sobrescribir métodos core sin llamar a super(). Esto puede romper funcionalidades de otros módulos y complicar futuros upgrades.
- Omitir display_type en líneas que son secciones o notas. Si no se marca, la línea será tratada como producto y puede fallar validaciones obligatorias.
Conclusión
El modelo sale.order.line es el núcleo de las posiciones de venta en Odoo: almacena cada artículo de presupuestos y pedidos. Conocer sus campos y cómo se amplía te permitirá configurar, personalizar e integrar Odoo con menos errores.
Tanto si eres consultor funcional que mapea procesos como si eres desarrollador que crea módulos, dominar sale.order.line ahorra tiempo y reduce problemas en producción.
¿Necesitas ayuda con tu implementación de Odoo?
Dasolo acompaña a empresas en la implantación, personalización y optimización de Odoo. Somos especialistas en integraciones API y desarrollo sobre la arquitectura de datos de Odoo, con amplia experiencia en modelos como sale.order.line.
Si necesitas ayuda con tu implantación de Odoo, desarrollo de módulos o integraciones, podemos asesorarte y ejecutar el proyecto. Solicita una demo para hablar sobre tu proyecto.