نقشهای جریان نقدی

فراداده cash-flow-role را به دایرکتیو open یک حساب اضافه کنید تا نحوه طبقهبندی آن حساب در گزارش جریان نقدی مشخص شود. یک کلید، چهار مقدار. حسابهای بدون این فراداده، از قوانین پیشفرض پیروی میکنند.

2000-01-01 open Assets:US:Brokerage
  cash-flow-role: "investing"
 
2000-01-01 open Assets:US:Marcus:Savings
  cash-flow-role: "cash"

کلید و مقادیر​

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

عملکرد هر مقدار​

یک نقش اعلامشده همزمان به دو سؤال پاسخ میدهد: آیا حساب بخشی از موجودی نقدی است و در غیر این صورت به کدام بخش فعالیت تعلق دارد.

• "cash" — حساب به مجموعه وجه نقد و معادلها میپیوندد. حسابهای نقدی هرگز بهعنوان اقلام خطی فعالیت ظاهر نمیشوند. خط پایانی صورت، تغییر خالص در وجه نقد و معادلها، برابر با مجموع تغییرات دوره آنهاست. انتقال بین دو حساب نقدی یکدیگر را خنثی میکنند. برای حسابهایی که قانون نامگذاری آنها را از دست میدهد، مانند صندوق بازار پول یا کیف پول استیبلکوین، از این مقدار استفاده کنید.
• "operating"، "investing"، "financing" — حساب نقدی نیست و تغییر دوره آن بهعنوان یک خط زیر آن بخش فعالیت ظاهر میشود. اعلام یکی از این مقادیر برای حسابی که قانون نامگذاری آن را نقدی میشمارد، مانند Assets:US:Bank:CD، هم آن را از مجموعه نقدی حذف میکند و هم در بخش اعلامشده بایگانی میکند.

اعلامها بر قراردادهای حسابداری ارجحیت دارند. یک حساب Equity که بهصورت "operating" اعلام شده باشد، بهطور کامل رعایت میشود.

اولویت​

بالاترین اولویت برنده است:

1. فراداده cash-flow-role در دایرکتیو open حساب.
2. قوانین پیشفرض داخلی زیر.

طبقهبندیهای پیشفرض​

حسابی بدون نقش اعلامشده بر اساس ریشه آن طبقهبندی میشود و بررسی نام، عضویت نقدی را تعیین میکند:

حسابهای دارایی که نام آنها شامل Cash، Checking، Savings یا Bank است، بهطور پیشفرض بهعنوان وجه نقد و معادلها در نظر گرفته میشوند. یک نقش اعلامشده در هر دو جهت، بررسی نام را لغو میکند.

مقادیر نامعتبر​

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

تغییر طبقهبندی​

طبقهبندیها از نظر تاریخی مؤثر نیستند. صورت مالی برای هر دوره از اعلامهای موجود در حال حاضر استفاده میکند. برای تغییر، دایرکتیو open را ویرایش کنید؛ کنترل نسخه دفتر کل ثبت میکند چه چیزی و چه زمانی تغییر کرده است.

محل اعمال اعلامها​

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

• گزارش جریان نقدی: بخشهای فعالیت، مجموعه وجه نقد و معادلها و تطبیق خط پایانی.
• خروجیهای CSV، Markdown و چاپ: همان اعداد. افشای «طبقهبندی استنباطشده» فقط برای ردیفهایی ظاهر میشود که همچنان توسط قانون پیشفرض حل شدهاند.
• نمودار جریان نقدی نمای کلی: "cash" حساب را از گرههای جریان حذف میکند و نقشهای فعالیت اعلامشده برای حسابهای غیر-Income رعایت میشوند. Income سمت منبع باقی میماند و Equity از نمودار حذف میشود؛ اعلامها هرگز این دو را بازنویسی نمیکنند.
• پنل وضعیت حساب: یک حساب اعلامشده دیگر بهعنوان دارایی طبقهبندینشده ظاهر نمیشود.

قابلیت انتقال​

فراداده در دایرکتیوهای open بخش اصلی نحو Beancount است. bean-check، Fava و همه ابزارهای v2/v3 آن را تجزیه کرده و کلید ناشناخته را نادیده میگیرند، بنابراین دفتر کل در خارج از Beancount.io بهطور کامل قابل استفاده باقی میماند. برای قالب کلی فراداده، به نحو Beancount مراجعه کنید.