Créer un dossier

Nom de l'outilcreate_dossier
Écriture

Description

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

Crée dans Oxygenius un dossier (chantier) pour un client, avec ses étapes selon la procédure. Le chantier est à l'adresse du client, ou d'un autre tiers chantier (siteTiersId), ou à une adresse propre (siteAddress). On peut lier d'autres tiers avec leur rôle (contact, architecte…), désigner le gestionnaire (search_users avec dossierManagersOnly), le type de chantier et la procédure (get_reference_lists). Avant l'appel, annoncer le dossier à créer et attendre l'accord de l'utilisateur ; ne pas rappeler l'outil après un succès, chaque appel crée un nouveau dossier. Renvoie le dossier créé.

Accès requis

Paramètres

NomTypePrésenceDescription
ownerTiersIdintegerobligatoireIdentifiant du client, le tiers facturé (champ id de search_tiers ou de create_tiers).
indicationstringfacultatifIntitulé court du dossier (ex. Rénovation toiture).
siteAddressobjectfacultatifAdresse propre du chantier (rue obligatoire). Sans elle, le chantier est à l'adresse du tiers chantier.
siteAddress.streetstringfacultatifRue.
siteAddress.numberstringfacultatifNuméro.
siteAddress.boxstringfacultatifBoîte.
siteAddress.postCodestringfacultatifCode postal.
siteAddress.citystringfacultatifLocalité.
siteAddress.countrystringfacultatifCode pays ISO à deux lettres (BE par défaut pour une nouvelle adresse).
siteTiersIdintegerfacultatifTiers chantier, dont l'adresse est celle du chantier : le client (par défaut) ou un des tiers liés.
managerIdintegerfacultatifGestionnaire du dossier (champ id de search_users).
siteTypeIdintegerfacultatifType de chantier (champ id de siteTypes dans get_reference_lists).
procedureIdintegerfacultatifProcédure (champ id de procedures dans get_reference_lists) ; par défaut, la première procédure principale.
originTiersIdintegerfacultatifProvenance : tiers par qui le client est arrivé (champ id de search_tiers). Obligatoire si la société l'exige (Paramètres > Dossiers) : l'outil le signale alors ; demander la provenance à l'utilisateur plutôt que de la deviner.
externalReference1stringfacultatifPremière référence externe (ex. numéro de commande du client).
externalReference2stringfacultatifSeconde référence externe.
additionalTiersobject[]facultatifAutres tiers à lier au dossier, avec leur rôle (10 au plus).
additionalTiers[].tiersIdintegerobligatoireIdentifiant du tiers (champ id de search_tiers).
additionalTiers[].roleIdintegerobligatoireRôle du tiers dans le dossier (champ id de tiersRoles dans get_reference_lists).

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
idintegerIdentifiant technique du dossier.
referencestringpeut être nullRéférence du dossier.
indicationstringpeut être nullIntitulé court du dossier (indication).
statusstringpeut être nullLibellé du statut du dossier.
siteTypestringpeut être nullType de chantier.
isActivebooleanFaux si le dossier est désactivé.
externalReference1stringpeut être nullRéférence externe 1 (référence client).
externalReference2stringpeut être nullRéférence externe 2.
managerstringpeut être nullNom du gestionnaire du dossier.
creationDatestring (date)peut être nullDate de création du dossier (AAAA-MM-JJ).
siteAddressstringpeut être nullAdresse du chantier : celle du tiers « chantier » s'il y en a un, sinon celle du dossier.
currentStepstringpeut être nullÉtape en cours : première étape non terminée de la procédure.
stepsobject[]Étapes de la procédure, dans l'ordre.
steps[].namestringpeut être nullNom de l'étape.
steps[].isCompletedbooleanVrai si l'étape est terminée.
steps[].completedOnstring (date)peut être nullDate de fin de l'étape (AAAA-MM-JJ), si elle est terminée.
steps[].dueDatestring (date)peut être nullÉchéance prévue de l'étape (AAAA-MM-JJ).
tiersobject[]Tiers liés au dossier, avec leur rôle (propriétaire, locataire, contact, provenance…).
tiers[].tiersIdintegerIdentifiant technique du tiers (à passer à get_tiers).
tiers[].rolestringpeut être nullRôle du tiers dans le dossier (libellé).
tiers[].namestringDénomination : société, sinon nom et prénom.
tiers[].referencestringpeut être nullRéférence du tiers.
tiers[].emailstringpeut être nullCourriel principal.
tiers[].phonestringpeut être nullTéléphone principal.
tiers[].isInvoiceReceiverbooleanVrai si le tiers reçoit les factures du dossier.
tiers[].isSiteTiersbooleanVrai si l'adresse du tiers est l'adresse du chantier.
estimateCountintegerpeut être nullNombre de devis du dossier (null sans accès aux devis). Détail : search_estimates avec dossierId.
invoiceCountintegerpeut être nullNombre de factures du dossier (null sans accès aux factures). Détail : search_invoices avec dossierId.
creditNoteCountintegerpeut être nullNombre de notes de crédit du dossier (null sans accès). Détail : search_credit_notes avec dossierId.

Annotations MCP

AnnotationValeurSignification
titleCréer un dossierNom 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_dossier",
  "title": "Créer un dossier",
  "description": "Crée dans Oxygenius un dossier (chantier) pour un client, avec ses étapes selon la procédure. Le chantier est à l'adresse du client, ou d'un autre tiers chantier (siteTiersId), ou à une adresse propre (siteAddress). On peut lier d'autres tiers avec leur rôle (contact, architecte…), désigner le gestionnaire (search_users avec dossierManagersOnly), le type de chantier et la procédure (get_reference_lists). Avant l'appel, annoncer le dossier à créer et attendre l'accord de l'utilisateur ; ne pas rappeler l'outil après un succès, chaque appel crée un nouveau dossier. Renvoie le dossier créé.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ownerTiersId": {
        "description": "Identifiant du client, le tiers facturé (champ id de search_tiers ou de create_tiers).",
        "type": "integer"
      },
      "indication": {
        "description": "Intitulé court du dossier (ex. Rénovation toiture).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "siteAddress": {
        "description": "Adresse propre du chantier (rue obligatoire). Sans elle, le chantier est à l'adresse du tiers chantier.",
        "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
      },
      "siteTiersId": {
        "description": "Tiers chantier, dont l'adresse est celle du chantier : le client (par défaut) ou un des tiers liés.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "managerId": {
        "description": "Gestionnaire du dossier (champ id de search_users).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "siteTypeId": {
        "description": "Type de chantier (champ id de siteTypes dans get_reference_lists).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "procedureId": {
        "description": "Procédure (champ id de procedures dans get_reference_lists) ; par défaut, la première procédure principale.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "originTiersId": {
        "description": "Provenance : tiers par qui le client est arrivé (champ id de search_tiers). Obligatoire si la société l'exige (Paramètres > Dossiers) : l'outil le signale alors ; demander la provenance à l'utilisateur plutôt que de la deviner.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "externalReference1": {
        "description": "Première référence externe (ex. numéro de commande du client).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "externalReference2": {
        "description": "Seconde référence externe.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "additionalTiers": {
        "description": "Autres tiers à lier au dossier, avec leur rôle (10 au plus).",
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "tiersId": {
              "description": "Identifiant du tiers (champ id de search_tiers).",
              "type": "integer"
            },
            "roleId": {
              "description": "Rôle du tiers dans le dossier (champ id de tiersRoles dans get_reference_lists).",
              "type": "integer"
            }
          },
          "required": [
            "tiersId",
            "roleId"
          ]
        },
        "default": null
      }
    },
    "required": [
      "ownerTiersId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "description": "Identifiant technique du dossier.",
        "type": "integer"
      },
      "reference": {
        "description": "Référence du dossier.",
        "type": [
          "string",
          "null"
        ]
      },
      "indication": {
        "description": "Intitulé court du dossier (indication).",
        "type": [
          "string",
          "null"
        ]
      },
      "status": {
        "description": "Libellé du statut du dossier.",
        "type": [
          "string",
          "null"
        ]
      },
      "siteType": {
        "description": "Type de chantier.",
        "type": [
          "string",
          "null"
        ]
      },
      "isActive": {
        "description": "Faux si le dossier est désactivé.",
        "type": "boolean"
      },
      "externalReference1": {
        "description": "Référence externe 1 (référence client).",
        "type": [
          "string",
          "null"
        ]
      },
      "externalReference2": {
        "description": "Référence externe 2.",
        "type": [
          "string",
          "null"
        ]
      },
      "manager": {
        "description": "Nom du gestionnaire du dossier.",
        "type": [
          "string",
          "null"
        ]
      },
      "creationDate": {
        "description": "Date de création du dossier (AAAA-MM-JJ).",
        "type": [
          "string",
          "null"
        ],
        "format": "date"
      },
      "siteAddress": {
        "description": "Adresse du chantier : celle du tiers « chantier » s'il y en a un, sinon celle du dossier.",
        "type": [
          "string",
          "null"
        ]
      },
      "currentStep": {
        "description": "Étape en cours : première étape non terminée de la procédure.",
        "type": [
          "string",
          "null"
        ]
      },
      "steps": {
        "description": "Étapes de la procédure, dans l'ordre.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "description": "Nom de l'étape.",
              "type": [
                "string",
                "null"
              ]
            },
            "isCompleted": {
              "description": "Vrai si l'étape est terminée.",
              "type": "boolean"
            },
            "completedOn": {
              "description": "Date de fin de l'étape (AAAA-MM-JJ), si elle est terminée.",
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "dueDate": {
              "description": "Échéance prévue de l'étape (AAAA-MM-JJ).",
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            }
          },
          "required": [
            "isCompleted"
          ]
        }
      },
      "tiers": {
        "description": "Tiers liés au dossier, avec leur rôle (propriétaire, locataire, contact, provenance…).",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "tiersId": {
              "description": "Identifiant technique du tiers (à passer à get_tiers).",
              "type": "integer"
            },
            "role": {
              "description": "Rôle du tiers dans le dossier (libellé).",
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "description": "Dénomination : société, sinon nom et prénom.",
              "type": "string"
            },
            "reference": {
              "description": "Référence du tiers.",
              "type": [
                "string",
                "null"
              ]
            },
            "email": {
              "description": "Courriel principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "phone": {
              "description": "Téléphone principal.",
              "type": [
                "string",
                "null"
              ]
            },
            "isInvoiceReceiver": {
              "description": "Vrai si le tiers reçoit les factures du dossier.",
              "type": "boolean"
            },
            "isSiteTiers": {
              "description": "Vrai si l'adresse du tiers est l'adresse du chantier.",
              "type": "boolean"
            }
          },
          "required": [
            "tiersId",
            "name",
            "isInvoiceReceiver",
            "isSiteTiers"
          ]
        }
      },
      "estimateCount": {
        "description": "Nombre de devis du dossier (null sans accès aux devis). Détail : search_estimates avec dossierId.",
        "type": [
          "integer",
          "null"
        ]
      },
      "invoiceCount": {
        "description": "Nombre de factures du dossier (null sans accès aux factures). Détail : search_invoices avec dossierId.",
        "type": [
          "integer",
          "null"
        ]
      },
      "creditNoteCount": {
        "description": "Nombre de notes de crédit du dossier (null sans accès). Détail : search_credit_notes avec dossierId.",
        "type": [
          "integer",
          "null"
        ]
      }
    },
    "required": [
      "id",
      "isActive"
    ]
  },
  "annotations": {
    "title": "Créer un dossier",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}