# ایجاد و پیگیری فاکتورها با Beancount

_یک الگوی متن ساده، یک گردش کار تکرارپذیر، و یک پرس و جوی واحد برای «چه کسی هنوز به من بدهکار است؟»_

---

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

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

---

## حداقل فاکتور قابل قبول (فیلدهایی که هرگز نباید از آنها صرف نظر کنید)

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

- **جزئیات فروشنده:** نام و آدرس فیزیکی کسب و کار شما.
- **جزئیات مشتری:** نام مشتری شما و (در صورت امکان) آدرس آنها.
- **شماره فاکتور:** یک شناسه منحصر به فرد و متوالی که هرگز دوباره استفاده نمی‌شود. `INV-045` بعد از `INV-044` می‌آید.
- **تاریخ صدور و سررسید:** به وضوح بیان کنید که فاکتور چه زمانی صادر شده و چه زمانی انتظار پرداخت می‌رود.
- **اقلام فاکتور:** شرح واضحی از خدمات یا محصولات، همراه با کمیت، نرخ و جمع کل هر ردیف.
- **جمع جزئی، مالیات و جمع کل:** محاسبات را نشان دهید تا مشتری بتواند به راحتی آن را دنبال کند.
- **یادداشت‌های اختیاری:** مکانی برای تشکر، دستورالعمل‌های واریز یا شماره سفارش خرید ارائه شده توسط مشتری.

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

**Note:** Invoice templates are coming soon! In the meantime, you can create your own using the fields listed above in Google Docs, Word, Sheets, Excel, or any other document format.

---

## ثبت فاکتور در دفتر کل شما

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

**1. هنگام صدور فاکتور:**

شما تراکنشی ایجاد می‌کنید که کل مبلغ را از حساب `Income` شما به `Assets:AccountsReceivable` منتقل می‌کند. این یک IOU دیجیتال در دفاتر شما ایجاد می‌کند.

```beancount
; 1404-05-01 فاکتور #045  طراحی وب برای شرکت Acme
2025-07-21 * "شرکت Acme" "INV-045 طراحی وب"
  Assets:AccountsReceivable          3500.00 USD  ; due:2025-08-04
  Income:Design:Web
  invoice_id: "INV-045"
  contact_email: "ap@acme.example"
  link: "docs/invoices/2025-07-21_Acme_INV-045.pdf"
```

در اینجا، شما `AccountsReceivable` را بدهکار و حساب `Income` خود را بستانکار می‌کنید. به ابرداده‌های غنی توجه کنید: تاریخ سررسید، `invoice_id` منحصر به فرد و حتی یک `link:` مستقیم به PDF که ارسال کرده‌اید.

**2. هنگام پرداخت مشتری:**

وقتی پول به حساب بانکی شما واریز می‌شود، تراکنش دومی را برای "بستن" IOU ثبت می‌کنید. این موجودی را از `AccountsReceivable` به حساب جاری شما منتقل می‌کند.

```beancount
2025-08-01 * "شرکت Acme" "پرداخت INV-045"
  Assets:Bank:Checking               3500.00 USD
  Assets:AccountsReceivable
  invoice_id: "INV-045"
```

موجودی `INV-045` در `Assets:AccountsReceivable` اکنون صفر است و دفاتر شما کاملاً متعادل هستند.

> **پیوست کردن PDF:** کلید ابرداده `link:` به ویژه هنگام استفاده با Fava، رابط وب Beancount، قدرتمند است. Fava یک لینک قابل کلیک را مستقیماً در نمای تراکنش ارائه می‌دهد، بنابراین سند منبع هرگز بیش از یک کلیک فاصله ندارد. این گردش کار در اوایل سال 2016 در یک درخواست ویژگی ([GitHub](https://github.com/beancount/fava/issues/386)) پیش‌بینی شده بود.

---

## یک پرس و جو برای فهرست کردن همه فاکتورهای باز

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

موارد زیر را به عنوان فایلی با نام `open-invoices.sql` ذخیره کنید:

```sql
SELECT
  meta('invoice_id') AS id,
  payee,
  narration,
  date,
  number(balance) AS outstanding
WHERE
  account = "Assets:AccountsReceivable"
  AND balance != 0
ORDER BY
  date;
```

حالا، آن را از خط فرمان خود اجرا کنید:

```bash
bean-query books.beancount open-invoices.sql
```

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

---

## خودکارسازی کارهای تکراری

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

- **قالب + Pandoc = PDF:** الگوی فاکتور خود را در Markdown نگه دارید. یک اسکریپت کوچک پایتون می‌تواند متغیرها (نام مشتری، اقلام فاکتور، شماره فاکتور) را پر کند و ابزار خط فرمان [Pandoc](https://pandoc.org/) می‌تواند فوراً آن را به یک PDF حرفه‌ای تبدیل کند.
- **قلاب Git Pre-commit:** اگر دفتر کل خود را در Git ذخیره می‌کنید، یک قلاب pre-commit ساده می‌تواند قبل از ذخیره کار شما، بررسی‌هایی را انجام دهد. می‌تواند تأیید کند که هر `invoice_id` جدید منحصر به فرد است، که ارسال‌های تراکنش به صفر می‌رسد و فایلی که در ابرداده `link:` به آن ارجاع داده شده است واقعاً وجود دارد.
- **Cron Job:** یک کار زمان‌بندی شده (cron job) تنظیم کنید تا پرس و جوی `open-invoices.sql` شما هر شب اجرا شود و خلاصه را برای شما ایمیل کند. شما هر روز را با دانستن دقیق اینکه چه کسی به یک یادآوری دوستانه نیاز دارد، شروع خواهید کرد.

---

## یک هشدار واقع‌بینانه

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

برای اکثر فریلنسرها و فروشگاه‌های کوچک، این مرحله دستی قیمت کمی برای یک سیستم حسابداری ضدگلوله، قابل حسابرسی و رایگان است که شما کاملاً مالک و کنترل آن هستید ([beancount.io](https://beancount.io/blog/2025/04/15/beancount-ecosystem)).

---

## مراحل بعدی

آماده‌اید تا کنترل صدور فاکتور خود را به دست بگیرید؟ در اینجا نحوه شروع آمده است.

1. **یک الگو دانلود کنید** و از آن برای ایجاد فاکتور واقعی بعدی خود استفاده کنید و مطمئن شوید که از یک شماره فاکتور متوالی استفاده می‌کنید.
2. **فایل‌های PDF ارسال شده خود را** در یک پوشه اختصاصی مانند `docs/invoices/` ذخیره کنید و از کلید ابرداده `link:` در تراکنش Beancount خود برای ارجاع به آنها استفاده کنید.
3. **پرس و جوی `open-invoices.sql` را ذخیره کنید** و اجرای آن را بخشی از بررسی مالی هفتگی خود قرار دهید.

حسابداری متن ساده به معنای کنار گذاشتن دقت یا کنترل نیست - فقط به این معنی است که پایگاه داده قابل `grep` است. با یک الگوی ساده و قطعه کدهای بالا، _سریعتر_ پول دریافت می‌کنید _و_ دفاتر خود را بی‌عیب و نقص نگه می‌دارید.
