NetBill WebService V3.8 — وضعیت‌های عملیاتی workflow

ورود / ثبت‌نام
← بازگشت به راهنما

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`) پارامتر دقیق همان متد را نشان می‌دهد — مثل راهنمای شاهکار.

اتصال



  • **Provisioning → سرورهای بیرونی** → ماژول `netbill`

  • فیلدها: `base_url`, `admin_id`, `webservice_path`, `timeout`

  • روی عملیات: `external_module_key=netbill` + `netbill_method` + URL با `{{netbill_webservice_url}}` / `{{netbill_admin_id}}`


    • 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}}` | سرور بیرونی |

    نکته



  • دستهٔ قدیمی **یکپارچه — AAA / Provisioning** (`integration.aaa_*`) حذف شده است.

  • مسیر روزانهٔ create/suspend روی اشتراک همچنان می‌تواند از **ماژول Provisioning** محصول (`netbill`) بیاید؛ کارتابل سفارشی از HTTP بالا استفاده می‌کند.