87 پست با برچسب "Beancount"

هنگامی که یک کسب‌وکار را اداره می‌کنید یا امور مالی شخصی خود را مدیریت می‌کنید، اصطلاحات دفترداری و حسابداری اغلب با هم ترکیب می‌شوند. اما درک تفاوت‌های آن‌ها —به‌ویژه هنگام استفاده از ابزاری مبتنی بر متن ساده مانند 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 به شما این قدرت را می‌دهد که دفاتر خود را با دقت مدیریت کنید —و در نهایت تصمیمات استراتژیک مانند یک مدیر ارشد مالی (CFO) بگیرید.

به یاد داشته باشید:

• دفترداری = آنچه اتفاق افتاد
• حسابداری = آنچه به معنای آن است

با Beancount، شما هر دو لایه را با وضوح و اطمینان می‌سازید.

اگر نسخه قابل چاپ یا آموزش تکمیلی می‌خواهید، به من اطلاع دهید.

هر تراکنش مالی که کسب و کار شما انجام می‌دهد، باید ثبت شود - و در دنیای حسابداری متن ساده، این با ثبت‌های دفتر روزنامه شروع می‌شود. اگر از Beancount استفاده می‌کنید، درک ثبت‌های دفتر روزنامه کلید ایجاد سوابق مالی دقیق، قابل ممیزی و پاکیزه است.

این راهنما شما را در موارد زیر راهنمایی می‌کند:

• ثبت دفتر روزنامه چیست؟
• چرا ثبت‌های دفتر روزنامه مهم هستند؟
• چگونه آن‌ها را در دستور زبان Beancount بنویسیم؟
• چگونه به طور موثر از آن‌ها استفاده کنیم؟
• مثال‌هایی از تراکنش‌های دنیای واقعی (پرداخت‌های مشتری، خریدها، وام‌ها و غیره)

🧾 ثبت دفتر روزنامه در Beancount چیست؟​

در Beancount، ثبت دفتر روزنامه یک تراکنش تاریخ‌دار است که در قالب متن ساده و قابل خواندن توسط انسان نوشته شده است. هر ورودی از اصول حسابداری دوبل پیروی می‌کند - شما ثبت می‌کنید که پول از کجا می‌آید (بستانکار) و به کجا می‌رود (بدهکار)، و اطمینان حاصل می‌کنید که دفاتر شما همیشه تراز هستند.

مثال:

2024-06-01 * "پرداخت مشتری برای فاکتور #123"
  Assets:Bank:Checking     600.00 USD
  Income:Sales

• علامت * نشان دهنده یک تراکنش تسویه شده است.
• شرح، زمینه را برای ورودی نشان می‌دهد.
• Assets:Bank:Checking بدهکار شده است.
• Income:Sales بستانکار شده است (مقدار ضمنی است).

هر ورودی در داخل یک فایل .beancount قرار دارد - فقط یک فایل متنی که می‌توانید نسخه آن را کنترل کنید، پشتیبان‌گیری کنید و حتی در Vim یا VSCode ویرایش کنید.

📒 چرا ثبت‌های دفتر روزنامه مهم هستند​

ثبت‌های دفتر روزنامه واحد اتمی دفتر کل شما هستند.

آنها:

• به دفتر کل و مانده حساب‌ها وارد می‌شوند.
• همه گزارش‌ها را هدایت می‌کنند: صورت سود و زیان، ترازنامه، جریان‌های نقدی
• به شما این امکان را می‌دهند که هر دلار را، خط به خط، تا منبع آن ردیابی کنید.

با ابزارهای مناسب، این تراکنش‌ها را در یک رابط کاربری مشاهده خواهید کرد - طبقه‌بندی شده، قابل جستجو و فیلتر کردن. اما همه چیز با آن ورودی ساده متن ساده شروع می‌شود.

📚 نحوه کارکرد حسابداری دوبل در Beancount​

Beancount حسابداری دوبل را اعمال می‌کند. هر تراکنش باید متوازن باشد: مجموع بدهی‌ها = مجموع بستانکاری‌ها.

قانون سریع:

• بدهکار دارایی‌ها و هزینه‌ها (شما وجه نقد به دست می‌آورید یا هزینه‌ای را متحمل می‌شوید)
• بستانکار درآمد و بدهی‌ها (شما پول به دست می‌آورید یا بدهی را بر عهده می‌گیرید)

مثال - خرید لوازم اداری:

2024-06-02 * "خرید جوهر چاپگر"
  Expenses:OfficeSupplies   100.00 USD
  Assets:Bank:Checking

🧠 تجسم ورودی‌ها​

پس از ذخیره، در سمت چپ نوار پیمایش https://beancount.io/ledger/0/income_statement/ موارد زیر را خواهید دید ...

• نمای دفتر روزنامه: تراکنش‌ها را با جستجو، برچسب‌ها و فیلتر کردن ببینید
• منوی کشویی فیلتر حساب: مانده‌های جاری و ورودی‌های هر حساب را ببینید
• صورت سود و زیان: مجموع حساب‌های Income:* و Expenses:* شما
• ترازنامه: دارایی‌های شما منهای بدهی‌ها

Fava به تبدیل ورودی‌های خام Beancount شما به گزارش‌های عملی کمک می‌کند - بدون نیاز به تنظیم پایگاه داده.

💡 مثال‌های رایج ثبت دفتر روزنامه​

✅ شما توسط یک مشتری حقوق دریافت می‌کنید​

2024-06-05 * "پرداخت برای فاکتور #456"
  Assets:Bank:Checking     1,200.00 USD
  Income:Consulting

اختیاری: اگر از حساب‌های دریافتنی استفاده می‌کنید:

2024-05-20 * "فاکتور #456 ارسال شد"
  Assets:AccountsReceivable   1,200.00 USD
  Income:Consulting

2024-06-05 * "پرداخت برای فاکتور #456"
  Assets:Bank:Checking        1,200.00 USD
  Assets:AccountsReceivable  -1,200.00 USD

🖨️ شما لوازم اداری می‌خرید​

2024-06-07 * "خرید از Staples"
  Expenses:OfficeSupplies     85.00 USD
  Assets:Bank:Checking

🏦 شما پرداخت وام انجام می‌دهید​

فرض کنیم شما 1000 دلار پرداخت می‌کنید، با 200 دلار سود و 800 دلار به سمت اصل:

2024-06-10 * "بازپرداخت وام"
  Liabilities:Loan           -800.00 USD
  Expenses:LoanInterest       200.00 USD
  Assets:Bank:Checking      -1,000.00 USD

🔒 بستن ورودی‌ها در پایان سال​

برای "بستن دفاتر"، شما معمولاً همه حساب‌های Income و Expenses را به Equity منتقل می‌کنید.

2024-12-31 close Income:*
2024-12-31 close Expenses:*

یا، به صورت دستی:

2024-12-31 * "بستن دفاتر"
  Equity:RetainedEarnings     45,000.00 USD
  Income:Consulting          -45,000.00 USD

🛠️ تعدیل ورودی‌ها​

اگر در حال انجام حسابداری تعهدی هستید، می‌خواهید تعدیل ورودی‌ها را اضافه کنید - برای هزینه‌های پیش پرداخت شده، درآمد معوق و غیره.

مثال: اشتراک نرم افزار ماهانه 100 دلاری که سالانه پرداخت می‌شود

2024-01-01 * "پرداخت سالانه نرم افزار"
  Assets:Prepaid             1,200.00 USD
  Assets:Bank:Checking      -1,200.00 USD

2024-01-31 * "استهلاک ماهانه"
  Expenses:Software           100.00 USD
  Assets:Prepaid             -100.00 USD

با اسکریپت‌ها یا ابزارهای Beancount موجود، آن را خودکار کنید.

🧰 Beancount: سبک وزن، قابل ممیزی، قدرتمند​

Beancount فقط یک ابزار حسابداری نیست - بلکه یک ایده است: حقیقت مالی شفاف و متن ساده. این یک سیستم دفترداری مدرن است که:

• به راحتی قابل کنترل نسخه است (Git!)
• کاملاً قابل حمل است (بدون پایگاه داده اختصاصی)
• برای توسعه دهندگان، فریلنسرها و مشاغل کوچک عالی است

آماده شروع هستید؟​

فایل Beancount خود را با این موارد شروع کنید:

option "title" "دفتر کل کسب و کار من"
option "operating_currency" "USD"

2024-01-01 open Assets:Bank:Checking USD
2024-01-01 open Income:Sales USD
2024-01-01 open Expenses:OfficeSupplies USD
2024-01-01 open Equity:OpeningBalances USD

2024-01-01 * "مانده اولیه"
  Assets:Bank:Checking     10,000.00 USD
  Equity:OpeningBalances

سپس فایل خود را با ابزار تجسم ترجیحی خود بارگیری کنید تا جادو را ببینید.

یک شروع آسان‌تر می‌خواهید؟ الگوها، واردکننده‌ها یا ابزارهای انجمن مانند bean-extract را امتحان کنید.

با Beancount، دفاتر شما سرانجام متعلق به خودتان هستند - ساده، قابل اسکریپت‌نویسی و ضد ممیزی.

اگر نسخه PDF قابل دانلود یا تغییرات خاص کسب و کارهای کوچک از مثال‌ها را می‌خواهید، به من اطلاع دهید.

اصول اولیه دفترداری که واقعاً می‌توانید درک کنید—و مالک آن باشید​

مدیریت دفاتر خودتان نیازی به صفحات گسترده، استرس یا نرم‌افزارهای گران‌قیمت ندارد. بیانکونت راهی مینیمالیستی، قابل حسابرسی و قدرتمند برای انجام دفترداری با استفاده از تنها متن ساده و یک سیستم حسابداری دوطرفه را به شما می‌دهد.

این راهنما، مقدمه‌ای کامل برای مرتب کردن دفاتر کسب‌وکار کوچک شما با بیانکونت است—با مثال‌های واقعی و دستورالعمل‌های گام‌به‌گام.

🧾 بیانکونت چیست؟​

بیانکونت یک سیستم حسابداری متن ساده متن‌باز است که بر پایه دفترداری دوطرفه بنا شده است. شما تراکنش‌های خود را در فایل‌های .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

این سیستم قابل خواندن، قابل اسکریپت‌نویسی و قابل کنترل نسخه است—ایده‌آل برای صاحبان کسب‌وکار که شفافیت و کنترل می‌خواهند.

📌 چرا دفترداری اهمیت دارد (و چرا بیانکونت)​

• برای مالیات به آن نیاز دارید
• برای وضوح به آن نیاز دارید
• برای تأمین مالی به آن نیاز دارید
• برای شناسایی زودهنگام اشتباهات به آن نیاز دارید

و با بیانکونت، می‌توانید تمام این کارها را تنها با یک ویرایشگر متن و چند ابزار انجام دهید.

🪜 8 گام برای شروع دفترداری خودتان با بیانکونت​

1. تفکیک امور مالی کسب‌وکار و شخصی​

یک حساب جاری و کارت اعتباری جداگانه برای کسب‌وکار باز کنید. آن را در بیانکونت منعکس کنید:

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

این کار دفاتر شما را تمیز نگه می‌دارد و از شما از نظر قانونی محافظت می‌کند (به ویژه اگر شرکت با مسئولیت محدود یا سهامی باشید).

2. استفاده از دفترداری دوطرفه​

هر رویداد مالی دو حساب را تحت تأثیر قرار می‌دهد. بیانکونت این تعادل را به صورت طراحی شده اعمال می‌کند:

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/ استفاده کنید. سپس آن‌ها را در بیانکونت به این صورت پیوند دهید:

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

یا فقط به "جمعه بیانکونت" متعهد شوید و همه چیز را هفتگی تطبیق دهید.

💼 خودتان انجام دهید یا کمک بگیرید؟​

شما می‌توانید همه کارها را خودتان با بیانکونت انجام دهید. اما حتی کاربران حرفه‌ای نیز باید:

• در طول راه‌اندازی با یک حسابدار رسمی مشورت کنند
• در زمان مالیات، در صورت نیاز، یک حسابدار استخدام کنند
• از Fava برای گزارش‌های ماهانه استفاده کنند

شما تمام قدرت یک سیستم حسابداری را بدون وابستگی به فروشنده یا هزینه‌های اشتراک به دست می‌آورید.

🛠️ ابزارهای پیشنهادی برای کاربران بیانکونت​

• Fava – داشبورد وب زیبا برای فایل‌های بیانکونت
• 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

در دنیای امروز، معیارهای محیطی، اجتماعی، و حاکمیتی (ESG) دیگر فقط کلمات پرطرفدار نیستند؛ آن‌ها شاخص‌های اساسی سلامت و بقای آینده یک شرکت محسوب می‌شوند. اما چگونه این بینش‌های حیاتی پایداری را با حسابداری مالی سنتی ادغام می‌کنید؟ وارد شوید به Beancount، یک دفتر کل دوطرفه متن‌باز و متنی ساده که راه‌حلی به طرز شگفت‌انگیزی قدرتمند و انعطاف‌پذیر برای پر کردن این شکاف ارائه می‌دهد.

تصور کنید که گزارش‌دهی پایداری پراکنده خود را به یک سیستم یکپارچه و خودکار تبدیل کنید که همه چیز را از انتشار کربن گرفته تا تنوع تأمین‌کنندگان، همگی را در گردش کار مالی موجود شما ردیابی می‌کند. Beancount این امکان را با در نظر گرفتن داده‌های ESG به عنوان "شهروندان درجه یک در کنار تراکنش‌های مالی" فراهم می‌کند.

مدل‌سازی داده‌های ESG: رویکرد بین‌کاونت​

انعطاف‌پذیری ذاتی بین‌کاونت، نقطه قوت آن در زمینه ESG است. به جای صفحات گسترده مجزا، می‌توانید معیارهای پایداری را مستقیماً در ساختار مالی خود با استفاده از چند تکنیک کلیدی جاسازی کنید:

• حساب‌های اختصاصی و کالاها: ردپای زیست‌محیطی خود را مانند یک ارز دیگر در نظر بگیرید. می‌توانید حساب‌هایی مانند Metrics:Emissions:CO2e برای ردیابی انتشار کربن ایجاد کنید. این انتشارات حتی می‌توانند به عنوان یک کالا (مانند یک واحد معادل CO2، tCO2e) در نظر گرفته شوند، که به شما امکان می‌دهد مقادیر مشخصی را در تراکنش‌های خود ثبت کنید. به عنوان مثال، خرید یک پرواز می‌تواند حساب Emissions:CO2e را با +0.3 tCO2e در کنار هزینه پولی بستانکار کند.
• برچسب‌های فراداده سفارشی: فراداده کلید-مقدار بین‌کاونت برای افزودن زمینه عالی است. می‌توانید یک تراکنش را با CO2e: 0.3 t یا Scope: 3 برچسب‌گذاری کنید تا تأثیر کربن یا دامنه پروتکل GHG آن را نشان دهید. این کار هزینه‌های مالی را مستقیماً به پیامدهای زیست‌محیطی آن‌ها پیوند می‌دهد و تصویری غنی‌تر و کامل‌تر ارائه می‌دهد.
• برچسب‌های ساختاریافته برای دسته‌بندی‌ها: همسو شدن با استانداردهایی مانند پروتکل گازهای گلخانه‌ای (GHGP) حیاتی است. می‌توانید از برچسب‌های ثابت یا قراردادهای نام‌گذاری حساب، مانند Metrics:Emissions:Scope1، Metrics:Emissions:Scope2، و Metrics:Emissions:Scope3 برای دسته‌بندی و گزارش‌دهی آسان در مورد انتشارات مستقیم، مرتبط با انرژی، و زنجیره ارزش استفاده کنید.

این رویکرد سازگار به این معنی است که با تکامل استانداردهای ESG، می‌توانید ساختار دفتر کل خود را بدون نیاز به بازنگری کامل تنظیم کنید.

Beancount در مقابل ابزارهای تخصصی ESG: یک انتخاب استراتژیک​

در حالی که پلتفرم‌های اختصاصی ESG مانند Persefoni یا SAP Green Ledger راه‌حل‌های بسیار خودکار و هدفمند ارائه می‌دهند، Beancount یک جایگزین جذاب ارائه می‌کند، به ویژه برای کسانی که به دنبال شفافیت و کنترل هستند.

Beancount یک نیروگاه DIY (خودت انجام بده) است: این به شما انعطاف‌پذیری و شفافیت بی‌نظیری می‌دهد، که آن را برای افراد یا سازمان‌های کوچک با دانش فنی ایده‌آل می‌سازد. شما مالک کامل داده‌های خود هستید و از قفل شدن توسط فروشنده جلوگیری می‌کنید.

ابزارهای تخصصی راه‌حل‌های آماده ارائه می‌دهند: آن‌ها در جمع‌آوری خودکار داده‌ها، پایگاه‌های داده عوامل انتشار داخلی، و گزارش‌های انطباق آماده برتری دارند، اغلب با هزینه بالاتر و انعطاف‌پذیری کمتر.

یک رویکرد ترکیبی نیز قابل اجرا است: از Beancount برای ردیابی داخلی دقیق و تطبیق استفاده کنید، سپس داده‌های خلاصه را به یک پلتفرم خارجی برای گزارش‌دهی سطح بالا به ذینفعان صادر کنید.

کاربردهای واقعی: ESG در عمل با بین‌کاونت​

تطبیق‌پذیری بین‌کاونت آن را برای چندین مورد استفاده کلیدی ESG مناسب می‌سازد:

• ردیابی انتشار گازهای گلخانه‌ای Scope 3: چالش‌برانگیزترین انتشار گازهای گلخانه‌ای برای ردیابی (از زنجیره ارزش شما) می‌تواند با پیوند دادن داده‌های انتشار گازهای گلخانه‌ای تامین‌کنندگان به تراکنش‌های خرید، یکپارچه شود. بین‌کاونت یک مسیر حسابرسی شفاف برای این ارقام پیچیده فراهم می‌کند و امکان تحلیل بهتر و شناسایی منابع داده را می‌دهد.
• حسابرسی و اطمینان‌پذیری پایداری: مانند داده‌های مالی، ارقام ESG باید قابل تأیید باشند. بین‌کاونت به شما امکان می‌دهد هر ورودی ESG را به اسناد منبع (مانند قبوض آب و برق، بیانیه‌های تأیید شخص ثالث) پیوند دهید و یک مسیر حسابرسی دقیق برای شفافیت و اطمینان‌پذیری فراهم می‌کند.
• گزارش‌دهی انطباق با CSRD/ESRS اتحادیه اروپا: برای شرکت‌هایی که با مقررات سخت‌گیرانه‌ای مانند CSRD مواجه هستند، بین‌کاونت می‌تواند به عنوان یک مخزن مرکزی برای افشای کمی عمل کند. در حالی که گزارش‌ها را به طور خودکار به فرمت XBRL تبدیل نمی‌کند، داده‌های دقیق و قابل حسابرسی لازم را برای تولید ارقام آماده انطباق فراهم می‌کند.
• تحلیل ردپای کربن و حسابداری مدیریت: کربن را به عنوان بُعد دیگری از حسابداری مدیریت در نظر بگیرید. با تخصیص انتشار گازهای گلخانه‌ای به مراکز سود یا کدهای محصول، می‌توانید معیارهایی مانند "انتشار گازهای گلخانه‌ای به ازای هر دلار درآمد" را محاسبه کرده و نقاط داغ کربن را شناسایی کنید که منجر به تصمیم‌گیری‌های پایدارتر و آگاهانه‌تر می‌شود.

بهترین شیوه‌ها برای دفتر کل ESG بین‌کانت شما​

برای به حداکثر رساندن اثربخشی بین‌کانت برای ESG، این بهترین شیوه‌ها را در نظر بگیرید:

۱. طراحی سرفصل حساب‌های واضح برای ESG: حساب‌های ESG خود را با دقت ساختاربندی کنید (به عنوان مثال، Metrics:Emissions:Scope1:Fuel)، درست مانند حساب‌های مالی خود. ۲. استفاده مداوم از فراداده: از برچسب‌ها (به عنوان مثال، Scope: 3، FactorSource: EPA2024) برای زمینه یکپارچه و پرس‌وجوی آسان‌تر بهره ببرید. ۳. ایجاد تعادل بین جزئیات و قابلیت مدیریت: بر معیارهای با اهمیت تمرکز کنید تا از بارگذاری بیش از حد دفتر کل خود با جزئیات غیرضروری جلوگیری شود. ۴. خودکارسازی با احتیاط: از اسکریپت‌های پایتون برای وارد کردن و اعتبارسنجی داده‌ها استفاده کنید، اما از کنترل خطای دقیق و مستندسازی واضح فرآیندهای خودکارسازی اطمینان حاصل کنید. ۵. بهره‌گیری از کنترل نسخه: از گیت (Git) برای ردیابی هر تغییر در دفتر کل خود استفاده کنید و تاریخچه‌ای شفاف و قابل حسابرسی از داده‌های ESG خود ارائه دهید. ۶. اتصال به اسناد و شواهد: فایل‌های منبع (به عنوان مثال، فایل‌های PDF قبوض آب و برق) را به ورودی‌های دفتر کل پیوند دهید تا تأیید آسان در طول حسابرسی‌ها فراهم شود. ۷. بهره‌گیری از فاوا برای درک عمیق: فاوا را برای نمایش نمودارها و گزارش‌های سفارشی ESG پیکربندی کنید تا داده‌های پایداری شما قابل اقدام و برای ذی‌نفعان غیرفنی قابل دسترس باشد. ۸. به‌روز ماندن در مورد استانداردها: گزارش‌دهی ESG پویا است؛ آماده باشید تا ساختار بین‌کانت خود را با پدیدار شدن مقررات و چارچوب‌های جدید تطبیق دهید.

آینده سبز و متن ساده است​

در حالی که بین‌کانت در حال حاضر فاقد هوش بومی ESG یا قابلیت گزارش‌دهی آماده به کار است، ماهیت متن‌باز آن فرصت‌های بی‌شماری را برای بهبود ارائه می‌دهد. افزونه‌های توسعه‌یافته توسط جامعه برای حسابداری کربن، الگوهای استاندارد دفتر کل ESG، و یکپارچگی بهتر با APIهای عامل انتشار می‌توانند قابلیت‌های آن را به طور قابل توجهی افزایش دهند.

همانطور که دنیای شرکت‌ها به طور فزاینده‌ای از "دفاتر کل سبز" استقبال می‌کند، بین‌کانت به عنوان یک راه‌حل انعطاف‌پذیر، شفاف و قابل حسابرسی آماده است. با یکپارچه‌سازی داده‌های ESG با همان دقت داده‌های مالی، بین‌کانت سازمان‌ها را توانمند می‌سازد تا نه تنها الزامات انطباق را برآورده کنند، بلکه ابتکارات پایداری معنادار را نیز پیش ببرند.

آیا آماده‌اید داده‌های ESG خود را وارد انقلاب متن ساده کنید؟

آیا در تراکنش‌های کریپتو در صرافی‌های متعدد غرق شده‌اید، با پیچیدگی‌های DeFi دست و پنجه نرم می‌کنید، یا از فصل مالیات وحشت دارید؟ شما تنها نیستید. چشم‌انداز ارزهای دیجیتال از خریدهای ساده بیت‌کوین به یک اکوسیستم پیچیده از پروتکل‌های DeFi، پاداش‌های استیکینگ، ییلد فارمینگ، و فعالیت‌های بین‌زنجیره‌ای گسترش یافته است که روش‌های حسابداری سنتی را به چالش می‌کشد.

این واقعیت تلخ است: هر تراکنش کریپتو به طور بالقوه مشمول مالیات است و سازمان امور مالیاتی (IRS) در حال نظارت است. چه یک دارنده معمولی بیت‌کوین باشید و چه یک کاربر حرفه‌ای DeFi که موقعیت‌های خود را در ده‌ها پروتکل مدیریت می‌کنید، نگهداری سوابق مالی دقیق اختیاری نیست – بلکه برای انطباق (با قوانین) و وضوح مالی ضروری است.

مشکل چیست؟ نرم‌افزارهای حسابداری سنتی پشتیبانی بومی محدودی برای پیچیدگی‌های کریپتو دارند. در حالی که ابزارهایی مانند کوییک‌بوکس می‌توانند با افزونه‌های اضافی کریپتو را مدیریت کنند، و اکسل می‌تواند داده‌های بلاک‌چین را با اسکریپت وارد کند، اکثر راه‌حل‌ها برای حسابداری جامع کریپتو نیاز به سفارشی‌سازی قابل توجهی دارند.

راه‌حل چیست؟ سیستم حسابداری متن ساده Beancount.io که بر اساس زبان قدرتمند متن‌باز Beancount ساخته شده است. نکته مهم: Beancount یک زبان حسابداری دوطرفه متن‌باز است که توسط مارتین بلیس ایجاد شده، در حالی که Beancount.io یک سرویس میزبانی تجاری است که یک رابط کاربری دوستانه و زیرساخت ابری برای Beancount فراهم می‌کند. این راهنما هم اصول اساسی Beancount و هم نحوه استفاده موثر از آن‌ها را از طریق پلتفرم Beancount.io پوشش می‌دهد.

کابوس حسابداری رمزارز (و چرا بدتر می‌شود)​

سبد رمزارز شما در همه جا پراکنده است​

بیایید در مورد وضعیت شما صادق باشیم. شما احتمالاً موارد زیر را دارید:

• ۳-۵ صرافی مختلف (کوین‌بیس برای خریدهای آسان، بایننس برای آلت‌کوین‌ها، کراکن برای آن یک توکن خاص...)
• کیف پول‌های متعدد (متامسک برای دیفای، لجر برای نگهداری بلندمدت، آن کیف پول قدیمی که فراموش کرده‌اید...)
• موقعیت‌های دیفای در بیش از ۱۰ پروتکل (یونی‌سواپ، کامپاند، آوه، و هر ییلد فارم جدیدی که توجه شما را جلب کرده است)
• پاداش‌های استیکینگ که از اعتبارسنج‌های مختلف به آرامی وارد می‌شوند
• ایردراپ‌های تصادفی که مانند هدایای کریسمس رمزارزی در کیف پول شما ظاهر می‌شوند

هر پلتفرم زبان متفاوتی دارد. کوین‌بیس به شما یک فایل سی‌اس‌وی می‌دهد که اصلاً شبیه خروجی بایننس نیست. یونی‌سواپ حتی خروجی هم ندارد. و بماند که ردیابی موقعیت‌های دیفای شما در شبکه‌های لایه ۲ چقدر دشوار است.

انواع تراکنش‌هایی که حسابداری سنتی را به چالش می‌کشند​

فعالیت‌های رمزارزی شما شامل انواع تراکنش‌هایی است که سیستم‌های حسابداری سنتی در ابتدا برای مدیریت آن‌ها طراحی نشده بودند:

• زیان ناپایدار ناشی از تأمین نقدینگی (سعی کنید این را به QuickBooks توضیح دهید)
• وام‌های فلش که میلیون‌ها را در یک تراکنش واحد وام می‌گیرند و بازپرداخت می‌کنند
• فارم سود که در آن برای تأمین نقدینگی، ۵ توکن مختلف کسب می‌کنید
• پل‌های بین‌زنجیره‌ای که دارایی‌ها را در یک شبکه ناپدید کرده و در شبکه‌ای دیگر ظاهر می‌کنند
• مشتقات استیکینگ مانند stETH که ارزش را متفاوت از دارایی پایه انباشت می‌کنند
• توکن‌های حاکمیتی DAO که برای استفاده از پروتکل‌ها دریافت کردید

میدان مین رعایت مالیاتی​

این‌ها مواردی هستند که خواب را از چشمان سرمایه‌گذاران رمزارز می‌ربایند:

• هر معامله‌ای مشمول مالیات است (بله، حتی آن مبادله ETH به USDC)
• ردیابی مبنای بهای تمام شده با صدها ریزتراکنش غیرممکن می‌شود
• پاداش‌های استیکینگ درآمد محسوب می‌شوند به محض دریافت آن‌ها (با ارزش منصفانه بازار)
• پاداش‌های دیفای درآمد هستند حتی اگر هنوز نتوانید آن‌ها را بفروشید
• سازمان امور مالیاتی (IRS) فرم 8949 را می‌خواهد که هر تراکنش در آن فهرست شده باشد
• جریمه‌ها سنگین هستند در صورت اشتباه

نرم‌افزار حسابداری سنتی برای این پیچیدگی نیازمند سفارشی‌سازی قابل توجهی است. در حالی که راه‌حل‌هایی وجود دارند، اغلب به افزونه‌ها، اسکریپت‌ها یا فرآیندهای دستی اضافی برای مدیریت دامنه کامل فعالیت‌های رمزارزی نیاز دارند.

ورود به Beancount.io: راهکار حسابداری رمزارز که منتظرش بودید​

اگر به شما بگویم سیستمی حسابداری وجود دارد که دقیقاً برای مدیریت این هرج و مرج طراحی شده است، چه؟ Beancount.io فقط یک ابزار حسابداری دیگر نیست—این یک انقلاب حسابداری متنی ساده است که پیچیدگی رمزارز را طوری مدیریت می‌کند که گویی برای همین کار متولد شده است.

چرا Beancount.io در حسابداری رمزارز پیشتاز است​

🔍 شفافیت کامل: هر محاسبه‌ای قابل مشاهده است. بدون جعبه سیاه، بدون الگوریتم‌های "به ما اعتماد کنید". شما دقیقاً می‌بینید که مبنای هزینه شما چگونه محاسبه می‌شود، سودها چگونه محاسبه می‌شوند و هر ساتوشی به کجا رفته است.

📊 انعطاف‌پذیری نامحدود: هر ساختار حسابی که نیاز دارید ایجاد کنید. موقعیت‌های دیفای (DeFi)، مشتقات استیکینگ، دارایی‌های بین‌زنجیره‌ای، یا آن توکن عجیب و غریبی که از رأی‌گیری DAO به دست آورده‌اید را ردیابی کنید. اگر بتوانید آن را تصور کنید، می‌توانید آن را ردیابی کنید.

🎯 مبنای هزینه دقیق: ردیابی مبتنی بر لات با شناسایی خاص. دقیقاً انتخاب کنید که کدام بیت‌کوین را برای نتایج مالیاتی بهینه می‌فروشید. FIFO، LIFO، یا انتخاب لات‌های دلخواه شما — انتخاب با شماست.

🔗 مقاوم در برابر آینده: فرمت متن ساده به این معنی است که داده‌های شما برای همیشه متعلق به شماست. بدون قفل شدن به فروشنده، بدون فرمت‌های اختصاصی، بدون ایمیل‌های "متاسفیم، ما در حال تعطیلی هستیم".

⚡ قدرت اسکریپت‌پذیری: واردات را خودکار کنید، گزارش‌های سفارشی ایجاد کنید و با هر ابزری یکپارچه شوید. از آنجا که سبد رمزارز شما منحصر به فرد است، حسابداری شما نیز باید همینطور باشد.

راه‌اندازی مرکز فرماندهی رمزارز شما​

ساخت معماری حساب‌های شما​

این را به مثابه طراحی نقشه راه برای امپراتوری رمزارز خود در نظر بگیرید. ما در حال ایجاد ساختاری هستیم که می‌تواند همه چیز را از اولین خرید بیت‌کوین شما گرفته تا استراتژی‌های پیچیده دیفای چند پروتکلی مدیریت کند:

نکته: مثال‌ها از 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

; حساب‌های پروتکل دیفای
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 را در عمل ببینید؟ بیایید سناریوهای واقعی را بررسی کنیم که سیستم‌های حسابداری دیگر را دچار مشکل می‌کنند، اما در اینجا به شکلی ظریف و کارآمد مدیریت می‌شوند.

۱. اولین خرید بیت‌کوین شما (نقطه آغاز)​

هر سفر کریپتو از جایی شروع می‌شود. در اینجا نحوه ثبت آن لحظه تغییردهنده زندگی که اولین بیت‌کوین خود را خریدید، آمده است:

2024-01-15 * "Buy 0.5 BTC on 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 * "فروش 0.3 BTC در 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-02-01 * "ETH Staking Rewards"
  Assets:Staking:Ethereum:ETH      0.05 ETH {2500.00 USD}
  Income:Crypto:Staking:ETH      125.00 USD

4. کشت سود دیفای: جایی که اوضاع هیجان‌انگیز می‌شود 🌶️​

به حسابداری پیشرفته دیفای خوش آمدید. کشت سود دیفای شامل تراکنش‌های پیچیده چند-توکنی است که نیازمند ردیابی پیشرفته هستند. در ادامه نحوه حسابداری صحیح یک موقعیت نقدینگی یونی‌سواپ آمده است:

; 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

۵. انتقال بین صرافی‌ها​

انتقال بیت‌کوین از کوین‌بیس به کیف پول لجر:

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}

سناریوهای پیشرفته ارز دیجیتال​

معاملات مارجین​

ثبت موقعیت‌های اهرمی:

; باز کردن موقعیت لانگ اهرمی (قرض گرفتن بیت‌کوین)
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 * "دریافت ایردراپ UNI"
  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 به‌طور خودکار بهای تمام‌شده را با استفاده از سیستم مبتنی بر لات ردیابی می‌کند:

; Multiple purchases at different prices
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

; Selling specific lots (FIFO, LIFO, or specific identification)
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

۴. ردیابی تمام منابع درآمد​

• پاداش‌های استیکینگ (مشمول مالیات بر درآمد)
• پاداش‌های ماینینگ (مشمول مالیات بر درآمد)
• ایردراپ‌ها (مشمول مالیات بر اساس ارزش بازار منصفانه)
• بازده دیفای (مشمول مالیات بر درآمد)

5. مدیریت کارمزدها​

تمام کارمزدها را به صورت جداگانه برای کسر مالیات صحیح ردیابی کنید:

Expenses:Crypto:Fees:Trading     ; کارمزدهای معاملاتی صرافی
Expenses:Crypto:Fees:Network     ; کارمزدهای شبکه بلاکچین
Expenses:Crypto:Fees:Withdrawal  ; کارمزدهای برداشت

یکپارچه‌سازی با ابزارهای محبوب رمزارز​

یکپارچه‌سازی API صرافی‌ها​

Beancount.io می‌تواند با صرافی‌های اصلی یکپارچه شود:

• Coinbase Pro API: واردات خودکار تراکنش‌ها
• Binance API: به‌روزرسانی لحظه‌ای موجودی
• Kraken API: همگام‌سازی داده‌های تاریخی

تحلیل بلاکچین​

اتصال به کاوشگرهای بلاکچین:

• Etherscan: تأیید تراکنش‌های اتریوم
• Blockchain.info: ردیابی تراکنش‌های بیت‌کوین
• BscScan: نظارت بر بایننس اسمارت چین

ردیابی سبد سرمایه​

همگام‌سازی با ابزارهای مدیریت سبد سرمایه:

• کوین‌ترکر: تولید گزارش مالیاتی
• کوینلی: تجمیع چند صرافی
• بلاک‌فولیو: ردیابی سبد سرمایه موبایلی

سلب مسئولیت‌های مهم​

تذکر مالیاتی و حقوقی: این راهنما اطلاعات عمومی در مورد حسابداری ارزهای دیجیتال با استفاده از بین‌کانت ارائه می‌دهد و به منزله مشاوره مالیاتی، حقوقی یا مالی حرفه‌ای نیست. نحوه برخورد مالیاتی با تراکنش‌های ارز دیجیتال بسته به حوزه قضایی و شرایط فردی متفاوت است. سناریوهای پیچیده مانند پل‌های بین‌زنجیره‌ای، زیان ناپایدار و وام‌های فلش ممکن است تحت مقررات فعلی پیامدهای مالیاتی نامشخصی داشته باشند. برای راهنمایی خاص در مورد اینکه آیا تراکنش‌ها به منزله واگذاری‌های مشمول مالیات هستند، به سوالات متداول IRS Q-15 تا Q-18 (2024) مراجعه کنید یا با مقررات مالیاتی محلی مشورت نمایید. همیشه قبل از اتخاذ تصمیمات مربوط به مالیات، با یک متخصص مالیاتی واجد شرایط یا حسابدار رسمی (CPA) آشنا با مالیات ارزهای دیجیتال در حوزه قضایی خود مشورت نمایید.

توضیح نرم‌افزاری: مثال‌ها در این راهنما از گرامر استاندارد بین‌کانت استفاده می‌کنند. در حالی که Beancount.io یک رابط کاربری دوستانه برای بین‌کانت ارائه می‌دهد، اصول حسابداری زیربنایی برای هر پیاده‌سازی بین‌کانت کاربرد دارند.

نتیجه‌گیری​

حسابداری رمزارزها نیازی نیست پیچیده و طاقت‌فرسا باشد. با سیستم قدرتمند حسابداری متن ساده Beancount که از طریق پلتفرم Beancount.io در دسترس است، می‌توانید:

• شفافیت کامل را حفظ کنید: هر تراکنش قابل مشاهده و حسابرسی است
• از رعایت قوانین مالیاتی اطمینان حاصل کنید: ردیابی صحیح مبنای هزینه و گزارش‌دهی درآمد
• با سبد دارایی خود مقیاس‌پذیری داشته باشید: مدیریت معاملات ساده تا استراتژی‌های پیچیده دیفای
• به‌طور یکپارچه ادغام شوید: اتصال به صرافی‌ها، کیف پول‌ها و ابزارهای مالیاتی
• سوابق خود را برای آینده تضمین کنید: فرمت متن ساده دسترسی طولانی‌مدت را تضمین می‌کند

چه یک دارنده عادی بیت‌کوین باشید و چه یک فعال پیشرفته دیفای در حوزه کسب بازده، Beancount پایه و اساس و انعطاف‌پذیری لازم برای تسلط بر حسابداری رمزارزها را فراهم می‌کند. با تراکنش‌های پایه شروع کنید و به تدریج سناریوهای پیچیده‌تر را با تکامل مسیر رمزارزی خود، در آن بگنجانید.

مثال‌های این راهنما یک پایه و اساس مستحکم را فراهم می‌کنند، اما به یاد داشته باشید که حسابداری رمزارزها یک حوزه در حال تکامل است. از تغییرات نظارتی مطلع بمانید، با متخصصان مالیاتی مشورت کنید و شیوه‌های حسابداری خود را در صورت لزوم تطبیق دهید.

آماده‌اید کنترل امور مالی رمزارزی خود را در دست بگیرید؟ در Beancount.io ثبت‌نام کنید و قدرت حسابداری رمزارز شفاف و قابل برنامه‌ریزی را که بر پایه و اساس مستحکم Beancount بنا شده است، تجربه کنید.

مالیات‌گذاری ارزهای دیجیتال از یک نگرانی جزئی به یک الزام حیاتی برای میلیون‌ها سرمایه‌گذار تبدیل شده است. با افزایش نظارت IRS و الزام به گزارش‌دهی دقیق، نگهداری سوابق دقیق تنها یک رویه خوب نیست، بلکه برای جلوگیری از جریمه‌ها و بهینه‌سازی بدهی مالیاتی شما ضروری است.

این راهنمای جامع به شما نشان می‌دهد که چگونه با استفاده از سیستم قدرتمند حسابداری متن ساده Beancount.io، به رعایت کامل مالیات ارز دیجیتال دست یابید و اطمینان حاصل کنید که تمام الزامات IRS را برآورده کرده و در عین حال کارایی مالیاتی خود را به حداکثر می‌رسانید.

درک الزامات مالیاتی رمزارزها​

نحوه برخورد سازمان امور مالیاتی (IRS) با رمزارزها​

سازمان امور مالیاتی (IRS) رمزارز را به عنوان دارایی تلقی می‌کند، نه ارز، که پیامدهای مالیاتی خاصی را به همراه دارد:

• هر تراکنش به طور بالقوه مشمول مالیات است: معامله، فروش، خرج کردن یا مبادله رمزارز
• مبنای هزینه باید ردیابی شود: برای هر واحد رمزارز تحت مالکیت
• دوره نگهداری نرخ مالیات را تعیین می‌کند: سود سرمایه کوتاه‌مدت در مقابل بلندمدت
• شناسایی درآمد الزامی است: برای استخراج (ماینینگ)، استیکینگ، ایردراپ‌ها و پاداش‌های دیفای
• ثبت سوابق دقیق الزامی است: مستندات در سطح تراکنش برای حسابرسی‌ها

فرم‌های مالیاتی کلیدی برای رمزارز​

فرم 1040 - اظهارنامه مالیات بر درآمد افراد​

• ردیف 1: درآمد رمزارز (استیکینگ، ماینینگ، ایردراپ) را گزارش کنید
• جدول 1: سایر منابع درآمد
• پرسش مربوط به دارایی‌های دیجیتال: در صورت داشتن تراکنش‌های رمزارزی، باید "بله" پاسخ دهید

فرم ۸۹۴۹ - فروش و سایر واگذاری‌های دارایی‌های سرمایه‌ای​

• بخش اول: سود/زیان سرمایه‌ای کوتاه‌مدت (نگهداری شده برای حداکثر ۱ سال)
• بخش دوم: سود/زیان سرمایه‌ای بلندمدت (نگهداری شده برای بیش از ۱ سال)
• گزارش‌دهی تفصیلی تراکنش‌ها: تاریخ تحصیل، تاریخ فروش، عواید، مبنای بهای تمام شده

جدول D - سود و زیان سرمایه ای​

• خلاصه فرم ۸۹۴۹: مجموع سود و زیان سرمایه ای
• سود و زیان سرمایه ای خالص: محاسبه نهایی برای بدهی مالیاتی

تنظیم حسابداری رمزارز مطابق با مقررات مالیاتی​

ساختار حساب برای گزارش‌دهی مالیاتی​

سلسله‌مراتب حساب‌های خود را مطابق با الزامات مالیاتی طراحی کنید:

; دارایی‌ها - سازمان‌دهی شده بر اساس دوره نگهداری و منبع
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. فروش رمزارز​

سود سرمایه کوتاه‌مدت (≤ ۱ سال)​

2024-06-15 * "فروش بیت‌کوین - سود سرمایه کوتاه‌مدت" ^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

سود سرمایه بلندمدت (بیش از ۱ سال)​

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 * "معامله بیت‌کوین برای اتریوم - مبادله مشمول مالیات"
  ; واگذاری بیت‌کوین (رویداد مشمول مالیات)
  Assets:Crypto:Trading:Binance:BTC     -1.0 BTC {46000.00 USD}
  Income:CapitalGains:ShortTerm        2000.00 USD  ; 48000 - 46000

  ; کسب اتریوم (مبنای بهای تمام شده جدید)
  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 - ژانویه"
  reward-type: "استیکینگ"
  fair-market-value: "2500.00 دلار آمریکا به ازای هر ETH"
  taxable-income: "200.00 دلار آمریکا"
  دارایی‌ها:استیکینگ:اتریوم:ETH           0.08 ETH {2500.00 USD}
  درآمد:رمزارز:استیکینگ:عادی       200.00 USD

۴. درآمد استخراج​

2024-01-15 * "پاداش استخراج بیت‌کوین"
  mining-pool: "Slush Pool"
  block-height: "825000"
  fair-market-value: "۴۵۰۰۰.۰۰ دلار آمریکا به ازای هر بیت‌کوین"
  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"
  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. فعالیت‌های دیفای​

پاداش‌های کشت سود​

2024-02-28 * "Compound Protocol Yield"
  protocol: "Compound"
  reward-token: "COMP"
  fair-market-value: "85.00 USD per COMP"
  Assets:Crypto:Wallet:MetaMask:COMP    12 COMP {85.00 USD}
  Income:Crypto:DeFi:Ordinary         1020.00 USD

کارمزدهای استخر نقدینگی​

2024-02-15 * "کارمزدهای LP یونی‌سواپ دریافت شد"
  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:عادی          820.00 USD

استراتژی‌های بهینه‌سازی مالیات​

۱. برداشت زیان مالیاتی​

برای جبران سودها، زیان‌ها را به صورت سیستماتیک شناسایی کنید:

; شناسایی موقعیت‌های زیان‌ده
2024-12-15 * "برداشت زیان مالیاتی - فروش ADA با زیان"
  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  ; زیان محقق شده

۲. ملاحظات فروش شستشو​

اگرچه قوانین فروش شستشو رسماً در مورد رمزارزها اعمال نمی‌شود، از مشکلات احتمالی جلوگیری کنید:

; Wait 31 days before repurchasing
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  ; زیان قابل توجه

۴. برنامه‌ریزی بلندمدت در مقابل کوتاه‌مدت​

فروش‌ها را به صورت استراتژیک زمان‌بندی کنید تا از رفتار مالیاتی مطلوب بهره‌مند شوید:

; نگهداری برای برخورداری از رفتار بلندمدت مالیاتی
2024-12-20 * "بیت‌کوین در حال نزدیک شدن به وضعیت بلندمدت"
  purchase-date: "2024-01-01"
  days-held: "354"
  long-term-date: "2025-01-02"
  note: "۱۱ روز دیگر برای برخورداری از رفتار بلندمدت مالیاتی نگهداری شود"

گزارش‌دهی مالیاتی خودکار​

تولید فرم 8949​

از کوئری‌های Beancount.io برای تولید داده‌های فرم 8949 استفاده کنید:

-- سود و زیان سرمایه‌ای کوتاه‌مدت
SELECT
  date,
  narration,
  -position as quantity_sold,
  cost(position) as cost_basis,
  value(position) as proceeds,
  value(position) + cost(position) as gain_loss
WHERE account ~ "Income:CapitalGains:ShortTerm"
   OR account ~ "Expenses:CapitalLoss:ShortTerm"
ORDER BY date;

خلاصه سود و زیان سرمایه‌ای​

-- Capital gains summary
SELECT
  'Short-term' as type,
  sum(position) as total_gain_loss
WHERE account ~ "Income:CapitalGains:ShortTerm"
   OR account ~ "Expenses:CapitalLoss:ShortTerm"

UNION ALL

SELECT
  'Long-term' 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 Purchase - Complete Documentation" ^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: "Multiple exchange average"

اشتباهات رایج در انطباق مالیاتی​

1. تراکنش‌های از قلم افتاده​

• مشکل: عدم گزارش‌دهی تمامی رویدادهای مشمول مالیات
• راه‌حل: ردیابی جامع تراکنش‌ها در Beancount.io

۲. مبنای بهای تمام شده نادرست​

• مشکل: استفاده از روش محاسبه مبنای بهای تمام شده اشتباه
• راه حل: ردیابی مبتنی بر لات با شناسایی خاص

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
  'خلاصه سود سرمایه' as report_type,
  account,
  sum(position) as amount
WHERE account ~ "Income:CapitalGains"
   OR account ~ "Expenses:CapitalLoss"
GROUP BY account

UNION ALL

SELECT
  'خلاصه درآمد عادی' 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 را مدیریت کنید

مزایای کلیدی برای رعایت مالیات ارزهای دیجیتال:

• محاسبات شفاف: دقیقاً ببینید اعداد مالیاتی چگونه محاسبه می‌شوند
• گزارش‌دهی انعطاف‌پذیر: هر فرمت گزارشی که نیاز دارید را تولید کنید
• یکپارچگی حرفه‌ای: به طور یکپارچه با حسابداران رسمی (CPAs) و نرم‌افزارهای مالیاتی کار کنید
• سوابق آینده‌نگر: فرمت متن ساده دسترسی طولانی‌مدت را تضمین می‌کند

امروز رعایت صحیح مالیات ارزهای دیجیتال را آغاز کنید. سرمایه‌گذاری در نگهداری دقیق سوابق، در طول فصل مالیاتی در زمان، پول و استرس شما صرفه‌جویی می‌کند و در عین حال اطمینان حاصل می‌کند که کاملاً با الزامات IRS مطابقت دارید.

آماده‌اید تا بر رعایت مالیات ارزهای دیجیتال مسلط شوید؟ با Beancount.io شروع کنید و کنترل تعهدات مالیاتی ارزهای دیجیتال خود را در دست بگیرید.

امور مالی غیرمتمرکز (دیفای) نحوه تعامل ما با خدمات مالی را متحول کرده و فرصت‌های بی‌سابقه‌ای برای تولید سود، تامین نقدینگی و معاملات غیرمتمرکز ارائه می‌دهد. با این حال، در کنار این فرصت‌ها، چالش ردیابی دقیق تراکنش‌های پیچیده برای رعایت مالیاتی و مدیریت سبد دارایی نیز وجود دارد.

روش‌های حسابداری سنتی با ویژگی‌های منحصر به فرد دیفای دست و پنجه نرم می‌کنند: بازارسازان خودکار، استخراج نقدینگی، زیان ناپایدار و پاداش‌های چندتوکنی. این راهنمای جامع به شما نشان می‌دهد که چگونه با استفاده از سیستم قدرتمند حسابداری متن-ساده Beancount.io بر حسابداری دیفای مسلط شوید.

درک چالش‌های حسابداری دیفای​

پیچیدگی تراکنش‌های دیفای​

پروتکل‌های دیفای چالش‌های حسابداری ایجاد می‌کنند که در مالی سنتی وجود ندارند:

• تراکنش‌های چند-توکنی: عملیات واحد شامل چندین ارز دیجیتال
• سود مرکب خودکار: پاداش‌هایی که به صورت خودکار بازسرمایه‌گذاری می‌شوند
• زیان ناپایدار: تغییرات ارزش به دلیل واگرایی قیمت در استخرهای نقدینگی
• بهینه‌سازی کارمزد گس: ساختارهای کارمزد پیچیده در شبکه‌های مختلف
• حاکمیت پروتکل: حقوق رأی‌دهی و توزیع توکن‌های حاکمیتی
• تعاملات بین-پروتکلی: تراکنش‌هایی که چندین پلتفرم دیفای را در بر می‌گیرند

پیامدهای مالیاتی فعالیت‌های دیفای​

سازمان امور مالیاتی آمریکا (IRS) فعالیت‌های دیفای را به عنوان رویدادهای مشمول مالیات در نظر می‌گیرد:

• تأمین نقدینگی: ممکن است هنگام واریز دارایی‌ها، رویدادهای مشمول مالیات را ایجاد کند
• پاداش‌های کشت سود (ییلد فارمینگ): در زمان دریافت به عنوان درآمد عادی و با ارزش منصفانه بازار مشمول مالیات هستند
• زیان ناپایدار: پیامدهای مالیاتی بالقوه هنگام برداشت از استخرها
• توکن‌های حاکمیتی: ایردراپ‌ها و پاداش‌ها به عنوان درآمد مشمول مالیات هستند
• پاداش‌های استیکینگ: در زمان دریافت به عنوان درآمد مشمول مالیات هستند

راه‌اندازی حساب‌های دیفای در Beancount.io​

ساختار حساب جامع​

یک سلسله مراتب حساب دقیق ایجاد کنید که تمام فعالیت‌های دیفای را پوشش دهد:

; 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

کالاهای ویژه دیفای​

توکن‌ها و توکن‌های LP را با فراداده مناسب تعریف کنید:

1970-01-01 commodity UNI-V3-ETH-USDC
  name: "توکن LP یونی‌سواپ V3 ETH-USDC"
  asset-class: "liquidity-pool"
  protocol: "uniswap-v3"

1970-01-01 commodity cUSDC
  name: "کامپاند USDC"
  asset-class: "lending-token"
  protocol: "compound"

1970-01-01 commodity stETH
  name: "اتریوم استیک شده لیدو"
  asset-class: "staking-derivative"
  protocol: "lido"

ردیابی فعالیت‌های رایج دیفای​

۱. تأمین نقدینگی یونی‌سواپ​

افزودن نقدینگی به یک استخر​

2024-01-15 * "افزودن نقدینگی به استخر Uniswap V3 جفت ETH-USDC"
  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 * "Claim Uniswap LP fees"
  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  ; محاسبه IL
  Expenses:DeFi:Gas:Ethereum           0.008 ETH {2800.00 USD}
  Assets:Crypto:Wallet:MetaMask:ETH   -0.008 ETH {2800.00 USD}

2. وام‌دهی پروتکل کامپاند​

واریز دارایی‌ها به کامپاند​

2024-01-20 * "واریز USDC به کامپاند"
  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​

واریز و وام‌گیری​

; واریز ETH به عنوان وثیقه
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}

; وام گرفتن USDC در ازای وثیقه ETH
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  ; Interest accrued
  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. استیکینگ اتریوم​

استیکینگ مستقیم اتریوم​

2024-01-10 * "استیک کردن ETH در اتریوم 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

استیکینگ نقدشونده با لیدو​

2024-01-12 * "استیک کردن ETH با لیدو"
  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}

سناریوهای پیشرفته دیفای​

راهبردهای ییلد فارمینگ​

کشت سود چند پروتکلی​

; مرحله ۱: واریز USDC به کامپاند
2024-01-30 * "واریز USDC به کامپاند برای کشت سود"
  Assets:Crypto:Wallet:MetaMask:USDC  -20000 USDC
  Assets:DeFi:Compound:cUSDC            1000 cUSDC {20.00 USD}

; مرحله ۲: قرض گرفتن DAI در ازای cUSDC
2024-01-30 * "قرض گرفتن DAI از کامپاند"
  Assets:Crypto:Wallet:MetaMask:DAI    15000 DAI
  Liabilities:DeFi:Compound:DebtDAI   -15000 DAI

; مرحله ۳: تأمین نقدینگی DAI-USDC برای یونی‌سواپ
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}

عملیات دیفای بین‌زنجیره‌ای​

پل زدن دارایی‌ها​

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 * "فرصت آربیتراژ با وام آنی"
  ; وام آنی
  Assets:Crypto:Temp:FlashLoan       100000 USDC
  Liabilities:DeFi:Aave:FlashLoan   -100000 USDC

  ; معامله آربیتراژ
  Assets:Crypto:Temp:FlashLoan      -100000 USDC
  Assets:Crypto:Temp:Arbitrage       101500 USDC

  ; بازپرداخت وام آنی
  Liabilities:DeFi:Aave:FlashLoan    100000 USDC
  Assets:Crypto:Temp:Arbitrage      -100090 USDC  ; شامل کارمزدها

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

ملاحظات گزارش مالیاتی دیفای​

شناسایی درآمد​

تمام پاداش‌های دی‌فای به عنوان درآمد عادی مشمول مالیات هستند:

; ردیابی تمام منابع درآمد به صورت جداگانه
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           ; کارمزدهای لایه ۲
Expenses:DeFi:Interest:Aave         ; هزینه‌های استقراض
Expenses:DeFi:ImpermanentLoss       ; زیان ناپایدار از موقعیت‌های ارائه‌دهنده نقدینگی

ردیابی سود سرمایه​

برای محاسبه دقیق سود سرمایه، از حسابداری مبتنی بر لات استفاده کنید:

; مبنای بهای تمام‌شده متفاوت برای یک توکن مشابه
Assets:DeFi:Compound:cUSDC   100 cUSDC {20.00 USD}  ; دسته ۱
Assets:DeFi:Compound:cUSDC   100 cUSDC {21.00 USD}  ; دسته ۲

بهترین روش‌ها برای حسابداری دیفای​

1. ثبت بلادرنگ تراکنش‌ها​

• تراکنش‌ها را بلافاصله پس از انجام ثبت کنید
• برای تأیید از هش‌های تراکنش استفاده کنید
• ممپول را برای تراکنش‌های در انتظار پایش کنید

2. ردیابی بهینه‌سازی کارمزد گس​

; ردیابی استراتژی‌های بهینه‌سازی کارمزد گس
Expenses:DeFi:Gas:Ethereum:Standard    ; کارمزد گس استاندارد
Expenses:DeFi:Gas:Ethereum:Fast        ; کارمزد گس سریع
Expenses:DeFi:Gas:Ethereum:Instant     ; کارمزد گس فوری

۳. مدیریت ریسک پروتکل​

; ردیابی ریسک‌های خاص پروتکل
Expenses:DeFi:Risk:SmartContract      ; شکست‌های قرارداد هوشمند
Expenses:DeFi:Risk:Liquidation        ; رویدادهای انحلال
Expenses:DeFi:Risk:Slippage          ; هزینه‌های لغزش

۴. تطبیق خودکار​

• تنظیم فیدهای قیمت خودکار
• استفاده از APIهای پروتکل برای تأیید مانده
• پیاده‌سازی وارد کردن خودکار تراکنش‌ها

5. استانداردهای مستندسازی​

• نگهداری یادداشت‌های مفصل تراکنش
• مستندسازی منطق استراتژی
• نگهداری سوابق تعامل پروتکل

یکپارچه‌سازی با ابزارهای دیفای​

پیگیری سبد سرمایه​

• DeBank: نمای کلی سبد دیفای
• Zapper: داشبورد چند پروتکلی
• Zerion: کیف پول و ردیاب دیفای

گزارشگری مالیاتی​

• Koinly: محاسبات مالیاتی دیفای
• CoinTracker: پشتیبانی چند پروتکلی
• TokenTax: گزارشگری تخصصی دیفای

پلتفرم‌های تحلیلی​

• DeFi Pulse: تحلیل پروتکل‌ها
• DeFiLlama: ردیابی TVL و بازده
• APY.vision: ردیابی زیان ناپایدار

نتیجه‌گیری​

پیچیدگی حسابداری دیفای نباید شما را از مشارکت در انقلاب مالی غیرمتمرکز بازدارد. با سیستم قدرتمند حسابداری متنی ساده Beancount.io، می‌توانید:

• ردیابی تراکنش‌های پیچیده: مدیریت یکپارچه تعاملات چند پروتکلی
• اطمینان از انطباق مالیاتی: شناسایی صحیح درآمد و ردیابی هزینه‌ها
• نظارت بر عملکرد سبد دارایی: بینش‌های بلادرنگ در مورد موقعیت‌های دیفای
• مدیریت ریسک: ردیابی زیان ناپایدار و ریسک‌های پروتکل
• مقیاس‌پذیری عملیات: از استیکینگ ساده تا استراتژی‌های پیچیده ییلد فارمینگ

کلید موفقیت در حسابداری دیفای، ثبات، دقت و دسته‌بندی صحیح است. با پروتکل‌های پایه شروع کنید و به تدریج با آشنایی بیشتر با الگوهای حسابداری، به استراتژی‌های پیچیده‌تر گسترش دهید.

آماده‌اید تا بر حسابداری دیفای مسلط شوید؟ سفر خود را با Beancount.io آغاز کنید و امروز کنترل سبد مالی غیرمتمرکز خود را در دست بگیرید.

نسخه 3 Beancount که در اواسط سال 2024 منتشر شد، نشان‌دهنده یک تکامل معماری قابل توجه برای ابزار محبوب حسابداری متن‌ساده است. در حالی که این نسخه سازگاری با نسخه‌های قبلی را برای فایل‌های دفتر کل کاربران حفظ می‌کند، ساختار زیربنایی و ابزارهای همراه آن دستخوش تغییرات اساسی شده‌اند. در ادامه به تفکیک آنچه در Beancount v3 جدید است، می‌پردازیم.

معماری ماژولارتر و بهینه‌تر​

مهم‌ترین تغییر در Beancount v3، حرکت به سمت یک اکوسیستم ماژولارتر است. چندین قابلیت کلیدی که قبلاً با هسته اصلی همراه بودند، به پروژه‌های مستقل و جداگانه تبدیل شده‌اند. این امر باعث می‌شود هسته Beancount سبک‌تر شده و امکان توسعه متمرکزتر بر روی اجزای جداگانه فراهم شود.

اجزای کلیدی که اکنون بسته‌های جداگانه هستند، عبارتند از:

• beanquery: ابزار قدرتمند جستجوی SQL-مانند برای فایل‌های دفتر کل شما، اکنون در بسته مستقل خود قرار دارد.
• beangulp: این خانه جدید چارچوب وارد کردن داده است که جایگزین ماژول قبلی beancount.ingest شده است.
• beanprice: ابزاری اختصاصی برای دریافت قیمت کالاها و سهام.

این جداسازی به این معنی است که کاربران برای حفظ تمام قابلیت‌هایی که در نسخه 2 به آن‌ها عادت داشتند، باید این بسته‌ها را علاوه بر beancount نصب کنند.

تغییرات در ابزارهای خط فرمان و جریان‌های کاری​

با توجه به معماری ماژولار جدید، تغییرات قابل توجهی در ابزارهای خط فرمان وجود دارد:

• bean-report حذف شده است: این ابزار حذف شده است. اکنون به کاربران توصیه می‌شود برای نیازهای گزارش‌گیری خود از bean-query (از بسته beanquery) استفاده کنند.
• جریان کاری جدید واردکننده: دستورات bean-extract و bean-identify از هسته حذف شده‌اند. رویکرد جدید با beangulp مبتنی بر اسکریپت است. اکنون کاربران باید اسکریپت‌های پایتون خود را برای مدیریت وارد کردن داده‌ها از منابع خارجی مانند صورت‌حساب‌های بانکی ایجاد کنند.

بهبودهای گرامر (سینتکس) و ویژگی‌ها​

در حالی که اصول اصلی حسابداری بدون تغییر باقی مانده‌اند، Beancount v3 انعطاف‌پذیری مطلوبی را در گرامر (سینتکس) خود معرفی می‌کند:

• کدهای ارز انعطاف‌پذیرتر: محدودیت‌های قبلی در مورد طول و کاراکترهای نام ارزها کاهش یافته است. اکنون نمادهای ارز تک‌کاراکتری پشتیبانی می‌شوند.
• پرچم‌های تراکنش گسترش‌یافته: کاربران اکنون می‌توانند از هر حرف بزرگ انگلیسی (A تا Z) به عنوان پرچم برای تراکنش‌ها استفاده کنند که امکان دسته‌بندی دقیق‌تری را فراهم می‌کند.

مهم‌تر اینکه، این تغییرات سازگار با نسخه‌های قبلی هستند، بنابراین فایل‌های دفتر کل 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 یک نسخه بنیادی است که معماری پروژه را بهینه‌سازی می‌کند و آن را در بلندمدت ماژولارتر، آسان‌تر برای نگهداری و گسترش می‌سازد. در حالی که نیاز به برخی تنظیمات در جریان‌های کاری کاربران، به ویژه در مورد وارد کردن داده‌ها دارد، اما زمینه را برای توسعه آینده این ابزار قدرتمند حسابداری فراهم می‌کند.

صاحبان کسب و کارهای کوچک به‌طور متوسط ​​11 ساعت در ماه را صرف طبقه‌بندی دستی هزینه‌ها می‌کنند - تقریباً سه هفته کاری کامل در سال به ورود داده‌ها اختصاص داده می‌شود. یک نظرسنجی QuickBooks در سال 2023 نشان می‌دهد که 68 درصد از صاحبان مشاغل، ردیابی هزینه‌ها را به عنوان ناامیدکننده‌ترین وظیفه دفترداری خود رتبه‌بندی می‌کنند، با این حال تنها 15 درصد از راه‌حل‌های خودکارسازی استفاده کرده‌اند.

حسابداری متن ساده، با پشتیبانی ابزارهایی مانند Beancount، رویکردی جدید برای مدیریت مالی ارائه می‌دهد. با ترکیب معماری شفاف و قابل برنامه‌ریزی با قابلیت‌های مدرن هوش مصنوعی، کسب‌وکارها می‌توانند به طبقه‌بندی هزینه‌ها با دقت بسیار بالا دست یابند و در عین حال کنترل کامل بر داده‌های خود را حفظ کنند.

این راهنما شما را در ساختن یک سیستم خودکارسازی هزینه متناسب با الگوهای منحصربه‌فرد کسب‌وکار خود راهنمایی می‌کند. شما خواهید آموخت که چرا نرم‌افزارهای سنتی ناکارآمد هستند، چگونه از پایه متنی ساده Beancount استفاده کنید، و گام‌های عملی برای پیاده‌سازی مدل‌های یادگیری ماشین تطبیقی.

هزینه‌های پنهان مدیریت دستی هزینه​

طبقه‌بندی دستی هزینه‌ها چیزی فراتر از اتلاف وقت است — بلکه پتانسیل کسب‌وکار را نیز تضعیف می‌کند. هزینه فرصت را در نظر بگیرید: ساعاتی که صرف تطبیق رسیدها با دسته‌ها می‌شود، می‌تواند به جای آن به رشد کسب‌وکار، تقویت روابط با مشتری یا اصلاح پیشنهادات شما کمک کند.

یک نظرسنجی اخیر Accounting Today نشان داد که صاحبان کسب و کارهای کوچک 10 ساعت در هفته را به وظایف حسابداری اختصاص می‌دهند. فراتر از اتلاف وقت، فرآیندهای دستی خطراتی را به همراه دارند. به عنوان مثال، یک آژانس بازاریابی دیجیتال دریافت که طبقه‌بندی دستی آن‌ها هزینه‌های سفر را 20٪ افزایش داده است، که برنامه‌ریزی مالی و تصمیم‌گیری آن‌ها را تحریف می‌کند.

بر اساس گزارش اداره کسب و کارهای کوچک، مدیریت مالی ضعیف همچنان یکی از دلایل اصلی شکست کسب و کارهای کوچک است. هزینه‌های طبقه‌بندی‌شده نادرست می‌توانند مسائل مربوط به سودآوری را پنهان کنند، فرصت‌های صرفه‌جویی در هزینه را نادیده بگیرند و مشکلات فصل مالیات را ایجاد کنند.

معماری Beancount: جایی که سادگی با قدرت روبرو می‌شود​

پایه متن ساده Beancount داده‌های مالی را به کد تبدیل می‌کند و هر تراکنش را قابل ردیابی و آماده برای هوش مصنوعی می‌کند. برخلاف نرم‌افزارهای سنتی که در پایگاه‌های داده اختصاصی به دام افتاده‌اند، رویکرد Beancount امکان کنترل نسخه را از طریق ابزارهایی مانند Git فراهم می‌کند و یک مسیر ممیزی برای هر تغییر ایجاد می‌کند.

این معماری باز امکان ادغام یکپارچه با زبان‌های برنامه‌نویسی و ابزارهای هوش مصنوعی را فراهم می‌کند. یک آژانس بازاریابی دیجیتال گزارش داد که از طریق اسکریپت‌های سفارشی که تراکنش‌ها را بر اساس قوانین تجاری خاص خود به طور خودکار طبقه‌بندی می‌کنند، 12 ساعت در ماه صرفه‌جویی می‌کند.

فرمت متن ساده تضمین می‌کند که داده‌ها قابل دسترسی و قابل انتقال باقی می‌مانند — عدم وابستگی به فروشنده به این معنی است که کسب‌وکارها می‌توانند با پیشرفت فناوری سازگار شوند. این انعطاف‌پذیری، همراه با قابلیت‌های خودکارسازی قوی، پایه‌ای برای مدیریت مالی پیچیده بدون قربانی کردن سادگی ایجاد می‌کند.

ایجاد خط لوله اتوماسیون خود​

ساختن یک سیستم خودکارسازی هزینه با Beancount با سازماندهی داده‌های مالی شما آغاز می‌شود. بیایید یک پیاده‌سازی عملی را با استفاده از مثال‌های واقعی مرور کنیم.

1. تنظیم ساختار Beancount خود​

ابتدا، ساختار حساب و دسته‌های خود را ایجاد کنید:

2025-01-01 open Assets:Business:Checking
2025-01-01 open Expenses:Office:Supplies
2025-01-01 open Expenses:Software:Subscriptions
2025-01-01 open Expenses:Marketing:Advertising
2025-01-01 open Liabilities:CreditCard

2. ایجاد قوانین اتوماسیون​

در اینجا یک اسکریپت پایتون وجود دارد که طبقه‌بندی خودکار را نشان می‌دهد:

import pandas as pd
from datetime import datetime

def categorize_transaction(description, amount):
    rules = {
        'ADOBE': 'Expenses:Software:Subscriptions',
        'OFFICE DEPOT': 'Expenses:Office:Supplies',
        'FACEBOOK ADS': 'Expenses:Marketing:Advertising'
    }

    for vendor, category in rules.items():
        if vendor.lower() in description.lower():
            return category
    return 'Expenses:Uncategorized'

def generate_beancount_entry(row):
    date = row['date'].strftime('%Y-%m-%d')
    desc = row['description']
    amount = abs(float(row['amount']))
    category = categorize_transaction(desc, amount)

    return f'''
{date} * "{desc}"
    {category}                               {amount:.2f} USD
    Liabilities:CreditCard                  -{amount:.2f} USD
'''

3. پردازش تراکنش‌ها​

در اینجا نحوه نمایش ورودی‌های خودکار در فایل Beancount شما آورده شده است:

2025-05-01 * "ADOBE CREATIVE CLOUD"
    Expenses:Software:Subscriptions            52.99 USD
    Liabilities:CreditCard                   -52.99 USD

2025-05-02 * "OFFICE DEPOT #1234 - PRINTER PAPER"
    Expenses:Office:Supplies                  45.67 USD
    Liabilities:CreditCard                   -45.67 USD

2025-05-03 * "FACEBOOK ADS #FB12345"
    Expenses:Marketing:Advertising           250.00 USD
    Liabilities:CreditCard                  -250.00 USD

آزمایش حیاتی است - با زیرمجموعه‌ای از تراکنش‌ها شروع کنید تا صحت طبقه‌بندی را تأیید کنید. اجرای منظم از طریق زمان‌بندهای وظیفه می‌تواند بیش از 10 ساعت در ماه صرفه‌جویی کند و شما را آزاد کند تا روی اولویت‌های استراتژیک تمرکز کنید.

دستیابی به دقت بالا از طریق تکنیک‌های پیشرفته​

بیایید بررسی کنیم که چگونه می‌توان یادگیری ماشین را با تطبیق الگو برای طبقه‌بندی دقیق ترکیب کرد.

تطبیق الگو با عبارات منظم​

import re

patterns = {
    r'(?i)aws.*cloud': 'Expenses:Cloud:AWS',
    r'(?i)(zoom|slack|notion).*subscription': 'Expenses:Software:Subscriptions',
    r'(?i)(uber|lyft|taxi)': 'Expenses:Travel:Transport',
    r'(?i)(marriott|hilton|airbnb)': 'Expenses:Travel:Accommodation'
}

def regex_categorize(description):
    for pattern, category in patterns.items():
        if re.search(pattern, description):
            return category
    return None

یکپارچه‌سازی یادگیری ماشین​

from sklearn.feature_extraction.text import TfidfVectorizer
from sklearn.naive_bayes import MultinomialNB
import re
from typing import List, Tuple

class ExpenseClassifier:
    def __init__(self):
        self.vectorizer = TfidfVectorizer()
        self.classifier = MultinomialNB()

    def parse_beancount_entries(self, beancount_text: str) -> List[Tuple[str, str]]:
        """Parse Beancount entries into (description, category) pairs."""
        entries = []
        for line in beancount_text.split('\n'):
            # Look for transaction descriptions
            if '* "' in line:
                desc = re.search('"(.+)"', line)
                if desc:
                    description = desc.group(1)
                    # Get the next line which should contain the expense category
                    next_line = next(filter(None, beancount_text.split('\n')[beancount_text.split('\n').index(line)+1:]))
                    if 'Expenses:' in next_line:
                        category = next_line.split()[0].strip()
                        entries.append((description, category))
        return entries

    def train(self, beancount_text: str):
        """Train the classifier using Beancount entries."""
        entries = self.parse_beancount_entries(beancount_text)
        if not entries:
            raise ValueError("No valid entries found in training data")

        descriptions, categories = zip(*entries)
        X = self.vectorizer.fit_transform(descriptions)
        self.classifier.fit(X, categories)

    def predict(self, description: str) -> str:
        """Predict category for a new transaction description."""
        X = self.vectorizer.transform([description])
        return self.classifier.predict(X)[0]

# Example usage with training data:
classifier = ExpenseClassifier()

training_data = """
2025-04-01 * "AWS Cloud Services Monthly Bill"
    Expenses:Cloud:AWS                         150.00 USD
    Liabilities:CreditCard                   -150.00 USD

2025-04-02 * "Zoom Monthly Subscription"
    Expenses:Software:Subscriptions            14.99 USD
    Liabilities:CreditCard                    -14.99 USD

2025-04-03 * "AWS EC2 Instances"
    Expenses:Cloud:AWS                         250.00 USD
    Liabilities:CreditCard                    -250.00 USD

2025-04-04 * "Slack Annual Plan"
    Expenses:Software:Subscriptions           120.00 USD
    Liabilities:CreditCard                   -120.00 USD
"""

# Train the classifier
classifier.train(training_data)

# Test predictions
test_descriptions = [
    "AWS Lambda Services",
    "Zoom Webinar Add-on",
    "Microsoft Teams Subscription"
]

for desc in test_descriptions:
    predicted_category = classifier.predict(desc)
    print(f"Description: {desc}")
    print(f"Predicted Category: {predicted_category}\n")