زی‌هاب/سرویس‌ها/استعلام اطلاعات شرکت

استعلام اطلاعات شرکت

برای ورود کسب‌وکار حقوقی به فرایند پذیرش استفاده می‌شود. پاسخ آزمایشی، اطلاعات رسمی ثبت شرکت‌ها نیست.

خدماتی

ورودی

  • شناسه ملی companyNationalIdیازده رقم با رقم کنترلی معتبر. اعتبار ساختاری با استعلام ثبت شرکت‌ها فرق دارد.

خروجی

  • نام nameنام آزمایشی شرکت.
  • یافت شد foundنتیجه منفی معتبر یعنی شناسه در منبع آزمایشی نیست.

نمونهٔ درخواست و شکل پاسخ

نمونهٔ ساختار است و نتیجهٔ یک فراخوانی واقعی نیست.

POST /v1/services/company-inquiry/execute
Authorization: Bearer zh_test_…
Idempotency-Key: <unique-per-operation>

{
  "input": {
    "companyNationalId": "10100000103"
  }
}
{
  "requestId": "sreq_…",
  "status": "SUCCEEDED | NEGATIVE | FAILED | UNKNOWN",
  "data": { … },
  "error": null,
  "billing": { "status": "CHARGED | RELEASED | PENDING_RECONCILIATION", "amountRial": "…", "currency": "IRR" },
  "mock": true
}

خطاها و هزینه

VALIDATION_ERRORورودی از نظر ساختاری نامعتبر است و هزینه‌ای ندارد.بدون هزینه
FORBIDDENحساب یا کلید به این سرویس دسترسی ندارد و هزینه‌ای ندارد.بدون هزینه
RATE_LIMITEDمحدودیت نرخ اعمال شده و هزینه‌ای ندارد.بدون هزینه
INSUFFICIENT_FUNDSموجودی قابل استفاده کافی نیست و رزروی انجام نمی‌شود.بدون هزینه
PROVIDER_ERRORخطای فنی قطعی است و رزرو آزاد می‌شود.بدون هزینه
PROVIDER_TIMEOUTنتیجه نامعلوم است. وجه تا تعیین تکلیف رزرو می‌ماند.بدون هزینه

رفتار محیط آزمایشی: ده رقم اول شناسه ملی: پایان 90 عدم وجود، 91 خطای فنی، 92 مهلت نامعلوم.