Rapprocher un compte

Objectif : s’assurer que YNAB est d’accord avec votre banque, trouver la cause quand ce n’est pas le cas, et marquer le compte rapproché une fois d’accord.

Avant de commencer : le solde que votre banque affiche aujourd’hui, et l’écriture activée pour marquer le compte rapproché (le diagnostic fonctionne en lecture seule).

Outil : reconcile_account. Prompt : reconcile.

La conversation

1. Demandez, avec le solde de la banque.

   Vous : Ma banque affiche 3 440,80 sur mon compte courant. YNAB est-il d’accord ?

2. L’agent compare. Il appelle reconcile_account avec {"plan_id": "last-used", "account_id": "acc-checking", "bank_balance": 3440.80}. avenir-mcp additionne les transactions pointées du compte (celles que la banque a montrées) et compare. Elles diffèrent, donc rien n’est écrit :

   reconcile_account — écart trouvé

   {
     "status": "difference_found",
     "message": "YNAB's cleared balance differs from the bank by -71.86. Nothing was changed. Check explained_by, uncleared and possible_duplicates with the user; call again once fixed, or with adjust=true to record the gap as an adjustment.",
     "account": "Checking",
     "analysis": {
       "account_id": "acc-checking",
       "bank_balance": 3440.8,
       "cleared_balance": 3512.66,
       "working_balance": 3512.66,
       "difference": -71.86,
       "to_reconcile_count": 49,
       "uncleared_count": 0,
       "uncleared": [],
       "explained_by": [],
       "possible_duplicates": [
         [
           "tx-050",
           "tx-051"
         ]
       ]
     },
     "adjustment": null,
     "confirmation": null,
     "operation_id": null
   }

3. L’agent explique l’écart.

   Claude : YNAB compte 71,86 de plus que la banque. Deux paiements Market Fresh identiques de 71,86 le 19 septembre ressemblent à un import arrivé deux fois.

   La réponse offre trois pistes : explained_by (une transaction en attente dont le montant est exactement l’écart), uncleared (ce que la banque n’a pas encore montré) et possible_duplicates (même montant et même commerçant, à 3 jours au plus, sur les 60 derniers jours).

4. Vous corrigez la cause — ici, supprimer le doublon dans YNAB.

5. Redemandez. Quand les soldes concordent, avenir-mcp prévisualise le rapprochement : chaque transaction pointée du compte devient rapprochée. Vous confirmez ; c’est appliqué en une requête et inscrit au journal.

Quand l’écart reste inexpliqué

Parfois une petite différence demeure : des frais jamais importés, une ancienne erreur. Seulement si vous le demandez, l’agent rappelle l’outil avec adjust=true :

• une transaction Balance adjustment du montant de l’écart est créée sur le compte, datée du jour, dans Ready to Assign, avec le mémo Entered by reconcile_account ;
• puis le compte est rapproché, ajustement compris.

Attention

Un ajustement masque un problème au lieu de le résoudre. avenir-mcp n’en crée jamais de lui-même, et l’évaluation vérifie qu’un agent à qui l’on dit « ne change rien » n’en crée pas non plus.

Annuler

undo_operation remet chaque transaction rapprochée à l’état pointé et supprime l’ajustement, s’il y en a eu un. Voir Annuler un changement.

Statuts

status	Signification
difference_found	les soldes diffèrent ; rien d’écrit ; lire analysis
nothing_to_do	les soldes concordent et rien ne reste à rapprocher
confirmation_required	les soldes concordent (ou adjust a été demandé) ; en attente de votre accord
applied	rapproché ; operation_id pour annuler
declined	vous avez refusé ; rien d’écrit

Fonctionnement de la comparaison : Rapprochement.