Créer un dossier

Tool namecreate_dossier
Write

Creates a project for a customer, with its procedure steps, optional linked third parties, manager, site type and site address.

Description

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

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éé.

Required access

Parameters

NameTypePresenceDescription
ownerTiersIdintegerrequiredIdentifiant du client, le tiers facturé (champ id de search_tiers ou de create_tiers).
indicationstringoptionalIntitulé court du dossier (ex. Rénovation toiture).
siteAddressobjectoptionalAdresse propre du chantier (rue obligatoire). Sans elle, le chantier est à l'adresse du tiers chantier.
siteAddress.streetstringoptionalRue.
siteAddress.numberstringoptionalNuméro.
siteAddress.boxstringoptionalBoîte.
siteAddress.postCodestringoptionalCode postal.
siteAddress.citystringoptionalLocalité.
siteAddress.countrystringoptionalCode pays ISO à deux lettres (BE par défaut pour une nouvelle adresse).
siteTiersIdintegeroptionalTiers chantier, dont l'adresse est celle du chantier : le client (par défaut) ou un des tiers liés.
managerIdintegeroptionalGestionnaire du dossier (champ id de search_users).
siteTypeIdintegeroptionalType de chantier (champ id de siteTypes dans get_reference_lists).
procedureIdintegeroptionalProcédure (champ id de procedures dans get_reference_lists) ; par défaut, la première procédure principale.
originTiersIdintegeroptionalProvenance : 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.
externalReference1stringoptionalPremière référence externe (ex. numéro de commande du client).
externalReference2stringoptionalSeconde référence externe.
additionalTiersobject[]optionalAutres tiers à lier au dossier, avec leur rôle (10 au plus).
additionalTiers[].tiersIdintegerrequiredIdentifiant du tiers (champ id de search_tiers).
additionalTiers[].roleIdintegerrequiredRôle du tiers dans le dossier (champ id de tiersRoles dans get_reference_lists).

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
idintegerIdentifiant technique du dossier.
referencestringnullableRéférence du dossier.
indicationstringnullableIntitulé court du dossier (indication).
statusstringnullableLibellé du statut du dossier.
siteTypestringnullableType de chantier.
isActivebooleanFaux si le dossier est désactivé.
externalReference1stringnullableRéférence externe 1 (référence client).
externalReference2stringnullableRéférence externe 2.
managerstringnullableNom du gestionnaire du dossier.
creationDatestring (date)nullableDate de création du dossier (AAAA-MM-JJ).
siteAddressstringnullableAdresse du chantier : celle du tiers « chantier » s'il y en a un, sinon celle du dossier.
currentStepstringnullableÉtape en cours : première étape non terminée de la procédure.
stepsobject[]Étapes de la procédure, dans l'ordre.
steps[].namestringnullableNom de l'étape.
steps[].isCompletedbooleanVrai si l'étape est terminée.
steps[].completedOnstring (date)nullableDate de fin de l'étape (AAAA-MM-JJ), si elle est terminée.
steps[].dueDatestring (date)nullableÉ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[].rolestringnullableRôle du tiers dans le dossier (libellé).
tiers[].namestringDénomination : société, sinon nom et prénom.
tiers[].referencestringnullableRéférence du tiers.
tiers[].emailstringnullableCourriel principal.
tiers[].phonestringnullableTé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.
estimateCountintegernullableNombre de devis du dossier (null sans accès aux devis). Détail : search_estimates avec dossierId.
invoiceCountintegernullableNombre de factures du dossier (null sans accès aux factures). Détail : search_invoices avec dossierId.
creditNoteCountintegernullableNombre de notes de crédit du dossier (null sans accès). Détail : search_credit_notes avec dossierId.

MCP annotations

AnnotationValueMeaning
titleCréer un dossierHuman-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_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
  }
}