# ledger

Utilisez les surfaces régies de grand livre et de rappels lorsqu'un agent a besoin d'un contexte opérationnel durable.

- Canonical: https://docs.xmemo.dev/fr/docs/tools/ledger
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: 3bc28bb66da214c9eceb8c96db997d55d16493cd954fb2e787f46cdc124e477e
- Edition-Digest: 3ac97d31420c37a734514734a225196fdfa17e8ccd339b2ed4e4873ca2feb8a1
- Source-Revision: sha256:5ae3da12a28b7c528cd1988ad36022f9c72af84d4498e1c17052666c465b4673

## Tool Reference: `ledger`

### Purpose

Gérer les transactions financières régies et les rappels de renouvellement de services externes via le répartiteur Ledger, avec récapitulatifs structurés et limites d'audit.

### Parameters

- `action` (add_expense | list | summary | overview | update_transaction, required): Opération Ledger sélectionnée par l'appelant. Seules ces cinq valeurs littérales sont acceptées.
- `item / amount / transaction_type / currency` (string / number, optional): Champs principaux de transaction ; montant et devise sont requis pour les écritures financières.
- `transaction_date / category / merchant / payment_method / note` (string, optional): Champs facultatifs de classification, de date et de note de transaction.
- `query / date_from / date_to / min_amount / max_amount` (string / number, optional): Filtres de liste et de récapitulatif.
- `transaction_id / expected_version / patch` (string / integer / object, optional): Cible exacte de mise à jour, version de concurrence optimiste et champs de mise à jour autorisés.
- `owner_timezone / project_id` (string, optional): Interprétation de date et limite de projet/équipe autorisée.
- `limit / offset / months` (integer / boolean, optional, default: 20 / 0 / 6 / false): Contrôles de pagination, d'horizon de récapitulatif et de sortie structurée.

### Returns

La sortie structurée contient la transaction demandée, les groupes de récapitulatif ou la vue d'ensemble ainsi qu'un résumé textuel destiné à l'utilisateur. Les appelants de widget peuvent recevoir des métadonnées d'actualisation ; les secrets bruts ne font jamais partie du contrat de réponse.

### Errors

- Échec d'autorisation : le jeton ne dispose pas de memory:read pour les lectures ou de memory:write pour les mutations.
- Échec de validation : les champs de transaction requis, formats de date, devise ou valeurs d'action sont invalides.
- Échec de concurrence : une mise à jour comporte un expected_version obsolète ou la transaction exacte est introuvable.
- Limite d'agrégation : les enregistrements dans des devises différentes sont signalés séparément au lieu de produire un faux total combiné.

### Examples

#### Enregistrer une dépense



```typescript
ledger({
  action: "add_expense",
  item: "Domain renewal",
  amount: 18.00,
  currency: "USD",
  transaction_date: "2026-08-21",
  category: "software"
})
```

#### Examiner un récapitulatif mensuel



```typescript
ledger({ action: "summary", months: 1 })
```

### Related Tools

- [remember](/docs/tools/remember): À utiliser uniquement pour le contexte durable non financier autour de l'enregistrement.
- [todos](/docs/tools/todos): Utiliser TODO pour les tâches de suivi générales ; ledger peut activer des rappels de révision.
- [forget](/docs/tools/forget): Supprimer un enregistrement Ledger examiné via son cycle de vie régi.

## Examiner avant d'enregistrer

Consultez d'abord le récapitulatif actuel ; les enregistrements de grand livre sont des données financières et une entrée dupliquée est plus difficile à corriger qu'une entrée manquante.

```ts
ledger({ action: "summary", months: 1 })
```