API تاریخچه هیئتمدیره
دوره‌های تصدی پیشین مدیران و بازرسان یک شرکت را با تاریخ شروع و پایان هر دوره برمی‌گرداند.
این سرویس چه میکند
قراردادی در سال ۱۳۹۸ امضا شده و امروز کسی ادعا میکند امضاکننده آن موقع مدیرعامل نبوده. فهرست فعلی هیئتمدیره این را نمی‌تواند جواب بدهد، چون فقط ترکیب امروز را نشان میدهد. این سرویس همهٔ دوره‌ها را با start_date و end_date میدهد.
ورودی فقط شناسهٔ ملی شرکت است. خروجی در board_members آرایه‌ای است که ردیف‌هایش name، position، start_date، end_date و duration دارند.
یک شخص، چند ردیف
در نمونهٔ پاسخ، یک سمت در چند دوره تکرار می‌شود: بازرسها هر سال دوباره می‌آیند و مدیران هر دو سال. اگر با گروه‌بندی بر اساس نام و سمت جمع بزنید، دوره‌های جدا به هم می‌چسبند. گروه را بر اساس نام، سمت و start_date بسازید.
نوشتار سمت و نام یکدست نیست
یک سمت می‌تواند با نوشتارهای مختلف بیاید. در نمونه، «رییس هییت مدیره» و «رییس هیأت مدیره»، و «بازرس علی البدل» و «بازرس علی‌البدل» هر دو دیده میشوند. پیش از گروه‌بندی یا فیلتر، نویسهها و فاصله‌ها را یکدست کنید. duration هم متن آزاد است، مثل «2 سال» یا «1 سال مالی»، و نباید عدد فرضش کرد.
ترکیب در یک تاریخ مشخص
برای یافتن ترکیب در روز معین، ردیفهایی را نگه دارید که start_date آنها از آن روز بیشتر نباشد و end_date از آن کمتر نباشد. قالب تاریخ سال/ماه/روز با صفر پیشین است، پس مقایسهٔ رشته‌ای هم ترتیب درست میدهد. با این حال برای محاسبه‌های دیگر بهتر است به تاریخ واقعی تبدیل کنید.
چه چیزی را نمی‌دهد
دلیل پایان دوره را نمی‌گوید؛ استعفا، عزل و پایان مدت قانونی همه یک تاریخ پایان‌اند. سهامداران و تغییر سهام هم نیست. ترکیب فعلی را هم برای همین سرویس فرض نکنید: برای فهرست امروز از سرویس اعضای هیئتمدیره استفاده کنید. شرکتی که آگهی ندارد، پاسخ not_found می‌گیرد که هزینه دارد.
کجا به کار میآید
- وکیل یا کارشناس دعاوی تجاریبرای اثبات سمت امضاکننده در تاریخ یک قرارداد قدیمی، ردیف دورهٔ مربوط را از تاریخچه بیرون می‌کشد.
- شرکت تأمین مالی جمعیثبات مدیریتی پروژه را از تعداد دفعات تغییر مدیرعامل و رئیس هیئتمدیره در چند سال اخیر می‌سنجد.
- واحد بازرسی داخلی یک بانکدر پرونده‌ای که به سال‌ها پیش برمی‌گردد، مدیران همان دوره را شناسایی میکند، نه مدیران امروز.
ورودی و خروجی
ورودی
companyNationalIdstringشناسهٔ ملی شخص حقوقییازده رقم.خروجی
board_membersarraycompany_titlestringنام شرکتقیمت و شرط پرداخت
قیمت هر فراخوان API تاریخچه هیئتمدیره ۱۴٬۰۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۱۴٬۰۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل می‌شود و اگر پاسخی نیاید، آزاد می‌شود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
چطور بفهمیم در سال خاصی مدیرعامل شرکت چه کسی بوده؟
تاریخچه را بگیرید و ردیفهایی را نگه دارید که start_date آنها از آن سال بیشتر نباشد و end_date از آن کمتر نباشد. سپس سمت مدیرعامل را بین آنها پیدا کنید.
سوابق هیئتمدیره شرکت شامل چه اطلاعاتی است؟
هر ردیف نام، سمت، تاریخ شروع، تاریخ پایان و مدت تصدی را دارد. هر دورهٔ تصدی یک ردیف جدا است.
چرا یک نفر چند بار در فهرست آمده؟
چون هر دوره یک ردیف است. بازرسها هر سال و مدیران هر چند سال تمدید میشوند و هر تمدید ردیف تازهای میسازد.
دلیل تغییر مدیران هم مشخص است؟
نه. استعفا، عزل و پایان مدت همه فقط با یک تاریخ پایان دیده میشوند.
چرا سمتها در پاسخ یکدست نیستند؟
چون متن سمت از مرجع همانطور که ثبت شده میآید. «رییس هییت مدیره» و «رییس هیأت مدیره» هر دو دیده میشوند. پیش از فیلتر، نویسهها را یکدست کنید.
ترکیب فعلی هم در همین سرویس است؟
برای ترکیب امروز سرویس اعضای هیئتمدیره را فراخوانی کنید. این سرویس برای زمانهاست و ردیف فعلی را جدا مشخص نمیکند.
برای شرکت بدون آگهی چه پاسخی میآید؟
پاسخ not_found با HTTP ۲۰۰ و ok: false که هزینه دارد. این یک نتیجهٔ معتبر است، نه خطای فنی.
پاسخ تاریخچه تا چه حد تازه است؟
چون گذشته کم تغییر میکند، پاسخ ممکن است تا حدود یک ماه از کش بیاید. source.fetchedAt زمان واقعی را نشان میدهد.