> ## Documentation Index
> Fetch the complete documentation index at: https://mcp.klark.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Achat (e-factures reçues)

> 5 outils — E-factures fournisseurs reçues et dépenses

## 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").

<ParamField body="lines" type="array" required>
  Lignes de la facture fournisseur — sans productId requis
</ParamField>

<ParamField body="supplierId" type="string">
  ID du fournisseur Klark si connu
</ParamField>

<ParamField body="number" type="string">
  Numéro de facture extrait du document
</ParamField>

<ParamField body="issueDate" type="string">
  Date d'émission ISO 8601 (ex : "2025-06-01")
</ParamField>

<ParamField body="dueDate" type="string">
  Date d'échéance ISO 8601
</ParamField>

<ParamField body="expenseCategory" type="string">
  Catégorie de charge (ex : "transport", "logiciel", "fournitures")
</ParamField>

<ParamField body="notes" type="string">
  Notes ou remarques libres
</ParamField>

<ParamField body="adjustments" type="array">
  Remises ou frais au niveau document
</ParamField>

<ParamField body="ocrSource" type="object" required>
  Métadonnées OCR pour la traçabilité
</ParamField>

## 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).

<ParamField body="status" type="string">
  Filtre sur l'état Copilote — Valeurs : pending | converted | dismissed
</ParamField>

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

<ParamField body="receivedInvoiceId" type="string" required>
  ID de l'e-facture reçue (depuis list\_received\_invoices)
</ParamField>

## 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").

<ParamField body="supplierName" type="string">
  Nom du fournisseur
</ParamField>

<ParamField body="siret" type="string">
  SIRET du fournisseur
</ParamField>

<ParamField body="vatNumber" type="string">
  Numéro de TVA intracommunautaire
</ParamField>

<ParamField body="label" type="string">
  Libellé / objet de la dépense
</ParamField>

<ParamField body="lines" type="array">
  Lignes de la dépense
</ParamField>

## dismiss\_received\_invoice

`Écriture`

Marque une e-facture reçue comme ignorée (ne sera plus proposée à la conversion en dépense).

<ParamField body="receivedInvoiceId" type="string" required>
  ID de l'e-facture reçue
</ParamField>