# Страхотен Beancount

Подбрано ръководство за екосистемата на Beancount. Beancount е мощна, отворена счетоводна система, която използва прост, текстово-базиран формат за управление на вашите финанси със стриктността на двустранното счетоводство. Тази страница съчетава курирани от общността списъци и прегледи на екосистемата в един цялостен ресурс.

## Защо счетоводство с обикновен текст?

Счетоводството с обикновен текст (PTA) е методология за управление на финанси, използваща прости текстови файлове и мощни инструменти от командния ред. Този подход ви дава пълна собственост върху данните ви, осигурява дълготрайност и предлага несравнима гъвкавост за автоматизация и анализ.

- **Официален PTA център:** [Plain Text Accounting](https://plaintextaccounting.org/)
- **Кратко въведение:** [Accounting for the simple minds with plain text accounting](https://dustri.org/b/accounting-for-the-simple-minds-with-plain-text-accounting.html)
- **От уеб приложения до CLI:** [Command line accounting: From mint.com to Ledger](https://muehe.org/posts/command-line-accounting/)

***

## Екосистемата на Beancount

Екосистемата на Beancount е колекция от инструменти, плъгини и ресурси, изградени около основен двигател. Всеки компонент играе специфична роля в създаването на цялостен работен процес за финансово управление.

### 1. Основен двигател и официални ресурси

Това са основните елементи на Beancount, поддържани от създателя и официалните сътрудници.

| Ресурс               | Описание                                                                                                                                                                                                                                                  |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beancount (Ядро)** | Двигателят, който чете вашия счетоводен файл, прилага правила за двустранно счетоводство и генерира отчети. Той предоставя основни помощни програми от командния ред като `bean-check` и `bean-format`. Всички други инструменти са изградени върху него. |
| **Начална страница** | [beancount.github.io](https://beancount.github.io/)                                                                                                                                                                                                       |
| **Изходен код**      | [github.com/beancount/beancount](https://github.com/beancount/beancount)                                                                                                                                                                                  |
| **Документация**     | [GitHub Pages](https://beancount.github.io/docs/) и [Google Docs](https://docs.google.com/document/d/1RaondTJCS_IUPBHFNdT8oqFKJjVJDsfsn6JEjBG04eA/edit)                                                                                                   |
| **Външни приноси**   | [Официален списък с приноси от общността](https://beancount.github.io/docs/external_contributions.html)                                                                                                                                                   |
| **Beanquery**        | Мощен, подобен на SQL инструмент за заявки (`v3`) за стартиране на разширени заявки (напр. `SELECT ... FROM ... WHERE ...`) към вашия счетоводен файл за генериране на персонализирани анализи.                                                           |

### 2. Потребителски интерфейси

Тези инструменти предоставят визуални интерфейси за изследване и редактиране на вашите финансови данни.

| Инструмент                 | Описание                                                                                                                                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fava**                   | Окончателното, пълнофункционално уеб табло за Beancount. То предоставя интерактивни диаграми, подробни таблици, редактиране в браузъра и система от разширения за добавяне на функции като бюджетиране. |
| **Fava-GTK**               | Нативно GNOME Desktop приложение, което обвива Fava за безпроблемно настолно изживяване.                                                                                                                |
| **Beancount Mobile**       | Мобилно приложение за въвеждане на данни за добавяне на транзакции в движение.                                                                                                                          |
| **Beancount Telegram Bot** | Telegram бот за бързо добавяне на транзакции към вашия счетоводен файл чрез чат.                                                                                                                        |

### 3. Импортиране на транзакции

Импортирането е процес на конвертиране на данни от финансови институции (като банкови CSV или PDF файлове) в записи на Beancount.

| Инструмент                  | Описание                                                                                                                                                       |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beangulp (v3)**           | Модерната, самостоятелна рамка за изграждане на импортери. Тя обработва външни файлове чрез Python скриптове (плъгини), за да генерира директиви на Beancount. |
| **Smart Importer**          | Инструмент, който обогатява импортерите с машинно обучение за автоматично прогнозиране и присвояване на категории.                                             |
| **Beancount Reds Ingestor** | Колекция от импортери с обща библиотека за обработка на CSV и OFX файлове.                                                                                     |
| **double-entry-generator**  | Базиран на правила импортер, фокусиран върху китайски услуги като Alipay и WeChat Pay.                                                                         |

#### Импортери на общността (по държави)

Огромна колекция от скриптове за конкретни банки и услуги, поддържани от общността.

- **Китай**

  - Alipay / 支付宝: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator), [wzyboy/importer](https://github.com/wzyboy/awesome-beancount/blob/master/importers/alipay_acclog.py)
  - China Merchants Bank (CMB): [Дебитна карта](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_debit_cards.py), [Кредитна карта](https://github.com/wzyboy/awesome-beancount/blob/master/importers/cmb_credit_cards.py)
  - WeChat Pay / 微信支付: [deb-sig/double-entry-generator](https://github.com/deb-sig/double-entry-generator)

- **Франция**

  - Caisse d'Epargne: [beancount-ce](https://github.com/ArthurFDLR/beancount-ce)
  - Boursorama, Amex: [Beancount-myTools](https://github.com/grostim/Beancount-myTools)

- **Германия**

  - Commerzbank: [beancount-commerzbank](https://github.com/siddhantgoel/beancount-commerzbank)
  - Deutsche Kredit Bank (DKB): [beancount-dkb](https://github.com/siddhantgoel/beancount-dkb)
  - ING: [beancount-ing](https://github.com/siddhantgoel/beancount-ing)
  - N26: [beancount-n26](https://github.com/siddhantgoel/beancount-n26)
  - Volksbank & GLS-Bank: [beancount-importer-volksbank](https://github.com/Fjanks/beancount-importer-volksbank)

- **Индия**
  - SBI, BOI, Paytm, HSBC, ICICI: [beancount-importers-india](https://github.com/dumbPy/beancount-importers-india)

- **Нидерландия**
  - ABN AMRO: [beancount-abnamro](https://github.com/deepakg/beancount-abnamro)

- **Швейцария**

  - Общи: [tariochbctools](https://tariochbctools.readthedocs.io/) (BCGE, Neon, Raiffeisen, ZKB, Fidelity)
  - Finpension: [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#finpension-importer)
  - PostFinance: [tariochbctools](https://github.com/tarioch/beancounttools/blob/master/src/tariochbctools/importers/postfinance/importer.py), [drnuke-bean](https://github.com/Dr-Nuke/drnuke-bean?tab=readme-ov-file#postfinance-importer-swiss)

- **Великобритания**

  - Monzo, Revolut, Wise: [Evernight/beancount-importers](https://github.com/Evernight/beancount-importers/)
  - Revolut, Wise: [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#revolut)

- **САЩ**

  - Amex, Chase, Citi, Schwab: [mterwill/gist](https://gist.github.com/mterwill/7fdcc573dc1aa158648aacd4e33786e8#file-importers-amex-py)
  - Capital One: [mtlynch/beancount-capitalone](https://github.com/mtlynch/beancount-capitalone)
  - Chase: [mtlynch/beancount-chase-bank](https://github.com/mtlynch/beancount-chase-bank), [ArthurFDLR/beancount-chase](https://github.com/ArthurFDLR/beancount-chase)
  - Clipper: [beancount-clipper](https://git.sr.ht/~goorzhel/beancount-clipper)
  - Mercury: [mtlynch/beancount-mercury](https://github.com/mtlynch/beancount-mercury)

- **Блокчейн**
  - [tariochbctools](https://tariochbctools.readthedocs.io/en/latest/importers.html#blockchain)

### 4. Поддръжка на редактори и инструменти

Инструменти, които интегрират Beancount във вашата среда за разработка, за да опростят редактирането и поддръжката.

- **Поддръжка на IDE:** Плъгини, осигуряващи подсветка на синтаксиса, автоматично довършване и проверка на баланса в реално време.

  - [VSCode](https://marketplace.visualstudio.com/items?itemName=Lencerf.beancount)
  - [Emacs](https://github.com/beancount/beancount-mode)
  - [Vim](https://github.com/nathangrigg/vim-beancount)
  - [Zed](https://github.com/zed-extensions/beancount)
  - [Sublime Text](https://github.com/norseghost/sublime-beancount)
  - [Atom](https://atom.io/packages/beancount)
  - [Beancount Language Server](https://github.com/polarmutex/beancount-language-server) (за всеки LSP-съвместим редактор)

- **Автоматизация и помощни програми:**

  - `bean-add`: Интерактивно добавяне на транзакции от командния ред.
  - `beancount-black`: Форматер на код по подразбиране за Beancount файлове.
  - `beancount-categorizer`: Автоматично категоризира транзакции с правила за регулярни изрази.
  - `beanahead`: Администрира и проектира бъдещи транзакции.

- **Инструменти за миграция на данни:** Помощни програми за конвертиране на данни от други счетоводни системи.

  - От GnuCash: [henriquebastos/gc-to-bc](https://github.com/henriquebastos/gnucash-to-beancount/), [dtrai2/gc-to-bc](https://github.com/dtrai2/gnucash-to-beancount/)
  - От Ledger/hledger: [travisdahlke/gist](https://gist.github.com/travisdahlke/71152286b0a8826249fe), [zacchiro/ledger2beancount](https://github.com/zacchiro/ledger2beancount)
  - От YNAB: [hoostus/beancount-ynab](https://github.com/hoostus/beancount-ynab)

### 5. Плъгини (Разширения на главната книга)

In-ledger Python модули, които работят по време на обработка, за да прилагат персонализирани правила, да автоматизират транзакции или да добавят нови функции.

- **Бюджетиране:**
  - [fava-envelope](https://github.com/polarmutex/fava-envelope): Разширение на Fava за бюджетиране в стил плик.

- **Автоматизация и проверки:**

  - [autobean.share](https://github.com/SEIAROTg/autobean/tree/master/autobean/share): Разделяне на разходи и управление на дългове.
  - [autobean.sorted](https://github.com/SEIAROTg/autobean/tree/master/autobean/sorted): Гарантира, че транзакциите са хронологично подредени.
  - [beancount-checkclosed](https://github.com/daniel-wells/beancount_checkclosed): Автоматично проверява за нулев баланс по закрити сметки.

- **Манипулация на данни:**

  - [autobean.narration](https://github.com/SEIAROTg/autobean/tree/master/autobean/narration): Автоматично генерира описания на транзакции.
  - [beancount-lazy-plugins.filter\_map](https://github.com/Evernight/beancount-lazy-plugins/tree/main?tab=readme-ov-file#filter_map): Прилага операции към филтрирана група транзакции.

### 6. Източници на цени

Скриптове, които извличат исторически и текущи цени на стоки, акции и валути за проследяване на стойностите на инвестициите.

- [beancount-exchangerates](https://github.com/xuhcc/beancount-exchangerates): За фиатни валути чрез API като `frankfurter.dev`.
- [pricehist](https://gitlab.com/chrisberkhout/pricehist): Извлича цени от множество източници.
- [beancount-cryptoassets](https://github.com/xuhcc/beancount-cryptoassets): За извличане на цени на криптовалути.
- [tariochbctools](https://tariochbctools.readthedocs.io/): Включва източник на цени за Interactive Brokers.

***

## Обучение и общност

### Книги и подробни ръководства

- **Проследяване на лични финанси с Python:** Книга, която предоставя изчерпателно ръководство за изграждане на система за лични финанси с Beancount. ([Уебсайт](https://personalfinancespython.com/))
- **Поредица от китайски блогове (BYVoid):** [Част 1: Защо?](https://byvoid.com/zhs/blog/beancount-bookkeeping-1), [Част 2: Дебити и кредити](https://byvoid.com/zhs/blog/beancount-bookkeeping-2)

### Избрани публикации в блогове

- **Английски**

  - [Counting beans - and more - with Beancount](https://lwn.net/Articles/751874/)
  - [Managing Personal Finances using Python](https://sgoel.dev/posts/managing-personal-finances-using-python/)
  - [No-Bullshit Beancount Introduction](https://web.archive.org/web/20221119110728/https://blog.leononame.dev/2019/08/beancount/)

- **Френски**
  - [Beancount ou la comptabilité pour les hackers](https://cyril.deguet.com/fr/2015/09/03/beancount-comptabilite-pour-hackers/)

- **Китайски**
  - [Beancount —— 命令行复式簿记](https://wzyboy.im/post/1063.html)

### Общност

- **Пощенски списък:** [Google Groups](https://groups.google.com/g/beancount) (Основен дискусионен форум)
- **Чат на живо (IRC):** [#beancount on web.libera.chat](https://web.libera.chat/gamja/?channels=%23beancount)
- **Telegram (китайски):** [t.me/beancount\_zh](https://t.me/beancount_zh)

***

## Търговски услуги и приложения

За потребители, които искат силата на Beancount, без да управляват инфраструктурата сами.

| Услуга           | Описание                                                                                                                                                                                                                                                                         |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beancount.io** | SaaS (Софтуер като услуга) платформа, предоставяща готова Beancount и Fava инстанция. Тя също така предлага специализирани мобилни приложения за [iOS](https://apps.apple.com/app/id1527950512) и [Android](https://play.google.com/store/apps/details?id=io.beancount.android). |

## Използвайте силата на обикновения текст.

Създайте счетоводна книга в Beancount или следвайте ръководството за собствена настройка.

[Започнете безплатно](https://beancount.io/sign-up/?next=%2Fledger%2F) [Ръководство за начало](https://beancount.io/bg/docs/getting-started)

## Where to look next

- [Sitemap](https://beancount.io/sitemap.xml) - all pages with hreflang alternates
- [LLMs index](https://beancount.io/llms.txt) - curated links for AI agents (also /llms-full.txt for full docs)
- [Documentation](https://beancount.io/docs) - every doc is also available as text/markdown via .md suffix or Accept negotiation
- [REST API reference](https://beancount.io/docs/api-reference) - interactive endpoints, schemas, authentication, and code samples
- [OpenAPI spec](https://beancount.io/openapi.json) - OpenAPI 3.1 spec for this website's public content endpoints; the product contract for ledger operations is at https://beancount.io/api-gateway/v1/openapi.json
- [GraphQL](https://beancount.io/graphql) - public, read-only content API over the blog and research logs (no credentials, no ledger data): 12 query fields over 23 types
- [MCP server](https://beancount.io/mcp) - Model Context Protocol at https://beancount.io/api-gateway/mcp
