Añade una nueva clase mixin para definir plantillas de comentarios que imprimir en documentos. Las plantillas de comentarios se pueden definir como plantillas de make, por lo que puedes usar variables de los modelos vinculados.
Hay dos posiciones disponibles para los comentarios:
- encima de las líneas del documento (before_lines)
- debajo de las líneas del documento (after_lines)
Las plantillas son generales y se pueden asociar a cualquier Model y basarse en un dominio definido en la plantilla. Puedes definir una plantilla predeterminada por Model y dominio, que se puede sobrescribir para cualquier compañía y socios. Tiene un campo de prioridad (número menor = mayor prioridad)
En los informes existentes, si añades esta línea obtendrás la plantilla de comentarios si has creado una como
- \ ( o sin ningún parámetro)
Este módulo es el módulo base para los siguientes módulos:
- sale_comment_template
- purchase_comment_template
- account_comment_template
- stock_picking_comment_template
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Crea plantillas de comentarios reutilizables que se puedan imprimir en documentos e informes, con reglas que decidan qué plantilla aparece para cada empresa, contacto o registro.
Este módulo añade un nuevo tipo de registro llamado plantilla de comentario. Cada plantilla tiene un nombre, un cuerpo con texto enriquecido y una posición que indica si el comentario debe aparecer en la parte superior o inferior de un documento.
- Las plantillas se gestionan desde un nuevo menú "Comment Templates" bajo el menú técnico Reporting, donde puedes crearlas, archivarlas y reordenarlas.
- Para cada plantilla eliges los modelos a los que se aplica, una condición de filtro, una prioridad y, opcionalmente, una compañía o contactos específicos. Una plantilla también puede marcarse como global para que esté disponible en todas partes.
- Un botón Preview abre un asistente donde eliges un registro de ejemplo, un idioma y un motor de renderizado para ver exactamente cómo quedará el comentario antes de usarlo.
- En un formulario de contacto, una nueva pestaña "Comment Templates" permite asociar plantillas específicas a ese contacto; se tratan como campos comerciales, por lo que siguen la jerarquía de compañías.
- Los documentos que admiten comentarios reciben automáticamente las plantillas coincidentes según el modelo, la condición de filtro, el contacto y la compañía, y el texto del comentario puede incluir valores tomados del propio documento.
- Una regla multi-compañía limita qué plantillas puede ver cada compañía.
Este es un módulo base: proporciona el mecanismo, mientras que la impresión real en ventas, compras, facturas o entregas se añade mediante módulos relacionados.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (5)
- ir.model · amplía un modelo existenteis_comment_template (Comment Template)
- res.partner · amplía un modelo existentebase_comment_template_ids (Comment Templates)
- comment.template · modelo nuevocomment_template_ids
- base.comment.template · modelo nuevoname, text (Template), active, domain (Filter Domain), engine, models, position (Position on document), sequence, model_ids (IR Model), company_id, partner_ids, global_template
- base.comment.template.preview · modelo nuevobody, lang (Template Preview Language), engine (Template Preview Engine), model_id, model_ids, no_record, resource_ref (Record reference), base_comment_template_id
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 8 confirmadas, 1 sin información de 9 versiones.
Fuentes · Odoo 12.0
Confirmado el 2026-11-03 en la rama 12.0 de OCA/account-invoice-reporting.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Configuración
Fuente · Odoo 19.0Ve a Settings \> Technical \> Reporting \> Comment Templates y empieza a diseñar tus plantillas de comentarios.
Este módulo es el módulo base para los siguientes módulos:
- sale_comment_template
- purchase_comment_template
- invoice_comment_template
- stock_picking_comment_template
- Vaya a Ajustes y active el modo desarrollador.
- Vaya a Ajustes \> Técnico \> Informes \> Plantillas de comentarios.
- Cree un nuevo registro.
- Defina la Compañía a la que está vinculada la plantilla o déjelo por defecto para todas las compañías.
- Defina el Partner al que está vinculada la plantilla o déjelo por defecto para todos los partners.
- Defina el Model, Domain al que está vinculada la plantilla.
- Defina la Position donde se imprimirá la plantilla:
- encima de las líneas del documento
- debajo de las líneas del documento
Debe tener al menos una plantilla con el campo Default establecido; si elige un Partner, la plantilla se deselecciona como predeterminada. Si crea una nueva plantilla con la misma configuración (Model, Domain, Position) y la establece como Default, la anterior se deseleccionará como predeterminada.
La plantilla es un campo html que se renderizará igual que una plantilla de correo, por lo que puede usar variables como {{object}}, {{user}}, {{ctx}} para añadir contenido dinámico.
Cambie el informe relacionado con el modelo desde la configuración y añada una declaración como:
\ \
\
\ \
\
Siempre debe usar t-if, ya que el método devuelve False si no se encuentra ninguna plantilla.
Si desea usar plantillas Qweb, o un contexto diferente, puede especificarlo igual que en mail.render.mixin con los parámetros:
- engine: "inline_template", "qweb" o "qweb_view",
- add_context: dict con su propio contexto,
- post_process: realiza un post procesamiento sobre el resultado renderizado
así podría usarlo:
\ \
\
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.