forked from hesabix/arc
183 lines
11 KiB
HTML
183 lines
11 KiB
HTML
<p><strong>سطوح قیمت</strong> (قیمت پلکانی) یعنی همان کالا بسته به <strong>تعداد خرید</strong> قیمت متفاوت دارد: ۱ عدد = قیمت «تکی»، ۱۰ عدد به بالا = «عمده»، ۵۰ عدد = «همکار». در حسابیکس این منطق با فیلدهای <strong>نام پله</strong> و <strong>حداقل تعداد</strong> در <strong>آیتم‌های لیست قیمت</strong> پیاده شده است.</p>
|
||
|
||
<p><strong>سطح دسترسی مطلب:</strong> paid — برای کسب‌وکارهای عمده‌فروشی، پخش و B2B.</p>
|
||
|
||
<h2>مدل داده در حسابیکس</h2>
|
||
<p>هر «سطح قیمت» یک <strong>ردیف جدا</strong> در همان لیست قیمت است:</p>
|
||
<table>
|
||
<thead><tr><th>فیلد API/UI</th><th>برچسب فارسی</th><th>مثال</th></tr></thead>
|
||
<tbody>
|
||
<tr><td><code>tier_name</code></td><td><strong>نام پله</strong></td><td>تکی، عمده، همکار</td></tr>
|
||
<tr><td><code>min_qty</code></td><td><strong>حداقل تعداد</strong></td><td>۱، ۱۰، ۵۰</td></tr>
|
||
<tr><td><code>price</code></td><td><strong>قیمت</strong></td><td>۱۰۰٬۰۰۰ / ۹۵٬۰۰۰ / ۹۰٬۰۰۰</td></tr>
|
||
<tr><td><code>unit_id</code></td><td><strong>واحد</strong></td><td>عدد، کارتن</td></tr>
|
||
<tr><td><code>currency_id</code></td><td><strong>ارز</strong></td><td>ریال</td></tr>
|
||
<tr><td><code>price_list_id</code></td><td>لیست قیمت</td><td>«فروش عمده»</td></tr>
|
||
</tbody>
|
||
</table>
|
||
<p>سیستم هنگام فاکتور، مناسب‌ترین پله را بر اساس <strong>تعداد ردیف</strong> و <strong>حداقل تعداد</strong> انتخاب می‌کند (بزرگ‌ترین min_qty که ≤ تعداد باشد).</p>
|
||
|
||
<h2>کجا پله تعریف می‌شود — و کجا نه</h2>
|
||
<table>
|
||
<thead><tr><th>محل</th><th>نام پله / حداقل تعداد</th><th>قیمت ساده</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>فرم کالا ← افزودن قیمت</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>ایمپورت Excel bulk prices</td><td>✅ ستون‌های pi_*</td><td>✅</td></tr>
|
||
</tbody>
|
||
</table>
|
||
<p><strong>قانون طلایی:</strong> برای پلکانی واقعی، از فرم ساده کالا فقط «یک قیمت per لیست» بگیرید؛ پله‌ها را در صفحه آیتم‌ها یا ویرایش گسترده بسازید.</p>
|
||
|
||
<h2>روش ۱ — صفحه آیتم‌های لیست قیمت (پیشنهادی برای شروع)</h2>
|
||
|
||
<h3>مسیر</h3>
|
||
<ol>
|
||
<li><strong>کالاها</strong> ← <strong>مدیریت لیست‌های قیمت</strong></li>
|
||
<li>لیست «عمده‌فروشی» ← ورود به آیتم‌ها</li>
|
||
<li>یا مستقیم: <code>/price-lists/{id}/items</code></li>
|
||
</ol>
|
||
|
||
<h3>ساخت پله برای یک کالا</h3>
|
||
<p>برای کالای «چای Lipton» سه ردیف در <strong>همان</strong> لیست:</p>
|
||
<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>۱۰۰</td><td>۴۰٬۰۰۰</td></tr>
|
||
</tbody>
|
||
</table>
|
||
<p>فیلدهای فرم هر ردیف:</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></li>
|
||
</ul>
|
||
<p>نمایش در لیست: <code>{نام کالا} {شناسه} - {نام پله}</code> همراه min_qty، price، currency، آخرین بروزرسانی</p>
|
||
|
||
<h2>روش ۲ — ویرایش گسترده قیمت‌ها</h2>
|
||
<p>مسیر: <strong>کالاها</strong> ← <strong>ویرایش گسترده قیمت‌ها</strong> — <code>/products/bulk-prices-sheet</code></p>
|
||
|
||
<h3>قابلیت‌ها</h3>
|
||
<ul>
|
||
<li>جدول همه کالاها با ستون قیمت پایه + ستون به ازای هر ترکیب <strong>لیست · ارز · پله</strong></li>
|
||
<li>ویرایش درجا در مرورگر</li>
|
||
<li><strong>خروجی Excel</strong> — شیت <code>BulkPrices</code></li>
|
||
<li><strong>ورود مجدد Excel</strong> — ستون‌های <code>pi_*</code> شناسه آیتم قیمت هستند؛ مقدار جدید = قیمت به‌روز</li>
|
||
<li>فیلتر جست‌وجوی همان لیست کالا (دسته، نوع، …)</li>
|
||
</ul>
|
||
|
||
<h3>جریان کار تیم قیمت‌گذاری</h3>
|
||
<ol>
|
||
<li>صبح: Export Excel از ویرایش گسترده</li>
|
||
<li>ویرایش قیمت‌ها در Excel توسط مدیر فروش</li>
|
||
<li>Import — خلاصه درج/به‌روزرسانی/خطا</li>
|
||
<li>نمونه فاکتور ۱، ۱۲، ۱۰۰ عدد برای تست پله</li>
|
||
</ol>
|
||
|
||
<h2>روش ۳ — تغییر قیمت‌های گروهی (تعدیل درصدی روی پله‌ها)</h2>
|
||
<p>وقتی همه قیمت‌های یک لیست ۵٪ گران می‌شود:</p>
|
||
<ol>
|
||
<li>کالاها ← <strong>تغییر قیمت‌های گروهی</strong></li>
|
||
<li>نوع: <strong>درصدی</strong> — جهت: <strong>افزایش</strong> — ۵٪</li>
|
||
<li>محدوده: <strong>فقط لیست‌های قیمت</strong></li>
|
||
<li>فیلتر لیست: «عمده‌فروشی»</li>
|
||
<li><strong>پیش‌نمایش</strong> — هر پله: <code>عمده · تکی: ۴۵٬۰۰۰ → ۴۷٬۲۵۰</code></li>
|
||
<li>تأیید و اعمال</li>
|
||
</ol>
|
||
<p><strong>هشدار:</strong> عملیات برگشت‌ناپذیر — قبل از اعمال Export بگیرید.</p>
|
||
|
||
<h2>استفاده در فاکتور — انتخاب خودکار پله</h2>
|
||
<ol>
|
||
<li>فاکتور فروش — ردیف کالا</li>
|
||
<li>تعداد را وارد کنید (مثلاً ۱۵)</li>
|
||
<li>آیکن قیمت — لیست «عمده» را انتخاب کنید</li>
|
||
<li>سیستم پله با بزرگ‌ترین min_qty ≤ ۱۵ را اعمال می‌کند (مثلاً عمده با min ۱۲)</li>
|
||
</ol>
|
||
<p>اگر دستی قیمت عوض کنید: نیاز <code>invoices.change_unit_price</code></p>
|
||
|
||
<h2>واحد فرعی و پله</h2>
|
||
<p>اگر کالا <strong>واحد فرعی</strong> (کارتن) دارد:</p>
|
||
<ul>
|
||
<li>پله می‌تواند بر اساس <strong>واحد</strong> تعریف شود — یک پله برای «عدد»، یکی برای «کارتن»</li>
|
||
<li>ضریب تبدیل در تب اطلاعات کلی کالا باید درست باشد</li>
|
||
</ul>
|
||
|
||
<h2>سناریوی کامل B2B</h2>
|
||
|
||
<h3>پیش‌نیاز</h3>
|
||
<ul>
|
||
<li>لیست قیمت «نمایندگان»</li>
|
||
<li>کالاهای A، B، C با پله تکی/عمده/پخش</li>
|
||
<li>مشتری نماینده در اشخاص</li>
|
||
</ul>
|
||
|
||
<h3>فاکتور</h3>
|
||
<ol>
|
||
<li>مشتری نماینده — ۳ ردیف با تعداد ۱، ۲۰، ۲۰۰</li>
|
||
<li>هر ردیف: انتخاب قیمت از لیست «نمایندگان»</li>
|
||
<li>بررسی قیمت واحد مطابق پله</li>
|
||
<li>تخفیف کلی جدا از پله است — پله قبل از تخفیف ردیفی/کلی اعمال می‌شود</li>
|
||
</ol>
|
||
|
||
<h3>فروش سریع</h3>
|
||
<p>فروش سریع معمولاً <strong>یک</strong> لیست پیش‌فرض دارد — برای پله‌های پیچیده از <strong>فاکتور</strong> استفاده کنید یا لیست «خرده» را در فروش سریع و «عمده» را در فاکتور.</p>
|
||
|
||
<h2>نمایش در فرم کالا</h2>
|
||
<p>پس از تعریف پله در آیتم‌ها، در تب قیمت کالا کارت‌ها نشان می‌دهند:</p>
|
||
<ul>
|
||
<li>نام لیست، ارز، قیمت</li>
|
||
<li><strong>سطح: عمده</strong></li>
|
||
<li><strong>حداقل تعداد: ۱۲</strong></li>
|
||
</ul>
|
||
<p>ویرایش پله از این کارت مستقیم نیست — به آیتم‌های لیست بروید.</p>
|
||
|
||
<h2>تفاوت پله قیمت و تخفیف فاکتور</h2>
|
||
<table>
|
||
<thead><tr><th></th><th>پله (min_qty)</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>قیمت واحد در فاکتور</td><td>ستون تخفیف</td></tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<h2>اعتبار مشتری + قیمت پله</h2>
|
||
<p>مستقل هستند:</p>
|
||
<ul>
|
||
<li>پله: چقدر <strong>هر واحد</strong> است</li>
|
||
<li>اعتبار: آیا <strong>نسیه</strong> مجاز است (تنظیمات ← اعتبار کاربران + تب اعتبار شخص)</li>
|
||
</ul>
|
||
|
||
<h2>عیب‌یابی پیشرفته</h2>
|
||
<table>
|
||
<thead><tr><th>علامت</th><th>علت</th><th>راه‌حل</th></tr></thead>
|
||
<tbody>
|
||
<tr><td>همیشه قیمت «تکی»</td><td>min_qty پله عمده > تعداد</td><td>تعداد را زیاد کنید یا min_qty را کم</td></tr>
|
||
<tr><td>دو پله همmin_qty</td><td>تعارض</td><td>نام پله متفاوت ولی min یکسان — یکی را حذف/ادغام</td></tr>
|
||
<tr><td>Import Excel خطا</td><td>ستون pi_* اشتباه</td><td>Export تازه بگیرید، فقط price را عوض کنید</td></tr>
|
||
<tr><td>پله در ارز دلار نیامد</td><td>ارز فاکتور ریال</td><td>آیتم پله برای همان ارز فاکتور</td></tr>
|
||
<tr><td>قیمت پایه به‌جای پله</td><td>لیست انتخاب نشده</td><td>از picker لیست قیمت در ردیف استفاده کنید</td></tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
<h2>چک‌لیست راه‌اندازی پلکانی</h2>
|
||
<ul>
|
||
<li>لیست قیمت B2B ساخته و فعال</li>
|
||
<li>برای هر SKU پرفروش حداقل ۲ پله (تکی + عمده)</li>
|
||
<li>min_qtyها صعودی و بدون تکراری</li>
|
||
<li>تست فاکتور با ۳ تعداد مختلف</li>
|
||
<li>Export پشتیبان قبل از تغییر گروهی</li>
|
||
<li>آموزش فروشنده: انتخاب لیست در ردیف فاکتور</li>
|
||
</ul>
|
||
|
||
<h2>منابع مرتبط</h2>
|
||
<ul>
|
||
<li>تعریف کالا — قیمت پایه و موجودی</li>
|
||
<li>لیست قیمت — ساخت لیست و استفاده در فروش سریع</li>
|
||
<li>فاکتور فروش — تخفیف ردیفی و کلی</li>
|
||
</ul>
|