Ir al contenido

Modelo sale.order.line: Arquitectura de las líneas de pedido en Odoo

Guía imprescindible sobre el modelo de líneas de pedido en Odoo para desarrolladores y consultores funcionales
10 de marzo de 2026 por
Modelo sale.order.line: Arquitectura de las líneas de pedido en Odoo
Dasolo
| Sin comentarios aún

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.

Modelo sale.order.line: Arquitectura de las líneas de pedido en Odoo
Dasolo 10 de marzo de 2026
Compartir esta publicación
Iniciar sesión para dejar un comentario