Créer un tiers
create_tiersDescription
Crée dans Oxygenius un tiers (client, fournisseur ou contact), société ou personne. Raison sociale ou nom obligatoire. Régime de TVA et condition de paiement : ceux proposés par défaut par l'application, sinon à choisir dans get_reference_lists. L'application cherche d'abord des tiers semblables (même nom, même société ou même adresse) : s'il y en a, rien n'est créé et ils sont renvoyés dans possibleDuplicates ; ne rappeler avec allowDuplicate qu'après l'accord explicite de l'utilisateur. Avant l'appel, annoncer le tiers à créer et attendre l'accord de l'utilisateur. Données bancaires, identifiants Peppol, remise et remarques ne sont jamais modifiés par cet outil.
Accès requis
- Permission :
tiers.new-tiers.create - Société ouverte aux outils d'écriture (Paramètres → Intégration IA).
- Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
companyName | string | facultatif | Raison sociale (société). |
lastName | string | facultatif | Nom de la personne (ou du contact de la société). |
firstName | string | facultatif | Prénom. |
vatNumber | string | facultatif | Numéro de TVA précédé du code pays, ex. BE0123456789 (check_vat le vérifie). |
companyNumber | string | facultatif | Numéro d'entreprise (BCE), 10 caractères au plus sans points ni espaces. |
vatRegimeId | integer | facultatif | Régime de TVA (champ id de vatRegimes dans get_reference_lists) ; par défaut, celui proposé par l'application. |
email | string | facultatif | Courriel principal. |
billingEmail | string | facultatif | Courriel de facturation. |
phone1 | string | facultatif | Téléphone principal, avec l'indicatif (ex. +32 81 12 34 56). |
phone2 | string | facultatif | Second téléphone. |
website | string | facultatif | Site web. |
address | object | facultatif | Adresse (rue obligatoire si l'adresse est fournie). |
address.street | string | facultatif | Rue. |
address.number | string | facultatif | Numéro. |
address.box | string | facultatif | Boîte. |
address.postCode | string | facultatif | Code postal. |
address.city | string | facultatif | Localité. |
address.country | string | facultatif | Code pays ISO à deux lettres (BE par défaut pour une nouvelle adresse). |
isSupplier | boolean | facultatif | Vrai pour un fournisseur (faux par défaut). |
paymentTermId | integer | facultatif | Condition de paiement (champ id de paymentTerms dans get_reference_lists) ; par défaut, celle proposée par l'application. |
allowDuplicate | boolean | facultatif | Vrai pour créer malgré les tiers semblables renvoyés par un premier appel, avec l'accord explicite de l'utilisateur. |
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
created | boolean | Vrai si le tiers a été créé ; faux si l'application a trouvé des tiers semblables, et rien n'a été créé. | |
tiers | object | peut être null | Le tiers créé (absent si rien n'a été créé). |
tiers.id | integer | Identifiant technique du tiers. | |
tiers.reference | string | peut être null | Référence du tiers. |
tiers.name | string | Dénomination : société, sinon nom et prénom. | |
tiers.companyName | string | peut être null | Raison sociale. |
tiers.lastName | string | peut être null | Nom de la personne. |
tiers.firstName | string | peut être null | Prénom de la personne. |
tiers.kind | string | company ou individual. | |
tiers.isSupplier | boolean | Vrai pour un fournisseur. | |
tiers.isActive | boolean | Faux si le tiers est en sommeil. | |
tiers.isDefaultContact | boolean | Vrai si le tiers est un contact par défaut. | |
tiers.email | string | peut être null | Courriel principal. |
tiers.billingEmail | string | peut être null | Courriel de facturation. |
tiers.phone1 | string | peut être null | Téléphone principal. |
tiers.phone2 | string | peut être null | Second téléphone. |
tiers.website | string | peut être null | Site web. |
tiers.address | string | peut être null | Adresse postale. |
tiers.vatNumber | string | peut être null | Numéro de TVA, précédé du code pays. |
tiers.companyNumber | string | peut être null | Numéro d'entreprise (BCE). |
tiers.vatRegime | string | peut être null | Régime de TVA appliqué au tiers. |
tiers.paymentTerm | string | peut être null | Condition de paiement. |
tiers.peppolIds | string[] | Identifiants Peppol (facturation électronique). | |
tiers.dossierCount | integer | peut être null | Nombre de dossiers visibles où le tiers intervient (null sans accès aux dossiers). |
tiers.recentDossiers | object[] | Dossiers les plus récents où le tiers intervient, avec son rôle (vide sans accès aux dossiers). | |
tiers.recentDossiers[].dossierId | integer | Identifiant technique du dossier (à passer à get_dossier). | |
tiers.recentDossiers[].reference | string | peut être null | Référence du dossier. |
tiers.recentDossiers[].indication | string | peut être null | Intitulé court du dossier. |
tiers.recentDossiers[].role | string | peut être null | Rôle du tiers dans le dossier (propriétaire, locataire, contact…). |
possibleDuplicates | object[] | Tiers semblables (même nom, même société ou même adresse) : les montrer à l'utilisateur ; ne créer quand même qu'avec son accord explicite, en rappelant l'outil avec allowDuplicate. | |
possibleDuplicates[].id | integer | Identifiant technique du tiers (à passer à get_tiers). | |
possibleDuplicates[].reference | string | peut être null | Référence du tiers. |
possibleDuplicates[].name | string | Dénomination : société, sinon nom et prénom. | |
possibleDuplicates[].kind | string | company (société renseignée) ou individual (personne). | |
possibleDuplicates[].isSupplier | boolean | Vrai pour un fournisseur. | |
possibleDuplicates[].isActive | boolean | Faux si le tiers est en sommeil. | |
possibleDuplicates[].email | string | peut être null | Courriel principal. |
possibleDuplicates[].phone | string | peut être null | Téléphone principal. |
possibleDuplicates[].city | string | peut être null | Code postal et localité. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Créer un tiers | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | non | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"name": "create_tiers",
"title": "Créer un tiers",
"description": "Crée dans Oxygenius un tiers (client, fournisseur ou contact), société ou personne. Raison sociale ou nom obligatoire. Régime de TVA et condition de paiement : ceux proposés par défaut par l'application, sinon à choisir dans get_reference_lists. L'application cherche d'abord des tiers semblables (même nom, même société ou même adresse) : s'il y en a, rien n'est créé et ils sont renvoyés dans possibleDuplicates ; ne rappeler avec allowDuplicate qu'après l'accord explicite de l'utilisateur. Avant l'appel, annoncer le tiers à créer et attendre l'accord de l'utilisateur. Données bancaires, identifiants Peppol, remise et remarques ne sont jamais modifiés par cet outil.",
"inputSchema": {
"type": "object",
"properties": {
"companyName": {
"description": "Raison sociale (société).",
"type": [
"string",
"null"
],
"default": null
},
"lastName": {
"description": "Nom de la personne (ou du contact de la société).",
"type": [
"string",
"null"
],
"default": null
},
"firstName": {
"description": "Prénom.",
"type": [
"string",
"null"
],
"default": null
},
"vatNumber": {
"description": "Numéro de TVA précédé du code pays, ex. BE0123456789 (check_vat le vérifie).",
"type": [
"string",
"null"
],
"default": null
},
"companyNumber": {
"description": "Numéro d'entreprise (BCE), 10 caractères au plus sans points ni espaces.",
"type": [
"string",
"null"
],
"default": null
},
"vatRegimeId": {
"description": "Régime de TVA (champ id de vatRegimes dans get_reference_lists) ; par défaut, celui proposé par l'application.",
"type": [
"integer",
"null"
],
"default": null
},
"email": {
"description": "Courriel principal.",
"type": [
"string",
"null"
],
"default": null
},
"billingEmail": {
"description": "Courriel de facturation.",
"type": [
"string",
"null"
],
"default": null
},
"phone1": {
"description": "Téléphone principal, avec l'indicatif (ex. +32 81 12 34 56).",
"type": [
"string",
"null"
],
"default": null
},
"phone2": {
"description": "Second téléphone.",
"type": [
"string",
"null"
],
"default": null
},
"website": {
"description": "Site web.",
"type": [
"string",
"null"
],
"default": null
},
"address": {
"description": "Adresse (rue obligatoire si l'adresse est fournie).",
"type": [
"object",
"null"
],
"properties": {
"street": {
"description": "Rue.",
"type": [
"string",
"null"
]
},
"number": {
"description": "Numéro.",
"type": [
"string",
"null"
]
},
"box": {
"description": "Boîte.",
"type": [
"string",
"null"
]
},
"postCode": {
"description": "Code postal.",
"type": [
"string",
"null"
]
},
"city": {
"description": "Localité.",
"type": [
"string",
"null"
]
},
"country": {
"description": "Code pays ISO à deux lettres (BE par défaut pour une nouvelle adresse).",
"type": [
"string",
"null"
]
}
},
"default": null
},
"isSupplier": {
"description": "Vrai pour un fournisseur (faux par défaut).",
"type": "boolean",
"default": false
},
"paymentTermId": {
"description": "Condition de paiement (champ id de paymentTerms dans get_reference_lists) ; par défaut, celle proposée par l'application.",
"type": [
"integer",
"null"
],
"default": null
},
"allowDuplicate": {
"description": "Vrai pour créer malgré les tiers semblables renvoyés par un premier appel, avec l'accord explicite de l'utilisateur.",
"type": "boolean",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"created": {
"description": "Vrai si le tiers a été créé ; faux si l'application a trouvé des tiers semblables, et rien n'a été créé.",
"type": "boolean"
},
"tiers": {
"description": "Le tiers créé (absent si rien n'a été créé).",
"type": [
"object",
"null"
],
"properties": {
"id": {
"description": "Identifiant technique du tiers.",
"type": "integer"
},
"reference": {
"description": "Référence du tiers.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Dénomination : société, sinon nom et prénom.",
"type": "string"
},
"companyName": {
"description": "Raison sociale.",
"type": [
"string",
"null"
]
},
"lastName": {
"description": "Nom de la personne.",
"type": [
"string",
"null"
]
},
"firstName": {
"description": "Prénom de la personne.",
"type": [
"string",
"null"
]
},
"kind": {
"description": "company ou individual.",
"type": "string"
},
"isSupplier": {
"description": "Vrai pour un fournisseur.",
"type": "boolean"
},
"isActive": {
"description": "Faux si le tiers est en sommeil.",
"type": "boolean"
},
"isDefaultContact": {
"description": "Vrai si le tiers est un contact par défaut.",
"type": "boolean"
},
"email": {
"description": "Courriel principal.",
"type": [
"string",
"null"
]
},
"billingEmail": {
"description": "Courriel de facturation.",
"type": [
"string",
"null"
]
},
"phone1": {
"description": "Téléphone principal.",
"type": [
"string",
"null"
]
},
"phone2": {
"description": "Second téléphone.",
"type": [
"string",
"null"
]
},
"website": {
"description": "Site web.",
"type": [
"string",
"null"
]
},
"address": {
"description": "Adresse postale.",
"type": [
"string",
"null"
]
},
"vatNumber": {
"description": "Numéro de TVA, précédé du code pays.",
"type": [
"string",
"null"
]
},
"companyNumber": {
"description": "Numéro d'entreprise (BCE).",
"type": [
"string",
"null"
]
},
"vatRegime": {
"description": "Régime de TVA appliqué au tiers.",
"type": [
"string",
"null"
]
},
"paymentTerm": {
"description": "Condition de paiement.",
"type": [
"string",
"null"
]
},
"peppolIds": {
"description": "Identifiants Peppol (facturation électronique).",
"type": "array",
"items": {
"type": "string"
}
},
"dossierCount": {
"description": "Nombre de dossiers visibles où le tiers intervient (null sans accès aux dossiers).",
"type": [
"integer",
"null"
]
},
"recentDossiers": {
"description": "Dossiers les plus récents où le tiers intervient, avec son rôle (vide sans accès aux dossiers).",
"type": "array",
"items": {
"type": "object",
"properties": {
"dossierId": {
"description": "Identifiant technique du dossier (à passer à get_dossier).",
"type": "integer"
},
"reference": {
"description": "Référence du dossier.",
"type": [
"string",
"null"
]
},
"indication": {
"description": "Intitulé court du dossier.",
"type": [
"string",
"null"
]
},
"role": {
"description": "Rôle du tiers dans le dossier (propriétaire, locataire, contact…).",
"type": [
"string",
"null"
]
}
},
"required": [
"dossierId"
]
}
}
},
"required": [
"id",
"name",
"kind",
"isSupplier",
"isActive",
"isDefaultContact"
]
},
"possibleDuplicates": {
"description": "Tiers semblables (même nom, même société ou même adresse) : les montrer à l'utilisateur ; ne créer quand même qu'avec son accord explicite, en rappelant l'outil avec allowDuplicate.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Identifiant technique du tiers (à passer à get_tiers).",
"type": "integer"
},
"reference": {
"description": "Référence du tiers.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Dénomination : société, sinon nom et prénom.",
"type": "string"
},
"kind": {
"description": "company (société renseignée) ou individual (personne).",
"type": "string"
},
"isSupplier": {
"description": "Vrai pour un fournisseur.",
"type": "boolean"
},
"isActive": {
"description": "Faux si le tiers est en sommeil.",
"type": "boolean"
},
"email": {
"description": "Courriel principal.",
"type": [
"string",
"null"
]
},
"phone": {
"description": "Téléphone principal.",
"type": [
"string",
"null"
]
},
"city": {
"description": "Code postal et localité.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"kind",
"isSupplier",
"isActive"
]
}
}
},
"required": [
"created"
]
},
"annotations": {
"title": "Créer un tiers",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}