Seyyed_arc/docs/help-content/773-define-person.html

<p><strong>طرف‌حساب</strong> (شخص) در حسابیکس هر فرد یا شرکتی است که با او معامله مالی دارید. این درس همهٔ امکانات تعریف و مدیریت اشخاص را — از افزودن دستی تا ایمپورت اکسل — با نام واقعی فیلدها و تب‌ها توضیح می‌دهد.</p>

<h2>مسیرها</h2>
<ul>
<li><strong>اشخاص</strong> ← لیست</li>
<li>افزودن: دکمه <strong>+</strong> در منو، یا دکمه افزودن در بالای لیست</li>
<li>ویرایش: کلیک روی سطر → جزئیات → ویرایش، یا عملیات سطر → <strong>ویرایش</strong></li>
</ul>

<h2>دیالوگ «افزودن شخص» / «ویرایش شخص»</h2>
<p>فرم در پنجرهٔ مودال با <strong>تب‌های افقی</strong> باز می‌شود. دکمه پایین: <strong>افزودن</strong> یا <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>سویچ <strong>خودکار</strong> / <strong>دستی</strong> — خودکار: سرور کد می‌دهد</td></tr>
<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>
<tr><td><strong>نوع حقوقی</strong></td><td>خیر</td><td><strong>حقیقی</strong> / <strong>حقوقی</strong></td></tr>
<tr><td><strong>نام</strong> / <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>عدد صحیح &gt; ۰</td></tr>
</tbody>
</table>

<h3>انواع شخص — چه زمانی انتخاب کنیم؟</h3>
<table>
<thead><tr><th>نوع</th><th>کاربرد</th></tr></thead>
<tbody>
<tr><td><strong>مشتری</strong></td><td>فاکتور فروش، باشگاه مشتریان، CRM — پیش‌فرض شخص جدید</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></td><td>شریک یا طرف عمومی</td></tr>
<tr><td><strong>سهامدار</strong></td><td>نیاز به تعداد سهام</td></tr>
</tbody>
</table>
<p>یک شخص می‌تواند همزمان <strong>مشتری</strong> و <strong>تامین‌کننده</strong> باشد.</p>

<h2>تب ۲ — اطلاعات اقتصادی</h2>
<ul>
<li><strong>شناسه ملی</strong></li>
<li><strong>شماره ثبت</strong></li>
<li><strong>شناسه اقتصادی</strong></li>
</ul>
<p>برای فاکتور رسمی و یکپارچه‌سازی مودیان مهم است.</p>

<h2>تب ۳ — اطلاعات تماس</h2>
<table>
<thead><tr><th>فیلد</th></tr></thead>
<tbody>
<tr><td>کشور، استان، شهرستان، کد پستی، آدرس</td></tr>
<tr><td>تلفن، موبایل، موبایل ۲، موبایل ۳، فکس</td></tr>
<tr><td>پست الکترونیکی، وب‌سایت</td></tr>
</tbody>
</table>

<h3>پیام‌رسان و شبکه‌های اجتماعی</h3>
<p>بخش جدا با دکمه <strong>افزودن راه ارتباطی</strong>:</p>
<ul>
<li><strong>پلتفرم:</strong> تلگرام، بله، روبیکا، ایتا، واتساپ، اینستاگرام، لینکدین، توییتر/X، سایر</li>
<li><strong>آیدی، لینک یا شماره</strong></li>
<li>برای «سایر»: <strong>نام پلتفرم</strong></li>
</ul>

<h2>تب ۴ — حساب‌های بانکی</h2>
<p>برای هر حساب (چند کارت مجاز):</p>
<ul>
<li><strong>نام بانک</strong></li>
<li><strong>شماره حساب</strong></li>
<li><strong>شماره کارت</strong></li>
<li><strong>شماره شبا</strong></li>
</ul>
<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><strong>بدهکار</strong> (شخص به ما بدهکار) / <strong>بستانکار</strong> (ما به شخص بدهکاریم)</td></tr>
<tr><td><strong>سال مالی</strong></td><td>فقط نمایش — سال جاری</td></tr>
</tbody>
</table>
<p>راهنما: «مانده در سند تراز افتتاحیه سال مالی ثبت می‌شود و روی اطلاعات شخص ذخیره نمی‌شود.»</p>
<p>برای حذف مانده: مبلغ را خالی کنید و ذخیره کنید.</p>

<h2>تب ۶ — اعتبار</h2>
<p>سیاست نسیه این شخص:</p>
<ul>
<li><strong>حالت بررسی اعتبار:</strong> ارث از تنظیمات کسب‌وکار / فعال / غیرفعال</li>
<li><strong>سقف اعتبار اختصاصی</strong> — خالی = سقف پیش‌فرض کسب‌وکار (<strong>تنظیمات</strong> ← <strong>اعتبار کاربران</strong>)</li>
</ul>

<h2>تب ۷ — درصد پورسانت فروش (فقط بازاریاب/فروشنده)</h2>
<ul>
<li>درصد از فروش (۰–۱۰۰٪)</li>
<li>درصد از برگشت از فروش</li>
<li>مبلغ پورسانت فروش / برگشت</li>
<li>سویچ‌ها: عدم محاسبه تخفیف؛ عدم محاسبه اضافات و کسورات؛ ثبت پورسانت در سند حسابداری فاکتور</li>
</ul>

<h2>مراحل افزودن مشتری ساده</h2>
<ol>
<li><strong>اشخاص</strong> ← <strong>+</strong></li>
<li>تب اطلاعات پایه: نام مستعار «علی احمدی»، نوع <strong>مشتری</strong></li>
<li>تب تماس: موبایل 0912…</li>
<li><strong>افزودن</strong></li>
</ol>
<p>پیام: «شخص با موفقیت ایجاد شد» — در کمبوباکس فاکتور فروش قابل انتخاب است.</p>

<h2>صفحه لیست اشخاص — امکانات کامل</h2>

<h3>جست‌وجو و فیلتر</h3>
<ul>
<li>جست‌وجوی سراسری در کد، نام مستعار، نام، شرکت، موبایل، ایمیل، شناسه ملی</li>
<li>فیلتر ستون <strong>نوع شخص</strong> (چندانتخابی)</li>
<li>فیلتر <strong>گروه</strong></li>
<li>فیلتر <strong>وضعیت</strong>: بستانکار، بدهکار، بالانس، بدون تراکنش</li>
<li>فیلتر کشور / استان</li>
</ul>

<h3>عملیات بالای جدول</h3>
<table>
<thead><tr><th>آیکن/دکمه</th><th>کار</th><th>دسترسی</th></tr></thead>
<tbody>
<tr><td><strong>+</strong></td><td>افزودن شخص</td><td>people.add</td></tr>
<tr><td>مدیریت گروه‌ها</td><td>دیالوگ گروه‌های اشخاص</td><td>people.edit</td></tr>
<tr><td>حذف گروهی</td><td>حذف اشخاص انتخاب‌شده</td><td>people.delete</td></tr>
<tr><td>ایمپورت اکسل</td><td>دیالوگ ایمپورت</td><td>—</td></tr>
<tr><td>خروجی Excel / PDF</td><td>دانلود لیست</td><td>—</td></tr>
</tbody>
</table>

<h3>عملیات هر سطر</h3>
<ul>
<li>کلیک روی سطر → <strong>جزئیات شخص</strong> (دیالوگ)</li>
<li><strong>کاردکس</strong> → گزارش کاردکس با فیلتر این شخص</li>
<li><strong>ویرایش</strong> / <strong>حذف</strong></li>
</ul>

<h2>ایمپورت اشخاص از اکسل</h2>
<p>دیالوگ: <strong>ایمپورت اشخاص از اکسل</strong></p>
<ol>
<li><strong>دانلود قالب</strong> — فایل <code>persons_import_template.xlsx</code></li>
<li>فایل را پر کنید</li>
<li><strong>تطبیق بر اساس:</strong> کد / شناسه ملی / پست الکترونیکی</li>
<li><strong>سیاست تداخل:</strong> فقط درج / به‌روزرسانی موجود / درج یا به‌روزرسانی (upsert)</li>
<li>اختیاری: <strong>اعتبارسنجی فقط</strong> (dry-run) — بدون ذخیره واقعی</li>
<li><strong>ایمپورت</strong></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>CRM — تماس، جلسه، یادداشت</td></tr>
<tr><td><strong>فرصت‌های فروش</strong></td><td>معاملات CRM</td></tr>
<tr><td><strong>اشتراک‌گذاری</strong></td><td>لینک عمومی کارت حساب برای مشتری</td></tr>
</tbody>
</table>

<h2>اشتراک‌گذاری کارت حساب با مشتری</h2>
<p>تب <strong>اشتراک‌گذاری</strong>:</p>
<ul>
<li><strong>ایجاد لینک</strong> — اعتبار ۷/۱۴/۳۰ روز یا بدون انقضا</li>
<li><strong>حداکثر بازدید</strong> (۱–۱۰۰۰ یا نامحدود)</li>
<li><strong>نمایش کارت حساب</strong> — ریز تراکنش‌ها</li>
<li><strong>نمایش لیست فاکتورها</strong></li>
<li><strong>ارسال لینک با پیامک</strong> (اگر موبایل ثبت شده)</li>
<li><strong>لغو لینک</strong> / <strong>کپی و ارسال لینک</strong></li>
</ul>
<p>حداقل یکی از «کارت حساب» یا «لیست فاکتورها» باید فعال باشد.</p>

<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>تعداد سهام &gt; ۰</td></tr>
<tr><td>شما دسترسی لازم برای مشاهده لیست اشخاص را ندارید</td><td>از مالک دسترسی people بگیرید</td></tr>
<tr><td>سند تراز افتتاحیه نهایی شده…</td><td>مانده اولیه از فرم شخص قابل تغییر نیست</td></tr>
</tbody>
</table>

<h2>چک‌لیست بعد از تعریف</h2>
<ul>
<li>شخص در لیست با کد و نام مستعار دیده می‌شود</li>
<li>در فاکتور فروش/خرید در کمبوباکس ظاهر می‌شود</li>
<li>مانده ابتدا صفر یا مانده افتتاحیه ثبت شده</li>
</ul>

<h2>گام بعدی</h2>
<ul>
<li>گروه‌بندی برای سازماندهی ← درس <strong>گروه‌بندی اشخاص</strong></li>
<li>پیگیری بدهی ← درس <strong>مانده و گردش حساب شخص</strong></li>
</ul>