Savoir où en est une facture

# Où en est cette facture ?

## But

Répondre à « où en est la facture de tel fournisseur ? » en lisant les trois états d'une facture, qui avancent **indépendamment** les uns des autres :

| État | Champ | Valeurs |
|------|-------|---------|
| Approbation | `approvalStatus` | `pending`, `approved`, `rejected` |
| Paiement | `paymentStatus` | `unpaid`, `partiallyPaid`, `paid` |
| Export comptable | `exportStatus` | lu sur le détail de la facture |

Une facture peut être approuvée et impayée, ou payée et pas encore exportée. Ne pas présenter ces états comme une seule ligne d'étapes.

Le skill ne fait que lire : l'assistant ne peut ni approuver, ni payer, ni planifier un paiement.

## Étape 1 — Retrouver la facture

Par numéro de facture (recherche exacte, sans tenir compte de la casse) :

```json
{ "tool": "get_invoices", "params": { "invoiceNumber": "INV-2026-7734" } }
```

Par nom de fournisseur ou recherche libre :

```json
{ "tool": "get_invoices", "params": { "search": "Accenture", "sortBy": "issueDate" } }
```

- Les factures **en attente d'approbation sont visibles** ici, contrairement à `get_payables`, qui ne contient une facture qu'une fois approuvée.
- Les brouillons et factures incomplètes ne sont jamais listés. Si la facture est introuvable, elle est peut-être encore dans la boîte de réception : voir le skill dédié (`get_intakes`).
- Les avoirs demandent un appel séparé avec `type: "creditNote"`.
- Si plusieurs factures correspondent, les lister et demander laquelle.

## Étape 2 — Lire le détail

```json
{ "tool": "get_invoice_by_id", "params": { "id": "<id de la facture>" } }
```

- **Approbation** : `approval.steps` ; l'étape dont `state` vaut `current` porte les approbateurs attendus (identifiants à résoudre avec `get_users`). `rejected` couvre aussi les factures expirées ou annulées.
- **Paiement** : `payments`, `amountPaid`, `amountDue`. Cet outil recalcule le paiement à partir des paiements enregistrés : il fait foi, et peut différer de la liste de l'étape 1.
- **Export** : `exportStatus` et `exportedAt`.
- **Divers** : `dueDate`, `purchaseOrders`, `buyer`, `dispute`, `attachments`.

## Étape 3 — Vue d'ensemble (si la question est générale)

Pour compter sans paginer :

```json
{ "tool": "get_invoices_summary", "params": { "approvalStatus": ["approved"], "paymentStatus": ["unpaid", "partiallyPaid"] } }
```

Donne le nombre et le montant par devise des factures approuvées et impayées. Dans ce résumé, `amountDue` vaut toujours 0 : ne pas le citer. Remplacer les filtres par `approvalStatus: ["pending"]` pour les factures en attente d'approbation.

## Réponse type

```
Facture <n°> — <fournisseur> — <montant>
Émise le <date>, échéance le <date>

Approbation : approuvée / en attente chez <nom> / rejetée
Paiement    : impayée / payée en partie (X sur Y) / payée le <date>
Export      : exportée le <date> / pas encore exportée

<Une phrase en clair : ce qui bloque, ou ce qui reste à faire>
```

Signaler une échéance dépassée. Les montants restent dans la devise de la facture.

## Limites à dire

- Pas de date de paiement prévue : le MCP ne lit pas les paiements planifiés d'une facture donnée.
- L'assistant ne peut pas approuver, payer ni relancer lui-même.
- Un avoir affiche toujours « impayé » : ce n'est pas un reste à payer.

## Résultat observé (compte démo, 5 octobre 2026)

22 factures approuvées et impayées, en trois devises (15 en EUR, 4 en GBP, 3 en USD), et 2 en attente d'approbation. Sur l'une de ces dernières (USD 19 513,20), l'étape d'approbation courante attendait deux approbateurs.

## Exemples de prompts
- "Où en est la facture Accenture de mai ?"
- "Quelles factures sont approuvées et en attente de paiement ?"
- "La facture INV-2026-7734 a-t-elle été payée et exportée ?"