Odoo 20.0 Community · Persistant

snailmail.letter : champs, relations et API

Le modèle snailmail.letter (« Lettre postale ») est un modèle persistant déclaré par le module Snail Mail. Il expose 31 champs, dont 25 déclarés directement sur le modèle ; 1 champ d'autres modèles pointe vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 20.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: snailmail.letter
Libellé: Lettre postale
Type: Persistant (models.Model)
Table SQL: snailmail_letter
Module d'origine: Snail Mail (snailmail)

Champs du modèle

25 champs propres, 0 hérités des mixins et 6 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

31 champs affichés sur 31

Nom technique	Libellé	Type	Détails
attachment_fname	Nom du fichier en pièce jointe	`char`	related : `attachment_id.name`
attachment_id	Pièce jointe	`many2one` → ir.attachment
attachment_raw	Document	`binary`	related : `attachment_id.raw`
city	Ville	`char`
color	Couleur	`boolean`
company_id	Société	`many2one` → res.company	requislecture seule
country_id	Pays	`many2one` → res.country
cover	Page de couverture	`boolean`
duplex	Recto-verso	`boolean`
error_code	Erreur	`selection`	Valeurs calculées dynamiquement
info_msg	Informations	`html`
letter_uid	Snailmail letter ID	`char`
message_id	Message de statut de l'envoi postal	`many2one` → mail.message
model	Modèle	`char`	requis
notification_ids	Notifications	`one2many` → mail.notification	inverse : `letter_id`
partner_id	Destinataire	`many2one` → res.partner	requis
reference	Enregistrement relatif	`char`	lecture seulecalculé
report_template	Rapport facultatif à imprimer et à joindre	`many2one` → ir.actions.report
res_id	ID document	`integer`	requis
state	Statut 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`	requislecture seule Valeurs : `pending` (Dans la file d'attente), `process` (En cours de traitement), `sent` (Envoyé), `error` (Erreur), `canceled` (Annulé)
state_id	Statut	`many2one` → res.country.state
street	Rue	`char`
street2	Rue 2	`char`
user_id	Envoyé par	`many2one` → res.users
zip	Code postal	`char`
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
display_name	Nom affiché	`char`	lecture seulecalculéautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

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

Champs d'autres modèles qui pointent ici

mail.notification : letter_id

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 20 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/snailmail.letter/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-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://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-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())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/snailmail-letter">snailmail.letter (Odoo 20.0)</a>

Sources

Données vérifiées le 25 septembre 2026 · Odoo 20.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo