NetBill WebService V3.8 — وضعیتهای عملیاتی workflow
> version: 1.1 | last_updated: 2026-08-10 | audience: admin
> منبع: [`NetBill-WebService-Guide-V3.8.pdf`](./NetBill-WebService-Guide-V3.8.pdf)
> provisioning: [`netbill-provisioning.md`](./netbill-provisioning.md)
ایده
هر متد رسمی NetBill بهصورت یک وضعیت عملیاتی HTTP (`http.netbill_{method}`) seed میشود.
آدرس و `admin_id` از **سرور بیرونی** با ماژول `netbill` خوانده میشود.
در فرم ویرایش عملیات، بلوک **«چه چیزی ارسال میشود؟»** (`NetBillQueryGuide`) پارامتر دقیق همان متد را نشان میدهد — مثل راهنمای شاهکار.
اتصال
Sandbox سرور بیرونی → فراخوانی واقعی انجام نمیشود.
دستهبندی (فعلی)
| کلید | عنوان |
|------|--------|
| `netbill.common` | عمومی / اتصال |
| `netbill.user` | کاربر |
| `netbill.credit` | اعتبار |
| `netbill.isg` | ISG |
| `netbill.temp_credit` | گیگباکس |
| `netbill.limit` | محدودیت سرعت |
| `netbill.ip` | IP / شبکه |
| `netbill.report` | گزارش |
متدهای VoIP / reset از کاتالوگ seed حذف شدهاند (در صورت نیاز دستی با HTTP سفارشی بسازید).
نمونههای پرکاربرد ADSL
| وضعیت کارتابل | کلید عملیات | متد |
|----------------|-------------|------|
| ایجاد کاربر | `http.netbill_adduser` | `adduser` |
| ویرایش / فعالسازی | `http.netbill_edituser` | `edituser` |
| اطلاعات کاربر | `http.netbill_userinfo` | `userinfo` |
موفقیت پاسخ
پروتکل: HTTP GET + XML.
BSS علاوه بر HTTP 2xx، `result_id >= 0` را موفق میداند (طبق V3.8).
Seed
```bash
cd /home/bsshostkhaneh/bss
/opt/cpanel/ea-php83/root/usr/bin/php artisan db:seed \
--class='Modules\Order\Database\Seeders\NetBillWorkflowActionSeeder' --force
```
یا همراه کل کاتالوگ: `WorkflowActionSeeder`.
Placeholderهای پرکاربرد
| کلید | منبع |
|------|------|
| `{{username}}` / `{{password}}` | `provisioning_data` اشتراک |
| `{{service_group_id}}` | sid محصول / provisioning_data |
| `{{status_id}}` | وضعیت NetBill (مثلاً ۱ ایجاد، ۲ فعال) |
| `{{mobile}}` / `{{phone}}` / `{{national_id}}` | مشتری |
| `{{netbill_webservice_url}}` / `{{netbill_admin_id}}` | سرور بیرونی |