Préparer un brouillon de facture ou de devis
create_invoice_draftPrépare un BROUILLON de facture (definitive), de devis (quote), de proforma ou de facture d'acompte (acompte) pour un client existant. Référence : une facture ou une facture d'acompte en brouillon porte une référence provisoire BR-… (son numéro DEF-… ou ACPT-… lui est donné à l'émission) ; un devis reçoit tout de suite son numéro DEVIS-…, une proforma PROF-…. Le brouillon n'est ni émis, ni envoyé au client, ni payé, et ne modifie ni le stock ni la comptabilité : un utilisateur le relit et l'émet dans SAMA Entreprise (lien renvoyé). customer_id, product_id et service_id sont des identifiants existants. Chaque ligne porte un produit ou une prestation ; une prestation à facteurs se décrit par calculations (une ligne par pièce, équipe, journée… ; values dans l'ordre des facteurs de la prestation) ; options = libellés des options choisies. Remise (discount_amount), frais de livraison (delivery_amount) et retenue (retenue_type) sont facultatifs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customer_id": "<customer_id>",
"items": "<items>"
},
"name": "create_invoice_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | definitive = facture (défaut), quote = devis, proforma = proforma, acompte = facture d'acompte. | definitive |
| items | Yes | Lignes du document : chacune porte un produit ou une prestation, avec sa quantité. | |
| notes | No | Notes du document (facultatif). | |
| subject | No | Objet du document (facultatif). | |
| due_date | No | YYYY-MM-DD | |
| tax_rate | No | Taux de TVA en % (défaut 18). | |
| customer_id | Yes | Identifiant d'un client existant. | |
| invoice_date | No | YYYY-MM-DD | |
| retenue_type | No | Retenue : PRECOMPTE_TVA (client public qui retient toute la TVA, art. 372 CGI) ou RAS_5 (5 % du HT, prestataire personne physique, art. 200). Ne change pas le total : réduit le net à payer. | |
| delivery_amount | No | Frais de livraison en FCFA (ex: 1500). Ajoutés au total. | |
| discount_amount | No | Remise globale en FCFA (ex: 500). Déduite du total. |