راهنمای اپراتور — اتصال شاهکار HTTP به کارتابل ADSL

> version: 1.1 | last_updated: 2026-08-10 | audience: admin / ops

هدف

استعلام شاهکار (`estelaam`) روی وضعیت **منتظر شاهکار** در pipeline ADSL به‌صورت خودکار اجرا شود.

پیش‌نیاز

**توکن API** را در یکی از این دو جا بگذارید:

- منو **Compliance → تنظیمات شاهکار** → درایور `api` → فیلد `api_key`
- یا هدر `Authorization` عملیات با `{{shahkar_authorization}}`

اطلاعات هویتی مشتری در پروفایل کامل باشد:

- حقیقی ایرانی: نام، نام خانوادگی، پدر، تاریخ تولد، شناسنامه، کد ملی
- اتباع / حقوقی: طبق نگاشت [شاهکار وضعیت‌های عملیاتی](./shahkar-workflow-actions.md)

بدنهٔ `http.shahkar_estelaam` با `shahkar_dynamic_body` از مشتری ساخته می‌شود (نیازی به ویرایش دستی قالب نیست).

جریان

```
AAA ایجاد شد → منتظر شاهکار → (HTTP estelaam) → تأیید / رد
```

موفق → `شاهکار تأیید شد` → نصب

ناموفق → `شاهکار رد شد` → لغو و جمع‌آوری

تست دستی

کیس ADSL را روی وضعیت **منتظر شاهکار** بگذارید.

دکمه **اجرای عملیات وضعیت** را بزنید.

در تاریخچه، رویداد «اجرای عملیات» + **جزئیات عملیات / پاسخ** (HTTP status و body) را ببینید.

منبع فیلدها

فیلدها از Party / حساب مشتری خوانده می‌شوند. جزئیات نگاشت چهار حالت حقیقی/حقوقی × ایرانی/غیرایرانی در [شاهکار وضعیت‌های عملیاتی](./shahkar-workflow-actions.md).

مرتبط: [وضعیت‌های عملیاتی workflow](./workflow-actions.md)