Odoo 19.0 Community · Persistant

fetchmail.server : champs, relations et API

Le modèle fetchmail.server (« Serveur de messagerie entrant ») est un modèle persistant déclaré par le module Discussion, puis enrichi par 2 autres modules. Il expose 34 champs, dont 20 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 19.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: fetchmail.server
Libellé: Serveur de messagerie entrant
Type: Persistant (models.Model)
Table SQL: fetchmail_server
Module d'origine: Discussion (mail)
Étendu par: google_gmail, microsoft_outlook
Tri par défaut (_order): priority
Hérite de (mixins): google.gmail.mixin microsoft.outlook.mixin

Champs du modèle

20 champs propres, 8 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

34 champs affichés sur 34

Nom technique	Libellé	Type	Détails
active	Actif	`boolean`
attach	Conserver les pièces jointes Si les pièces jointes doivent être ou non téléchargées. Si cela n'est pas activé, les e-mails entrants seront détachés de leurs pièces jointes avant d'être traités.	`boolean`
configuration	Configuration	`text`	lecture seule
date	Date de la dernière récupération	`datetime`	lecture seule
error_date	Date de la dernière erreur Date du dernier échec, réinitialisée en cas de réussite.	`datetime`	lecture seule
error_message	Dernier message d’erreur	`text`	lecture seule
is_ssl	SSL/TLS Les connexions sont chiffrées via SSL/TLS au travers d'un port dédié (par défaut : IMAPS=993, POP3S=995)	`boolean`
message_ids	Messages	`one2many` → mail.mail	lecture seule inverse : `fetchmail_server_id`
name	Nom	`char`	requis
object_id	Créer un nouvel enregistrement Traiter chaque e-mail entrant comme une partie de conversation correspondant à ce type de documents. Cela créera un nouveau document pour chaque nouvelle conversation, or attachera les e-mails à une conversation (document) existante.	`many2one` → ir.model
original	Conserver l'original Une copie originale complète de chaque e-mail doit être conservée comme référence et attachée à chaque message traité. Cela engendrera le doublement de la taille de votre base de données des messages.	`boolean`
password	Mot de passe	`char`
port	Port	`integer`
priority	Priorité du serveur Définit l'ordre de traitement, les valeurs les moins élevées correspondent à une haute priorité	`integer`
script	Script	`char`	lecture seule
server	Nom du serveur Nom de domaine ou adresse IP du serveur e-mail	`char`
server_type	Type de serveur	`selection`	requis Valeurs : `imap` (Serveur IMAP), `pop` (Serveur POP), `local` (Serveur local)
server_type_info	Informations sur le type de serveur	`text`	calculé
state	Statut	`selection`	lecture seule Valeurs : `draft` (Non confirmé), `done` (Confirmé)
user	Nom d'utilisateur	`char`
google_gmail_access_token	Jeton d'accès	`char`	hérité de google.gmail.mixin
google_gmail_access_token_expiration	Horodatage de l'expiration du jeton d'accès	`integer`	hérité de google.gmail.mixin
google_gmail_refresh_token	Actualiser le jeton	`char`	hérité de google.gmail.mixin
google_gmail_uri	URI L'URL pour générer le code d'autorisation de Google	`char`	calculé hérité de google.gmail.mixin
microsoft_outlook_access_token	Jeton d'accès Outlook	`char`	hérité de microsoft.outlook.mixin
microsoft_outlook_access_token_expiration	Horodatage de l'expiration du jeton d'accès Outlook	`integer`	hérité de microsoft.outlook.mixin
microsoft_outlook_refresh_token	Actualiser le jeton Outlook	`char`	hérité de microsoft.outlook.mixin
microsoft_outlook_uri	Authentification URI L'URL pour générer le code d'autorisation à partir d'Outlook	`char`	calculé hérité de microsoft.outlook.mixin
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.model : object_id
mail.mail : message_ids

Champs d'autres modèles qui pointent ici

mail.mail : fetchmail_server_id

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 19 : 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/fetchmail.server/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","server_type","state","object_id","active"],"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}/fetchmail.server/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","server_type","state","object_id","active"], "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/fetchmail-server">fetchmail.server (Odoo 19.0)</a>

Sources

Données vérifiées le 23 septembre 2026 · Odoo 19.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