کمیسیون نمایندگان

> version: 2.8 | last_updated: 2026-09-23 | audience: admin

نحوه کار

پورسانت به **محصولی که نماینده فروخته** تعلق می‌گیرد (نرخ همان محصول، وگرنه دسته، وگرنه نرخ کلی).
پایهٔ محاسبه = **مبلغ پرداخت فاکتور** (شامل قیمت گزینه‌های قابل‌تنظیم روی همان سرویس). گزینهٔ قابل‌تنظیم ردیف پورسانت جدا ندارد.
پس از **هر پرداخت موفق فاکتور** (درگاه، کیف پول مشتری، کیف پول ریسلر، پرداخت دستی) محاسبه می‌شود و **همان لحظه به کیف پول** واریز می‌گردد (وضعیت `paid`) — تأیید/پرداخت دستی لازم نیست.

هنگام **برگشت از فروش** (`issueSalesReturnInvoice`) یا **استرداد credit note**، همان زنجیرهٔ نرخ روی مبلغ برگشتی اعمال و از کیف پول نماینده **کسر** می‌شود (رکورد با مبلغ منفی / نوع کسر برگشت). اگر موجودی کافی نباشد، کیف پول می‌تواند منفی شود.

از پایین به بالا

در یک تراکنش، اول فروشنده بعد والد:

نمایندهٔ فروشنده: نرخ مؤثر خودش

هر والد: `(نرخ خودش − نرخ فرزند مسیر)`

مجموع ≤ نرخ ریشه نسبت به شرکت

مثال: والد ۱۵٪، فرزند ۱۰٪، فروش ۱۰٬۰۰۰٬۰۰۰ ریال → فرزند ۱٬۰۰۰٬۰۰۰، والد ۵۰۰٬۰۰۰.

نرخ مؤثر: override محصول → دسته → نرخ کلی پروفایل → در نهایت `BILLING_RESELLER_COMMISSION_PERCENT`.

تنظیم نرخ

از **CRM → نمایندگان فروش**:

تب **محصولات قابل فروش** — دسته را انتخاب کنید؛ لیست فقط **محصول و افزونه مستقل** همان دسته/زیردسته است (گزینهٔ قابل‌تنظیم در لیست نیست).

تب **پورسانت** — فقط همان موارد انتخاب‌شده. صفرقیمت و Free در لیست نیستند.

نرخ فرزند ≤ نرخ والد همان محصول/دسته.

تنظیمات `.env` (سقف پیش‌فرض)

```
BILLING_RESELLER_COMMISSION_PERCENT=10
```

مدیریت

**گزارش‌گیری → کمیسیون نمایندگان** — مشاهده سوابق (معمولاً از قبل `پرداخت شده`). دکمه **آموزش** در هدر. دکمه‌های تأیید/پرداخت دستی وجود ندارد.

گردش و مانده کیف پول همان نماینده: **CRM → نمایندگان فروش → مدیریت مالی** (افزایش/کاهش دستی توسط ادمین شرکت).

پنل نماینده

`/reseller/commissions` — مشاهده؛ مبلغ در **کیف پول**.
زیرنماینده: کاتالوگ والد + نرخ والد کنار هر مورد.

جزئیات سلسله: [resellers.md](./resellers.md)