Odoo 20.0 Community · Persistente

mail.template: campos, relaciones y API

El modelo mail.template («Plantilla de correo electrónico») es un modelo persistente declarado por el módulo Conversaciones y ampliado por 3 módulos más. Expone 38 campos, 29 de ellos declarados directamente en el modelo; 39 campos de otros modelos apuntan a él. A continuación encontrará cada campo con su nombre técnico, tipo, etiqueta en español y relaciones, y un ejemplo de llamada a la API JSON-2 de Odoo 20.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: mail.template
Etiqueta: Plantilla de correo electrónico
Tipo: Persistente (models.Model)
Tabla SQL: mail_template
Módulo de origen: Conversaciones (mail)
Ampliado por: account, event, pos_self_order
Orden por defecto (_order): user_id, name, id
Hereda de (mixins): mail.render.mixin template.reset.mixin pos.load.mixin

Campos del modelo

29 campos propios, 3 heredados de mixins y 6 campos automáticos del ORM. Haga clic en un nombre para obtener el enlace directo al campo.

Ocultar los campos heredados

38 de 38 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
active	Activo	`boolean`
attachment_ids	Archivos adjuntos	`many2many` → ir.attachment
auto_delete	Eliminar automáticamente Esta opción borra cualquier rastro del envío del correo, incluido el menú Técnico en los Ajustes, para preservar el espacio de almacenamiento de su base de datos Odoo.	`boolean`
body_html	Contenido	`html`	traducible
can_write	Puede escribir El usuario actual puede editar la plantilla.	`boolean`	calculado
description	Descripción de la plantilla Este campo se utiliza para la descripción interna del uso de la plantilla.	`text`	traducible
email_cc	Cc Destinatarios en CC (se pueden utilizar marcadores de posición aquí)	`char`
email_from	Enviar desde Dirección del remitente (se pueden usar expresiones de campo aquí). Si no se establece, el valor por defecto será el alias de correo electrónico del autor si está configurado, o la dirección de correo electrónico.	`char`
email_layout_force_footer	Force Footer If checked, the footer will be always shown in the email body when this template is used withnotification layout.	`boolean`
email_layout_force_header	Force Header If checked, the header will be always shown in the email body when this template is used withnotification layout.	`boolean`
email_layout_xmlid	Diseño de notificación de correo electrónico	`char`
email_to	A (correos electrónicos) Direcciones de destinatarios separadas por comas (se pueden utilizar marcadores de posición aquí)	`char`
has_dynamic_reports	Tiene informes dinámicos	`boolean`	calculado
has_mail_server	Tiene un servidor de correo	`boolean`	calculado
is_template_editor	Es editor de plantilla	`boolean`	calculado
mail_server_id	Servidor de correo de salida Servidor de salida preferido (opcional). Si no está establecido, se usará el de mayor prioridad.	`many2one` → ir.mail_server
model	Modelo de documento relacionado	`char`	solo lectura related: `model_id.model`
model_id	Aplica a	`many2one` → ir.model
name	Nombre	`char`	traducible
partner_cc	Cc (Partners) Comma-separated ids of recipient Cc partners (placeholders may be used here)	`char`
partner_to	A (empresas) Comma-separated ids of recipient To partners (placeholders may be used here)	`char`
ref_ir_act_window	Acción de barra lateral Acción de la barra lateral para hacer disponible esta plantilla en los registros del modelo de documento relacionado	`many2one` → ir.actions.act_window	solo lectura
reply_to	Reply To Address	`char`
report_template_ids	Informes dinámicos	`many2many` → ir.actions.report
scheduled_date	Fecha programada Si esta opción está activada, el gerente de colas enviará el correo electrónico después de la fecha. Si no está activada, el correo electrónico se enviará lo antes posible. Puede utilizar expresiones dinámicas.	`char`
subject	Asunto Asunto (se pueden utilizar aquí expresiones de campos)	`char`	traducible
template_category	Categoría de la plantilla	`selection`	calculado Valores: `base_template` (Plantilla base), `hidden_template` (Plantilla oculta), `custom_template` (Plantilla personalizada)
use_default_to	Destinatarios por defecto Default recipients of the record: - partner (using id on a partner or the partner_id field) OR - email (using email_from or email field)	`boolean`
user_id	Propietario	`many2one` → res.users
lang	Idioma Idioma opcional de traducción (código ISO) para seleccionar al enviar un correo electrónico. Si no se especifica, se usará el idioma del contacto principal. Normalmente, debe ser una expresión de marcador de posición que proporcione el idioma adecuado, por ejemplo, {{ object.partner_id.lang }}.	`char`	heredado de mail.render.mixin
render_model	Modelo de visualización	`char`	calculado heredado de mail.render.mixin
template_fs	Nombre del archivo de la plantilla Archivo desde el que se origina la plantilla. Se utiliza para restablecer la plantilla rota.	`char`	heredado de template.reset.mixin
create_date	Creado el	`datetime`	solo lecturaautomático
create_uid	Creado por	`many2one` → res.users	solo lecturaautomático
display_name	Nombre mostrado	`char`	solo lecturacalculadoautomático
id	ID	`integer`	solo lecturaautomático
write_date	Última actualización el	`datetime`	solo lecturaautomático
write_uid	Última actualización por	`many2one` → res.users	solo lecturaautomático

Relaciones

Modelos enlazados desde este modelo

ir.actions.act_window: ref_ir_act_window
ir.actions.report: report_template_ids
ir.attachment: attachment_ids
ir.mail_server: mail_server_id
ir.model: model_id
res.users: user_id

Campos de otros modelos que apuntan aquí

account.move.send.wizard: template_id
applicant.get.refuse.reason: template_id
calendar.alarm: mail_template_id
calendar.event.archive.or.unlink.wizard: template_id
event.track.stage: mail_template_id
fleet.vehicle.send.mail: template_id
gamification.challenge: report_template_id
hr.applicant.refuse.reason: template_id
hr.recruitment.stage: template_id
ir.actions.server: template_id
loyalty.mail: mail_template_id
loyalty.program: mail_template_id
mail.activity: mail_template_ids
mail.activity.type: mail_template_ids
mail.compose.message: template_id
mail.composer.mixin: template_id
mail.message: source_template_id
mail.template.preview: mail_template_id
mail.template.reset: template_ids
pos.preset: mail_template_id
product.template: email_template_id
project.project.stage: mail_template_id
project.task.type: mail_template_id, rating_template_id
res.company: stock_mail_confirmation_template_id
res.config.settings: cart_recovery_mail_template, confirmation_email_template_id, invoice_mail_template_id, rating_email_template_id
sale.order: pending_email_template_id
sale.order.template: mail_template_id
slide.channel: completed_template_id, publish_template_id, share_channel_template_id, share_slide_template_id
survey.survey: certification_mail_template_id
website: cart_recovery_mail_template_id, confirmation_email_template_id, rating_email_template_id

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 20: lectura de los cinco primeros registros con campos reales del modelo. Sustituya la instancia, la base y la clave API por las suyas.

curl

curl -X POST "https://su-instancia.odoo.com/json/2/mail.template/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","mail_server_id","model_id","ref_ir_act_window","user_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://su-instancia.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "su-base"}

res = requests.post(
    f"{BASE_URL}/mail.template/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","mail_server_id","model_id","ref_ir_act_window","user_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

El acceso a la API externa está reservado al plan Custom de Odoo.
XML-RPC y JSON-RPC se retirarán en Odoo 22 (otoño de 2028): use JSON-2.
Se aplican los permisos de acceso y las reglas de registro del usuario de la clave.

Citar esta herramienta

¿Escribe un tutorial, una documentación interna o una respuesta en un foro? Copie este enlace para dirigir a sus lectores a la ficha actualizada.

<a href="https://aidoo.ai/es/outils/explorateur-modeles-odoo/mail-template">mail.template (Odoo 20.0)</a>

Fuentes

Datos verificados el 25 de septiembre de 2026 · Odoo 20.0 Community

¿Tiene un proyecto Odoo o quiere aprovechar su ERP con la IA? Hablemos

Implantación, desarrollo de módulos, conexión de Claude o ChatGPT a sus datos: cuéntenos su contexto y le responderemos en 24 horas laborables.

Contactarnos Ver una demo