Seyyed_arc/docs/help-content/777-person-ledger.html

<p>هر معامله با یک شخص — فاکتور، دریافت، پرداخت — روی <strong>مانده حساب</strong> او اثر می‌گذارد. این درس همهٔ راه‌های مشاهده تراز، گردش، بدهکاران و بستانکاران را در حسابیکس آرک پوشش می‌دهد.</p>

<h2>مفاهیم پایه — قبل از گزارش‌گیری</h2>
<table>
<thead><tr><th>مفهوم</th><th>در لیست اشخاص</th><th>معنی عملی</th></tr></thead>
<tbody>
<tr><td><strong>تراز / مانده</strong></td><td>ستون عددی — قدر مطلق؛ سبز بستانکار، قرمز بدهکار</td><td>مانده خالص به ارز پایه (معادل). علامت منفی نشان داده نمی‌شود؛ وضعیت را از برچسب ببینید.</td></tr>
<tr><td><strong>وضعیت: بدهکار</strong></td><td>برچسب</td><td>طرف‌حساب به شما بدهکار است (مثلاً مشتری پس از فاکتور فروش نسیه)</td></tr>
<tr><td><strong>وضعیت: بستانکار</strong></td><td>برچسب</td><td>شما به طرف‌حساب بدهکارید (مثلاً تأمین‌کننده پس از فاکتور خرید نسیه)</td></tr>
<tr><td><strong>تسویه</strong></td><td>—</td><td>مانده صفر (قبلاً «بالانس»)</td></tr>
<tr><td><strong>بدون تراکنش</strong></td><td>—</td><td>هنوز سندی ثبت نشده</td></tr>
</tbody>
</table>
<p>در فاکتور فروش، کنار نام مشتری <strong>مانده مالی</strong> نمایش داده می‌شود.</p>
<p>چندارزی: روی تراز tooltip ارزهای فعال؛ در جزئیات شخص کارت <strong>مانده به تفکیک ارز</strong>.</p>

<h2>مسیر ۱ — سریع از لیست اشخاص</h2>
<ol>
<li><strong>اشخاص</strong> ← ستون <strong>تراز</strong> را ببینید</li>
<li>کلیک روی سطر → دیالوگ <strong>جزئیات شخص</strong></li>
<li>تب <strong>اطلاعات شخص</strong> ← کارت مالی: جمع بدهکار، جمع بستانکار، مانده و وضعیت (سال مالی انتخاب‌شده، مبالغ به ارز پایه)</li>
<li>تب <strong>کارت حساب</strong> ← جدول ریز گردش</li>
</ol>

<h2>تب کارت حساب (در جزئیات شخص)</h2>
<p>عنوان: <strong>معین جامع طرف‌حساب (ریز خرید/فروش + دریافت/پرداخت)</strong></p>
<ul>
<li>چیپ سال مالی انتخاب‌شده در برنامه</li>
<li>مانده نهایی همان سال بالای جدول (نیازی به رفتن به آخرین صفحه نیست)</li>
<li>جست‌وجو در: کد سند، نوع سند، شرح، نام کالا</li>
</ul>

<h3>ستون‌های جدول</h3>
<table>
<thead><tr><th>ستون</th><th>محتوا</th></tr></thead>
<tbody>
<tr><td><strong>تاریخ سند</strong></td><td>تاریخ ثبت</td></tr>
<tr><td><strong>کد سند</strong></td><td>شماره فاکتور / دریافت / …</td></tr>
<tr><td><strong>نوع سند</strong></td><td>فروش، خرید، دریافت، پرداخت، …</td></tr>
<tr><td><strong>کالا/خدمت</strong></td><td>در ریز فاکتور</td></tr>
<tr><td><strong>تعداد</strong> / <strong>فی</strong></td><td>اقلام فاکتور؛ فی به ارز همان سند است</td></tr>
<tr><td><strong>توضیحات</strong></td><td>شرح سطر</td></tr>
<tr><td><strong>بدهکار</strong> / <strong>بستانکار</strong></td><td>مبلغ سطر به ارز پایه؛ اگر سند ارزی باشد اصل مبلغ در پرانتز</td></tr>
<tr><td><strong>تراز متحرک</strong></td><td>مانده تجمعی از ابتدای سال، قدر مطلق با برچسب بدهکار/بستانکار</td></tr>
<tr><td>عملیات</td><td><strong>مشاهده سند</strong></td></tr>
</tbody>
</table>

<h2>مسیر ۲ — کاردکس از لیست</h2>
<p>عملیات سطر → <strong>کاردکس</strong></p>
<p>مسیر: <code>/business/{id}/reports/kardex?person_ids={personId}</code></p>
<p>کاردکس عمومی‌تر است — فیلتر محصول، بانک، صندوق، انبار، چک و… علاوه بر شخص.</p>

<h2>مسیر ۳ — گزارش «معین اشخاص» (کامل‌ترین)</h2>
<p><strong>گزارش‌ها</strong> ← بخش <strong>گزارشات اشخاص</strong> ← <strong>معین اشخاص (خرید/فروش + دریافت/پرداخت)</strong></p>
<p>زیرعنوان: «ریز اقلام فاکتور همراه دریافت و پرداخت برای هر طرف‌حساب»</p>
<p>آدرس: <code>/business/{id}/reports/people-transactions</code></p>
<p>دسترسی: <code>people_transactions</code></p>

<h3>فیلترهای گزارش</h3>
<table>
<thead><tr><th>فیلتر</th><th>کاربرد</th></tr></thead>
<tbody>
<tr><td><strong>سال مالی</strong></td><td>محدود به سال</td></tr>
<tr><td><strong>از تاریخ</strong> / <strong>تا تاریخ</strong></td><td>بازه زمانی</td></tr>
<tr><td><strong>واحد پول</strong></td><td>ارز گزارش</td></tr>
<tr><td><strong>شخص</strong></td><td>یک طرف‌حساب یا همه (hint: همه اشخاص)</td></tr>
<tr><td><strong>نوع سند</strong></td><td>فروش، خرید، دریافت، پرداخت، …</td></tr>
<tr><td><strong>سطح جزئیات</strong></td><td><strong>معین جامع (ریز اقلام)</strong> / <strong>خلاصه (مبلغ کل سند)</strong></td></tr>
</tbody>
</table>

<h3>خروجی</h3>
<ul>
<li><strong>Excel</strong></li>
<li><strong>PDF</strong></li>
</ul>
<p>پاورقی: <strong>جمع بدهکار</strong>، <strong>جمع بستانکار</strong></p>
<p>اگر شخص انتخاب نشده: ستون اضافه <strong>نام شخص</strong></p>

<h2>مسیر ۴ — گزارش بدهکاران و بستانکاران</h2>
<p><strong>گزارش‌ها</strong> ← گزارشات اشخاص:</p>

<h3>بدهکاران</h3>
<ul>
<li>لیست اشخاص با مانده بدهکار</li>
<li>فیلتر: تاریخ، سال مالی، ارز، حداقل مانده</li>
<li>ستون‌ها: کد، نام، تراز، جمع بدهکار/بستانکار، تاریخ آخرین تراکنش، وضعیت</li>
<li>خروجی Excel/PDF</li>
</ul>

<h3>بستانکاران</h3>
<p>مشابه — اشخاصی که شما به آن‌ها بدهکارید (یا مانده بستانکار دارند).</p>

<h2>مانده افتتاحیه و تراز</h2>
<p>مانده اول دوره از تب <strong>مانده افتتاحیه</strong> در فرم شخص (یا تراز افتتاحیه حسابداری) در <strong>سند تراز افتتاحیه</strong> ثبت می‌شود — نه مستقیم روی کارت شخص.</p>
<p>پیام‌های محدودیت:</p>
<ul>
<li>«سند تراز افتتاحیه نهایی شده؛ مانده اولیه از این فرم قابل ثبت نیست»</li>
<li>«اسناد دیگری در این سال مالی ثبت شده…»</li>
<li>«برای ثبت مانده افتتاحیه به دسترسی ویرایش تراز افتتاحیه نیاز است»</li>
</ul>

<h2>اعتبار و مانده (ارتباط)</h2>
<p><strong>تنظیمات</strong> ← <strong>اعتبار کاربران</strong> (<code>settings/credit</code>):</p>
<table>
<thead><tr><th>تنظیم</th><th>برچسب</th></tr></thead>
<tbody>
<tr><td>فعال‌سازی اعتبار</td><td>سویچ اعتبار</td></tr>
<tr><td>سقف پیش‌فرض</td><td>مبلغ نسیه مجاز</td></tr>
<tr><td>مهلت</td><td>روزهای مهلت</td></tr>
<tr><td>جریمه تأخیر</td><td>درصد</td></tr>
<tr><td>مسدودیت خودکار</td><td>بعد از N روز</td></tr>
<tr><td>استراتژی</td><td>سقف یکنواخت / بر اساس گروه / اختصاصی هر کاربر</td></tr>
</tbody>
</table>
<p>هنگام فاکتور فروش: اگر مانده + فاکتور از سقف عبور کند، ممکن است ذخیره متوقف شود (مگر «نادیده گرفتن اعتبار» در فاکتور).</p>

<h2>مثال عملی — پیگیری بدهی مشتری</h2>
<ol>
<li>فاکتور فروش ۱۰ میلیون به «شرکت آلفا» — بدون دریافت (نسیه)</li>
<li>لیست اشخاص: مانده شرکت آلفا = ۱۰ میلیون، وضعیت <strong>بدهکار</strong></li>
<li>جزئیات ← کارت حساب: یک سطر فروش در ستون بدهکار، تراز متحرک ۱۰ میلیون بدهکار</li>
<li>دریافت ۵ میلیون از صندوق با تخصیص به همان مشتری</li>
<li>کارت حساب: سطر دریافت در ستون بستانکار، تراز متحرک ۵ میلیون بدهکار</li>
<li>گزارش بدهکاران: شرکت آلفا با مانده ۵ میلیون</li>
</ol>

<h2>اشتراک مانده با مشتری (خارج از پنل)</h2>
<p>جزئیات شخص ← تب <strong>اشتراک‌گذاری</strong>:</p>
<ul>
<li>لینک عمومی با کارت حساب و/یا لیست فاکتور</li>
<li>ارسال پیامک لینک</li>
<li>مشتری بدون ورود به آرک مانده را می‌بیند</li>
</ul>

<h2>ویجت‌های داشبورد مرتبط</h2>
<ul>
<li><strong>خلاصه بدهکاران</strong></li>
<li><strong>خلاصه بستانکاران</strong></li>
<li><strong>بهترین مشتریان</strong> / <strong>بهترین تأمین‌کنندگان</strong></li>
</ul>

<h2>عیب‌یابی</h2>
<table>
<thead><tr><th>علامت</th><th>علت محتمل</th><th>راه‌حل</th></tr></thead>
<tbody>
<tr><td>تراز صفر ولی فاکتور دارم</td><td>پیش‌نویس یا سال مالی دیگر</td><td>فاکتور قطعی؟ سال مالی درست؟</td></tr>
<tr><td>کارت حساب خالی</td><td>سال مالی بدون سند</td><td>سال مالی را عوض کنید</td></tr>
<tr><td>معین اشخاص خطای دسترسی</td><td>بدون people_transactions</td><td>دسترسی گزارش</td></tr>
<tr><td>دو مانده متفاوت</td><td>سال مالی یا ارز متفاوت</td><td>سال مالی هدر برنامه را چک کنید؛ کارت چندارزی مانده بومی هر ارز را جدا نشان می‌دهد</td></tr>
<tr><td>دریافت در کارت نیست</td><td>دریافت بدون شخص</td><td>دریافت را با انتخاب مشتری ثبت کنید</td></tr>
</tbody>
</table>

<h2>چک‌لیست گزارش ماهانه اشخاص</h2>
<ul>
<li>گزارش بدهکاران با حداقل مانده</li>
<li>معین اشخاص برای مشتریان پرحجم</li>
<li>مقایسه با صورتحساب بانکی دریافت‌ها</li>
<li>پیگیری تلفنی مشتریان معوق (از ستون تاریخ آخرین تراکنش)</li>
</ul>

<h2>گام بعدی</h2>
<ul>
<li>ثبت فاکتور ← فصل <strong>فروش و فاکتور</strong></li>
<li>ثبت دریافت ← <strong>دریافت و پرداخت</strong> (فصل بانکداری)</li>
</ul>