BSS HostKhaneh
← بازگشت به راهنما

اتصال NetBill — Provisioning



> version: 1.1 | last_updated: 2026-07-27 | audience: admin
> مستند رسمی: [NetBill WebService Guide v3.8](https://netbill.ir/site/docs/NetBill-WebService-Guide-V3.8.pdf)

معرفی



ماژول `netbill` با **WebService رسمی NetBill v3.8** (قاصدک سامانه) یکپارچه می‌شود.

  • پروتکل: **HTTP GET** + پاسخ **XML**

  • آدرس پایه: `http://IP/netbill-holder/webservice/?admin=ADMIN_ID&method=...`


    • ---

    دریافت ADMIN_ID



  • وارد لایه **VISP** شوید

  • منو **Manage Visps** → روی **Login As** کلیک راست → **Copy Link Location**

  • عدد HASH داخل URL همان `admin_id` است


    • ---

    پیکربندی Tenant



    **Provisioning → ماژول‌های Provisioning → ایجاد**

    | فیلد config | مثال | توضیح |
    |-------------|------|--------|
    | `base_url` | `http://192.168.1.10` | IP سرور NetBill |
    | `admin_id` | `abc123hash...` | HASH از Login As |
    | `webservice_path` | `/netbill-holder/webservice/` | مسیر webservice |
    | `service_group_id` | `5` | Service Group ID (ستون ID در Service Groups) |
    | `default_status_id` | `2` | وضعیت ایجاد (2=فعال) |
    | `suspend_status_id` | `101` | وضعیت تعلیق |
    | `enable_status_id` | `2` | وضعیت فعال‌سازی |

    کدهای status_id



    | مقدار | معنی |
    |-------|------|
    | 1 | Not Used |
    | 2 | Enabled |
    | 101 | Disabled |
    | 102 | Expired |
    | 1000 | Low Credit |

    ---

    پیکربندی محصول



  • **ماژول:** `netbill`

  • **provisioning_config:**

    • - `service_group_id` = ID گروه سرویس در NetBill (مثلاً `5`)

    ---

    عملیات BSS → NetBill



    | BSS | method | پارامترها |
    |-----|--------|-----------|
    | ایجاد | `adduser` | username, password, sid, status_id, mobile_no, ... |
    | تعلیق | `edituser` | username, status_id=101 |
    | فعال‌سازی | `edituser` | username, status_id=2 |
    | حذف | `deleteuser` | username |
    | تغییر پلن | `edituser` | username, sid |
    | تست اتصال | `check_admin` | — |

    ---

    تست اتصال



  • Sandbox را خاموش کنید

  • **تست اتصال** در Filament

  • پاسخ موفق: `Admin is correct` + نام admin


    • ---

    Sandbox



    تا زمان دریافت `admin_id` واقعی، Sandbox را **فعال** نگه دارید.

    ---

    نمونه URL (مستند رسمی)



    ```
    http://IP/netbill-holder/webservice/?admin=ADMIN_ID&method=adduser&username=ali&password=123456&sid=5&status_id=2&mobile_no=09121234567
    ```

    پاسخ موفق:

    ```xml
    <USER>
    <result_id>0</result_id>
    <result_description>Successfully added!</result_description>
    <username>ali</username>
    <password>123456</password>
    <visp_service_group_id>5</visp_service_group_id>
    </USER>
    ```

    ---

    متدهای اضافی (آینده)



    مستند v3.8 شامل متدهای `addcredit`, `disconnect_user`, `show_servicegroup`, `report` و ... نیز هست که در صورت نیاز قابل افزودن به BSS هستند.