Odoo 20.0 Community · Persistente

snailmail.letter: campos, relaciones y API

El modelo snailmail.letter («Carta por correo postal») es un modelo persistente declarado por el módulo Snail Mail. Expone 31 campos, 25 de ellos declarados directamente en el modelo; 1 campo de otros modelos apunta 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: snailmail.letter
Etiqueta: Carta por correo postal
Tipo: Persistente (models.Model)
Tabla SQL: snailmail_letter
Módulo de origen: Snail Mail (snailmail)

Campos del modelo

25 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

31 de 31 campos mostrados

Nombre técnico	Etiqueta	Tipo	Detalles
attachment_fname	Nombre del archivo adjunto	`char`	related: `attachment_id.name`
attachment_id	Archivo adjunto	`many2one` → ir.attachment
attachment_raw	Documento	`binary`	related: `attachment_id.raw`
city	Ciudad	`char`
color	Color	`boolean`
company_id	Compañía	`many2one` → res.company	obligatoriosolo lectura
country_id	País	`many2one` → res.country
cover	Página de portada	`boolean`
duplex	Ambos lados	`boolean`
error_code	Error	`selection`	Valores calculados dinámicamente
info_msg	Información	`html`
letter_uid	Snailmail letter ID	`char`
message_id	Mensaje del estado de correo postal	`many2one` → mail.message
model	Modelo	`char`	obligatorio
notification_ids	Notificaciones	`one2many` → mail.notification	inverso: `letter_id`
partner_id	Destinatario	`many2one` → res.partner	obligatorio
reference	Registro relacionado	`char`	solo lecturacalculado
report_template	Informe opcional a generar y adjuntar	`many2one` → ir.actions.report
res_id	ID del documento	`integer`	obligatorio
state	Estado When a letter is created, the status is 'Pending'. If the letter is correctly sent to provider, the status goes in 'process', If the provider confirms the letter is delivered, the status goes in 'Sent'. If not sent or delivered, it will got in state 'Error' and the error message will be displayed in the field 'Error Message'.	`selection`	obligatoriosolo lectura Valores: `pending` (En cola), `process` (Procesando), `sent` (Enviado), `error` (Error), `canceled` (Cancelado)
state_id	Estado	`many2one` → res.country.state
street	Calle	`char`
street2	Calle2	`char`
user_id	Enviado por	`many2one` → res.users
zip	C.P.	`char`
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.report: report_template
ir.attachment: attachment_id
mail.message: message_id
mail.notification: notification_ids
res.company: company_id
res.country: country_id
res.country.state: state_id
res.partner: partner_id
res.users: user_id

Campos de otros modelos que apuntan aquí

mail.notification: letter_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/snailmail.letter/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: su-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["company_id","model","partner_id","res_id","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}/snailmail.letter/search_read",
    headers=headers,
    json={"domain": [], "fields": ["company_id","model","partner_id","res_id","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/snailmail-letter">snailmail.letter (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