RÉSERVÉ AU STUDIO (token). Crée une facture client Qonto (brouillon/proforma par défaut, ou 'unpaid' = officielle) et renvoie numéro, total, lien de paiement Mollie. Client cherché par id, email puis nom ; création possible avec create_client_if_missing=true + adresse. Anti-doublon : refuse un document identique le même jour (sauf force=true) ; request_id rend l'appel rejouable sans doublon. Aucun PDF dans la réponse : utiliser prepare_quote_email (qonto_type/qonto_number) pour l'envoyer, qonto_get pour l'URL PDF.
View input schema
{
"type": "object",
"properties": {
"client_id": {
"type": "string",
"description": "Id Qonto du client (prioritaire sur email/nom)."
},
"client_name": {
"type": "string",
"description": "Nom du client (label, studio, artiste ou 'Prénom Nom'). Recherche exacte insensible à la casse."
},
"client_email": {
"type": "string",
"description": "Email du client (recherche par email d'abord)."
},
"create_client_if_missing": {
"type": "boolean",
"description": "Si le client n'existe pas : le créer (sinon erreur explicite). Exige alors l'adresse ci-dessous."
},
"client_kind": {
"type": "string",
"enum": [
"company",
"individual"
],
"description": "Type du client créé. Défaut individual (le nom du label/artiste est conservé tel quel comme nom affiché) ; company UNIQUEMENT avec tin_number (SIREN/SIRET) — sinon Qonto refuse le devis."
},
"tin_number": {
"type": "string",
"description": "SIREN/SIRET (ou n° fiscal étranger) du client : rend le type company possible. Optionnel."
},
"contact_name": {
"type": "string",
"description": "Prénom Nom de la personne de contact (ex. 'Rafa Santos') quand client_name est un label — sert de prénom/nom Qonto. Optionnel."
},
"client_country": {
"type": "string",
"description": "Code pays ISO2 du client créé (défaut FR)."
},
"street_address": {
"type": "string",
"description": "Adresse de facturation (rue) — obligatoire pour créer un client, sauf address_unknown."
},
"zip_code": {
"type": "string",
"description": "Code postal — obligatoire pour créer un client, sauf address_unknown."
},
"city": {
"type": "string",
"description": "Ville — obligatoire pour créer un client."
},
"address_unknown": {
"type": "boolean",
"description": "Le client n'a PAS communiqué son adresse : rue/code postal remplacés par « — » (ville + pays requis). JAMAIS inventer une adresse — la demander au client."
},
"vat_number": {
"type": "string",
"description": "N° TVA intracom du client créé (optionnel)."
},
"request_id": {
"type": "string",
"description": "Identifiant unique de CET appel (ex. 'mate027-devis-2026-09-22'). Si le même request_id est rejoué (timeout, relance), le serveur renvoie la réponse d'origine sans rien recréer."
},
"force": {
"type": "boolean",
"description": "Créer même si un document identique (même client, même total, même jour) existe déjà. Défaut false."
},
"items": {
"type": "array",
"description": "Lignes (au moins 1).",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Intitulé de la prestation, ex. 'Mastering stéréo — Track X'."
},
"quantity": {
"type": [
"string",
"number"
],
"description": "Quantité (défaut 1)."
},
"unit_price": {
"type": "number",
"description": "Prix unitaire HT en €."
}
},
"required": [
"title",
"unit_price"
]
}
},
"status": {
"type": "string",
"enum": [
"draft",
"unpaid"
],
"description": "draft (proforma, à finaliser plus tard) ou unpaid (facture officielle). Défaut : draft."
},
"due_days": {
"type": "integer",
"description": "Jours avant échéance (défaut 30)."
},
"auth_token": {
"type": "string",
"description": "Token d'administration (si le client MCP ne permet pas le header Authorization)."
}
},
"required": [
"items"
],
"additionalProperties": false
}