create_expense_from_ocr
Écriture
Crée une dépense / facture fournisseur à partir d’un document scanné (OCR déjà extrait). Utiliser quand l’IA a analysé un PDF ou une image de facture fournisseur et en a extrait les données structurées. Les lignes n’ont PAS besoin de productId — une simple description suffit. Passer ocrSource.extractedBy pour la traçabilité (ex : “claude”, “gemini”, “openai”).
array
required
Lignes de la facture fournisseur — sans productId requis
string
ID du fournisseur Klark si connu
string
Numéro de facture extrait du document
string
Date d’émission ISO 8601 (ex : “2025-06-01”)
string
Date d’échéance ISO 8601
string
Catégorie de charge (ex : “transport”, “logiciel”, “fournitures”)
string
Notes ou remarques libres
array
Remises ou frais au niveau document
object
required
Métadonnées OCR pour la traçabilité
list_received_invoices
Lecture seule
Liste les e-factures reçues (Plateforme de Dématérialisation Partenaire) prêtes à devenir des dépenses. Filtrer par état Copilote : “pending” (à traiter), “converted” (déjà en brouillon), “dismissed” (ignorées).
string
Filtre sur l’état Copilote — Valeurs : pending | converted | dismissed
convert_received_invoice_to_expense
Écriture
Convertit une e-facture reçue en brouillon de dépense (catégorie auto, fournisseur rattaché). Idempotent : rappeler renvoie le même brouillon. Le brouillon reste à valider dans Klark.
string
required
ID de l’e-facture reçue (depuis list_received_invoices)
suggest_expense_category
Lecture seule
Suggère la catégorie de charge et le rattachement fournisseur pour une dépense en cours de saisie (historique → IA → repli “autre”).
string
Nom du fournisseur
string
SIRET du fournisseur
string
Numéro de TVA intracommunautaire
string
Libellé / objet de la dépense
array
Lignes de la dépense
dismiss_received_invoice
Écriture
Marque une e-facture reçue comme ignorée (ne sera plus proposée à la conversion en dépense).
string
required
ID de l’e-facture reçue