Créer un tiers

Nom de l'outilcreate_tiers
Écriture

Description

Texte exact envoyé au modèle par tools/list :

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

Paramètres

NomTypePrésenceDescription
companyNamestringfacultatifRaison sociale (société).
lastNamestringfacultatifNom de la personne (ou du contact de la société).
firstNamestringfacultatifPrénom.
vatNumberstringfacultatifNuméro de TVA précédé du code pays, ex. BE0123456789 (check_vat le vérifie).
companyNumberstringfacultatifNuméro d'entreprise (BCE), 10 caractères au plus sans points ni espaces.
vatRegimeIdintegerfacultatifRégime de TVA (champ id de vatRegimes dans get_reference_lists) ; par défaut, celui proposé par l'application.
emailstringfacultatifCourriel principal.
billingEmailstringfacultatifCourriel de facturation.
phone1stringfacultatifTéléphone principal, avec l'indicatif (ex. +32 81 12 34 56).
phone2stringfacultatifSecond téléphone.
websitestringfacultatifSite web.
addressobjectfacultatifAdresse (rue obligatoire si l'adresse est fournie).
address.streetstringfacultatifRue.
address.numberstringfacultatifNuméro.
address.boxstringfacultatifBoîte.
address.postCodestringfacultatifCode postal.
address.citystringfacultatifLocalité.
address.countrystringfacultatifCode pays ISO à deux lettres (BE par défaut pour une nouvelle adresse).
isSupplierbooleanfacultatifVrai pour un fournisseur (faux par défaut).
Par défaut : false
paymentTermIdintegerfacultatifCondition de paiement (champ id de paymentTerms dans get_reference_lists) ; par défaut, celle proposée par l'application.
allowDuplicatebooleanfacultatifVrai pour créer malgré les tiers semblables renvoyés par un premier appel, avec l'accord explicite de l'utilisateur.
Par défaut : false

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
NomTypePrésenceDescription
createdbooleanVrai si le tiers a été créé ; faux si l'application a trouvé des tiers semblables, et rien n'a été créé.
tiersobjectpeut être nullLe tiers créé (absent si rien n'a été créé).
tiers.idintegerIdentifiant technique du tiers.
tiers.referencestringpeut être nullRéférence du tiers.
tiers.namestringDénomination : société, sinon nom et prénom.
tiers.companyNamestringpeut être nullRaison sociale.
tiers.lastNamestringpeut être nullNom de la personne.
tiers.firstNamestringpeut être nullPrénom de la personne.
tiers.kindstringcompany ou individual.
tiers.isSupplierbooleanVrai pour un fournisseur.
tiers.isActivebooleanFaux si le tiers est en sommeil.
tiers.isDefaultContactbooleanVrai si le tiers est un contact par défaut.
tiers.emailstringpeut être nullCourriel principal.
tiers.billingEmailstringpeut être nullCourriel de facturation.
tiers.phone1stringpeut être nullTéléphone principal.
tiers.phone2stringpeut être nullSecond téléphone.
tiers.websitestringpeut être nullSite web.
tiers.addressstringpeut être nullAdresse postale.
tiers.vatNumberstringpeut être nullNuméro de TVA, précédé du code pays.
tiers.companyNumberstringpeut être nullNuméro d'entreprise (BCE).
tiers.vatRegimestringpeut être nullRégime de TVA appliqué au tiers.
tiers.paymentTermstringpeut être nullCondition de paiement.
tiers.peppolIdsstring[]Identifiants Peppol (facturation électronique).
tiers.dossierCountintegerpeut être nullNombre de dossiers visibles où le tiers intervient (null sans accès aux dossiers).
tiers.recentDossiersobject[]Dossiers les plus récents où le tiers intervient, avec son rôle (vide sans accès aux dossiers).
tiers.recentDossiers[].dossierIdintegerIdentifiant technique du dossier (à passer à get_dossier).
tiers.recentDossiers[].referencestringpeut être nullRéférence du dossier.
tiers.recentDossiers[].indicationstringpeut être nullIntitulé court du dossier.
tiers.recentDossiers[].rolestringpeut être nullRôle du tiers dans le dossier (propriétaire, locataire, contact…).
possibleDuplicatesobject[]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[].idintegerIdentifiant technique du tiers (à passer à get_tiers).
possibleDuplicates[].referencestringpeut être nullRéférence du tiers.
possibleDuplicates[].namestringDénomination : société, sinon nom et prénom.
possibleDuplicates[].kindstringcompany (société renseignée) ou individual (personne).
possibleDuplicates[].isSupplierbooleanVrai pour un fournisseur.
possibleDuplicates[].isActivebooleanFaux si le tiers est en sommeil.
possibleDuplicates[].emailstringpeut être nullCourriel principal.
possibleDuplicates[].phonestringpeut être nullTéléphone principal.
possibleDuplicates[].citystringpeut être nullCode postal et localité.

Annotations MCP

AnnotationValeurSignification
titleCréer un tiersNom lisible affiché par le client MCP.
readOnlyHintnonL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintnonRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintnonL'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
  }
}