مستندات فنی «استعلام اطلاعات شرکت با شناسه ملی»

اندپوینت و دسترسی استعلام اطلاعات شرکت با شناسه ملی

این صفحه مستندات فنی فراخوانی GET /kyb/v2/clients/{clientId}/companyInfo است.

Scope: kyb:company-info:get

Grant type: client_credentials

دسته‌بندی OpenAPI: شناخت کسب‌وکار KYB. شناسه عملیات: kybCompanyInfoGet.

معرفی استعلام اطلاعات شرکت با شناسه ملی

KYB فینوتک با شناسه ملی شرکت، مشخصات ثبتی کسب‌وکار را می‌دهد. مناسب شناخت کسب‌وکار و اعتبارسنجی حقوقی.

ورودی و خروجی استعلام اطلاعات شرکت با شناسه ملی

ورودی‌های اصلی: شناسه کلاینت، شناسه شرکت.

پارامترهای اختیاری متداول: کد پیگیری.

فیلدهای مهم پاسخ: شناسه شرکت، شماره ثبت، عنوان، تاریخ ثبت، آخرین سرمایه ثبتی، آدرس، کدپستی، کد اقتصادی.

جزئیات نوع داده، الزامی بودن و نمونه JSON در مشخصات Elements همین صفحه آمده است.

کاربرد فنی استعلام اطلاعات شرکت با شناسه ملی

KYB فینوتک با شناسه ملی شرکت، مشخصات ثبتی کسب‌وکار را می‌دهد. مناسب شناخت کسب‌وکار و اعتبارسنجی حقوقی.

پس از دریافت توکن مناسب (مطابق Grant type)، درخواست را به مسیر بالا بفرستید و پاسخ را بر اساس اسکیمای اعلام‌شده پردازش کنید. راهنمای گرفتن توکن در راهنمای شروع آمده است.

در صورت خطای احراز هویت یا Scope ناکافی، ابتدا اعتبار توکن و سطح دسترسی کلاینت را بررسی کنید؛ سپس پارامترهای الزامی مسیر و بدنه را با اسکیمای همین صفحه تطبیق دهید.

برای توضیح کسب‌وکاری، موارد استفاده و پیش‌نیازها به صفحه سرویس «استعلام اطلاعات شرکت با شناسه ملی» مراجعه کنید.

عملیات مرتبط با استعلام اطلاعات شرکت با شناسه ملی

• استعلام صاحبان امضا — GET /kyb/v2/clients/{clientId}/authorizedSignatories
• استعلام صاحبان امضا — GET /kyb/v2/clients/{clientId}/authorizedSignatories
• استعلام اعضای هیئت مدیره — GET /kyb/v2/clients/{clientId}/boardMembers
• استعلام اعضای هیئت مدیره — GET /kyb/v2/clients/{clientId}/boardMembers
• استعلام مجوزهای شرکت — GET /kyb/v2/clients/{clientId}/companyLicenses