# Externalització de la Comptabilitat: Com Delegar les Teves Tasques Financeres (per a Usuaris de Beancount)

Si el teu llibre major viu en text pla, ja valores la claredat, el control i la reproduïbilitat. Externalitzar la teva comptabilitat no ha de comprometre res d'això. Ben al contrari, quan es fa bé, transforma la teva configuració de Beancount en un flux de treball fiable i documentat gestionat per especialistes, mentre tu conserves la propietat completa de les dades, el repositori i les regles.

Aquesta és una guia pràctica per a usuaris de Beancount sobre què externalitzar, què mantenir internament, com estructurar els lliurables i com avaluar proveïdors. Es tracta de delegar el treball mecànic sense renunciar mai al control.

---

## Per a Qui és Aquesta Guia

Aquesta guia és per a tu si encaixes en un d'aquests perfils:

- **Fundadors solitaris, indie hackers i consultors** que utilitzen Beancount i volen recuperar temps dedicat a les parts mecàniques de la comptabilitat per concentrar-se a construir el teu producte o servir clients.
- **Enginyers amb coneixements financers** que exigeixen controls estrictes, història versionada i auditabilitat completa, però no volen passar els caps de setmana important extractes bancaris i conciliant comptes ells mateixos.
- **Organitzacions que migren d'un proveïdor tot-en-un** que ara prioritzen la custòdia de les dades i la reproduïbilitat. Els tancaments sobtats i recents de plataformes comptables com Bench han subratllat una lliçó crítica: els plans de sortida i els formats oberts no són opcionals. ([TechCrunch](https://techcrunch.com/2024/12/27/bench-shuts-down-leaving-thousands-of-businesses-without-access-to-accounting-and-tax-docs/), [Informe de KSV Advisory](https://www.ksvadvisory.com/docs/default-source/insolvency-case-documents/bench/bankruptcy-proceedings/reports/bench-accounting-inc---first-report-of-the-trustee-dated-march-5-2025.pdf?sfvrsn=8b189e85_1))

---

## Beancount, Breument

Per als no iniciats, l'ecosistema de Beancount es construeix sobre uns quants components bàsics que el fan potent per a aquest tipus de flux de treball:

- **Beancount:** En el seu nucli, és un llenguatge de comptabilitat de doble entrada especificat en text pla. Escrius fitxers de llibre major llegibles per humans, els confirmes en un repositori Git i utilitzes un compilador per validar-los i generar informes financers. ([GitHub](https://github.com/beancount/beancount))
- **Fava:** Aquesta és l'elegant interfície web per a Beancount. Fava llegeix el teu fitxer de llibre major i et proporciona balanços de situació interactius, comptes de resultats, tendències, filtres i un potent llenguatge de consulta semblant a SQL per inspeccionar les teves dades. ([Demo de Fava](https://beancount.github.io/fava/))
- **beangulp:** El marc modern per automatitzar la ingesta de dades. Evolucionat de l'importador original de Beancount, `beangulp` proporciona les eines per escriure importadors robustos que poden analitzar extractes CSV, OFX, QFX i fins i tot PDF, convertint dades bancàries crues en entrades estructurades de Beancount. ([GitHub](https://github.com/beancount/beangulp))

Una relació d'externalització exitosa hauria de preservar i millorar aquests punts forts: control de versions, història llegible per humans, validació estricta i la composabilitat de les teves eines.

---

## Què Externalitzar vs. Què Mantenir

Per a la llista més àmplia de "què delegar primer" en comptabilitat, nòmines, TI i màrqueting — a més de com registrar la despesa de contractistes i el 1099-NEC — consulta [Externalització Empresarial: Què Delegar i Com Registrar-ho](/blog/2026/01/17/small-business-outsourcing-complete-guide).

La clau per a una delegació eficaç és una divisió clara del treball. Aquí tens com traçar la línia entre l'execució tàctica i la propietat estratègica.

### Grans Candidats per Externalitzar

Aquestes tasques són típicament repetitives, basades en regles i requereixen temps: perfectes per a un especialista.

- **Recopilació i Importació d'Extractes:** Descarregar extractes mensuals, normalitzar diversos formats de fitxer (CSV, OFX, PDF) i executar els teus importadors `beangulp`. Això inclou mantenir les regles dels importadors a mesura que les institucions financeres canvien inevitablement els seus formats d'extracte.
- **Assistència en la Categorització:** Construir heurístiques i regles declaratives per categoritzar transaccions. Opcionalment poden utilitzar eines com `smart_importer` per predir anotacions basades en dades històriques, però la revisió final sempre roman amb un humà.
- **Conciliació i Comprovacions d'Integritat:** El treball meticulós de publicar afirmacions `balance` per coincidir amb els teus extractes, investigar discrepàncies i assegurar que el llibre major romangui sense errors.
- **Adjunts i Higiene Documental:** Recuperar factures i rebuts, enllaçar-los a les transaccions amb metadades i arxivar els documents font en un arbre de directoris ordenat i reproduïble.
- **Tancament de Fi de Mes i Informes:** Preparar el conjunt estàndard d'informes (P\&G, Balanç de Situació, Estat de Fluxos d'Efectiu) i proporcionar vistes de Fava o exportacions per a les teves actualitzacions de gestió.
- **Operacions de Comptes a Cobrar/Comptes a Pagar i Preparació de Nòmines:** Preparar factures per al pagament, generar factures, perseguir cobraments i preparar fitxers de nòmines per a la teva revisió i aprovació final.
- **Preparació del Paquet Fiscal:** A final d'any, produir un balanç de comprovació net, calendaris de suport i tots els fitxers necessaris per al teu CPA o assessor fiscal.

### Mantenir Internament (Tu Ets el Propietari de la Intenció i el Risc)

Aquestes responsabilitats són estratègiques i defineixen la columna vertebral financera del teu negoci. Et pertanyen a tu.

- **Disseny del Pla de Comptes:** L'estructura i les convencions de nomenclatura dels teus comptes reflecteixen com penses sobre el teu negoci. Aquest és el teu mapa financer.
- **Polítiques Comptables Bàsiques:** Decisions sobre l'estructura de l'entitat, el reconeixement d'ingressos i les polítiques de capitalització tenen implicacions financeres i legals a llarg termini.
- **Aprovacions Finals:** Has de conservar l'última paraula sobre tots els moviments d'efectiu, incloent pagaments, execucions de nòmines i assentaments comptables significatius.
- **Finances Estratègiques:** Previsió, pressupostació i definir com es veu el "bé" per al teu negoci són responsabilitats fonamentals del propietari.

---

## El Flux de Treball d'Externalització Natiu de Beancount

Així és com es veu una col·laboració estructurada basada en Git a la pràctica.

### 1\) Estructura del Repositori (Exemple)

El teu repositori és la font única de veritat. Una estructura ben organitzada fa que el procés sigui transparent i mantenible.

```text
/ledger
  main.beancount        # Main ledger file, includes others
  accounts/             # Chart of Accounts definition
  includes/             # Monthly or yearly transaction files
  prices/               # Price directives for commodities/stocks
  metadata/             # Custom metadata declarations
  plugins/              # Custom Beancount plugins
  documents/            # Bank statements, receipts, invoices
/importers              # beangulp importers + rules
  config.yaml
  bank_x.py
  card_y.py
/scripts
  import.sh             # Orchestration script for importers
  close_month.py        # Month-end validation and reporting script
/reports
  monthly/
  year_end/
/ops
  runbook.md            # How to run the system
  checklist.md          # Procedural checklists (e.g., month-end)
  controls.md           # Documentation of financial controls
```

### 2\) El Cicle Setmanal

El treball rutinari hauria de seguir un ritme previsible, culminant en un lliurable clar per a la teva revisió.

1. **Ingesta:** El teu proveïdor descarrega extractes i executa els importadors `beangulp` per preparar noves transaccions.
2. **Categorització:** Apliquen regles de categorització i, si s'utilitza, suggeriments de `smart_importer`. Això es segueix d'una **revisió humana** per corregir qualsevol ambigüitat.
3. **Conciliació:** Afegeixen afirmacions `balance` per coincidir amb els totals dels extractes i investiguen qualsevol diferència. L'ús de directrius `pad` hauria de ser rar i sempre requerir una explicació clara.
4. **Documentació:** Els documents rellevants (rebuts, factures) s'adjunten a les transaccions.
5. **Confirmació i Proposta:** Els canvis es confirmen amb missatges descriptius i s'obre una sol·licitud d'extracció (pull request) per a la teva revisió, permetent-te veure el `diff` exacte del que ha canviat en els teus llibres.

### 3\) El Tancament de Fi de Mes (Mínim Viable)

Tancar els llibres és un punt de control crític per assegurar la precisió i produir informes fiables.

- Actualitza les directrius `price` per a qualsevol moneda estrangera o valors basats en el mercat.
- Revisa els elements pendents: comptes a cobrar, comptes a pagar, meritacions, despeses anticipades i préstecs.
- Valida que totes les afirmacions `balance` passin i que no hi hagi altres comprovacions fallides.
- Etiqueta la confirmació amb el període de tancament (per exemple, `2025-08-close`) i exporta els informes estàndard.
- Publica una instantània de Fava o proporciona una URL segura per al període.

### 4\) El Paquet de Fi d'Any

La culminació del treball de l'any és un paquet ordenat i auditable per al teu preparador d'impostos. Això inclou un balanç de comprovació final, calendaris de suport per a comptes clau (com actius fixos o inventari) i un script reproduïble per regenerar tots els artefactes directament des del repositori Git.

---

## Seguretat i Accés (Innegociables)

Un flux de treball professional prioritza la seguretat i la teva propietat de les dades.

- **Custòdia de Dades Primer:** Tu ets el propietari del repositori Git privat. El teu proveïdor hauria de treballar des d'una bifurcació (fork) i enviar sol·licituds d'extracció. Mai haurien d'allotjar l'única còpia del teu llibre major.
- **Accés Bancari:** Proporciona accés de només lectura sempre que sigui possible. Si has d'utilitzar un servei agregador, crea credencials aïllades i tingues un procés clar per revocar-les.
- **Secrets i Xifratge:** Utilitza eines com GPG o `age` per xifrar documents sensibles en repòs. Aplica l'autenticació multifactor a tots els serveis. Opera amb el principi de mínim privilegi.
- **Accés a Fava:** Hauries d'allotjar Fava tu mateix o executar-lo localment (`fava ledger.beancount`) i compartir l'accés per a sessions de revisió mitjançant un túnel segur o VPN. Evita exposar-lo directament a internet pública.
- **Pla de Sortida:** Insisteix en un manual de "estirar el cordó". Això hauria d'incloure dipòsit en garantia o lliurament garantit de tots els scripts, configuracions i documentació. Com mostren els esdeveniments recents, els proveïdors poden desaparèixer d'un dia per l'altre; els teus registres financers no han de quedar atrapats amb ells.

---

## Com Es Veuen els "Bons" Lliurables (Cada Mes)

Al final de cada mes, hauries de rebre dues coses: un artefacte tècnic i un resum de negoci.

**1. Una Sol·licitud d'Extracció Neta que Contingui:**

- Totes les transaccions importades i revisades per al període.
- Un `diff` de qualsevol regla d'importador nova o modificada.
- Missatges de confirmació que resumeixin supòsits clau o ajustos manuals.
- Un estat 100% verd en totes les **afirmacions `balance`**, amb un registre que mostri que cada compte s'ha conciliat.
- Enllaços en el fitxer de Beancount a tots els documents adjunts, més un informe de qualsevol document que falti.
- Directrius `price` actualitzades per a inversions o monedes estrangeres.

**2. Un Paquet de Gestió que Contingui:**

- Informes estàndard: P\&G, Balanç de Situació i Estat de Fluxos d'Efectiu.
- Mètriques clau com la pista d'efectiu i els ressaltats de variació entre pressupost i real.
- Enllaços directes a vistes de Fava pre-filtrades per a anàlisi interactiva més profunda.

---

## Tipus de Proveïdors (I Quan Encaisen)

No tots els proveïdors són iguals. Ajusta el proveïdor a la teva etapa i complexitat.

- **Comptable Expert en Beancount:** Perfecte per gestionar el flux de treball bàsic: importació constant, categorització, conciliacions i preparació de paquets d'informes de fi de mes.
- **Despatx Comptable Boutique:** Una bona opció si necessites serveis addicionals com gestionar comptes a cobrar/comptes a pagar, coordinació de nòmines, consolidació multi-entitat o suport en la preparació fiscal.
- **Controller/CFO Fraccional:** L'elecció adequada quan necessites supervisió estratègica. Ajuden a dissenyar polítiques comptables, construir previsions financeres, preparar informes a nivell de consell i dissenyar controls interns.

Els contractes es solen estructurar amb un honorari mensual per al treball rutinari i una tarifa per hora per a projectes ad hoc.

---

## Preguntes d'Entrevista per a l'Externalització de Beancount

Quan avaluïs un proveïdor potencial, fes preguntes específiques i tècniques per avaluar la seva experiència.

- Quins importadors `beangulp` has construït o mantingut personalment? Pots mostrar-me exemples anonimitzats?
- Lliuraràs **scripts reproduïbles** i un manual d'operacions, o només els fitxers de sortida finals?
- Com fas complir la integritat de les dades en el teu procés? (Busca respostes que involucrin afirmacions `balance`, llistes de verificació de revisió i potser fins i tot linting CI/CD).
- Utilitzes `smart_importer`? Si és així, quin és el teu procés per revisar i anul·lar les seves prediccions?
- Com proposes que estructuris el flux de treball de Git (per exemple, estratègia de branques, plantilles de sol·licitud d'extracció, convencions de missatges de confirmació)?
- Quin és el teu **pla de sortida**? Com és el procés de devolució de dades per assegurar zero bloqueig?
- Com executes Fava de manera segura per a sessions de revisió amb clients?

---

## Una Declaració de Treball (SoW) Simple que Pots Copiar i Enganxar

Utilitza això com a punt de partida per al teu acord de col·laboració.

```text
Scope of Work

- Weekly transaction imports via beangulp; includes rules maintenance for all connected financial institutions.
- Human-reviewed transaction categorization. Use of smart_importer for suggestions is permitted, but entries will not be auto-committed without review.
- Weekly reconciliations against statements, enforced with `balance` assertions. Variance notes will be provided for any unreconciled differences greater than $X.
- Document collection for all significant transactions; attachment hygiene and a monthly missing-documents report.
- Month-end close process, including price updates, accruals checklist, and delivery of Fava report links.
- Year-end package preparation, including a trial balance and supporting schedules for CPA review.

Deliverables

- A monthly pull request tagged "<YYYY-MM>-close" with all checks passing.
- Updates to the `/ops` folder, including diffs for `runbook.md` and `controls.md`.
- Final reports archived in `/reports/monthly` with a summary changelog.

Access & Security

- All work will be performed in the client-owned private Git repository. Vendor access is granted via a dedicated user, and all changes will be submitted via pull requests.
- Credentials will be scoped to read-only access where possible. Multi-factor authentication is required on all shared services.
- Sensitive documents will be stored using client-provided encryption keys and will be purged from vendor systems upon termination.

SLA & Cadence

- A weekly PR with reconciled transactions will be submitted every <Day of Week>.
- The month-end closing PR will be submitted by business day <N> of the following month.
- Standard response time for inquiries is <X> business hours; critical issue response is <Y> hours.

Exit Clause

- Upon termination, the vendor will hand back the complete repository, all scripts, documentation, and a map of all credentials used within <Z> business days. A 2-hour turnover call is included.
```

---

## Consells que Estalvien Hores (I Dolor Futur)

- **Anomena els comptes per a la conciliació.** Estructura els noms dels teus comptes per incloure la institució i els últims quatre dígits del número de compte (per exemple, `Assets:Bank:Chase:Checking:1234`). Això fa que la depuració sigui trivial.
- **Afirma saldos en els límits dels extractes.** Tracta cada extracte bancari com un punt de verificació comprovable. Una directriu `balance` al final de cada període d'extracte assegura que els errors es detectin aviat i quedin continguts.
- **Automatitza les actualitzacions de preus.** Utilitza les eines de Beancount per obtenir preus de mercat automàticament i registrar-los amb directrius `price`. Això és essencial per a informes precisos d'inversions i tipus de canvi.
- **Mantén les regles declaratives.** Afavoreix escriure importadors `beangulp` petits i provables sobre construir scripts complexos i ad hoc. Les regles declaratives són més fàcils de mantenir i depurar.
- **Revisa amb Fava, aprova a Git.** Utilitza la potent interfície de Fava per explorar els canvis i entendre el seu impacte. Però l'aprovació final passa per revisar el `diff` en una sol·licitud d'extracció de Git. Mai deixis que els teus llibres es converteixin en una "caixa negra".

---

## Eines Utilitzades Freqüentment en Aquesta Pila

- **Beancount:** Motor principal i documentació del llenguatge. ([Docs](https://beancount.github.io/docs/index.html))
- **beangulp:** L'estàndard per construir importadors. ([GitHub](https://github.com/beancount/beangulp))
- **smart_importer:** Prediccions assistides per aprenentatge automàtic per a la categorització. ([GitHub](https://github.com/beancount/smart_importer))
- **Fava:** La interfície web indispensable per visualitzar el teu llibre major. ([Lloc web](https://beancount.github.io/fava/))

---

## La Conclusió

Externalitzar per a usuaris de Beancount no tracta de "renunciar al control". És el contrari. Es tracta de **codificar** els teus processos financers perquè un especialista els pugui executar de manera fiable en el teu nom. Tu conserves el repositori, els scripts, les afirmacions i la capacitat fonamental de regenerar qualsevol informe des de zero. Delegues el treball, no la propietat.
