Seyyed_arc/docs/help-content/805-receipts-payments.html

<p>سند <strong>دریافت و پرداخت</strong> جایی است که پول واقعی جابه‌جا می‌شود: مشتری بدهی خود را می‌پردازد، شما به تأمین‌کننده پول می‌دهید، یا چک/بانک/صندوق را با مانده اشخاص تسویه می‌کنید. برخلاف فاکتور که «بدهی/طلب» را ثبت می‌کند، این سند <strong>جریان نقد</strong> را ثبت می‌کند.</p>

<h2>این درس برای چه کسی است؟</h2>
<ul>
<li>کسی که فاکتور فروش زده و حالا می‌خواهد <strong>دریافت نقدی/بانکی</strong> ثبت کند</li>
<li>حسابدار که باید پرداخت به تأمین‌کننده یا تسویه چند مشتری را یکجا بنویسد</li>
<li>کسی که می‌خواهد دریافت را به <strong>فاکتور مشخص</strong> لینک کند یا <strong>قسط</strong> بگیرد</li>
</ul>

<h2>مسیر منو</h2>
<ol>
<li><strong>حسابداری</strong> ← <strong>دریافت و پرداخت</strong> — <code>/business/{id}/receipts-payments</code></li>
<li>افزودن: دکمه <strong>افزودن</strong> در لیست یا آیکون <strong>+</strong> کنار همان آیتم منو</li>
</ol>
<p>دسترسی لازم: <code>people_transactions</code> (مشاهده/افزودن/ویرایش/حذف)</p>

<h2>پیش‌نیازها</h2>
<ul>
<li>حداقل یک <strong>شخص</strong> (مشتری برای دریافت، تأمین‌کننده برای پرداخت)</li>
<li>حداقل یک <strong>حساب</strong>: بانک، صندوق، تنخواه — یا چک ثبت‌شده</li>
<li>برای لینک فاکتور: فاکتور <strong>قطعی</strong> همان شخص با مانده باز</li>
<li>برای اقساط: فاکتور <strong>اقساطی</strong> با طرح اقساط تعریف‌شده</li>
</ul>

<blockquote><strong>تفاوت با تب «تراکنش‌ها» در فاکتور:</strong> در فاکتور می‌توانید همان لحظه دریافت ثبت کنید؛ سند دریافت و پرداخت برای تسویه‌های جداگانه، چندطرفه، یا بعد از فاکتور مناسب‌تر است.</blockquote>

<h2>صفحه لیست</h2>
<p>ستون‌های اصلی: <strong>کد سند</strong>، <strong>نوع</strong> (دریافت/پرداخت)، <strong>تاریخ سند</strong>، <strong>مبلغ کل</strong>، <strong>اشخاص</strong>، <strong>حساب‌ها</strong>، <strong>ایجادکننده</strong>.</p>
<p>فیلترها: نوع سند، بازه تاریخ، سال مالی، پروژه، شخص. خروجی Excel/PDF و حذف گروهی سطرهای انتخاب‌شده.</p>
<p>کلیک روی سطر → مشاهده جزئیات؛ دوبار کلیک → ویرایش.</p>

<h2>فرم ثبت — نمای کلی</h2>
<p>دیالوگ تمام‌صفحه با دو پنل اصلی و فوتر جمع:</p>
<ul>
<li><strong>سمت اشخاص</strong> — چه کسی پول داده/گرفته و چقدر</li>
<li><strong>سمت حساب‌ها</strong> — پول از کجا آمده یا به کجا رفته (بانک، صندوق، چک، …)</li>
<li>در موبایل: دو تب <strong>اشخاص</strong> | <strong>حساب‌ها</strong></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></td><td>شرح کلی سند</td></tr>
</tbody>
</table>

<h2>پنل اشخاص — ردیف به ردیف</h2>
<p>برای هر شخص یک ردیف اضافه کنید:</p>
<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>
</tbody>
</table>

<h3>سویچ «لینک به فاکتور»</h3>
<p>وقتی روشن باشد، این دریافت/پرداخت به یک فاکتور مشخص وصل می‌شود:</p>
<ul>
<li><strong>دریافت</strong> → فاکتورهای <strong>فروش</strong> و <strong>برگشت از خرید</strong> همان مشتری</li>
<li><strong>پرداخت</strong> → فاکتورهای <strong>خرید</strong> و <strong>برگشت از فروش</strong> همان تأمین‌کننده</li>
</ul>
<p>پس از انتخاب شخص، لیست فاکتورهای باز بارگذاری می‌شود؛ فاکتور را انتخاب کنید.</p>
<blockquote><strong>مهم:</strong> سویچ <strong>لینک به فاکتور</strong> با سویچ <strong>اقساط</strong> هم‌زمان فعال نمی‌شود — یکی را انتخاب کنید.</blockquote>

<h3>سویچ «اقساط»</h3>
<p>برای دریافت قسط از فاکتور اقساطی:</p>
<ol>
<li>شخص را انتخاب کنید</li>
<li>سویچ اقساط را روشن کنید</li>
<li>فاکتور اقساطی را از دیالوگ انتخاب کنید (جستجو، مانده، وضعیت اقساط)</li>
<li>مبلغ را بین اقساط تخصیص دهید — جمع تخصیص ≤ مبلغ ردیف شخص</li>
</ol>
<p>اگر طرح اقساط برای فاکتور ثبت نشده باشد: «برای این فاکتور طرح اقساط ثبت نشده است»</p>

<h2>پنل حساب‌ها — انواع تراکنش</h2>
<p>همان ویجت تراکنش فاکتور؛ هر ردیف یک منبع/مقصد پول:</p>
<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></td><td>تسویه مستقیم بین دو شخص (حالت خاص)</td></tr>
<tr><td><strong>حساب</strong></td><td>حساب دفتر کل</td></tr>
</tbody>
</table>
<p>هر ردیف: تاریخ، مبلغ، توضیحات، و فیلدهای وابسته به نوع (مثلاً انتخاب بانک یا چک).</p>

<h2>قانون طلایی — اختلاف باید صفر باشد</h2>
<p>در فوتر سه عدد می‌بینید:</p>
<ul>
<li><strong>جمع اشخاص</strong></li>
<li><strong>جمع حساب‌ها</strong></li>
<li><strong>اختلاف</strong> — باید <strong>۰</strong> باشد تا دکمه ذخیره فعال شود</li>
</ul>
<p>اگر اختلاف ≠ ۰، دکمه‌های کمکی:</p>
<ul>
<li><strong>مطابق اشخاص</strong> — مبلغ آخرین ردیف حساب را طوری تنظیم می‌کند که جمع حساب‌ها = جمع اشخاص</li>
<li><strong>مطابق حساب‌ها</strong> — برعکس، جمع اشخاص را با حساب‌ها هم‌تراز می‌کند</li>
</ul>
<p>حداقل یک ردیف در هر دو طرف لازم است.</p>

<h2>مثال عملی ۱ — دریافت نقدی از مشتری</h2>
<ol>
<li>فاکتور فروش ۵٬۰۰۰٬۰۰۰ به مشتری «علی رضایی» — مانده باز</li>
<li><strong>دریافت و پرداخت</strong> ← افزودن ← نوع: <strong>دریافت</strong></li>
<li>اشخاص: علی رضایی — ۵٬۰۰۰٬۰۰۰ — سویچ <strong>لینک به فاکتور</strong> روشن — فاکتور را انتخاب کنید</li>
<li>حساب‌ها: نوع <strong>صندوق</strong> — صندوق فروشگاه — ۵٬۰۰۰٬۰۰۰</li>
<li>اختلاف = ۰ → <strong>ذخیره</strong></li>
</ol>
<p><strong>نتیجه:</strong> مانده مشتری صفر؛ موجودی صندوق +۵M؛ فاکتور به‌عنوان تسویه‌شده شناخته می‌شود.</p>

<h2>مثال عملی ۲ — پرداخت بانکی به تأمین‌کننده</h2>
<ol>
<li>نوع: <strong>پرداخت</strong></li>
<li>شخص: تأمین‌کننده — مبلغ فاکتور خرید</li>
<li>حساب‌ها: <strong>بانک</strong> — حساب ملت — همان مبلغ</li>
<li>لینک به فاکتور خرید (اختیاری ولی توصیه می‌شود)</li>
</ol>

<h2>مثال عملی ۳ — دریافت قسط</h2>
<ol>
<li>فاکتور اقساطی ۱۲M با ۶ قسط ۲M</li>
<li>دریافت — مشتری — ۲٬۰۰۰٬۰۰۰</li>
<li>سویچ <strong>اقساط</strong> — انتخاب فاکتور — تخصیص به قسط ۱</li>
<li>حساب: بانک یا صندوق — ۲M</li>
</ol>

<h2>انتقالات (مکمل)</h2>
<p>برای جابه‌جایی بین حساب‌های خودتان (بدون شخص):</p>
<p><strong>حسابداری</strong> ← <strong>انتقالات</strong> — <code>/transfers</code></p>
<p>مبدأ و مقصد: بانک / صندوق / تنخواه. فیلدها: تاریخ، مبلغ، ارز، کارمزد (اختیاری)، توضیحات. در حالت چندارزی: نرخ تبدیل و مبلغ مقصد.</p>

<h2>چک‌لیست بعد از ذخیره</h2>
<ul>
<li>کد سند در لیست دیده می‌شود</li>
<li>مانده شخص در کاردکس شخص کم/زیاد شده</li>
<li>موجودی بانک/صندوق در لیست حساب‌ها به‌روز است</li>
<li>اگر لینک فاکتور بود — مانده فاکتور کاهش یافته</li>
<li>اگر اقساط بود — وضعیت قسط «پرداخت‌شده» یا مانده قسط کم شده</li>
</ul>

<h2>عیب‌یابی</h2>
<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>در فاکتور فروش اقساطی، تب اقساط را پر کنید</td></tr>
<tr><td>چک در لیست انتخاب نیست</td><td>چک را از منوی چک‌ها ثبت کنید؛ وضعیت مناسب داشته باشد</td></tr>
<tr><td>دسترسی ندارید</td><td>مدیر: کاربران و دسترسی‌ها ← people_transactions</td></tr>
</tbody>
</table>

<h2>گام بعدی</h2>
<p>اگر با چک کار می‌کنید: <strong>مدیریت چک‌ها</strong> — ثبت، سپرده، وصول، واگذاری</p>