API اعضای هیئتمدیره
فهرست مدیران و بازرسان فعلی یک شرکت را با سمت، تاریخ شروع و مدت تصدی از روی شناسه ملی برمی‌گرداند.
این سرویس چه می‌کند
قراردادی بزرگ پیش رو دارید و طرف مقابل یک شرکت است. پیش از آن، پرسش ساده‌ای هست: اسم چه کسی را در پای قرارداد قبول کنیم؟ این سرویس با شناسهٔ ملی شرکت، فهرست اشخاص و سمت هر کدام را در board_members میدهد و نام شرکت را هم در company_title کنارش می‌گذارد.
هر ردیف چهار فیلد دارد: name، position، start_date و duration. فهرست فقط مدیران نیست؛ بازرس اصلی و علیالبدل هم در همین آرایهاند و تنها با position از مدیران جدا میشوند.
سمت‌ها را با متن دقیق نخوانید
نوشتار سمت‌ها یکدست نیست. در نمونهٔ پاسخ، «رییس هیأت مدیره»، «مدیر عامل و عضو هیأت مدیره» و «بازرس علی البدل» با فاصله و همزه به همین شکل میآیند. شرط position === 'مدیرعامل' چیزی پیدا نمی‌کند. به‌جایش متن را یکدست کنید (فاصله‌ها، ی و همزه) و با شامل‌بودن عبارت بسنجید، مثلاً هر ردیفی که «بازرس» دارد را از مدیران جدا کنید.
مدت تصدی رشتهٔ خام است
duration عدد نیست و پیشوند هم دارد. نمونه‌ها G:تا پایان سال مالی و G:تا تاریخ 07/07/1405 هستند. پیشوند G: جزئی از مقدار است. بازرس‌ها معمولاً تا پایان سال مالی می‌مانند و مدیران تا تاریخی مشخص. اگر روی این فیلد محاسبه‌ای می‌کنید، آن را بخوانید و تفسیرش را جدا نگه دارید؛ برای نمایش به کاربر، همان رشته با حذف پیشوند کافی است.
وقتی شرکت آگهی ندارد
برای شرکتی که سرویس مرجع آگهی‌ای از آن ندارد، پاسخ not_found میآید: HTTP ۲۰۰، ok: false و هزینه. این به معنای نبودن شرکت نیست. ممکن است سرویس اطلاعات ثبتی برای همان شناسه جواب موفق بدهد و این سرویس رکوردی نیابد. در رابط کاربری، «اطلاعاتی برای این شرکت ثبت نشده» را از خطای فنی جدا نشان دهید.
چه چیزی را نمی‌دهد
نحوهٔ امضای اسناد و حدود اختیار هر سمت در پاسخ نیست؛ سمت میآید ولی متن اساسنامه یا صورت‌جلسه نه. سهامداران، درصد سهام و نشانی مدیران هم در این پاسخ نیست. اینکه چه کسی «صاحب حق امضا» است را باید از مدارک شرکت یا مشاور حقوقی بپرسید.
کجا به کار میآید
- واحد حقوقی پیش از امضای قرارداد خریدنام امضاکننده با فهرست سمت‌های فعلی شرکت مقایسه می‌شود تا نماینده‌ای ناشناس پای سند نرود.
- تیم احراز هویت یک صرافی یا کارگزاریهنگام باز کردن حساب شرکتی، نام مدیرعامل اظهار‌شده با فهرست مدیران تطبیق می‌یابد.
- تحلیلگر ریسک در شرکت تأمین سرمایهاسم مدیران چند شرکت کنار هم گذاشته می‌شود تا نام‌های مشترک و گره‌های مالکیت پنهان پیدا شوند.
ورودی و خروجی
ورودی
companyNationalIdstringشناسهٔ ملی شخص حقوقییازده رقم.خروجی
board_membersarraycompany_titlestringنام شرکتقیمت و شرط پرداخت
قیمت هر فراخوان API اعضای هیئتمدیره ۷٬۷۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۷٬۷۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل می‌شود و اگر پاسخی نیاید، آزاد می‌شود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
چطور بفهمیم مدیرعامل یک شرکت کیست؟
فهرست board_members را بخوانید و ردیفی را بردارید که position آن مدیر عامل است. سمت‌ها با نوشتار متفاوت میآیند، پس متن را یکدست کنید و با شامل‌بودن عبارت بسنجید.
بازرس اصلی و علیالبدل هم در این پاسخ میآیند؟
بله. بازرس اصلی و علیالبدل در همان آرایهاند و فقط با فیلد position از مدیران جدا میشوند.
حق امضا یا نحوهٔ امضای اسناد را هم میدهد؟
نه. فقط سمت و تاریخ شروع و مدت تصدی را میدهد. نحوهٔ امضا و حدود اختیار در پاسخ نیست و باید از مدارک شرکت بیاید.
فیلد duration یعنی چه و چرا G: دارد؟
مدت تصدی است و رشتهٔ خام میآید، مثل «G:تا پایان سال مالی» یا «G:تا تاریخ ...». پیشوند G: جزئی از مقدار است و برای نمایش میتوانید حذفش کنید.
اگر شرکتی آگهی نداشته باشد چه پاسخی میآید؟
not_found با HTTP ۲۰۰ و ok: false. این پاسخ معتبر است و هزینه دارد. آن را از خطای فنی جدا نشان دهید.
شناسهٔ ملی شخص حقیقی هم قبول است؟
نه. ورودی شناسهٔ ملی شخص حقوقی یازدهرقمی است. کد ملی دهرقمی افراد برای این سرویس معتبر نیست.
فهرست اعضا هر بار تازه از مرجع گرفته می‌شود؟
نه همیشه. پاسخ تا چند روز ممکن است از کش بیاید و source.cached و source.fetchedAt این را نشان می‌دهند.
برای دیدن مدیران گذشته چه کنیم؟
سرویس تاریخچهٔ هیئتمدیره همین ساختار را با تاریخ پایان هر دوره میدهد. این سرویس فقط فهرست فعلی را میدهد.