Utilitza IA per suggerir comptes i explicar transaccions, després comprova les partides contra els teus documents d'origen abans de desar-les. Aquesta guia porta un petit extracte fictici a través de la categorització, la revisió, la validació i una consulta que pots verificar.
Tria un flux de treball allotjat o local a continuació. L'exemple pràctic utilitza un fitxer de mostra local perquè puguis reproduir cada comprovació abans de connectar IA als teus propis llibres.
Tria el teu flux de treball
| La teva configuració | Comença aquí | Com arriben els canvis al teu llibre major |
|---|---|---|
| Utilitzes Beancount.io | Utilitza Importació Intel·ligent per arxius d'extractes, o Assistent IA per preguntes i edicions proposades. | Revisa les files abans d'enviar una importació. Per edicions de l'Assistent, revisa el diff proposat i tria Aprova o Denega. |
| Utilitzes un client d'IA extern | Segueix la guia de configuració de Beancount MCP per connectar el teu client a un llibre major allotjat. | Una execució de prova previsualitza una operació d'edició. Una crida d'escriptura separada l'aplica. Les indicacions d'aprovació depenen de la configuració del teu client. |
| Mantens fitxers locals | Utilitza el convertidor CSV a Beancount o un importador, després demana a una eina d'IA que suggereixi categories. | Revisa les partides proposades, valida el fitxer i desa els canvis acceptats. |
L'Assistent allotjat i MCP són integracions de Beancount.io. Instal·lar el motor de comptabilitat de codi obert Beancount no afegeix aquests serveis a un llibre major local.
Abans de començar
Tingues el teu extracte d'origen, el compte al qual pertany i una llista de comptes de destinació permesos. Conserva l'extracte original perquè puguis comparar-lo amb el resultat.
Per al recorregut local, instal·la Beancount utilitzant la guia d'inici. També necessitaràs Beanquery per executar la consulta final des d'un terminal. L'exemple assumeix USD durant tot el procés i cap transacció existent al fitxer de mostra.
Per a dades reals, decideix quina informació pot rebre la teva eina d'IA. Elimina identificadors innecessaris abans de compartir un extracte. Un llibre major local encara pot enviar dades a un model al núvol a través d'un editor o client MCP. Comprova les polítiques de dades del client i del proveïdor del model; mantenir un fitxer al teu ordinador no manté local el seu contingut per si sol.
1. Comença amb les transaccions d'origen
El nostre compte corrent fictici comença agost amb 1.000,00 USD. El seu extracte conté tres retirades i tanca a 805,10 USD després d'aquestes retirades:
date,payee,description,amount
2026-08-03,Office Depot,Printer paper,-45.00
2026-08-04,Cloud Hosting Inc,Monthly hosting,-120.00
2026-08-05,Amazon,Online purchase,-29.90Els imports negatius aquí signifiquen diners que surten del compte corrent. Confirma la convenció de signes del teu banc abans d'importar; altres exports i importadors poden utilitzar una convenció diferent.
Al convertidor CSV, assigna aquestes quatre columnes i estableix el compte d'origen a Assets:Bank:Checking amb la moneda USD. Deixa Capgira tots els signes desactivat per a aquesta mostra. Comprova que els càrrecs d'origen són negatius. Un compte de destinació provisional és només un marcador de posició fins que hagis revisat les categories.
Si comences amb una imatge de rebut o PDF, compara les dates extretes, els imports, la moneda i el nombre de transaccions amb el document original abans de categoritzar qualsevol cosa. Conserva els valors d'origen intactes mentre decideixes els comptes.
2. Demana categories amb límits explícits
Utilitza una indicació que anomeni els comptes permesos i deixi espai per a la incertesa:
Suggeriu un compte de destinació per a cada fila d'aquest extracte de mostra. El compte d'origen és Assets:Bank:Checking. Utilitzeu només Expenses:Office:Supplies o Expenses:Business:Hosting. Torneu la data original, el beneficiari, l'import, el compte suggerit i una raó breu. Si la descripció és insuficient, torneu NEEDS_REVIEW i expliqueu quina informació falta. No inventeu comptes, canvieu imports ni escriviu al llibre major.
Proporciona les tres files CSV amb la indicació. Un resultat útil tindria aquest aspecte; la redacció i els suggeriments del model poden variar:
| Data | Beneficiari | Import (USD) | Compte suggerit | Raó de revisió |
|---|---|---|---|---|
| 2026-08-03 | Office Depot | -45,00 | Expenses:Office:Supplies | La descripció identifica papers d'impressora. |
| 2026-08-04 | Cloud Hosting Inc | -120,00 | Expenses:Business:Hosting | La descripció identifica allotjament. |
| 2026-08-05 | Amazon | -29,90 | NEEDS_REVIEW | El nom del comerciant no identifica què es va comprar. |
La indicació expressa la teva intenció. No aplica permisos en una eina que pot escriure fitxers. Configura els controls d'aprovació del client abans de donar-li accés a un llibre major real.
3. Resol la incertesa i revisa les partides
Comprova el rebut de la compra d'Amazon. Per aquest exemple, identifica un cable USB-C per a l'oficina, i el revisor assigna Expenses:Office:Supplies. Sense aquesta evidència, deixa la fila pendent en lloc d'acceptar una categoria endevinada.
Crea un fitxer nou anomenat review.beancount amb l'exemple complet següent. Inclou les declaracions de comptes i el saldo inicial que el CSV no conté. Si has utilitzat el convertidor, compara les seves transaccions amb aquestes partides revisades; no afegeixis les dues còpies al mateix llibre major.
option "title" "AI bookkeeping review example"
option "operating_currency" "USD"
2026-08-01 open Assets:Bank:Checking USD
2026-08-01 open Equity:Opening-Balances USD
2026-08-01 open Expenses:Office:Supplies USD
2026-08-01 open Expenses:Business:Hosting USD
2026-08-01 * "Opening balance"
Assets:Bank:Checking 1000.00 USD
Equity:Opening-Balances -1000.00 USD
2026-08-03 * "Office Depot" "Printer paper"
Assets:Bank:Checking -45.00 USD
Expenses:Office:Supplies 45.00 USD
2026-08-04 * "Cloud Hosting Inc" "Monthly hosting"
Assets:Bank:Checking -120.00 USD
Expenses:Business:Hosting 120.00 USD
2026-08-05 * "Amazon" "Online purchase; receipt: office USB-C cable"
Assets:Bank:Checking -29.90 USD
Expenses:Office:Supplies 29.90 USD
2026-08-06 balance Assets:Bank:Checking 805.10 USDLa transacció de saldo inicial pertany a aquest llibre major de pràctica buit. En un llibre major existent, utilitza el seu balanç establert i les declaracions de comptes en lloc d'afegir un altre saldo inicial.
Abans d'acceptar un canvi proposat, compara cada transacció amb la seva fila d'origen. Confirma els signes, la moneda, els comptes i el rebut de suport. Un nom de comerciant familiar per si sol no estableix el propòsit d'una compra.
4. Valida i concilia
Executa el validador de Beancount a la mostra local:
bean-check review.beancountL'exemple complet hauria de passar sense errors. La seva asserció de balanç comprova l'import al compte corrent a l'inici del 6 d'agost, després de les tres retirades anteriors.
Confirma el resultat contra l'extracte:
- Tres transaccions de l'extracte apareixen una vegada cadascuna, a més del saldo inicial.
- Les retirades sumen 194,90 USD.
- El compte corrent manté 805,10 USD: el saldo inicial de 1.000,00 USD menys aquestes retirades.
- Les despeses d'oficina sumen 74,90 USD i l'allotjament totalitza 120,00 USD.
Si deixes la transacció d'Amazon pendent, el compte corrent roman a 835,00 USD i l'asserció falla per 29,90 USD. Investiga aquesta diferència; no afegeixis un ajust inexplicat només per fer passar la comprovació.
bean-check detecta errors de sintaxi, comptes, equilibri i assercions de balanç. No pot establir que un rebut sigui genuí, que hagis seleccionat la categoria de despesa correcta, ni que cada fila de l'extracte sigui present. Una transacció anotada al compte de despesa equivocat encara pot equilibrar perfectament.
Quan alguna cosa no coincideix
| Símptoma | Comprovació següent |
|---|---|
| El balanç difereix de l'extracte | Compara el saldo inicial, el nombre de transaccions, els signes, les dates i els imports amb l'origen. |
| Dues partides semblen iguals | Compara els identificadors de transacció d'origen i els rebuts. El mateix comerciant i import poden representar dues compres legítimes. |
| El model inventa un compte | Tria un compte existent o crea-ne un de deliberadament després de revisar el teu pla de comptes. |
| L'extracció omet una fila o canvia un decimal | Corregeix les dades extretes contra el document original abans de categoritzar-les. |
| El validador passa però un informe sembla incorrecte | Inspecciona les eleccions de comptes, el període d'informe i els càrrecs individuals. |
Demana a la IA que expliqui les discrepàncies i que assenyali les files afectades. Confirma l'evidència abans d'eliminar un duplicat sospitós o canviar un import.
5. Desa el resultat revisat i consulta'l
Quan repeteixis aquest flux de treball amb el teu propi extracte, fusiona només les teves transaccions revisades al teu llibre major real, després valida el fitxer combinat. Mantén les partides fictícies al fitxer de mostra. Si utilitzes Git, inspecciona el diff i fes commit a través del teu flux de treball habitual. Mantén l'extracte d'origen disponible per a la conciliació posterior. La guia de fluxos de treball scriptables cobreix l'automatització local repetible.
Pots verificar els totals de la mostra amb el Llenguatge de Consulta de Beancount. Amb Beanquery instal·lat, executa:
bean-query review.beancount "SELECT account, sum(position) WHERE account ~ '^Expenses:' AND date >= 2026-08-01 AND date < 2026-09-01 GROUP BY account"Els dos totals de despeses haurien de ser 74,90 USD per a subministraments d'oficina i 120,00 USD per a allotjament. Inspecciona el rang de dates i el filtre de comptes de la consulta, així com la seva sortida.
Amb un client d'IA connectat a un llibre major que conté la mostra, pots preguntar:
Consulteu el llibre major de mostra per a les despeses d'agost de 2026 agrupades per compte. Mostreu la consulta i els seus resultats. No canvieu cap fitxer.
Compara la seva resposta amb els mateixos totals. Una resposta fluida només és útil quan els seus números es poden rastrejar fins al llibre major.
Aplica el procés de revisió a Beancount.io
Per a arxius d'extractes, obre Importa → Importació Intel·ligent a la barra lateral del teu llibre major. Revisa les files extretes, tria Compte d'origen i Moneda, i utilitza Ompliment IA per a suggeriments de comptes de destinació. Corregeix les categories abans d'enviar Importa, el botó del qual inclou el nombre de transaccions. Comprova el diari i els saldos resultants en un llibre major de mostra abans de processar un extracte real. Verifica que les retirades redueixen el compte d'origen; el CSV anterior està preparat per al convertidor local, i els importadors poden interpretar els signes de manera diferent.
Per a l'Assistent allotjat, obre Pregunta a Beancount.io dins del teu llibre major. Comença amb una pregunta sobre partides existents. Quan proposa una edició de fitxer, revisa el diff abans d'aprovar-lo. Les importacions acceptades i les edicions de l'Assistent es registren a Git perquè puguis inspeccionar o revertir els canvis.
Per a MCP, segueix les instruccions de configuració específiques del client enllaçades anteriorment i autoritza el llibre major previst. Demana editLedgerFiles amb dry_run: true abans de permetre una edició. Inspecciona el contingut proposat i el resum de l'operació, després permet una crida d'escriptura separada només després de la revisió. La previsualització d'execució de prova no estableix la correcció comptable ni garanteix que el teu client demanarà permís abans d'una escriptura posterior.
Mantén el procés de revisió mentre automatitzes
Comença amb un lot petit i registra quins suggeriments canvies. Converteix els mapatges repetits i confirmats en regles d'importació explícites o proporciona exemples revisats com a context. No assumeixis que un model aprèn permanentment d'una correcció en una conversa.
Mantén separades les comprovacions d'extracció, la revisió de categories i la conciliació d'extractes. Cadascuna detecta un tipus d'error diferent. Per a importacions recurrents, també comprova que importar la mateixa font dues vegades no dupliqui transaccions silenciosament.
La investigació recolza aquesta distinció entre sintaxi vàlida i comptabilitat correcta. L'estudi de gener de 2025 de Figueroa Rosero i col·legues va avaluar models petits de pes obert en escenaris de ràtios financers i generació de transaccions utilitzant indicacions estructurades. Els seus resultats descriuen aquells models i tasques, més que no pas una taxa de precisió per als assistents actuals o el teu flux d'importació. Avalua el teu propi flux de treball utilitzant transaccions d'origen comprovades i les correccions que requereixen.
Eines per a un flux de treball local repetible
Tria una eina per a la part del procés que necessitis repetir:
- Beangulp proporciona un marc d'importador. Substitueix el marc
beancount.ingestmés antic a Beancount 3. - smart_importer és un paquet instal·lat per separat que afegeix suggeriments d'aprenentatge automàtic als importadors. No és una funció d'LLM integrada.
- Beanborg documenta categorització basada en regles, suggeriments d'aprenentatge automàtic i prediccions opcionals de ChatGPT. Comprova la seva configuració actual i compatibilitat abans d'adoptar-lo.
Per a un context més ampli, consulta la guia d'automatització de comptabilitat i la guia de flux de treball comptable mensual.
Explora un exemple més gran
El llibre major públic següent és separat de l'exercici de tres transaccions. Utilitza'l per explorar com encaixen comptes, transaccions i informes abans de connectar IA als teus propis llibres.