Odoo 20.0 Community · Persistente

mailing.mailing: campos, relaciones y API

El modelo mailing.mailing («Correo masivo») es un modelo persistente declarado por el módulo Marketing por correo electrónico y ampliado por 5 módulos más. Expone 119 campos, 87 de ellos declarados directamente en el modelo; 13 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: mailing.mailing
Etiqueta: Correo masivo
Tipo: Persistente (models.Model)
Tabla SQL: mailing_mailing
Módulo de origen: Marketing por correo electrónico (mass_mailing)
Ampliado por: marketing_card, marketing_card_event, mass_mailing_crm, mass_mailing_sms, mass_mailing_sale
Orden por defecto (_order): state ASC, calendar_date DESC, write_date DESC
Campo mostrado (_rec_name): subject
Hereda de (mixins): mail.thread mail.activity.mixin mail.render.mixin

Campos del modelo

87 campos propios, 26 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

119 de 119 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
ab_testing_completed	Ab Testing Completed	`boolean`	related: `campaign_id.ab_testing_completed`
ab_testing_description	Descripción de la prueba A/B	`html`	calculado
ab_testing_enabled	Permitir pruebas A/B Si se revisa, se hará solo un envío a los destinatarios para toda la campaña. Esto permite hacer diferentes envíos a unos destinatarios seleccionados al azar y comprobar la efectividad de los mismos sin enviar mensajes duplicados.	`boolean`
ab_testing_is_winner_mailing	Es el ganador de su campaña	`boolean`	calculado
ab_testing_mailings_count	Ab Testing Mailings Count	`integer`	related: `campaign_id.ab_testing_mailings_count`
ab_testing_mailings_sms_count	Ab Testing Mailings Sms Count	`integer`	related: `campaign_id.ab_testing_mailings_sms_count` añadido por Marketing por SMS (`mass_mailing_sms`)
ab_testing_pc	Porcentaje de prueba A/B Porcentaje de los contactos a los que se les enviará correo. Los destinatarios se tomarán aleatoriamente.	`integer`
ab_testing_schedule_datetime	Ab Testing Schedule Datetime	`datetime`	related: `campaign_id.ab_testing_schedule_datetime`
ab_testing_sms_winner_selection	Ab Testing Sms Winner Selection	`selection`	related: `campaign_id.ab_testing_sms_winner_selection` añadido por Marketing por SMS (`mass_mailing_sms`)
ab_testing_version_name	A/B Testing Version	`char`
ab_testing_winner_selection	Ab Testing Winner Selection	`selection`	related: `campaign_id.ab_testing_winner_selection`
active	Activo	`boolean`
attachment_ids	Archivos adjuntos	`many2many` → ir.attachment
body_arch	Contenido	`html`
body_html	Cuerpo convertido para enviar por correo	`html`
body_plaintext	Contenido del SMS	`text`	calculado, almacenado añadido por Marketing por SMS (`mass_mailing_sms`)
bounced	Rebotado	`integer`	calculado
bounced_ratio	Proporción de correos rebotados	`float`	calculado
calendar_date	Fecha del calendario Fecha en la que el correo se envió o se enviará.	`datetime`	calculado, almacenado
campaign_id	Campaña UTM	`many2one` → utm.campaign
canceled	Cancelado	`integer`	calculado
canceled_ratio	Cancelled Ratio	`float`	calculado
card_campaign_id	Campaña de tarjetas	`many2one` → card.campaign	añadido por Tarjeta de marketing (`marketing_card`)
card_lang	Card Language Language in which the cards will be rendered	`selection`	calculado, almacenado Valores calculados dinámicamente añadido por Tarjeta de marketing (`marketing_card`)
card_requires_sync_count	Número de tarjetas que necesitan sincronización	`integer`	calculado añadido por Tarjeta de marketing (`marketing_card`)
clicked	Cliqueado	`integer`	calculado
clicks_ratio	Número de clics	`float`	calculado
color	Índice de Colores	`integer`
contact_list_ids	Listas de correo	`many2many` → mailing.list
crm_lead_count	Número de leads/oportunidades	`integer`	calculado añadido por Mass mailing on lead / opportunities (`mass_mailing_crm`)
currency_id	Moneda	`many2one` → res.currency	calculado añadido por Mass mailing on sale orders (`mass_mailing_sale`)
delivered	Entregado	`integer`	calculado
email_from	Enviar desde	`char`	calculado, almacenado
expected	Esperado	`integer`	calculado
failed	Fallido	`integer`	calculado
is_ab_test_sent	Se envía la prueba Ab	`boolean`	calculado
is_body_empty	El cuerpo está vacío	`boolean`	calculado
is_template	Es una plantilla	`boolean`
keep_archives	Mantener Archivos	`boolean`
kpi_mail_required	Se requieren los indicadores de rendimiento clave del correo	`boolean`
link_trackers_count	Número de rastreadores de enlaces	`integer`	calculado
mail_server_available	Servidor del correo disponible Campo técnico que se usa para saber si el usuario activó la opción de servidor de correo de salida en los ajustes	`boolean`	calculado
mail_server_id	Servidor de correo Use un servidor de correo específico con prioridad. De lo contrario, Odoo depende en el primer servidor de correo de salida disponible (según su secuencia) como lo hace para los correos normales.	`many2one` → ir.mail_server
mailing_domain	Dominio	`char`	calculado, almacenado
mailing_filter_ids	Dynamic Lists	`many2many` → mailing.filter	calculado, almacenado
mailing_model_id	Modelo de destinatarios	`many2one` → ir.model	obligatoriocalculado, almacenado
mailing_model_name	Nombre del modelo de destinatarios	`char`	solo lectura related: `mailing_model_id.model`
mailing_model_real	Modelo real de destinatarios	`char`	calculado
mailing_on_mailing_list	Basado en las listas de correo	`boolean`	calculado
mailing_trace_ids	Estadísticas de correos	`one2many` → mailing.trace	inverso: `mass_mailing_id`
mailing_type	Tipo de correo	`selection`	obligatorio Valores: `mail` (Correo electrónico)
mailing_type_description	Descripción del tipo de correo	`char`	calculado
medium_id	Medio Medio UTM: método de entrega (correo electrónico, SMS...)	`many2one` → utm.medium	calculado, almacenado
next_departure	Fecha programada	`datetime`	calculado
next_departure_is_past	La próxima salida es en el pasado	`boolean`	calculado
opened	Abierto	`integer`	calculado
opened_ratio	Proporción de apertura	`float`	calculado
pending	Pendiente	`integer`	calculado
preview	Vista previa	`char`
process	Procesar	`integer`	calculado
received_ratio	Proporción recibida	`float`	calculado
recipients_count	# Of Recipients	`integer`	calculado
replied	Respondido	`integer`	calculado
replied_ratio	Proporción de respondidos	`float`	calculado
reply_to	Responder a Dirección de respuesta favorita	`char`	calculado, almacenado
reply_to_mode	Modo de Responder a Hilo: las respuestas van al documento de destino. Correo electrónico: las respuestas se dirigen a un correo electrónico determinado.	`selection`	calculado, almacenado Valores: `update` (Seguidores destinatarios), `new` (Dirección de correo electrónico especificada)
sale_invoiced_amount	Importe facturado	`monetary`	calculado añadido por Mass mailing on sale orders (`mass_mailing_sale`)
sale_quotation_count	Número de presupuestos	`integer`	calculado añadido por Mass mailing on sale orders (`mass_mailing_sale`)
schedule_date	Programado para	`datetime`	calculado, almacenado
schedule_type	Programar	`selection`	obligatorio Valores: `now` (Enviar ahora), `scheduled` (Enviar el)
scheduled	Planificado	`integer`	calculado
sent	Enviado	`integer`	calculado
sent_date	Fecha de envío	`datetime`
sms_allow_unsubscribe	Incluir enlace para darse de baja	`boolean`	añadido por Marketing por SMS (`mass_mailing_sms`)
sms_force_send	Enviar directamente Envíe el SMS de inmediato en lugar de hacerlo esperar. Use a su propio riesgo.	`boolean`	añadido por Marketing por SMS (`mass_mailing_sms`)
sms_has_insufficient_credit	Créditos IAP insuficientes	`boolean`	calculado añadido por Marketing por SMS (`mass_mailing_sms`)
sms_has_unregistered_account	Cuenta IAP no registrada	`boolean`	calculado añadido por Marketing por SMS (`mass_mailing_sms`)
sms_subject	Título For an email, the subject your recipients will see in their inbox. For an SMS, the internal title of the message.	`char`	related: `subject` añadido por Marketing por SMS (`mass_mailing_sms`)
sms_template_id	Plantilla de SMS	`many2one` → sms.template	añadido por Marketing por SMS (`mass_mailing_sms`)
source_id	Origen UTM Source: source tracking (mass_mailing, newsletter, mass_sms, ...)	`many2one` → utm.source	calculado, almacenado
state	Estado	`selection`	obligatorio Valores: `draft` (Borrador), `in_queue` (En cola), `sending` (Enviando), `done` (Enviado)
subject	Asunto	`char`	obligatorio
total	Total	`integer`	calculado
use_exclusion_list	Utilizar lista de exclusión Evita enviar mensajes a contactos que se encuentran en la lista negra. Desactiva esta función solo cuando sea absolutamente necesario.	`boolean`	calculado, almacenado
use_leads	Usar leads	`boolean`	calculado añadido por Mass mailing on lead / opportunities (`mass_mailing_crm`)
user_id	Responsable	`many2one` → res.users
warning_message	Mensaje de advertencia Mensaje de advertencia que se mostrará en la vista de la forma del correo	`char`	calculado
activity_calendar_event_id	Siguiente evento en el calendario de actividades.	`many2one` → calendar.event	calculado heredado de mail.activity.mixin
activity_date_deadline	Fecha límite de la siguiente actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
activity_exception_decoration	Decoración de Actividad de Excepción Tipo de actividad de excepción en el registro.	`selection`	calculado Valores: `warning` (Alerta), `danger` (Error) heredado de mail.activity.mixin
activity_exception_icon	Icono Icono para indicar una actividad de excepción.	`char`	calculado heredado de mail.activity.mixin
activity_ids	Actividades	`one2many` → mail.activity	inverso: `res_id` heredado de mail.activity.mixin
activity_plans_ids	Planes de actividades	`many2many` → mail.activity.plan	calculado heredado de mail.activity.mixin
activity_state	Estado de la actividad Status based on activities Overdue: Due date is already passed Today: Activity date is today Planned: Future activities.	`selection`	calculado Valores: `overdue` (De retraso), `today` (Hoy), `planned` (Planificado) heredado de mail.activity.mixin
activity_summary	Resumen de la siguiente actividad	`char`	related: `activity_ids.summary` heredado de mail.activity.mixin
activity_type_icon	Icono de tipo de actividad	`char`	related: `activity_ids.icon` heredado de mail.activity.mixin
activity_type_id	Tipo de la siguiente actividad	`many2one` → mail.activity.type	related: `activity_ids.activity_type_id` heredado de mail.activity.mixin
activity_user_id	Usuario responsable	`many2one` → res.users	solo lecturacalculado heredado de mail.activity.mixin
has_message	Tiene un mensaje	`boolean`	calculado heredado de mail.thread
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
message_attachment_count	Número de archivos adjuntos	`integer`	calculado heredado de mail.thread
message_follower_ids	Seguidores	`one2many` → mail.followers	inverso: `res_id` heredado de mail.thread
message_has_error	Error de envío de mensaje Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_has_error_counter	Número de errores Número de mensajes con error de envío	`integer`	calculado heredado de mail.thread
message_has_sms_error	Error de envío del SMS Si está marcada, algunos mensajes tienen error de envío.	`boolean`	calculado heredado de mail.thread
message_ids	Mensajes	`one2many` → mail.message	inverso: `res_id` heredado de mail.thread
message_is_follower	Es un seguidor	`boolean`	calculado heredado de mail.thread
message_needaction	Acción requerida Si está marcada, hay nuevos mensajes que requieren su atención.	`boolean`	calculado heredado de mail.thread
message_needaction_counter	Número de acciones Número de mensajes que requieren una acción	`integer`	calculado heredado de mail.thread
message_partner_ids	Seguidores (Contactos)	`many2many` → res.partner	calculado heredado de mail.thread
my_activity_date_deadline	Fecha límite de mi actividad	`date`	solo lecturacalculado heredado de mail.activity.mixin
rating_ids	Calificaciones	`one2many` → rating.rating	inverso: `res_id` heredado de mail.thread
render_model	Modelo de visualización	`char`	calculado heredado de mail.render.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

card.campaign: card_campaign_id
ir.attachment: attachment_ids
ir.mail_server: mail_server_id
ir.model: mailing_model_id
mailing.filter: mailing_filter_ids
mailing.list: contact_list_ids
mailing.trace: mailing_trace_ids
res.currency: currency_id
res.users: user_id
sms.template: sms_template_id
utm.campaign: campaign_id
utm.medium: medium_id
utm.source: source_id

Campos de otros modelos que apuntan aquí

link.tracker: mass_mailing_id
link.tracker.click: mass_mailing_id
mail.compose.message: mass_mailing_id
mail.mail: mailing_id
mail.message: source_mailing_id
mailing.list: mailing_ids
mailing.mailing.schedule.date: mass_mailing_id
mailing.mailing.test: mass_mailing_id
mailing.sms.test: mailing_id
mailing.trace: mass_mailing_id
sms.composer: mailing_id
sms.sms: mailing_id
utm.campaign: ab_testing_winner_mailing_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/mailing.mailing/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["subject","mailing_model_id","mailing_type","schedule_type","state"],"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}/mailing.mailing/search_read",
    headers=headers,
    json={"domain": [], "fields": ["subject","mailing_model_id","mailing_type","schedule_type","state"], "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/mailing-mailing">mailing.mailing (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