48 публикации маркиран с/със "Beancount"

Изборът на лична счетоводна система включва компромиси между производителност, архитектура на данните и разширяемост. За инженери и други технически потребители, изборът често се свежда до това коя система предоставя най-стабилната, предвидима и програмируема основа.

Въз основа на подробен сравнителен доклад, нека анализираме техническите спецификации на Beancount спрямо неговите популярни алтернативи с отворен код: Ledger-CLI, hledger и GnuCash.

Скорост и производителност: Количествени показатели 🚀​

За всеки сериозен набор от данни, производителността е от съществено значение. Beancount е проектиран да обработва десетилетия транзакционни данни без компромис със скоростта. Въпреки че е имплементиран в Python (v2), неговият силно оптимизиран парсер е изключително ефективен.

• Beancount: Реалното използване показва, че може да зарежда и обработва счетоводни книги със стотици хиляди транзакции за приблизително 2 секунди. Използването на памет е умерено; парсирането на ~100 000 транзакции конвертира изходния текст в обекти в паметта, използвайки само десетки мегабайти RAM.
• Тест за натоварване с 1 милион транзакции: Тест с използване на синтетична счетоводна книга с 1 милион транзакции, 1000 сметки и 1 милион ценови записи разкри значителни архитектурни разлики:
  • hledger (Haskell): Успешно завърши пълно парсиране и отчет за ~80,2 секунди, обработвайки ~12 465 транзакции/сек, използвайки ~2,58 GB RAM.
  • Ledger-CLI (C++): Процесът беше прекратен след 40 минути без завършване, вероятно поради известна регресия, причиняваща прекомерно използване на памет и процесор при силно сложни счетоводни книги.
  • Beancount: Въпреки че не е включен в този специфичен тест с 1 милион транзакции, неговата крива на производителност предполага, че би се справил ефективно със задачата. Освен това, предстоящият Beancount v3, с новото си C++ ядро и Python API, се очаква да достави още едно порядъчно подобрение в пропускателната способност.
• GnuCash (C/Scheme): Като GUI приложение, зареждащо целия си набор от данни в паметта, производителността се влошава забележимо с размера. XML файл от ~50 MB (представляващ 100 000+ транзакции) отне 77 секунди за отваряне. Преминаването към SQLite backend само незначително подобри това до ~55 секунди.

Заключение: Beancount осигурява изключителна производителност, която се мащабира предвидимо, ключова характеристика за дългосрочно управление на данни. Той избягва проблемите с производителността, наблюдавани в Ledger, и латентността, свързана с потребителския интерфейс на GnuCash.

Архитектура на данните: Обикновен текст срещу непрозрачни бази данни 📄​

Начинът, по който системата съхранява вашите данни, определя нейната прозрачност, преносимост и издръжливост. Beancount използва чист, четим от човек текстов формат, който е превъзходен за технически потребители.

• Компактен и ефективен: Файл на Beancount със 100 000 транзакции е само ~8,8 MB. Това е по-компактно от еквивалентния Ledger файл (~10 MB), отчасти защото синтаксисът на Beancount позволява извеждане на крайния балансиращ размер в транзакция, намалявайки излишъка.
• Структурно наложен: Beancount изисква изрични директиви YYYY-MM-DD\ open\ Account. Този дисциплиниран подход предотвратява печатни грешки в имената на сметките да създават мълчаливо нови, неправилни сметки - често срещан капан в системи като Ledger и hledger, които създават сметки в движение. Тази структура прави данните по-надеждни за програмна манипулация.
• Готов за контрол на версиите: Счетоводна книга в обикновен текст е идеално подходяща за контрол на версиите с Git. Получавате пълна, проверяема история на всяка финансова промяна, която правите.
• Контраст с GnuCash: GnuCash използва по подразбиране gzip-компресиран XML файл, където данните са подробни и обвити в тагове с GUID за всяка единица. Въпреки че предлага SQLite, MySQL и PostgreSQL backends, това абстрахира данните от проста, директна текстова манипулация и версииране. Редактирането на суровия XML е възможно, но е много по-тромаво от редактирането на Beancount файл.

Заключение: Форматът на данните на Beancount не е просто текст; това е добре дефиниран език, който максимизира яснотата, налага коректност и се интегрира безпроблемно с инструменти за разработчици като git и grep.

Убийствената функция: Истинско Python API и плъгин архитектура 🐍​

Това е определящото техническо предимство на Beancount. Той не е монолитно приложение, а библиотека със стабилно, първокласно Python API. Това дизайнерско решение отключва неограничени възможности за автоматизация и интеграция.

• Директен програмен достъп: Можете да четете, заявявате и манипулирате данните от счетоводната си книга директно в Python. Ето защо разработчиците мигрират. Както отбеляза един потребител, фрустрацията от опитите за скриптиране срещу лошо документираните вътрешни връзки на Ledger изчезва с Beancount.
• Плъгин тръбопровод: Зареждащото устройство на Beancount ви позволява да вмъквате персонализирани Python функции директно в тръбопровода за обработка. Това позволява произволни трансформации и валидации на потока от данни, докато се зарежда - например, писане на плъгин, за да се гарантира, че всеки разход от конкретен доставчик трябва да има определен етикет.
• Мощна рамка за импортиране: Преминете отвъд тромавите CSV съветници за импортиране. С Beancount, вие пишете Python скриптове за парсиране на финансови отчети от всеки източник (OFX, QFX, CSV). Инструменти на общността като smart_importer дори използват модели за машинно обучение, за да предсказват и присвояват автоматично сметки за осчетоводяване, превръщайки часове ръчно категоризиране в процес от няколко секунди с една команда.
• Как се сравняват другите:
  • Ledger/hledger: Разширяемостта е предимно външна. Вие предавате данни към/от изпълнимия файл. Въпреки че могат да извеждат JSON/CSV, не можете да инжектирате логика в основния им цикъл на обработка, без да модифицирате C++/Haskell изходния код.
  • GnuCash: Разширяемостта се обработва чрез стръмна крива на обучение с Guile (Scheme) за персонализирани отчети или чрез Python връзки (използвайки SWIG и библиотеки като PieCash), които взаимодействат с GnuCash двигателя. Той е мощен, но по-малко директен и "Pythonic" от родния библиотечен подход на Beancount.

Заключение: Beancount е проектиран за програмиста. Неговият дизайн, ориентиран към библиотеката, и дълбоката интеграция с Python го правят най-гъвкавата и автоматизируема система от четирите.

Философия: Строг компилатор за вашите финанси 🤓​

Кривата на обучение на Beancount е пряк резултат от основната му философия: вашите финансови данни са формален език и трябва да са правилни.

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

Този детерминистичен подход осигурява ниво на целостта на данните, което е безценно за изграждането на надеждни автоматизирани системи върху него. Можете да пишете скриптове, които консумират изхода на Beancount с увереност, знаейки, че данните вече са строго валидирани.

За кого е Beancount?​

Въз основа на този технически анализ, Beancount е оптималният избор за:

• Разработчици и инженери, които искат да третират финансите си като контролиран от версии, програмируем набор от данни.
• Любители на данните, които искат да пишат персонализирани заявки, да изграждат уникални визуализации с инструменти като Fava или да подават финансовите си данни в други аналитични модели.
• Всеки, който цени доказуема коректност и автоматизация пред удобството на графичен потребителски интерфейс или снизходителността на по-малко структуриран формат.

Ако желаете сурова C++ производителност за стандартни отчети, Ledger е претендент. За изключителна мащабируемост във функционална парадигма на програмиране, hledger е впечатляващ. За GUI, пълен с функции, с минимална настройка, GnuCash е отличен.

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

Управлението на малък бизнес е постоянно жонглиране с парични потоци, доставчици и клиенти – данъчните изненади не бива да са още една топка във въздуха. Добрата новина: с проста рамка и няколко трика на Beancount можете да превърнете „Надявам се данъчната сметка да не е огромна“ в предвидимо месечно прехвърляне.

1. Знайте за какво наистина плащате​

Преди да можете да заделите пари, трябва да знаете къде отиват. За повечето малки бизнеси в САЩ (особено еднолични търговци и партньорства), общото данъчно задължение е комбинация от няколко отделни задължения.

• Федерален данък общ доход: Това е прогресивен данък, което означава, че ставката се увеличава с увеличаване на дохода ви. За 2025 г. скалите достигат до 37% за необвързани лица с доходи над $626 350 и за семейни двойки, подаващи съвместно декларация (MFJ), с доходи над$751 600.
• Данък върху самонаетите лица (SE): Това е версията за предприемачи на данъците FICA (социално осигуряване и Medicare), които плащат служителите по W-2. Той е фиксиран на 15,3% върху първата част от нетните ви доходи. 12,4% за социално осигуряване спират, след като печалбата ви достигне годишната база за заплати, която се очаква да бъде $176 100 през 2025 г. Останалите 2,9% за Medicare продължават върху всички печалби.
• Данък общ доход на щата и местните власти: Това варира значително в зависимост от местоположението, варирайки от 0% в щати като Уайоминг и Тексас до над 13% в най-високата скала на Калифорния.
• Тримесечни глоби за неплащане: IRS иска парите си през цялата година, а не наведнъж. За да избегнете глоби, обикновено трябва да платите предварително поне 90% от данъчното си задължение за текущата година или 100% от данъчната си сметка за предходната година (този праг се повишава до 110%, ако вашият коригиран брутен доход или AGI е над $150 000).

Бърза евристика: Повечето самостоятелно заети лица в САЩ, които живеят в щат със средно данъчно облагане, в крайна сметка дължат 25% - 30% от нетната печалба, след като се комбинират федералните, SE и щатските данъци.

2. Триетапна оценка, която можете да актуализирате месечно​

Не ви е необходим сложен софтуер, за да се справите с това. Достатъчен е един прост, повтарящ се процес.

1. Прогнозирайте годишната печалба: Погледнете резултатите си от началото на годината до момента и направете разумна прогноза за цялата година. Основната формула е ваш приятел: Прогнозирани приходи - Прогнозирани разходи за приспадане = Прогнозирана печалба.
2. Приложете ефективна данъчна ставка: Започнете с разумен процент. Ако имате данъчна декларация от миналата година, можете да изчислите ефективната си ставка от нея. Ако сте нови в това, евристиката от 30% е добра отправна точка.
3. Разделете на 12 (или 52): Вземете общия си прогнозен годишен данък и го разделете на броя на периодите на плащане, които искате да използвате. Препоръчваме месечно. Прехвърляйте тази сума в специална банкова сметка за данъчен резерв всеки месец. Ако вашият паричен поток е по-нестабилен, седмичното прехвърляне може да ви се стори по-управляемо.

3. Приложете го в Beancount​

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

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

; Заделяне на данъци за юли
2025-07-31 * "Прехвърляне на данъчен резерв"
  Assets:Bank:Checking          -3000 USD
  Assets:Bank:TaxReserve         3000 USD
  Equity:Opening-Balances

Когато извършвате тримесечно прогнозно плащане на държавата, записвате действителното задължение. Плащането идва директно от вашата резервна сметка.

; Записване на задължението при подаване на тримесечното плащане
2025-09-15 * "Тримесечно плащане на прогнозен данък"
  Assets:Bank:TaxReserve        -9000 USD
  Liabilities:Taxes:Federal      6000 USD
  Liabilities:Taxes:State        3000 USD

Тази проста система ви дава три мощни предимства:

• Незабавна видимост: Салдото по Assets:Bank:TaxReserve винаги показва какво вече е „заделено“. Знаете с един поглед, че тези пари не са налични за други бизнес разходи.
• Точна печалба: Тъй като резервът се третира като прехвърляне между сметки за активи, вашият отчет за печалби и загуби не е изкривен. Вие записвате данъчното задължение само когато действително го подадете и платите.
• Одитна следа: Всяко плащане към IRS или вашата държавна хазна е свързано с ясно маркирано движение от вашата резервна сметка, създавайки чиста документация.

4. Фина настройка на вашия процент​

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

• Консултанти/агенции с висока печалба: Ако надвишавате значително базата за заплати за социално осигуряване ($176 100), вашата ефективна данъчна ставка ще се повиши. Ставка от 30% - 35% е вероятно по-точна.
• Продуктови бизнеси със значителни приспадания: Ако имате значителни разходи за продадени стоки (COGS), инвентар или други приспадания, вашият марж на нетна печалба е по-нисък. Ставка от 20% - 25% може да е достатъчна. Използвайте работните листове на формуляр 1040-ES всяко тримесечие, за да потвърдите.
• Собственици на S-Corp: Вашата ситуация е различна. „Разумната заплата“, която си плащате, е обект на стандартно удържане на заплати (FICA и данъци върху доходите). Вашите разпределения (печалби, изплатени над заплатата) все още изискват тримесечни прогнозни плащания, но често с по-ниска пределна ставка, тъй като не са обект на SE данък.
• Продавачи в множество щати: Ако имате „nexus“ (значително бизнес присъствие) в множество щати, може да дължите данък общ доход във всеки от тях. Това може да увеличи вашите задължения. За по-голяма яснота създайте отделни сметки за задължения в Beancount, като например Liabilities:Taxes:State:CA и Liabilities:Taxes:State:NY.

5. Автоматизирайте, преглеждайте, повтаряйте​

Системата работи само ако я използвате. Направете я безпроблемна.

• Автоматизирайте: Свържете основната си оперативна сметка с високодоходна спестовна сметка с име като "TaxReserve". Настройте автоматично прехвърляне да се извършва веднага след като приключите книгите си всеки месец.
• Преглеждайте: Препрогнозирайте годишната си печалба тримесечно. Ако продажбите за второто тримесечие са надхвърлили очакванията, увеличете месечната си резервна сума незабавно. Не чакайте до януари, за да откриете, че сте спестили недостатъчно.
• Повтаряйте: Поддържайте ключовите документи организирани в директорията си Beancount. Запазването на окончателната данъчна декларация от миналата година (document: "2024/Taxes/Form1040.pdf") ви дава контекст с едно щракване, когато обсъждате цифри с вашия CPA или планирате за следващата година.

Заключителни мисли​

Данъчните сметки изглеждат случайни само когато процесът на заделяне е такъв. Като включите процентно базиран резерв директно във вашия поток на двойно счетоводство, вие заменяте безпокойството с алгебра – и Beancount прави математиката (и одитната следа) тривиални. Преглеждайте ставката си всяко тримесечие, поддържайте Assets:Bank:TaxReserve финансирана и 15 април ще се превърне в просто още един обикновен работен ден.

Опровержение: Тази статия е само за образователни цели и не е данъчен съвет. Винаги потвърждавайте цифрите с квалифициран специалист за вашата юрисдикция и тип юридическо лице.

Когато управлявате бизнес или личните си финанси, термините водене на счетоводни записи и счетоводство често се сливат. Но разбирането на техните разлики – особено когато използвате инструмент за обикновен текст като Beancount – може да ви помогне да изградите по-добри системи и да вземате по-интелигентни финансови решения.

В това ръководство ще разгледаме ролите на воденето на счетоводни записи и счетоводството, и как Beancount поддържа и двете (да, наистина).

📘 Водене на счетоводни записи: Изкуството на ежедневното проследяване​

Воденето на счетоводни записи е основният слой на финансовото управление. Става въпрос за записване на това, което действително се е случило – без предположения, без прогнози.

Воденето на счетоводни записи включва:

• Записване на приходи и разходи
• Проследяване на активи и пасиви
• Маркиране на транзакции за по-късна употреба
• Поддържане на главна счетоводна книга

В Beancount това изглежда така:

2025-06-27 * "Stripe Payout"
  Assets:Bank:Checking     1,200.00 USD
  Income:Sales

Всяка транзакция е градивен елемент. Все още не анализирате – просто записвате истината, ред по ред.

Ако тепърва започвате, Beancount насърчава добрите навици за водене на счетоводни записи чрез своята изрична структура и четим синтаксис. Ще бъдете принудени (в добрия смисъл!) да проследявате всеки цент и да обяснявате всяка транзакция.

📊 Счетоводство: Превръщане на данните в прозрения​

Счетоводството надгражда вашите счетоводни записи, за да отговори на по-дълбоки въпроси:

• Печеливши ли сме?
• Колко парични средства имаме на разположение?
• Трябва ли да предплатим този софтуер или да го осчетоводяваме месечно?
• Как да минимизираме данъците?

В счетоводството вие:

• Изравнявате сметки и коригирате записи
• Генерирате отчети като отчети за приходите и разходите
• Амортизирате активи
• Планирате данъци и бъдещи разходи

С Beancount можете да анализирате записите си, използвайки инструменти като beancount.io:

• Навигирайте в баланси, отчети за доходите и отчети за паричните потоци
• Визуализирайте приходите по категории
• Анотирайте решения, използвайки метаданни (напр. tag:business-trip)

Искате ли да проследите този годишен абонамент за Zoom?

2025-01-15 * "Zoom Annual Plan"
  Expenses:Software     149.90 USD
  Assets:Bank:Checking
  tag:business-tools

По-късно можете да го амортизирате месечно или да го анализирате по време на бюджетни сесии.

👩‍💼 Счетоводител (за записи) срещу Счетоводител (за анализ): Кой какво прави?​

• Счетоводител (за записи): Фокусира се върху прецизността. Записва, категоризира и организира.
• Счетоводител (за анализ): Добавя интерпретация. Съветва, планира и моделира резултати.

Beancount ви дава възможност да бъдете и двете, или да предадете един слой чисто на професионалист.

Например:

• Като основател, може да водите собствените си счетоводни записи с Beancount.
• По време на данъчния сезон, експортирате отчети или сурови данни за вашия счетоводител, за да ги финализира.

🛠️ Софтуер за водене на счетоводни записи и счетоводство: Къде принадлежи Beancount?​

Повечето масови инструменти (напр. QuickBooks, Xero) размиват границата между воденето на счетоводни записи и счетоводството. Beancount възприема различен подход:

• Управлявате всичко чрез обикновен текст, съхраняван под контрол на версиите, ако желаете.
• Няма скриване на транзакции или магия зад кулисите.
• Насърчавате се да разбирате собствените си книги.

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

🧠 Защо това разграничение е важно​

Познаването на разликата между воденето на счетоводни записи и счетоводството ви помага да:

• Останете съвместими и готови за одит
• Разберете къде да инвестирате време (ежедневно проследяване срещу месечни прозрения)
• Комуникирате ясно с финансови специалисти
• Мащабирате финансовите си системи, без да се удавите в сложност

🪄 Последна мисъл: Вашата счетоводна книга, вашите правила​

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

Запомнете:

• Водене на счетоводни записи = какво се е случило
• Счетоводство = какво означава

С Beancount изграждате и двата слоя с яснота и увереност.

Уведомете ме, ако желаете версия за печат или последващ урок.

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

Това ръководство ще ви преведе през:

• Какво е счетоводно записване
• Защо счетоводните записвания са важни
• Как да ги пишете в синтаксиса на Beancount
• Как да ги използвате ефективно
• Примери за реални транзакции (плащания от клиенти, покупки, заеми и др.)

🧾 Какво е счетоводно записване в Beancount?​

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

Пример:

2024-06-01 * "Client payment for invoice #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales

• Символът * показва изчистена транзакция.
• Описанието показва контекст за записването.
• Assets:Bank:Checking е дебитирана.
• Income:Sales е кредитирана (стойността е подразбираща се).

Всяко записване се намира във файл с разширение .beancount – просто текстов файл, който можете да контролирате като версии, да архивирате и дори да редактирате във Vim или VSCode.

📒 Защо счетоводните записвания са важни​

Счетоводните записвания са атомната единица на вашия леджър.

Те:

• Попълват вашата Главна книга и Салда по сметки
• Задвижват всички отчети: Отчети за приходите и разходите, Счетоводни баланси, Отчети за паричните потоци
• Позволяват ви да проследите всеки долар, ред по ред, до неговия източник

С правилните инструменти ще видите тези транзакции представени в потребителски интерфейс – категоризирани, търсещи се и филтрируеми. Но всичко започва с това просто текстово записване.

📚 Как работи двустранното счетоводство в Beancount​

Beancount прилага двустранно счетоводство. Всяка транзакция трябва да бъде балансирана: общо дебити = общо кредити.

Бързо правило:

• Дебитирайте активи и разходи (вие получавате пари или правите разход)
• Кредитирайте приходи и пасиви (вие печелите пари или поемате дълг)

Пример – Покупка на офис консумативи:

2024-06-02 * "Bought printer ink"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking

🧠 Визуализиране на записвания​

След като запазите, в лявата навигация на https://beancount.io/ledger/0/income_statement/ ще видите ...

• Изглед на журнал: Вижте транзакции с търсене, тагове и филтриране
• Падащо меню за филтър на сметки: Вижте текущи салда и записвания по сметки
• Отчет за приходите и разходите: Сума на вашите сметки Income:* и Expenses:*
• Счетоводен баланс: Вашите активи минус пасиви

Fava помага да превърнете вашите сурови Beancount записвания в приложими отчети – без настройка на база данни.

💡 Често срещани примери за счетоводни записвания​

✅ Получавате плащане от клиент​

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting

По избор: Ако използвате Вземания от клиенти:

2024-05-20 * "Invoice #456 sent"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "Payment for invoice #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD

🖨️ Купувате офис консумативи​

2024-06-07 * "Staples run"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking

🏦 Извършвате плащане по заем​

Да кажем, че плащате $1 000, като $200 са лихва и $800 са към главницата:

2024-06-10 * "Loan repayment"
  Liabilities:Loan           -800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD

🔒 Заключителни записвания в края на годината​

За да „затворите счетоводните книги“, обикновено прехвърляте всички

Основи на счетоводството, които наистина можете да разберете – и да управлявате сами​

Управлението на собствените ви счетоводни книги не е задължително да означава електронни таблици, стрес или скъп софтуер. Beancount ви дава минималистичен, подлежащ на одит и мощен начин да водите счетоводство, използвайки само обикновен текст и система за двустранно счетоводство.

Това ръководство е вашето пълно въведение в подреждането на счетоводните книги на малкия ви бизнес с Beancount – с реални примери и стъпка по стъпка указания.

🧾 Какво е Beancount?​

Beancount е счетоводна система с отворен код, базирана на обикновен текст, изградена около двустранното счетоводство. Вие записвате транзакциите си във файлове с разширение .beancount и използвате инструменти като bean-doctor, bean-report или Fava, за да анализирате и визуализирате счетоводните си книги.

Ето една основна транзакция:

2025-06-01 * "Client Payment: Invoice #123"
  Assets:Bank:Business:Checking      1,200.00 USD
  Income:Consulting                 -1,200.00 USD

Тя е четима, скриптуема и с контролирани версии – идеална за собственици на бизнес, които искат прозрачност и контрол.

📌 Защо счетоводството е важно (и защо Beancount)​

• Имате нужда от него за данъци
• Имате нужда от него за яснота
• Имате нужда от него за финансиране
• Имате нужда от него, за да улавяте грешки рано

И с Beancount, можете да направите всичко това само с текстов редактор и няколко инструмента.

🪜 8 стъпки, за да започнете да водите собствено счетоводство с Beancount​

1. Разделете бизнес и лични финанси​

Открийте отделна бизнес разплащателна сметка и кредитна карта. Отразете това в Beancount:

2025-06-01 open Assets:Bank:Business:Checking USD
2025-06-01 open Liabilities:CreditCard:Business USD

Това поддържа счетоводните ви книги чисти и ви защитава юридически (особено ако сте ООД или корпорация).

2. Използвайте двустранно счетоводство​

Всяко финансово събитие засяга две сметки. Beancount налага този баланс по дизайн:

2025-06-05 * "Web hosting payment"
  Expenses:Hosting                  15.00 USD
  Assets:Bank:Business:Checking    -15.00 USD

Това гарантира математическа цялост в цялата ви счетоводна книга.

3. Изберете касов принцип или принцип на начисление​

• Касов принцип: Записвайте приходи/разходи само когато парите са получени/похарчени.
• Принцип на начисление: Проследявайте задълженията (Вземания/Задължения).

Пример за касов принцип:

2025-06-10 * "Client payment received"
  Assets:Bank:Business:Checking     800.00 USD
  Income:Sales                     -800.00 USD

Пример за принцип на начисление (изпратена фактура, след това получено плащане):

2025-06-01 * "Invoice #2001 issued"
  Assets:AccountsReceivable         800.00 USD
  Income:Sales                     -800.00 USD

2025-06-15 * "Payment received for Invoice #2001"
  Assets:Bank:Business:Checking     800.00 USD
  Assets:AccountsReceivable        -800.00 USD

4. Настройте своя сметкоплан​

Дефинирайте ясно категориите си. Един минималистичен пример:

2025-01-01 open Income:Sales USD
2025-01-01 open Expenses:Software USD
2025-01-01 open Expenses:Meals USD
2025-01-01 open Equity:Owner USD

Приспособете ги към вашия бизнес. Поддържайте ги последователни и описателни.

5. Категоризирайте транзакциите (с метаданни)​

Използвайте метаданни, за да проследявате контекста. Това помага при приспадания, одити и яснота.

2025-06-18 * "Team lunch after Q2 milestone"
  Expenses:Meals                    90.00 USD
  Assets:Bank:Business:Checking    -90.00 USD
  ; business_purpose: Q2 celebration
  ; attendees: Alice, Bob, Tian

Добавете тагове или връзки към разписки:

  ; receipt: ./receipts/2025-06-18-lunch.jpg

6. Съхранявайте подкрепящи документи​

Използвайте Dropbox, Google Drive или папка receipts/. След това ги свържете в Beancount по следния начин:

2025-06-02 * "Domain Renewal - GoDaddy"
  Expenses:Hosting                  20.00 USD
  Assets:Bank:Business:Checking    -20.00 USD
  ; receipt: ./receipts/domain-godaddy.pdf

Одиторите и данъчните специалисти ще ви харесат.

7. Организирайте за данъчни облекчения​

Маркирайте ясно приспадаемите разходи:

2025-06-03 * "Adobe Creative Cloud Subscription"
  Expenses:Software                60.00 USD
  Assets:Bank:Business:Checking   -60.00 USD
  ; deductible: true
  ; usage: 100% business

Използвайте персонализирани метаданни или тагове като #deductible, за да проследявате потенциални отписвания.

8. Превърнете го в навик​

Създайте работен процес. Пример:

# Weekly bookkeeping routine
git pull origin main
bean-extract transactions.csv >> ledger.beancount
bean-doctor ledger.beancount
bean-check ledger.beancount
fava ledger.beancount

Или просто се ангажирайте с "Beancount петък" и съгласувайте всичко ежеседмично.

💼 Направи си сам или наеми помощ?​

Можете да направите всичко сами с Beancount. Но дори напредналите потребители трябва:

• Консултирайте се с дипломиран експерт-счетоводител по време на настройката
• Наемете счетоводител по време на данъчния период, ако е необходимо
• Използвайте Fava за месечни отчети

Получавате цялата мощ на счетоводна система без заключване към доставчик или абонаментни такси.

🛠️ Препоръчителни инструменти за потребители на Beancount​

• Fava – красиво уеб табло за управление на Beancount файлове
• bean-doctor – проверки на изправността на вашата счетоводна книга
• bean-query – изпълнявайте SQL-подобни отчети
• beancount-import / beanie – автоматизиран банков импорт
• Контрол на версиите – използвайте Git, за да проследявате промените в счетоводните си книги

✅ Последен пример: Пълен поток на транзакциите​

2025-06-20 * "Consulting payment from Acme Inc."
  Assets:Bank:Business:Checking        3,000.00 USD
  Income:Consulting                  -3,000.00 USD
  ; invoice: 2025-06-acme
  ; project: "Backend API redesign"

2025-06-21 * "Notion Pro Plan"
  Expenses:Software                     10.00 USD
  Assets:Bank:Business:Checking        -10.00 USD
  ; purpose: project documentation
  ; receipt: ./receipts/notion-june.pdf

🎯 Резюме​

Beancount е идеален за собственици на малък бизнес, които искат да:

• Поддържат ниски разходи
• Останат изцяло в контрол над финансите си
• Избягват претоварването от наследен софтуер
• Приемат прозрачността и простотата на обикновения текст

Искате ли шаблон за стартиране на .bean файл за изтегляне за вашия бизнес? Кажете ми типа на вашия бизнес и аз ще създам такъв, съобразен с вашите нужди.

В днешния свят показателите за околна среда, социална отговорност и управление (ЕСУ) вече не са просто модерни думи; те са основни индикатори за здравето и бъдещата жизнеспособност на една компания. Но как да интегрирате тези ключови прозрения за устойчивост с традиционното финансово счетоводство? Представяме ви Beancount, счетоводна книга с двойно записване, базирана на обикновен текст, с отворен код, която предлага изненадващо мощно и гъвкаво решение за преодоляване на тази празнина.

Представете си как превръщате разпокъсаното си отчитане на устойчивостта в рационализирана, автоматизирана система, която проследява всичко - от въглеродни емисии до разнообразие на доставчици, всичко това в рамките на съществуващия ви финансов работен процес. Beancount прави това възможно, като третира ЕСУ данните като "първокласни граждани наред с финансовите транзакции".

Моделиране на ESG данни: По начина на Beancount​

Присъщата гъвкавост на Beancount е неговата суперсила, когато става въпрос за ESG. Вместо разпокъсани електронни таблици, можете да вградите показатели за устойчивост директно във вашата финансова структура, използвайки няколко ключови техники:

• Специализирани сметки и стоки: Мислете за своя екологичен отпечатък като за друга валута. Можете да създадете сметки като Metrics:Emissions:CO2e за проследяване на въглеродните емисии. Тези емисии дори могат да бъдат третирани като стока (напр. единица CO2 еквивалент, tCO2e), което ви позволява да записвате конкретни количества във вашите транзакции. Например, покупка на полет може да кредитира сметка Emissions:CO2e с +0.3 tCO2e наред с паричната стойност.
• Персонализирани метаданни тагове: Метаданните ключ-стойност на Beancount са идеални за добавяне на контекст. Можете да маркирате транзакция с CO2e: 0.3 t или Scope: 3, за да обозначите нейния въглероден отпечатък или обхват по протокола за парникови газове (GHG Protocol). Това свързва финансовите разходи директно с техните екологични последици, осигурявайки по-богата и пълна картина.
• Структурирани тагове за категории: Съобразяването със стандарти като Протокола за парникови газове (GHGP) е от решаващо значение. Можете да използвате последователни тагове или конвенции за именуване на сметки, като Metrics:Emissions:Scope1, Metrics:Emissions:Scope2 и Metrics:Emissions:Scope3, за лесно категоризиране и отчитане на преки, свързани с енергията и емисии по веригата на стойността.

Този адаптивен подход означава, че с развитието на ESG стандартите можете да коригирате структурата на вашата счетоводна книга без цялостен ремонт.

Beancount срещу специализирани ESG инструменти: Стратегически избор​

Докато специализираните ESG платформи като Persefoni или SAP Green Ledger предлагат силно автоматизирани, целенасочени решения, Beancount представлява привлекателна алтернатива, особено за тези, които търсят прозрачност и контрол.

Beancount е DIY мощност: Той ви дава несравнима гъвкавост и прозрачност, което го прави идеален за индивидуални потребители или технически грамотни малки организации. Вие притежавате данните си изцяло, избягвайки заключване към доставчик.

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

Възможен е и хибриден подход: използвайте Beancount за детайлно вътрешно проследяване и съгласуване, след което експортирайте обобщени данни към външна платформа за отчитане на високо ниво пред заинтересовани страни.

Практически приложения: ESG в действие с Beancount​

Гъвкавостта на Beancount го прави подходящ за няколко ключови ESG приложения:

• Проследяване на емисии от обхват 3: Най-трудните за проследяване емисии (от вашата верига на стойността) могат да бъдат интегрирани чрез свързване на данни за емисии от доставчици с транзакции за покупки. Beancount осигурява ясна одитна следа за тези сложни данни, позволявайки по-добър анализ и точно определяне на източниците на данни.
• Одити за устойчивост и осигуряване: Подобно на финансовите данни, ESG данните трябва да бъдат проверими. Beancount ви позволява да свържете всеки ESG запис с изходни документи (напр. сметки за комунални услуги, изявления за проверка от трети страни), осигурявайки щателна одитна следа за прозрачност и осигуряване.
• Отчитане за съответствие с EU CSRD/ESRS: За компании, изправени пред строги регулации като CSRD, Beancount може да служи като централно хранилище за количествени оповестявания. Въпреки че няма автоматично да форматира отчетите в XBRL, той предоставя детайлните, одитируеми данни, необходими за генериране на готови за съответствие цифри.
• Анализ на въглеродния отпечатък и управленско счетоводство: Третирайте въглерода като друго измерение на управленското счетоводство. Чрез разпределяне на емисиите към центрове за печалба или продуктови кодове, можете да изчислите показатели като "емисии на долар приход" и да идентифицирате въглеродни горещи точки, което води до по-информирани решения за устойчивост.

Най-добри практики за вашия Beancount ESG регистър​

За да увеличите максимално ефективността на Beancount за ESG, разгледайте тези най-добри практики:

1. Проектирайте ясен сметкоплан за ESG: Структурирайте внимателно вашите ESG сметки (напр. Metrics:Emissions:Scope1:Fuel), точно както вашите финансови сметки.
2. Използвайте метаданни последователно: Използвайте тагове (напр. Scope: 3, FactorSource: EPA2024) за последователен контекст и по-лесно търсене.
3. Балансирайте детайлността с управляемостта: Съсредоточете се върху съществените показатели, за да избегнете претоварване на вашия регистър с ненужни детайли.
4. Автоматизирайте с повишено внимание: Използвайте Python скриптове за импортиране и валидиране на данни, но осигурете стабилна проверка за грешки и ясна документация на вашите процеси на автоматизация.
5. Използвайте контрол на версиите: Използвайте Git, за да проследявате всяка промяна във вашия регистър, осигурявайки прозрачна и одитируема история на вашите ESG данни.
6. Свържете с документи и доказателства: Свържете изходни файлове (напр. PDF файлове на сметки за комунални услуги) към записи в регистъра за лесна проверка по време на одити.
7. Използвайте Fava за прозрения: Конфигурирайте Fava да показва персонализирани ESG графики и отчети, правейки вашите данни за устойчивост приложими и достъпни за нетехнически заинтересовани страни.
8. Бъдете в крак със стандартите: ESG отчитането е динамично; бъдете готови да адаптирате вашата Beancount структура, когато се появят нови разпоредби и рамки.

Бъдещето е зелено и в обикновен текст​

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

Тъй като корпоративният свят все повече възприема „зелени регистри“, Beancount е готово да предложи гъвкаво, прозрачно и одитируемо решение. Чрез интегриране на ESG данни със същата прецизност като финансовите данни, Beancount дава възможност на организациите не само да отговарят на изискванията за съответствие, но и да стимулират значими инициативи за устойчивост.

Готови ли сте да въведете вашите ESG данни в революцията на обикновения текст?

Давите ли се в крипто транзакции в множество борси, борите ли се със сложността на DeFi или изпадате в паника заради данъчния сезон? Не сте сами. Пейзажът на криптовалутите експлодира от прости покупки на Биткойн до сложна екосистема от DeFi протоколи, награди от стейкинг, добив на доходност (yield farming) и междуверижни дейности, които предизвикват традиционните счетоводни методи.

Ето суровата реалност: всяка крипто транзакция е потенциално облагаема, и IRS наблюдава. Независимо дали сте обикновен притежател на Биткойн или напреднал потребител на DeFi, управляващ позиции в десетки протоколи, поддържането на точни финансови записи не е по избор – то е от съществено значение за съответствието и финансовата яснота.

Проблемът? Традиционният счетоводен софтуер има ограничена вградена поддръжка за сложността на криптовалутите. Докато инструменти като QuickBooks могат да обработват крипто с допълнителни плъгини, и Excel може да импортира блокчейн данни със скриптове, повечето решения изискват значителна персонализация за цялостно крипто счетоводство.

Решението? Системата за счетоводство в обикновен текст на Beancount.io, изградена върху мощния език за счетоводство с отворен код Beancount. Важна забележка: Beancount е език за двустранно счетоводство с отворен код, създаден от Мартин Блейс, докато Beancount.io е търговска хостинг услуга, която предоставя удобен за потребителя интерфейс и облачна инфраструктура за Beancount. Това ръководство обхваща както основните принципи на Beancount, така и как да ги използвате ефективно чрез платформата Beancount.io.

Кошмарът на криптовалутното счетоводство (И защо се влошава)​

Вашето крипто портфолио е разпръснато навсякъде​

Нека бъдем честни относно вашата настройка. Вероятно имате:

• 3-5 различни борси (Coinbase за лесни покупки, Binance за алткойни, Kraken за онзи един токен...)
• Множество портфейли (MetaMask за DeFi, Ledger за дългосрочни притежания, онзи стар портфейл, за който сте забравили...)
• DeFi позиции в над 10 протокола (Uniswap, Compound, Aave и всяка нова "ферма за доходност", която е привлякла вниманието ви)
• Награди от стейкинг, постъпващи от различни валидатори
• Случайни еърдропи, появяващи се във вашия портфейл като крипто коледни подаръци

Всяка платформа говори на различен език. Coinbase ви дава CSV файл, който изглежда съвсем различно от експорта на Binance. Uniswap дори няма експорти. И да не започваме с проследяването на вашите DeFi позиции в Layer 2 мрежи.

Видове транзакции, които предизвикват традиционното счетоводство​

Вашите крипто дейности включват видове транзакции, които традиционните счетоводни системи не са били първоначално проектирани да обработват:

• Непостоянна загуба от осигуряване на ликвидност (опитайте се да обясните това на QuickBooks)
• Флаш заеми, които заемат и изплащат милиони в една-единствена транзакция
• Добивно фермерство, при което печелите 5 различни токена за осигуряване на ликвидност
• Междуверижни мостове, които карат активите да изчезват в една мрежа и да се появяват в друга
• Стейкинг деривати като stETH, които натрупват стойност по различен начин от базовия актив
• DAO токени за управление, които сте получили за използване на протоколи

Минното поле на данъчното съответствие​

Ето какво държи крипто инвеститорите будни през нощта:

• Всяка отделна сделка е облагаема (да, дори този суап от ETH към USDC)
• Проследяването на цената на придобиване става невъзможно при стотици микротранзакции
• Наградите от стейкинг са доход в момента, в който ги получите (по справедлива пазарна стойност)
• DeFi наградите са доход, дори ако все още не можете да ги продадете
• IRS изисква Формуляр 8949 с всяка изброена транзакция
• Наказанията са тежки за грешки

Традиционният счетоводен софтуер изисква значително персонализиране за тази сложност. Макар и да съществуват решения, те често изискват допълнителни плъгини, скриптове или ръчни процеси, за да се справят с пълния обхват на криптовалутните дейности.

Представяме Beancount.io: Счетоводното решение за криптовалути, което чакахте​

Ами ако ви кажа, че съществува счетоводна система, създадена точно за този хаос? Beancount.io не е просто поредният счетоводен инструмент — това е революция в счетоводството с обикновен текст, която се справя със сложността на криптовалутите, сякаш е създадена за това.

Защо Beancount.io доминира в крипто счетоводството​

🔍 Пълна прозрачност: Всяко изчисление е видимо. Без черни кутии, без алгоритми от типа „довери ни се“. Виждате точно как се изчислява вашата базова стойност, как се изчисляват печалбите и къде е отишло всяко сатоши.

📊 Неограничена гъвкавост: Създайте всяка счетоводна структура, от която се нуждаете. Проследявайте DeFi позиции, деривати от стейкинг, междуверижни активи или онзи странен токен, който сте получили от гласуване в DAO. Ако можете да си го представите, можете да го проследите.

🎯 Прецизна базова стойност: Проследяване по партиди със специфична идентификация. Изберете точно кой Биткойн продавате за оптимални данъчни резултати. FIFO, LIFO или подберете партидите си – ваш избор.

🔗 Устойчивост на бъдещето: Форматът на обикновен текст означава, че данните ви са ваши завинаги. Без обвързване с доставчик, без собственически формати, без имейли от типа „съжаляваме, затваряме“.

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

Настройване на Вашия крипто команден център​

Изграждане на вашата счетоводна архитектура​

Представете си това като проектиране на план за вашата крипто империя. Създаваме структура, която може да обработва всичко – от първата ви покупка на Биткойн до сложни многопротоколни DeFi стратегии:

Забележка: Примерите използват 1970-01-01 като дата за отваряне на сметка. За реална употреба, заменете с вашите действителни дати на откриване на сметки, особено ако използвате автоматизирани инструменти за импортиране, които филтрират транзакциите по дата.

; Сметки за борси
1970-01-01 open Assets:Crypto:Coinbase:USD
1970-01-01 open Assets:Crypto:Coinbase:BTC
1970-01-01 open Assets:Crypto:Coinbase:ETH
1970-01-01 open Assets:Crypto:Binance:USD
1970-01-01 open Assets:Crypto:Binance:BTC
1970-01-01 open Assets:Crypto:Binance:ETH
1970-01-01 open Assets:Crypto:Binance:ADA

; Сметки за портфейли
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:UNI
1970-01-01 open Assets:Crypto:Wallet:Ledger:BTC
1970-01-01 open Assets:Crypto:Wallet:Ledger:ETH

; Сметки за DeFi протоколи
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Crypto:Mining:BTC

; Сметки за приходи
1970-01-01 open Income:Crypto:Staking:ETH
1970-01-01 open Income:Crypto:Mining:BTC
1970-01-01 open Income:Crypto:Airdrops
1970-01-01 open Income:Crypto:DeFi:Yield
1970-01-01 open Income:CapitalGains:Crypto
1970-01-01 open Income:Crypto:Trading:Margin

; Сметки за разходи
1970-01-01 open Expenses:Crypto:Fees:Trading
1970-01-01 open Expenses:Crypto:Fees:Network
1970-01-01 open Expenses:Crypto:Fees:Withdrawal

; Допълнителни сметки за напреднали сценарии
1970-01-01 open Assets:Crypto:Binance:BTC-Margin
1970-01-01 open Liabilities:Crypto:Binance:Borrowed
1970-01-01 open Liabilities:Crypto:Binance:BTC
1970-01-01 open Assets:Checking
1970-01-01 open Expenses:Crypto:Mining:Electricity

Дефиниции на стоки​

Дефинирайте вашите криптовалути като стоки с подходящи метаданни:

1970-01-01 commodity BTC
  name: "Bitcoin"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity ETH
  name: "Ethereum"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity ADA
  name: "Cardano"
  asset-class: "cryptocurrency"
  price-source: "binance"

1970-01-01 commodity USDC
  name: "USD Coin"
  asset-class: "stablecoin"
  price-source: "coinbase"

1970-01-01 commodity UNI
  name: "Uniswap"
  asset-class: "cryptocurrency"
  price-source: "coinbase"

1970-01-01 commodity UNI-V2-ETH-USDC
  name: "Uniswap V2 ETH-USDC LP Token"
  asset-class: "liquidity-pool"

Овладяване на крипто трансакциите: От прости до сложни​

Готови ли сте да видите Beancount.io в действие? Нека разгледаме реални сценарии, които биха затруднили други счетоводни системи, но тук се обработват елегантно.

1. Вашата първа покупка на Биткойн (Първата стъпка към пристрастяване)​

Всяко крипто пътешествие започва отнякъде. Ето как да запишете този променящ живота момент, когато купихте първия си Биткойн:

2024-01-15 * "Покупка на 0.5 BTC в Coinbase"
  Assets:Crypto:Coinbase:BTC     0.5 BTC {30000.00 USD}
  Assets:Crypto:Coinbase:USD  -15025.00 USD
  Expenses:Crypto:Fees:Trading    25.00 USD

2. Реализиране на печалби (или ограничаване на загуби) като професионалист​

Моментът на истината: продажбата на вашата криптовалута. Това е мястото, където повечето счетоводни системи се провалят, но Beancount.io се отличава с прецизно проследяване на себестойността:

2024-03-20 * "Sell 0.3 BTC on Coinbase"
  Assets:Crypto:Coinbase:BTC    -0.3 BTC {30000.00 USD}
  Assets:Crypto:Coinbase:USD   10470.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Income:CapitalGains:Crypto   1440.00 USD  ; 10470 - (0.3 × 30000) - 30 = 1440

3. Награди от стейкинг: Печелене, докато спите​

Пасивен доход в най-добрата си форма. Но помнете, IRS изисква наградите от стейкинг да се отчитат като облагаем доход при получаването им, въз основа на справедливата пазарна стойност към момента на получаване (съгласно указанията на IRS за цифрови активи, 2024 г.). Въпреки че има текущо съдебно дело (Джарет срещу Съединените щати), текущата официална позиция изисква незабавно отчитане. Ето как да ги проследявате правилно:

2024-02-01 * "ETH Staking Rewards"
  Assets:Staking:Ethereum:ETH      0.05 ETH {2500.00 USD}
  Income:Crypto:Staking:ETH      125.00 USD

4. DeFi Добивно Земеделие: Където нещата стават пикантни 🌶️​

Добре дошли в напредналото DeFi счетоводство. Добивното земеделие в DeFi включва сложни транзакции с множество токени, които изискват прецизно проследяване. Ето как правилно да осчетоводите позиция за ликвидност в Uniswap:

; Initial liquidity provision
2024-01-10 * "Add liquidity to ETH-USDC pool"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC -25000 USDC {1.00 USD}
  Assets:DeFi:Uniswap:ETH-USDC-LP     100 UNI-V2-ETH-USDC {500.00 USD}

; Claiming rewards
2024-02-10 * "Claim Uniswap LP rewards"
  Assets:Crypto:Wallet:MetaMask:UNI    50 UNI {8.00 USD}
  Income:Crypto:DeFi:Yield           400.00 USD

5. Трансфери между борси​

Прехвърляне на Биткойн от Coinbase към портфейл Ledger:

2024-01-20 * "Transfer BTC from Coinbase to Ledger"
  Assets:Crypto:Coinbase:BTC      -1.0 BTC {30000.00 USD}
  Assets:Crypto:Wallet:Ledger:BTC  0.9995 BTC {30000.00 USD}
  Expenses:Crypto:Fees:Withdrawal  0.0005 BTC {30000.00 USD}

Разширени сценарии с криптовалути​

Маржин търговия​

Записване на ливъридж позиции:

; Откриване на ливъридж дълга позиция (заемане на BTC)
2024-02-15 * "Open 2x leveraged BTC position"
  Assets:Crypto:Binance:BTC-Margin      1.0 BTC {35000.00 USD}
  Liabilities:Crypto:Binance:BTC       -1.0 BTC {35000.00 USD}
  Expenses:Crypto:Fees:Trading            50.00 USD
  Assets:Crypto:Binance:USD              -50.00 USD

; Затваряне на позицията с печалба
2024-02-20 * "Close leveraged BTC position"
  Assets:Crypto:Binance:BTC-Margin   -1.0 BTC {35000.00 USD}
  Assets:Crypto:Binance:USD          37950.00 USD
  Liabilities:Crypto:Binance:BTC      1.0 BTC {35000.00 USD}
  Income:Crypto:Trading:Margin       -2900.00 USD
  Expenses:Crypto:Fees:Trading          50.00 USD

Еърдропи и Форкове​

Записване на безплатни разпределения на токени:

2024-03-01 * "Received UNI airdrop"
  Assets:Crypto:Wallet:MetaMask:UNI   400 UNI {8.00 USD}
  Income:Crypto:Airdrops             3200.00 USD

Минни операции​

За копачи на криптовалути:

2024-01-01 * "Награда от копаене на Биткойн"
  Assets:Crypto:Mining:BTC    0.1 BTC {45000.00 USD}
  Income:Crypto:Mining:BTC   4500.00 USD

; Разходи за копаене
2024-01-31 * "Разходи за електричество за копаене"
  Expenses:Crypto:Mining:Electricity  800.00 USD
  Assets:Checking                    -800.00 USD

Данъчна отчетност и съответствие​

Проследяване на себестойността​

Beancount.io автоматично проследява себестойността, използвайки системата на партидите:

; Множество покупки на различни цени
2024-01-01 * "Buy BTC batch 1"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD -40000.00 USD

2024-02-01 * "Buy BTC batch 2"
  Assets:Crypto:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD -45000.00 USD

; Продажба на конкретни партиди (FIFO, LIFO или специфична идентификация)
2024-03-01 * "Sell BTC using FIFO"
  Assets:Crypto:Coinbase:BTC    -0.5 BTC {40000.00 USD}
  Assets:Crypto:Coinbase:USD   22470.00 USD
  Expenses:Crypto:Fees:Trading    30.00 USD
  Income:CapitalGains:Crypto    2440.00 USD  ; 22470 - 20000 - 30 = 2440

Генериране на данъчни отчети​

Използвайте системата за заявки и плъгините на Beancount, за да генерирате данъчни отчети:

• Формуляр 8949: Капиталови печалби и загуби (чрез bean-query или плъгини на трети страни)
• Приложение D: Обобщение на капиталовите печалби (изисква допълнително скриптиране)
• Формуляр 1040: Доход от стейкинг, копаене, аирдропи (чрез персонализирани отчети)
• Подробни дневници на транзакциите: За целите на одита

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

Най-добри практики за крипто счетоводство​

1. Редовно съгласуване​

• Импортирайте данни за обмен седмично
• Проверявайте салда по портфейли месечно
• Сверявайте с блокчейн експлоръри

2. Правилна документация​

• Запазвайте всички потвърждения за транзакции
• Документирайте целта на всяка транзакция
• Поддържайте записи на пазарните цени към момента на транзакцията

3. Отделяне на бизнес и лични​

; Лични крипто инвестиции
Assets:Personal:Crypto:Coinbase:BTC

; Бизнес крипто операции
Assets:Business:Crypto:Treasury:BTC

4. Проследявайте всички източници на доходи​

• Награди от стейкинг (облагаеми като доход)
• Награди от копаене (облагаеми като доход)
• Еърдропи (облагаеми по справедлива пазарна стойност)
• DeFi доходност (облагаеми като доход)

5. Управление на таксите​

Проследявайте всички такси поотделно за правилно данъчно приспадане:

Expenses:Crypto:Fees:Trading     ; Такси за борсова търговия
Expenses:Crypto:Fees:Network     ; Мрежови такси на блокчейна
Expenses:Crypto:Fees:Withdrawal  ; Такси за теглене

Интеграция с популярни крипто инструменти​

Интеграция с API на борси​

Beancount.io може да се интегрира с основни борси:

• Coinbase Pro API: Автоматичен импорт на транзакции
• Binance API: Актуализации на баланса в реално време
• Kraken API: Синхронизация на исторически данни

Анализ на блокчейн​

Свържете се с блокчейн изследователи:

• Etherscan: Проверка на Ethereum транзакции
• Blockchain.info: Проследяване на Bitcoin транзакции
• BscScan: Мониторинг на Binance Smart Chain

Проследяване на портфейл​

Синхронизиране с инструменти за управление на портфейл:

• CoinTracker: Генериране на данъчни отчети
• Koinly: Агрегиране от множество борси
• Blockfolio: Мобилно проследяване на портфейл

Важни Откази от Отговорност​

Данъчно и Правно Уведомление: Това ръководство предоставя обща информация относно счетоводството на криптовалути с помощта на Beancount и не представлява професионален данъчен, правен или финансов съвет. Данъчното третиране на криптовалутни транзакции варира в зависимост от юрисдикцията и индивидуалните обстоятелства. Сложни сценарии като междуверижни мостове (cross-chain bridges), непостоянна загуба (impermanent loss) и флаш заеми (flash loans) може да имат неясни данъчни последици съгласно настоящите разпоредби. За конкретни насоки относно това дали транзакциите представляват облагаеми разпореждания, вижте ЧЗВ на IRS Q-15 до Q-18 (2024) или се консултирайте с местните данъчни разпоредби. Винаги се консултирайте с квалифициран данъчен специалист или дипломиран експерт-счетоводител (ДЕC), запознат с данъчното облагане на криптовалути във вашата юрисдикция, преди да вземате решения, свързани с данъци.

Изяснение относно Софтуера: Примерите в това ръководство използват стандартен синтаксис на Beancount. Докато Beancount.io предоставя удобен за потребителя интерфейс за Beancount, основните счетоводни принципи се прилагат за всяка имплементация на Beancount.

Заключение​

Счетоводството на криптовалути не е задължително да бъде преобременяващо. С мощната система за счетоводство в обикновен текст на Beancount, достъпна чрез платформата Beancount.io, можете да:

• Поддържате пълна прозрачност: Всяка транзакция е видима и одитируема
• Осигурите данъчно съответствие: Правилно проследяване на себестойността и отчитане на доходите
• Мащабирате с портфолиото си: Обработвате от прости сделки до сложни DeFi стратегии
• Интегрирате безпроблемно: Свързвате се с борси, портфейли и данъчни инструменти
• Осигурите дългосрочна устойчивост на записите си: Форматът на обикновен текст осигурява дългосрочна достъпност

Независимо дали сте обикновен притежател на Биткойн или опитен DeFi yield farmer, Beancount предоставя основата и гъвкавостта, необходими за овладяване на счетоводството на криптовалути. Започнете с основни транзакции и постепенно включвайте по-сложни сценарии, докато вашето крипто пътешествие се развива.

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

Готови ли сте да поемете контрол над финансите си с криптовалути? Регистрирайте се в Beancount.io и изпитайте силата на прозрачното, скриптуемо крипто счетоводство, изградено върху здравата основа на Beancount.

Данъчното облагане на криптовалутите се е развило от нишова грижа до критично изискване за съответствие за милиони инвеститори. Тъй като IRS засилва прилагането на правилата и изисква подробно отчитане, точното водене на записи не е просто добра практика – то е от съществено значение за избягване на санкции и оптимизиране на данъчните ви задължения.

Това изчерпателно ръководство ви показва как да постигнете пълно данъчно съответствие на криптовалутите, използвайки мощната система за счетоводство в обикновен текст на Beancount.io, като гарантира, че отговаряте на всички изисквания на IRS, докато максимизирате данъчната ефективност.

Разбиране на данъчните изисквания за криптовалути​

Третиране на криптовалутите от IRS​

IRS третира криптовалутите като собственост, а не като валута, което създава специфични данъчни последици:

• Всяка транзакция е потенциално облагаема: Търговия, продажба, харчене или обмяна на крипто
• Данъчна основа трябва да се проследява: За всяка притежавана единица криптовалута
• Периодът на притежание определя данъчната ставка: Краткосрочни срещу дългосрочни капиталови печалби
• Изисква се признаване на доход: За копаене, стейкинг, ейрдропове и DeFi награди
• Подробни записи са задължителни: Документация на ниво транзакция за одити

Основни данъчни формуляри за криптовалути​

Формуляр 1040 - Данъчна декларация за доходите на физически лица​

• Ред 1: Декларирайте крипто доходи (стейкинг, майнинг, еърдропи)
• Приложение 1: Допълнителни източници на доходи
• Въпрос относно дигитални активи: Задължително отговорете с „Да“, ако сте извършвали крипто транзакции

Форма 8949 - Продажби и други разпореждания с капиталови активи​

• Част I: Краткосрочни капиталови печалби/загуби (притежавани ≤ 1 година)
• Част II: Дългосрочни капиталови печалби/загуби (притежавани > 1 година)
• Подробно отчитане на транзакциите: Дата на придобиване, дата на продажба, постъпления, данъчна основа

Приложение D - Капиталови печалби и загуби​

• Обобщение на формуляр 8949: Агрегирани капиталови печалби/загуби
• Нетна капиталова печалба/загуба: Окончателно изчисление за данъчно задължение

Настройване на данъчно съобразено крипто счетоводство​

Структура на сметките за данъчно отчитане​

Проектирайте йерархията на вашите сметки така, че да съответства на данъчните изисквания:

; Активи - Организирани по период на държане и източник
1970-01-01 open Assets:Crypto:ShortTerm:Coinbase:BTC
1970-01-01 open Assets:Crypto:LongTerm:Coinbase:BTC
1970-01-01 open Assets:Crypto:Trading:Binance:ETH
1970-01-01 open Assets:Crypto:Investment:Ledger:BTC

; Приходи - Разделени по данъчно третиране
1970-01-01 open Income:Crypto:Staking:Ordinary        ; Облагаеми като обикновен доход
1970-01-01 open Income:Crypto:Mining:Ordinary         ; Облагаеми като обикновен доход
1970-01-01 open Income:Crypto:Airdrops:Ordinary       ; Облагаеми като обикновен доход
1970-01-01 open Income:CapitalGains:ShortTerm         ; Краткосрочни капиталови печалби
1970-01-01 open Income:CapitalGains:LongTerm          ; Дългосрочни капиталови печалби

; Разходи - Данъчно приспадаеми категории
1970-01-01 open Expenses:Crypto:Fees:Deductible       ; Такси за търговия
1970-01-01 open Expenses:Crypto:Mining:Equipment      ; Оборудване за копаене
1970-01-01 open Expenses:Crypto:Mining:Electricity    ; Електричество за копаене
1970-01-01 open Expenses:CapitalLoss:ShortTerm        ; Краткосрочни капиталови загуби
1970-01-01 open Expenses:CapitalLoss:LongTerm         ; Дългосрочни капиталови загуби

Метаданни за данъчно съответствие​

Използвайте метаданни за проследяване на информация, свързана с данъци:

2024-01-15 * "Buy BTC for long-term investment" ^investment-btc #long-term
  purchase-date: "2024-01-15"
  intended-holding: "long-term"
  tax-lot-id: "BTC-001"
  Assets:Crypto:LongTerm:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD         -45000.00 USD
  Expenses:Crypto:Fees:Deductible        50.00 USD
  Assets:Crypto:Coinbase:USD            -50.00 USD

Отчитане на облагаеми събития с криптовалута​

1. Продажби на криптовалути​

Краткосрочни капиталови печалби (≤ 1 година)​

2024-06-15 * "Sell BTC - Short-term capital gain" ^btc-sale-001
  date-acquired: "2024-01-15"
  holding-period: "151 days"
  form-8949-code: "A"
  Assets:Crypto:ShortTerm:Coinbase:BTC  -0.5 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD           24000.00 USD
  Expenses:Crypto:Fees:Deductible         30.00 USD
  Assets:Crypto:Coinbase:USD             -30.00 USD
  Income:CapitalGains:ShortTerm         1470.00 USD  ; 24000 - 22500 - 30

Дългосрочни капиталови печалби (> 1 година)​

2025-02-01 * "Sell BTC - Long-term capital gain" ^btc-sale-002
  date-acquired: "2024-01-15"
  holding-period: "382 days"
  form-8949-code: "D"
  Assets:Crypto:LongTerm:Coinbase:BTC   -0.5 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD           28000.00 USD
  Expenses:Crypto:Fees:Deductible         35.00 USD
  Assets:Crypto:Coinbase:USD             -35.00 USD
  Income:CapitalGains:LongTerm          5465.00 USD  ; 28000 - 22500 - 35

2. Крипто-към-крипто сделки​

Всяка крипто-към-крипто сделка е облагаема:

2024-03-20 * "Търговия с BTC за ETH - Облагаем обмен"
  ; Продажба на BTC (облагаемо събитие)
  Assets:Crypto:Trading:Binance:BTC     -1.0 BTC {46000.00 USD}
  Income:CapitalGains:ShortTerm        2000.00 USD  ; 48000 - 46000

  ; Придобиване на ETH (нова себестойност)
  Assets:Crypto:Trading:Binance:ETH      20 ETH {2400.00 USD}

  ; Такси за търговия
  Expenses:Crypto:Fees:Deductible        40.00 USD
  Assets:Crypto:Trading:Binance:USD     -40.00 USD

3. Награди от стейкинг (Обикновен доход)​

2024-01-31 * "ETH Staking Rewards - January"
  reward-type: "staking"
  fair-market-value: "2500.00 USD per ETH"
  taxable-income: "200.00 USD"
  Assets:Staking:Ethereum:ETH           0.08 ETH {2500.00 USD}
  Income:Crypto:Staking:Ordinary       200.00 USD

4. Доход от копаене​

2024-01-15 * "Награда от копаене на Биткойн"
  mining-pool: "Slush Pool"
  block-height: "825000"
  fair-market-value: "45000.00 USD per BTC"
  Assets:Crypto:Mining:BTC              0.01 BTC {45000.00 USD}
  Income:Crypto:Mining:Ordinary        450.00 USD

  ; Разходи за копаене (приспадаеми)
  Expenses:Crypto:Mining:Electricity    120.00 USD
  Assets:Checking                      -120.00 USD

5. Еърдропи и Хард форкове​

2024-03-01 * "UNI Token Airdrop"
  airdrop-source: "Uniswap Protocol"
  fair-market-value: "8.00 USD per UNI"
  taxable-amount: "3200.00 USD"
  Assets:Crypto:Wallet:MetaMask:UNI    400 UNI {8.00 USD}
  Income:Crypto:Airdrops:Ordinary     3200.00 USD

6. DeFi Дейности​

Възнаграждения от доходно земеделие​

2024-02-28 * "Доходност от протокола Compound"
  protocol: "Compound"
  reward-token: "COMP"
  fair-market-value: "85.00 USD за COMP"
  Assets:Crypto:Wallet:MetaMask:COMP    12 COMP {85.00 USD}
  Income:Crypto:DeFi:Ordinary         1020.00 USD

Такси за Ликвиден Пул​

2024-02-15 * "Изискани такси от Uniswap ЛП"
  protocol: "Uniswap V3"
  pool: "ETH-USDC"
  Assets:Crypto:Wallet:MetaMask:ETH     0.2 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC    300 USDC
  Income:Crypto:DeFi:Ordinary          820.00 USD

Стратегии за данъчна оптимизация​

1. Прибиране на данъчни загуби​

Систематично реализирайте загуби, за да компенсирате печалби:

; Идентифицирайте губещи позиции
2024-12-15 * "Tax Loss Harvesting - Sell ADA at loss"
  purchase-date: "2024-06-01"
  purchase-price: "0.60 USD per ADA"
  sale-price: "0.45 USD per ADA"
  Assets:Crypto:Trading:Binance:ADA    -1000 ADA {0.60 USD}
  Assets:Crypto:Trading:Binance:USD     445.00 USD
  Expenses:Crypto:Fees:Deductible         5.00 USD
  Assets:Crypto:Trading:Binance:USD      -5.00 USD
  Expenses:CapitalLoss:ShortTerm       150.00 USD  ; Реализирана загуба

2. Съображения относно фиктивни продажби​

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

; Изчакайте 31 дни преди повторно закупуване
2025-01-16 * "Repurchase ADA after wash sale period"
  wash-sale-safe: "31+ days elapsed"
  Assets:Crypto:Trading:Binance:ADA    1000 ADA {0.45 USD}
  Assets:Crypto:Trading:Binance:USD    -450.00 USD
  Expenses:Crypto:Fees:Deductible         5.00 USD
  Assets:Crypto:Trading:Binance:USD      -5.00 USD

3. Метод на специфичното идентифициране​

Изберете кои партиди да продадете за оптимални данъчни резултати:

; Партида с висока себестойност за прибиране на загуби
2024-11-30 * "Sell high-cost ETH lot for tax loss"
  lot-selection: "specific-identification"
  cost-basis: "3500.00 USD per ETH"
  sale-price: "2400.00 USD per ETH"
  Assets:Crypto:Trading:Coinbase:ETH    -5 ETH {3500.00 USD}
  Assets:Crypto:Trading:Coinbase:USD  11950.00 USD
  Expenses:Crypto:Fees:Deductible        50.00 USD
  Assets:Crypto:Trading:Coinbase:USD    -50.00 USD
  Expenses:CapitalLoss:ShortTerm      5500.00 USD  ; Significant loss

4. Дългосрочно спрямо Краткосрочно Планиране​

Стратегически планирайте продажбите за благоприятно данъчно третиране:

; Задръжте за дългосрочно третиране
2024-12-20 * "BTC наближава дългосрочен статус"
  purchase-date: "2024-01-01"
  days-held: "354"
  long-term-date: "2025-01-02"
  note: "Задръжте още 11 дни за дългосрочно третиране"

Автоматизирано данъчно отчитане​

Генериране на Форма 8949​

Използвайте заявки на Beancount.io за генериране на данни за Форма 8949:

-- Краткосрочни капиталови печалби/загуби
SELECT
  date,
  narration,
  -position as продадено_количество,
  cost(position) as базисна_стойност,
  value(position) as постъпления,
  value(position) + cost(position) as печалба_загуба
WHERE account ~ "Доход:КапиталовиПечалби:Краткосрочни"
   OR account ~ "Разходи:КапиталовиЗагуби:Краткосрочни"
ORDER BY date;

Обобщение на Приложение D​

-- Обобщение на капиталовите печалби
SELECT
  'Краткосрочни' as type,
  sum(position) as total_gain_loss
WHERE account ~ "Income:CapitalGains:ShortTerm"
   OR account ~ "Expenses:CapitalLoss:ShortTerm"

UNION ALL

SELECT
  'Дългосрочни' as type,
  sum(position) as total_gain_loss
WHERE account ~ "Income:CapitalGains:LongTerm"
   OR account ~ "Expenses:CapitalLoss:LongTerm";

Отчитане на обикновен доход​

-- Крипто обикновен доход
SELECT
  account,
  sum(position) as total_income
WHERE account ~ "Income:Crypto.*:Ordinary"
GROUP BY account
ORDER BY total_income DESC;

Водене на записи и документация​

Основна Документация​

Поддържайте изчерпателни записи за всяка транзакция:

2024-01-15 * "Покупка на BTC - Пълна Документация" ^btc-001
  exchange: "Coinbase Pro"
  transaction-id: "abc123def456"
  confirmation-hash: "0x789..."
  ip-address: "192.168.1.100"
  timestamp: "2024-01-15T14:30:00Z"
  market-price-source: "CoinGecko"
  Assets:Crypto:LongTerm:Coinbase:BTC  1.0 BTC {45000.00 USD}
  Assets:Crypto:Coinbase:USD         -45000.00 USD

Поддържане на одитна следа​

Създаване на подробни одитни следи:

; Свързване на свързани трансакции
2024-01-15 * "BTC Purchase" ^btc-purchase-001
2024-01-20 * "BTC Transfer to Wallet" ^btc-purchase-001
2024-06-15 * "BTC Sale" ^btc-purchase-001

Проверка на цени​

Документиране на източници на цени за справедлива пазарна стойност:

2024-01-15 price BTC 45000.00 USD
  source: "CoinGecko"
  timestamp: "2024-01-15T14:30:00Z"
  verification: "Средна стойност от множество борси"

Често срещани грешки при данъчното съответствие​

1. Пропуснати транзакции​

• Проблем: Неотчитане на всички облагаеми събития
• Решение: Изчерпателно проследяване на транзакциите в Beancount.io

2. Неправилна Базова Стойност​

• Проблем: Използване на грешен метод за изчисляване на базовата стойност
• Решение: Проследяване по партиди със специфична идентификация

3. Неотчитане на доходи​

• Проблем: Неотчитане на доходи от стейкинг, копаене или аирдропи
• Решение: Отделни сметки за доходи за всички източници

4. Недостатъчна документация​

• Проблем: Недостатъчни записи за защита при одит
• Решение: Подробни метаданни и свързване на транзакции

5. Времеви проблеми​

• Проблем: Неправилни изчисления на периода на държане
• Решение: Автоматизирано проследяване на дати и известия

Интеграция с данъчен софтуер​

Експорт към популярни данъчни инструменти​

Генерирайте отчети, съвместими с основните данъчни софтуери:

# Експортиране във формат TurboTax
def export_turbotax_format():
    return {
        'form_8949_short_term': query_short_term_gains(),
        'form_8949_long_term': query_long_term_gains(),
        'schedule_1_income': query_ordinary_income(),
        'deductible_expenses': query_deductible_expenses()
    }

Професионална данъчна подготовка​

Предоставяйте на СПС изчерпателни отчети:

-- Пълен данъчен пакет за СПС
SELECT
  'Capital Gains Summary' as report_type,
  account,
  sum(position) as amount
WHERE account ~ "Income:CapitalGains"
   OR account ~ "Expenses:CapitalLoss"
GROUP BY account

UNION ALL

SELECT
  'Ordinary Income Summary' as report_type,
  account,
  sum(position) as amount
WHERE account ~ "Income:Crypto.*:Ordinary"
GROUP BY account;

Годишно данъчно планиране​

Декемврийски данъчни стратегии​

Приложете годишна данъчна оптимизация:

; Декемврийски контролен списък за данъчно планиране
2024-12-01 * "Преглед на годишното данъчно планиране"
  unrealized-gains: "Изчислете нереализираните позиции"
  loss-harvesting: "Идентифицирайте възможности за прибиране на загуби"
  income-timing: "Разгледайте отлагане на доходи за следващата година"
  expense-timing: "Ускорете приспадаемите разходи"

Тримесечни авансови данъци​

Проследявайте тримесечните данъчни задължения:

2024-01-15 * "Q1 Estimated Tax Payment"
  Expenses:Taxes:Estimated:Federal     5000.00 USD
  Expenses:Taxes:Estimated:State       1200.00 USD
  Assets:Checking                     -6200.00 USD

Заключение​

Спазването на данъчните изисквания за криптовалути не е задължително да бъде непосилно. С цялостната счетоводна система с обикновен текст на Beancount.io можете да:

• Осигурите пълно съответствие: Изпълнете всички изисквания за отчитане на IRS
• Оптимизирате данъчната си задълженост: Приложете сложни данъчни стратегии
• Поддържате готови за одит записи: Цялостна документация и одитни следи
• Автоматизирате отчитането: Генерирайте данъчни формуляри и отчети автоматично
• Мащабирате според сложността: Обработвайте от прости сделки до сложни DeFi стратегии

Ключови предимства за спазването на данъчните изисквания за криптовалути:

• Прозрачни изчисления: Вижте точно как се изчисляват данъчните суми
• Гъвкаво отчитане: Генерирайте всеки необходим формат на отчет
• Професионална интеграция: Работете безпроблемно с CPA и данъчен софтуер
• Записи, устойчиви на бъдещето: Форматът на обикновен текст осигурява дългосрочна достъпност

Започнете да прилагате правилното данъчно съответствие за криптовалути още днес. Инвестицията в точно водене на записи ще ви спести време, пари и стрес по време на данъчния сезон, като същевременно гарантира, че сте напълно съвместими с изискванията на IRS.

Готови ли сте да овладеете данъчното съответствие за криптовалути? Започнете с Beancount.io и поемете контрол над данъчните си задължения за криптовалути.

Децентрализираните финанси (DeFi) революционизираха начина, по който взаимодействаме с финансовите услуги, предлагайки безпрецедентни възможности за генериране на доходност, осигуряване на ликвидност и децентрализирана търговия. Въпреки това, с тези възможности идва и предизвикателството за точно проследяване на сложни транзакции за данъчно съответствие и управление на портфолио.

Традиционните счетоводни методи се затрудняват с уникалните характеристики на DeFi: автоматизирани маркет мейкъри (Automated Market Makers), добив на ликвидност (Liquidity Mining), непостоянна загуба (Impermanent Loss) и награди от множество токени. Това изчерпателно ръководство ви показва как да овладеете счетоводството за DeFi, използвайки мощната система за текстово счетоводство на Beancount.io.

Разбиране на счетоводните предизвикателства в DeFi​

Сложността на DeFi транзакциите​

DeFi протоколите създават счетоводни предизвикателства, които не съществуват в традиционните финанси:

• Мулти-токен транзакции: Единични операции, включващи множество криптовалути
• Автоматично капитализиране: Награди, автоматично реинвестирани
• Непостоянна загуба: Промени в стойността поради разминаване в цените в пуловете за ликвидност
• Оптимизация на таксите за газ: Сложни структури на таксите в различни мрежи
• Управление на протокола: Права на глас и разпределения на токени за управление
• Междупротоколни взаимодействия: Транзакции, обхващащи множество DeFi платформи

Данъчни последици от DeFi дейности​

IRS третира DeFi дейностите като облагаеми събития:

• Осигуряване на ликвидност: Може да предизвика облагаеми събития при депозиране на активи
• Награди от yield farming: Облагаеми като обикновен доход по справедлива пазарна стойност
• Непостоянна загуба: Потенциални данъчни последици при изтегляне от пулове
• Управляващи токени: Еърдропи и награди, облагаеми като доход
• Награди от стейкинг: Облагаеми като доход при получаване

Настройване на DeFi сметки в Beancount.io​

Изчерпателна структура на сметки​

Създайте подробна йерархия на сметки, която обхваща всички DeFi дейности:

; Wallet Accounts
1970-01-01 open Assets:Crypto:Wallet:MetaMask:ETH
1970-01-01 open Assets:Crypto:Wallet:MetaMask:USDC
1970-01-01 open Assets:Crypto:Wallet:MetaMask:DAI
1970-01-01 open Assets:Crypto:Wallet:MetaMask:WBTC

; Uniswap V3 Liquidity Pools
1970-01-01 open Assets:DeFi:Uniswap:ETH-USDC-LP
1970-01-01 open Assets:DeFi:Uniswap:DAI-USDC-LP
1970-01-01 open Assets:DeFi:Uniswap:WBTC-ETH-LP

; Compound Protocol
1970-01-01 open Assets:DeFi:Compound:cUSDC
1970-01-01 open Assets:DeFi:Compound:cETH
1970-01-01 open Assets:DeFi:Compound:cDAI

; Aave Protocol
1970-01-01 open Assets:DeFi:Aave:aUSDC
1970-01-01 open Assets:DeFi:Aave:aETH
1970-01-01 open Assets:DeFi:Aave:DebtETH

; Staking Protocols
1970-01-01 open Assets:Staking:Ethereum:ETH
1970-01-01 open Assets:Staking:Lido:stETH
1970-01-01 open Assets:Staking:RocketPool:rETH

; Income Accounts
1970-01-01 open Income:DeFi:Yield:Uniswap
1970-01-01 open Income:DeFi:Yield:Compound
1970-01-01 open Income:DeFi:Yield:Aave
1970-01-01 open Income:DeFi:Staking:Ethereum
1970-01-01 open Income:DeFi:Governance:Tokens
1970-01-01 open Income:DeFi:Airdrops

; Expense Accounts
1970-01-01 open Expenses:DeFi:Gas:Ethereum
1970-01-01 open Expenses:DeFi:Gas:Polygon
1970-01-01 open Expenses:DeFi:Gas:Arbitrum
1970-01-01 open Expenses:DeFi:ImpermanentLoss

DeFi-специфични стоки​

Дефинирайте токени и LP токени с подходящи метаданни:

1970-01-01 commodity UNI-V3-ETH-USDC
  name: "Uniswap V3 ETH-USDC LP Token"
  asset-class: "liquidity-pool"
  protocol: "uniswap-v3"

1970-01-01 commodity cUSDC
  name: "Compound USDC"
  asset-class: "lending-token"
  protocol: "compound"

1970-01-01 commodity stETH
  name: "Lido Staked Ethereum"
  asset-class: "staking-derivative"
  protocol: "lido"

Проследяване на обичайни DeFi дейности​

1. Предоставяне на ликвидност в Uniswap​

Добавяне на ликвидност към пул​

2024-01-15 * "Добавяне на ликвидност към ETH-USDC Uniswap V3 пул"
  Assets:Crypto:Wallet:MetaMask:ETH     -5.0 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC  -12500 USDC
  Assets:DeFi:Uniswap:ETH-USDC-LP        100 UNI-V3-ETH-USDC {250.00 USD}
  Expenses:DeFi:Gas:Ethereum            0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH    -0.01 ETH {2500.00 USD}

Прибиране на LP такси​

2024-02-15 * "Прибиране на Uniswap LP такси"
  Assets:Crypto:Wallet:MetaMask:ETH     0.2 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC    300 USDC
  Income:DeFi:Yield:Uniswap            820.00 USD
  Expenses:DeFi:Gas:Ethereum           0.005 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.005 ETH {2600.00 USD}

Премахване на ликвидност с непостоянна загуба​

2024-03-15 * "Премахване на ликвидност от ETH-USDC пул"
  Assets:DeFi:Uniswap:ETH-USDC-LP       -100 UNI-V3-ETH-USDC {250.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH      4.8 ETH {2800.00 USD}
  Assets:Crypto:Wallet:MetaMask:USDC   12800 USDC
  Expenses:DeFi:ImpermanentLoss         240.00 USD  ; изчисляване на непостоянна загуба
  Expenses:DeFi:Gas:Ethereum           0.008 ETH {2800.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.008 ETH {2800.00 USD}

2. Кредитиране чрез Compound Protocol​

Доставяне на активи към Compound​

2024-01-20 * "Supply USDC to Compound"
  Assets:Crypto:Wallet:MetaMask:USDC  -10000 USDC
  Assets:DeFi:Compound:cUSDC            500 cUSDC {20.00 USD}
  Expenses:DeFi:Gas:Ethereum           0.008 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.008 ETH {2500.00 USD}

Печелене на сложна лихва​

2024-02-20 * "Начисляване на сложна лихва"
  Assets:DeFi:Compound:cUSDC             5.2 cUSDC {20.50 USD}
  Income:DeFi:Yield:Compound           106.60 USD

Получаване на COMP награди​

2024-02-20 * "Изискване на COMP токени за управление"
  Assets:Crypto:Wallet:MetaMask:COMP     12 COMP {85.00 USD}
  Income:DeFi:Governance:Tokens        1020.00 USD
  Expenses:DeFi:Gas:Ethereum           0.006 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.006 ETH {2600.00 USD}

3. Операции на протокола Aave​

Депозиране и Заемане​

; Deposit ETH as collateral
2024-01-25 * "Deposit ETH to Aave"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:DeFi:Aave:aETH                 10 aETH {2500.00 USD}
  Expenses:DeFi:Gas:Ethereum          0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.01 ETH {2500.00 USD}

; Borrow USDC against ETH collateral
2024-01-25 * "Borrow USDC from Aave"
  Assets:Crypto:Wallet:MetaMask:USDC  15000 USDC
  Liabilities:DeFi:Aave:DebtUSDC     -15000 USDC
  Expenses:DeFi:Gas:Ethereum          0.008 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.008 ETH {2500.00 USD}

Погасяване на заеми с лихва​

2024-03-25 * "Repay USDC loan to Aave"
  Liabilities:DeFi:Aave:DebtUSDC      15000 USDC
  Expenses:DeFi:Interest:Aave           450 USDC  ; Начислена лихва
  Assets:Crypto:Wallet:MetaMask:USDC -15450 USDC
  Expenses:DeFi:Gas:Ethereum          0.008 ETH {2700.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.008 ETH {2700.00 USD}

4. Стейкинг на Ethereum​

Директно Стейкване на Етериум​

2024-01-10 * "Stake ETH on Ethereum 2.0"
  Assets:Crypto:Wallet:MetaMask:ETH    -32 ETH {2500.00 USD}
  Assets:Staking:Ethereum:ETH           32 ETH {2500.00 USD}
  Expenses:DeFi:Gas:Ethereum          0.01 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.01 ETH {2500.00 USD}

Награди от стейкинг​

2024-02-10 * "Награди от стейкинг на ETH"
  Assets:Staking:Ethereum:ETH          0.15 ETH {2600.00 USD}
  Income:DeFi:Staking:Ethereum        390.00 USD

Ликвидно стейкване с Lido​

2024-01-12 * "Стейкване на ETH с Lido"
  Assets:Crypto:Wallet:MetaMask:ETH    -10 ETH {2500.00 USD}
  Assets:Staking:Lido:stETH             10 stETH {2500.00 USD}
  Expenses:DeFi:Gas:Ethereum          0.008 ETH {2500.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.008 ETH {2500.00 USD}

Напреднали DeFi сценарии​

Стратегии за доходно земеделие​

Многопротоколно доходно фермерство​

; Стъпка 1: Депозиране на USDC в Compound
2024-01-30 * "Депозиране на USDC в Compound за доходно фермерство"
  Assets:Crypto:Wallet:MetaMask:USDC  -20000 USDC
  Assets:DeFi:Compound:cUSDC            1000 cUSDC {20.00 USD}

; Стъпка 2: Заемане на DAI срещу cUSDC
2024-01-30 * "Заемане на DAI от Compound"
  Assets:Crypto:Wallet:MetaMask:DAI    15000 DAI
  Liabilities:DeFi:Compound:DebtDAI   -15000 DAI

; Стъпка 3: Предоставяне на DAI-USDC ликвидност на Uniswap
2024-01-30 * "Добавяне на DAI-USDC ликвидност за фермерство"
  Assets:Crypto:Wallet:MetaMask:DAI   -15000 DAI
  Assets:Crypto:Wallet:MetaMask:USDC   -5000 USDC  ; Допълнителен USDC
  Assets:DeFi:Uniswap:DAI-USDC-LP        200 UNI-V3-DAI-USDC {100.00 USD}

Крос-верижни DeFi операции​

Премостване на активи​

2024-02-05 * "Bridge ETH to Polygon"
  Assets:Crypto:Wallet:MetaMask:ETH    -5 ETH {2600.00 USD}
  Assets:Crypto:Wallet:Polygon:ETH      5 ETH {2600.00 USD}
  Expenses:DeFi:Bridge:Fees           0.01 ETH {2600.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH  -0.01 ETH {2600.00 USD}

Флаш заеми и арбитраж​

2024-02-10 * "Flash loan arbitrage opportunity"
  ; Flash loan
  Assets:Crypto:Temp:FlashLoan       100000 USDC
  Liabilities:DeFi:Aave:FlashLoan   -100000 USDC

  ; Arbitrage trade
  Assets:Crypto:Temp:FlashLoan      -100000 USDC
  Assets:Crypto:Temp:Arbitrage       101500 USDC

  ; Repay flash loan
  Liabilities:DeFi:Aave:FlashLoan    100000 USDC
  Assets:Crypto:Temp:Arbitrage      -100090 USDC  ; Including fees

  ; Profit
  Assets:Crypto:Wallet:MetaMask:USDC   1410 USDC
  Income:DeFi:Arbitrage:Profit        1410.00 USD

Съображения за данъчно отчитане на DeFi​

Признаване на приходи​

Всички DeFi награди са облагаеми като обикновен доход:

; Проследяване на всички източници на доход поотделно
Income:DeFi:Yield:Uniswap           ; Такси за LP
Income:DeFi:Yield:Compound          ; Спечелена лихва
Income:DeFi:Staking:Ethereum        ; Награди от стейкинг
Income:DeFi:Governance:Tokens       ; Еърдропи на токени за управление
Income:DeFi:Airdrops               ; Еърдропи от протоколи

Приспадаеми разходи​

Проследявайте приспадаемите разходи:

Expenses:DeFi:Gas:Ethereum          ; Такси за газ
Expenses:DeFi:Gas:Polygon           ; Такси за слой 2
Expenses:DeFi:Interest:Aave         ; Разходи за заемане
Expenses:DeFi:ImpermanentLoss       ; Непостоянна загуба от LP позиции

Проследяване на капиталови печалби​

Използвайте партидно счетоводство за точно изчисляване на капиталови печалби:

; Different cost basis for same token
Assets:DeFi:Compound:cUSDC   100 cUSDC {20.00 USD}  ; Batch 1
Assets:DeFi:Compound:cUSDC   100 cUSDC {21.00 USD}  ; Batch 2

Най-добри практики за DeFi счетоводство​

1. Записване на транзакции в реално време​

• Записвайте транзакции веднага след изпълнението им.
• Използвайте хешове на транзакции за проверка.
• Наблюдавайте мемпула за чакащи транзакции.

2. Проследяване на оптимизацията на газ таксите​

; Проследяване на стратегии за оптимизация на газ таксите
Expenses:DeFi:Gas:Ethereum:Standard    ; Стандартна газ такса
Expenses:DeFi:Gas:Ethereum:Fast        ; Бърза газ такса
Expenses:DeFi:Gas:Ethereum:Instant     ; Незабавна газ такса

3. Управление на протоколни рискове​

; Проследяване на протоколно-специфични рискове
Expenses:DeFi:Risk:SmartContract      ; Провали на смарт договори
Expenses:DeFi:Risk:Liquidation        ; Ликвидационни събития
Expenses:DeFi:Risk:Slippage          ; Разходи от приплъзване

4. Автоматизирано съгласуване​

• Настройване на автоматизирани ценови потоци
• Използване на API на протоколи за проверка на баланса
• Внедряване на автоматизирано импортиране на транзакции

5. Стандарти за документация​

• Поддържайте подробни бележки за транзакции
• Документирайте обосновката на стратегията
• Съхранявайте записи на протоколни взаимодействия

Интеграция с DeFi инструменти​

Проследяване на портфолио​

• DeBank: Преглед на DeFi портфолио
• Zapper: Мултипротоколно табло за управление
• Zerion: DeFi портфейл и тракер

Данъчна отчетност​

• Koinly: DeFi данъчни изчисления
• CoinTracker: Многопротоколна поддръжка
• TokenTax: Специализирана DeFi отчетност

Аналитични платформи​

• DeFi Pulse: Анализ на протоколи
• DeFiLlama: TVL и проследяване на доходност
• APY.vision: Проследяване на непостоянна загуба

Заключение​

Сложността на DeFi счетоводството не бива да ви пречи да участвате в революцията на децентрализираните финанси. С мощната система за счетоводство в обикновен текст на Beancount.io можете:

• Проследяване на сложни транзакции: Безпроблемно обработване на взаимодействия между множество протоколи
• Осигуряване на данъчно съответствие: Правилно отчитане на приходите и проследяване на разходите
• Наблюдение на ефективността на портфолиото: Прозрения в реално време за DeFi позициите
• Управление на риска: Проследяване на непостоянни загуби и рискове на протокола
• Мащабиране на операциите: От просто стейкване до сложни стратегии за добив на доходност (yield farming)

Ключът към успешното DeFi счетоводство е последователността, точността и правилното категоризиране. Започнете с основни протоколи и постепенно разширявайте към по-сложни стратегии, докато свикнете със счетоводните модели.

Готови ли сте да овладеете DeFi счетоводството? Започнете своето пътешествие с Beancount.io и поемете контрол над вашето портфолио от децентрализирани финанси днес.

Beancount версия 3, пусната в средата на 2024 г., отбелязва значителна архитектурна еволюция за популярния инструмент за счетоводство в обикновен текст. Въпреки че поддържа обратна съвместимост за потребителските файлове с регистри, основната структура и придружаващите инструменти са претърпели съществени промени. Ето преглед на новостите в Beancount v3.

По-модулна и оптимизирана архитектура​

Най-значителната промяна в Beancount v3 е преминаването към по-модулна екосистема. Няколко ключови функционалности, които преди това бяха пакетирани с ядрото, са отделени в самостоятелни, независими проекти. Това прави ядрото на Beancount по-леко и позволява по-фокусирано развитие на отделни компоненти.

Ключовите компоненти, които сега са отделни пакети, включват:

• beanquery: Мощният SQL-подобен инструмент за заявки за вашите файлове с регистри вече е в собствен пакет.
• beangulp: Това е новият дом за рамката за импортиране на данни, заместваща бившия модул beancount.ingest.
• beanprice: Специализиран инструмент за извличане на цени на стоки и акции.

Това разделение означава, че потребителите ще трябва да инсталират тези пакети в допълнение към beancount сам по себе си, за да запазят пълната функционалност, с която са свикнали във версия 2.

Промени в инструментите на командния ред и работните потоци​

Отразявайки новата модулна архитектура, има някои забележителни промени в инструментите на командния ред:

• bean-report е премахнат: Този инструмент е премахнат. Потребителите вече се насърчават да използват bean-query (от пакета beanquery) за своите нужди от отчети.
• Нов работен поток за импортиране: Командите bean-extract и bean-identify са премахнати от ядрото. Новият подход с beangulp е базиран на скриптове. Потребителите вече ще създават свои собствени Python скриптове за обработка на импортирането на данни от външни източници като банкови извлечения.

Подобрения в синтаксиса и функциите​

Докато основните счетоводни принципи остават същите, Beancount v3 въвежда известна желана гъвкавост в своя синтаксис:

• По-гъвкави кодове на валути: Предишните ограничения за дължината и символите на имената на валутите са облекчени. Вече се поддържат едносимволни валутни символи.
• Разширени флагове за транзакции: Потребителите вече могат да използват всяка главна буква от А до Я като флаг за транзакции, което позволява по-детайлна категоризация.

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

Пренаписването на C++ и производителността​

Една от дългосрочните цели за Beancount е пренаписването на неговите критични за производителността компоненти на C++. Докато тази работа продължава, първоначалната версия на Beancount v3 не включва ядрото, базирано на C++. Това означава, че засега производителността на v3 е сравнима с тази на v2. Кодът на C++ остава в отделен клон за разработка за бъдеща интеграция.

Миграция от v2 към v3​

За повечето потребители миграцията от Beancount v2 към v3 е сравнително лесна:

1. Файлове с регистри: Не са необходими промени за вашите .beancount файлове.
2. Инсталация: Ще трябва да инсталирате новите, отделни пакети като beanquery и beangulp с помощта на pip.
3. Скриптове за импортиране: Ако имате персонализирани импортери, ще трябва да ги актуализирате, за да използват новия API на beangulp. Това включва главно промяна на базовия клас, от който наследяват вашите импортери, и коригиране на някои сигнатури на методи.
4. Fava: Популярният уеб интерфейс за Beancount, Fava, е актуализиран, за да бъде съвместим с v3. Уверете се, че разполагате с най-новата версия на Fava за безпроблемно изживяване.

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