Créer un tiers

Tool namecreate_tiers
Write

Creates a customer, supplier or contact. If similar third parties exist, nothing is created and they are returned as possible duplicates.

Description

Exact text sent to the model by tools/list (French, the language of the data):

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.

Required access

Parameters

NameTypePresenceDescription
companyNamestringoptionalRaison sociale (société).
lastNamestringoptionalNom de la personne (ou du contact de la société).
firstNamestringoptionalPrénom.
vatNumberstringoptionalNuméro de TVA précédé du code pays, ex. BE0123456789 (check_vat le vérifie).
companyNumberstringoptionalNuméro d'entreprise (BCE), 10 caractères au plus sans points ni espaces.
vatRegimeIdintegeroptionalRégime de TVA (champ id de vatRegimes dans get_reference_lists) ; par défaut, celui proposé par l'application.
emailstringoptionalCourriel principal.
billingEmailstringoptionalCourriel de facturation.
phone1stringoptionalTéléphone principal, avec l'indicatif (ex. +32 81 12 34 56).
phone2stringoptionalSecond téléphone.
websitestringoptionalSite web.
addressobjectoptionalAdresse (rue obligatoire si l'adresse est fournie).
address.streetstringoptionalRue.
address.numberstringoptionalNuméro.
address.boxstringoptionalBoîte.
address.postCodestringoptionalCode postal.
address.citystringoptionalLocalité.
address.countrystringoptionalCode pays ISO à deux lettres (BE par défaut pour une nouvelle adresse).
isSupplierbooleanoptionalVrai pour un fournisseur (faux par défaut).
Default : false
paymentTermIdintegeroptionalCondition de paiement (champ id de paymentTerms dans get_reference_lists) ; par défaut, celle proposée par l'application.
allowDuplicatebooleanoptionalVrai pour créer malgré les tiers semblables renvoyés par un premier appel, avec l'accord explicite de l'utilisateur.
Default : false

Result

The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.

Result fields
NameTypePresenceDescription
createdbooleanVrai si le tiers a été créé ; faux si l'application a trouvé des tiers semblables, et rien n'a été créé.
tiersobjectnullableLe tiers créé (absent si rien n'a été créé).
tiers.idintegerIdentifiant technique du tiers.
tiers.referencestringnullableRéférence du tiers.
tiers.namestringDénomination : société, sinon nom et prénom.
tiers.companyNamestringnullableRaison sociale.
tiers.lastNamestringnullableNom de la personne.
tiers.firstNamestringnullablePré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.emailstringnullableCourriel principal.
tiers.billingEmailstringnullableCourriel de facturation.
tiers.phone1stringnullableTéléphone principal.
tiers.phone2stringnullableSecond téléphone.
tiers.websitestringnullableSite web.
tiers.addressstringnullableAdresse postale.
tiers.vatNumberstringnullableNuméro de TVA, précédé du code pays.
tiers.companyNumberstringnullableNuméro d'entreprise (BCE).
tiers.vatRegimestringnullableRégime de TVA appliqué au tiers.
tiers.paymentTermstringnullableCondition de paiement.
tiers.peppolIdsstring[]Identifiants Peppol (facturation électronique).
tiers.dossierCountintegernullableNombre 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[].referencestringnullableRéférence du dossier.
tiers.recentDossiers[].indicationstringnullableIntitulé court du dossier.
tiers.recentDossiers[].rolestringnullableRô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[].referencestringnullableRé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[].emailstringnullableCourriel principal.
possibleDuplicates[].phonestringnullableTéléphone principal.
possibleDuplicates[].citystringnullableCode postal et localité.

MCP annotations

AnnotationValueMeaning
titleCréer un tiersHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "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
  }
}