Créer un dossier
create_dossierCreates a project for a customer, with its procedure steps, optional linked third parties, manager, site type and site address.
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éé.
Required access
- Permission:
dossier.new-dossier.create - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
ownerTiersId | integer | required | Identifiant du client, le tiers facturé (champ id de search_tiers ou de create_tiers). |
indication | string | optional | Intitulé court du dossier (ex. Rénovation toiture). |
siteAddress | object | optional | Adresse propre du chantier (rue obligatoire). Sans elle, le chantier est à l'adresse du tiers chantier. |
siteAddress.street | string | optional | Rue. |
siteAddress.number | string | optional | Numéro. |
siteAddress.box | string | optional | Boîte. |
siteAddress.postCode | string | optional | Code postal. |
siteAddress.city | string | optional | Localité. |
siteAddress.country | string | optional | Code pays ISO à deux lettres (BE par défaut pour une nouvelle adresse). |
siteTiersId | integer | optional | Tiers chantier, dont l'adresse est celle du chantier : le client (par défaut) ou un des tiers liés. |
managerId | integer | optional | Gestionnaire du dossier (champ id de search_users). |
siteTypeId | integer | optional | Type de chantier (champ id de siteTypes dans get_reference_lists). |
procedureId | integer | optional | Procédure (champ id de procedures dans get_reference_lists) ; par défaut, la première procédure principale. |
originTiersId | integer | optional | 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. |
externalReference1 | string | optional | Première référence externe (ex. numéro de commande du client). |
externalReference2 | string | optional | Seconde référence externe. |
additionalTiers | object[] | optional | Autres tiers à lier au dossier, avec leur rôle (10 au plus). |
additionalTiers[].tiersId | integer | required | Identifiant du tiers (champ id de search_tiers). |
additionalTiers[].roleId | integer | required | Rô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
| Name | Type | Presence | Description |
|---|---|---|---|
id | integer | Identifiant technique du dossier. | |
reference | string | nullable | Référence du dossier. |
indication | string | nullable | Intitulé court du dossier (indication). |
status | string | nullable | Libellé du statut du dossier. |
siteType | string | nullable | Type de chantier. |
isActive | boolean | Faux si le dossier est désactivé. | |
externalReference1 | string | nullable | Référence externe 1 (référence client). |
externalReference2 | string | nullable | Référence externe 2. |
manager | string | nullable | Nom du gestionnaire du dossier. |
creationDate | string (date) | nullable | Date de création du dossier (AAAA-MM-JJ). |
siteAddress | string | nullable | Adresse du chantier : celle du tiers « chantier » s'il y en a un, sinon celle du dossier. |
currentStep | string | nullable | Étape en cours : première étape non terminée de la procédure. |
steps | object[] | Étapes de la procédure, dans l'ordre. | |
steps[].name | string | nullable | Nom de l'étape. |
steps[].isCompleted | boolean | Vrai si l'étape est terminée. | |
steps[].completedOn | string (date) | nullable | Date de fin de l'étape (AAAA-MM-JJ), si elle est terminée. |
steps[].dueDate | string (date) | nullable | Échéance prévue de l'étape (AAAA-MM-JJ). |
tiers | object[] | Tiers liés au dossier, avec leur rôle (propriétaire, locataire, contact, provenance…). | |
tiers[].tiersId | integer | Identifiant technique du tiers (à passer à get_tiers). | |
tiers[].role | string | nullable | Rôle du tiers dans le dossier (libellé). |
tiers[].name | string | Dénomination : société, sinon nom et prénom. | |
tiers[].reference | string | nullable | Référence du tiers. |
tiers[].email | string | nullable | Courriel principal. |
tiers[].phone | string | nullable | Téléphone principal. |
tiers[].isInvoiceReceiver | boolean | Vrai si le tiers reçoit les factures du dossier. | |
tiers[].isSiteTiers | boolean | Vrai si l'adresse du tiers est l'adresse du chantier. | |
estimateCount | integer | nullable | Nombre de devis du dossier (null sans accès aux devis). Détail : search_estimates avec dossierId. |
invoiceCount | integer | nullable | Nombre de factures du dossier (null sans accès aux factures). Détail : search_invoices avec dossierId. |
creditNoteCount | integer | nullable | Nombre de notes de crédit du dossier (null sans accès). Détail : search_credit_notes avec dossierId. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Créer un dossier | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | no | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The 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
}
}