Seyyed_arc/docs/help-content/803-bank-account.html

<p>قبل از ثبت دریافت یا پرداخت، باید <strong>مقصد پول</strong> را در سیستم تعریف کنید. حسابیکس سه ساختار نزدیک به هم دارد: <strong>حساب بانکی</strong>، <strong>صندوق</strong> و <strong>تنخواه</strong>. فرم و فیلدها مشابه‌اند؛ این درس همه را پوشش می‌دهد.</p>

<h2>۱. حساب بانکی</h2>

<h3>مسیر</h3>
<p><strong>بانکداری</strong> ← <strong>حساب‌ها</strong> — <code>/business/{id}/accounts</code></p>
<p>افزودن: دکمه <strong>+</strong> کنار منو یا دکمه افزودن در لیست</p>

<h3>ستون‌های لیست</h3>
<p>کد، عنوان، شعبه، شماره حساب، شبا، کارت، مالک، شماره پوز، ارز، فعال، پیش‌فرض، <strong>موجودی</strong> (هشدار اگر منفی)</p>
<p>کلیک روی <strong>عنوان</strong> → گزارش <strong>کاردکس</strong> همان حساب</p>

<h3>فرم افزودن/ویرایش — ۳ تب</h3>

<h4>تب عنوان</h4>
<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><strong>بله</strong></td><td>ریال یا ارز دیگر</td></tr>
<tr><td><strong>عنوان</strong></td><td><strong>بله</strong></td><td>مثلاً «بانک ملت — جاری»</td></tr>
<tr><td><strong>توضیحات</strong></td><td>خیر</td><td></td></tr>
</tbody>
</table>

<h4>تب حساب‌های بانکی</h4>
<table>
<thead><tr><th>فیلد</th></tr></thead>
<tbody>
<tr><td>شعبه، مالک، شماره حساب (فقط رقم)</td></tr>
<tr><td>شماره کارت (فقط رقم)</td></tr>
<tr><td>شماره شبا (حداکثر ۲۴ کاراکتر)</td></tr>
<tr><td>شماره پوز، شناسه پرداخت</td></tr>
</tbody>
</table>

<h4>تب تنظیمات</h4>
<ul>
<li><strong>فعال</strong> — غیرفعال در لیست انتخاب دریافت/پرداخت نیاید</li>
<li><strong>پیش‌فرض</strong> — پیشنهاد اول در کمبوباکس‌ها</li>
</ul>
<p>موفقیت: «حساب بانکی با موفقیت ایجاد شد» / «…به‌روزرسانی شد»</p>

<h2>۲. صندوق (Cash Register)</h2>

<h3>مسیر</h3>
<p><strong>بانکداری</strong> ← <strong>صندوق</strong> — <code>/cash-box</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></td><td>خودکار/دستی</td></tr>
<tr><td><strong>ارز</strong></td><td>بله</td></tr>
<tr><td><strong>توضیحات</strong></td><td>خیر</td></tr>
<tr><td>شماره سویچ پرداخت / ترمینال / پذیرنده</td><td>برای POS</td></tr>
<tr><td><strong>فعال</strong> / <strong>پیش‌فرض</strong></td><td>—</td></tr>
</tbody>
</table>
<p>در <strong>فروش سریع</strong> و دریافت نقدی همین صندوق انتخاب می‌شود.</p>

<h2>۳. تنخواه (Petty Cash)</h2>
<p>مسیر: <strong>بانکداری</strong> ← <strong>تنخواه</strong> — <code>/petty-cash</code></p>
<p>فرم مشابه صندوق (بدون فیلدهای ترمینال پرداخت). برای هزینه‌های کوچک روزانه کارمند.</p>

<h2>۴. کیف پول (خلاصه)</h2>
<p>مسیر: <code>/wallet</code> — کیف پول سرویس Hesabix:</p>
<ul>
<li>مانده قابل برداشت / در انتظار تأیید</li>
<li><strong>شارژ</strong> کیف پول</li>
<li><strong>درخواست تسویه</strong> به حساب بانکی</li>
<li>گردش: شارژ، پرداخت مشتری، تسویه، کارمزد، …</li>
</ul>
<p>دسترسی: <code>wallet.view</code>، شارژ: <code>wallet.charge</code></p>

<h2>۵. تسهیلات دریافتی (خلاصه)</h2>
<p>مسیر: <code>/loan-facilities</code> — ثبت وام بانکی، جدول اقساط، پرداخت قسط. مکمل فصل بانکداری برای وام‌های سازمانی.</p>

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

<h2>مانده و کاردکس</h2>
<p>مانده هر حساب در ستون لیست به‌روز می‌شود وقتی:</p>
<ul>
<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>فعال باشد؛ دسترسی bank_accounts/cash</td></tr>
<tr><td>موجودی منفی</td><td>بررسی گردش — آیکون هشدار در لیست</td></tr>
</tbody>
</table>

<h2>گام بعدی</h2>
<p><strong>دریافت و پرداخت</strong> — ثبت واقعی ورود/خروج پول</p>