Vérifier les comptes comptables avant export

# Contrôle des comptes comptables avant export

## But

Vérifier, avant un export, que chaque dépense à exporter porte bien ses comptes comptables : compte de charge sur chaque ligne, compte de TVA quand il y a de la TVA, compte fournisseur. Une dépense sans compte part incomplète dans le journal.

Ce skill ne fait que lire. Corriger un compte demande l'outil `update_payable` (permission d'écriture « Manage payables », en Beta) ou l'application Spendesk.

## Où se trouvent les comptes

La liste renvoyée par `get_payables` porte les **identifiants** des comptes, et seulement quand un compte est affecté. Les codes et libellés se lisent dans le détail d'une dépense (`get_payable_by_id`).

| Compte | Dans la liste (`get_payables`) | Dans le détail (`get_payable_by_id`) |
|--------|-------------------------------|--------------------------------------|
| Compte de charge de la ligne | `itemLines[].expenseAccountId` | `lineItems[].expenseAccount` |
| Compte de TVA de la ligne | `itemLines[].taxAccountId` | `lineItems[].vatAccount` |
| Compte d'autoliquidation, le cas échéant | — | `lineItems[].reverseChargeAccount` |
| Compte fournisseur ou collaborateur | `accountPayableId` | `counterparty.accountPayable` |

Dans la liste, un compte non affecté se traduit par un champ **absent** ; dans le détail, par un champ à `null`. Il n'existe pas de champ `glCode` ni `accountingCode`.

## Étape 1 — Lister les dépenses à contrôler

Annoncer les dates exactes, puis :

```json
{
  "tool": "get_payables",
  "params": { "filters": { "operator": "and", "subfilters": [
    { "field": "payableDate", "operator": "between", "value": { "from": "2026-09-01T00:00:00.000Z", "to": "2026-09-30T23:59:59.999Z" } },
    { "field": "bookkeepingStatus", "operator": "=", "value": ["toPrepare", "toExport"] }
  ] } }
}
```

Inclure `toPrepare` : ce sont les dépenses qui n'ont pas encore été revues, donc celles où les comptes manquent le plus souvent. Paginer avec `cursor`.

## Étape 2 — Repérer les comptes manquants dans la liste

Sans appel supplémentaire, relever pour chaque dépense de la liste :

- les lignes sans `expenseAccountId` ;
- les lignes avec de la TVA (`vatAmount` non nul) sans `taxAccountId` ;
- l'absence de `accountPayableId`.

Dire combien de dépenses ont été contrôlées. Ne lire le détail que des dépenses en anomalie, pour obtenir le nom du fournisseur, les codes de comptes et le lien `appUrl` :

```json
{ "tool": "get_payable_by_id", "params": { "id": "<id de la dépense>" } }
```

## Étape 3 — Vérifier que les comptes utilisés sont toujours valides

```json
{ "tool": "get_chart_of_accounts", "params": { "includeArchived": true, "pageSize": 1000 } }
```

Rapprocher les identifiants de comptes relevés dans la liste de ceux du plan comptable. Signaler une dépense affectée à un compte **archivé** (`isArchived: true`) ou rendu indisponible (`isAvailable: false`). Sans `includeArchived`, ces comptes sont invisibles et le contrôle passerait à côté.

## Rapport

```
Contrôle des comptes — dépenses du <date> au <date> (N contrôlées)

✅ Complètes : N
❌ Sans compte de charge : N — X EUR
❌ Sans compte de TVA alors qu'il y a de la TVA : N
❌ Sans compte fournisseur : N
⚠️ Sur un compte archivé ou indisponible : N

| Dépense | Fournisseur | Montant | Ce qui manque | Lien |
```

`appUrl` (dans le détail de la dépense) donne le lien direct : le fournir tel quel. Les montants sont dans la devise de chaque dépense ; totaliser avec `functionalAmount`.

## Limites à dire

- Ce contrôle dit qu'un compte est présent et actif, pas qu'il est le **bon** compte pour cette dépense.
- Si le plan comptable est géré par le logiciel comptable de la société, les comptes se corrigent là-bas.

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

Une facture de septembre à préparer (EUR 15 779,40, TVA de EUR 2 519,40) n'avait ni compte de charge, ni compte de TVA, ni compte fournisseur : les trois identifiants étaient absents de la liste, et les trois champs à `null` dans le détail.

## Exemples de prompts
- "Vérifie que toutes mes dépenses à exporter ont leurs comptes comptables"
- "Y a-t-il des factures sans compte de charge avant ma clôture ?"
- "Quelles dépenses de septembre sont affectées à un compte archivé ?"