Générer l'export comptable du mois

# Export comptable : aperçu, contrôle, validation

## ⚠️ Outil d'écriture en Beta

`create_accounting_export`, `get_accounting_export` et `get_journal_templates` demandent la permission « Manage accounting exports », désactivée par défaut : un Admin ou Account Owner l'active sur la connexion, puis l'utilisateur se reconnecte et la coche. Sans elle, ces outils n'apparaissent pas du tout.

**Un export validé est irréversible** : les payables et règlements inclus passent à « exporté ». L'aperçu, lui, ne modifie rien. Ce skill fait toujours l'aperçu d'abord et ne valide que sur demande explicite de l'utilisateur.

Disponible uniquement si le logiciel comptable de la société est Spendesk Accounting, Sage ou Cegid. Pour tout autre logiciel connecté (Xero, Netsuite, Datev…), ces outils renvoient une erreur : ne pas réessayer.

## Étape 1 — Annoncer la période

Annoncer les dates exactes avant tout appel (« du 2026-09-01 au 2026-09-30 »). La fenêtre ne peut pas dépasser **31 jours**.

## Étape 2 — Contrôler ce qui sera exclu (le piège principal)

Les payables encore en `toPrepare` sont **exclus du journal d'achats sans aucun avertissement** : le résultat ne donne ni compteur ni liste des exclus. Les compter avant d'exporter :

```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"] }
  ] } }
}
```

Dire à l'utilisateur combien de payables resteront hors export, et pour quel montant. `mark_payable_as_ready` en fait passer un à `toExport` (permission « Manage payables », action sans retour par outil).

Vérifié en direct : sur septembre 2026, les 2 payables du mois (EUR 15 779,40 et EUR 10 055,50) étaient tous deux en `toPrepare`. L'aperçu du journal d'achats de cette période, téléchargé et ouvert, ne contenait que la ligne d'en-tête : aucune écriture, et aucun message pour le signaler.

## Étape 3 — Choisir le modèle (facultatif)

```json
{ "tool": "get_journal_templates", "params": {} }
```

Renvoie `id`, `name`, `type` (`purchase` ou `bank`), `isDefault`.

- `isDefault: true` signifie « modèle intégré Spendesk », **pas** « modèle par défaut de la société » : plusieurs lignes peuvent être à `true`. Sur le compte démo, 11 modèles étaient listés, dont 6 intégrés (Spendesk Accounting, Sage, Cegid) et 5 créés par la société.
- Sans `templates`, l'export utilise les modèles standard, en anglais.
- Ne passer un modèle Sage ou Cegid que si l'utilisateur demande ce format.
- Une liste vide signifie qu'aucune intégration comptable n'est connectée.

## Étape 4 — Aperçu

```json
{
  "tool": "create_accounting_export",
  "params": { "from": "2026-09-01", "to": "2026-09-30", "journals": ["purchase"], "markEntriesAsExported": false }
}
```

- `journals` vaut par défaut `["purchase", "bank"]` : ne passer que le journal demandé.
- `markEntriesAsExported: false` (défaut) = aperçu. Réponse observée : une `key`, `journalTypes: ["purchase"]`, `markedAsExported: false`.
- Le journal d'achats se cale sur la date du document des payables ; le journal de banque sur la date de chaque mouvement. Les frais bancaires ne sont inclus que par mois calendaire entier : une période qui ne finit pas le dernier jour du mois n'inclut pas les frais de ce mois.
- Les payables déjà exportés sont exclus, sauf `includeAlreadyExportedPayables: true`. Les règlements déjà exportés ne sont jamais ré-inclus.

## Étape 5 — Récupérer le fichier

```json
{ "tool": "get_accounting_export", "params": { "key": "<key de l'étape 4>" } }
```

Quatre issues possibles :

| Réponse | Quoi faire |
|---------|-----------|
| `downloadUrl` | Terminé. Lien signé vers un zip unique, valable environ 1 heure : le dire à l'utilisateur. S'il expire, rappeler avec la même clé |
| « still being generated » | Réessayer avec la **même** clé, 3 fois au plus, puis rendre la clé à l'utilisateur |
| « failed » | Définitif. Ne pas réessayer : créer un nouvel export |
| « not found » | Définitif. Clé erronée ou export créé dans une autre société : vérifier les deux |

## Étape 6 — Valider (seulement sur demande explicite)

Avant de valider, rappeler à l'utilisateur : la période, les journaux, le nombre de payables exclus, et le fait que c'est irréversible. Attendre son accord explicite, puis refaire l'appel de l'étape 4 avec `"markEntriesAsExported": true`.

Après l'appel, dire clairement ce qui s'est passé : aperçu (rien n'a changé) ou validation (écritures marquées exportées). Si le résultat est incertain, relire l'état des payables plutôt que de relancer l'export.

## Ce qui a été testé

Testé en direct sur le compte démo : la liste des modèles, le contrôle des payables `toPrepare`, la création d'un aperçu, l'obtention du lien de téléchargement et l'ouverture du zip (un fichier CSV par journal). **La validation (`markEntriesAsExported: true`) n'a pas été exécutée**, parce qu'elle est irréversible ; son comportement est décrit d'après la documentation de l'outil.

## Exemples de prompts utilisateur

- "Fais-moi un aperçu du journal d'achats de septembre, sans rien marquer comme exporté"
- "Combien de factures de septembre ne partiront pas dans l'export, et pourquoi ?"
- "L'aperçu est bon : valide l'export de septembre"