Odoo 19.0 Community · Persistente

mail.mail: campos, relaciones y API

El modelo mail.mail («Correos electrónicos salientes») es un modelo persistente declarado por el módulo Conversaciones y ampliado por 1 módulo más. Expone 27 campos, 21 de ellos declarados directamente en el modelo; 2 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 19.

Ver el código fuente Buscar otro modelo

Ficha de identidad

Nombre técnico: mail.mail
Etiqueta: Correos electrónicos salientes
Tipo: Persistente (models.Model)
Tabla SQL: mail_mail
Módulo de origen: Conversaciones (mail)
Ampliado por: mass_mailing
Orden por defecto (_order): id desc
Campo mostrado (_rec_name): subject
Delegación (_inherits): mail.message: los campos de este modelo también están disponibles, mediante mail_message_id

Campos del modelo

21 campos propios, 0 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

27 de 27 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
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_content	Contenido con texto enriquecido	`html`	calculado
body_html	Contenidos del texto Mensaje de texto enriquecido/HTML	`text`
email_cc	Cc Destinatarios en CC del mensaje	`char`
email_to	A Destinatarios del mensaje (correos electrónicos)	`text`
failure_reason	Razón del fallo Razón del error. Por lo general es la excepción lanzada por el servidor de correo electrónico y se almacena para facilitar la eliminación de errores.	`text`	solo lectura
failure_type	Tipo de fallo	`selection`	Valores: `unknown` (Error desconocido), `mail_spam` (Detectado como spam), `mail_email_invalid` (Dirección de correo electrónico no válida), `mail_email_missing` (Correo electrónico faltante), `mail_from_invalid` (No válido desde la dirección), `mail_from_missing` (Falta en la dirección), `mail_smtp` (Error de conexión (problema del servidor de correo de salida)), `mail_bl` (Direcciones incluidas en la lista negra), `mail_optout` (Exclusión voluntaria), `mail_dup` (Correo electrónico duplicado)
fetchmail_server_id	Servidor de correo de entrada	`many2one` → fetchmail.server	solo lectura
headers	Encabezados	`text`
is_notification	Correo electrónico de notificación Se ha creado un correo electrónico para notificar a la gente de un mensaje existente	`boolean`
mail_message_id	Mensaje	`many2one` → mail.message	obligatorio
mail_message_id_int	Int ID del mensaje de correo	`integer`	calculado
mailing_id	Correo masivo	`many2one` → mailing.mailing	añadido por Marketing por correo electrónico (`mass_mailing`)
mailing_trace_ids	Estadísticas	`one2many` → mailing.trace	inverso: `mail_mail_id` añadido por Marketing por correo electrónico (`mass_mailing`)
message_type	Tipo de mensaje	`selection`	related: `mail_message_id.message_type`
recipient_ids	A (empresas)	`many2many` → res.partner
references	Referencias Referencias del mensaje, tales como identificadores de mensajes anteriores	`text`	solo lectura
restricted_attachment_count	Archivos adjuntos restringidos	`integer`	calculado
scheduled_date	Fecha de envío programada Si se establece, el gerente de tareas enviará el correo electrónico después de la fecha. Si se establece, el correo electrónico se enviará lo antes posible. A menos que se especifique una zona horaria, se considerará que está en la zona horaria UTC.	`datetime`
state	Estado	`selection`	solo lectura Valores: `outgoing` (Saliente), `sent` (Enviado), `received` (Recibido), `exception` (Entrega fallida), `cancel` (Cancelado)
unrestricted_attachment_ids	Archivos adjuntos sin restricción	`many2many` → ir.attachment	calculado
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

fetchmail.server: fetchmail_server_id
ir.attachment: unrestricted_attachment_ids
mail.message: mail_message_id
mailing.mailing: mailing_id
mailing.trace: mailing_trace_ids
res.partner: recipient_ids

Campos de otros modelos que apuntan aquí

mail.notification: mail_mail_id
mailing.trace: mail_mail_id

Leer este modelo por la API

Ejemplo de llamada a la API JSON-2 de Odoo 19: 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.mail/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["mail_message_id","state","fetchmail_server_id","mailing_id","auto_delete"],"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.mail/search_read",
    headers=headers,
    json={"domain": [], "fields": ["mail_message_id","state","fetchmail_server_id","mailing_id","auto_delete"], "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-mail">mail.mail (Odoo 19.0)</a>

Fuentes

Datos verificados el 23 de septiembre de 2026 · Odoo 19.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