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

استعلام اطلاعات شرکت یک ورودی دارد: شناسه ملی شرکت. با همین یک عدد، مشخصات ثبتی و نشانی شرکت برمی‌گردد.

شناسه ملی شرکت چند رقم است؟

۱۱ رقم.

این با کد ملی اشخاص که ده رقم است فرق دارد. اگر عدد ده‌رقمی بفرستید، API ردش می‌کند.

چرا API فقط طول را بررسی می‌کند

کد ملی اشخاص یک رقم کنترلی دارد که بررسی‌اش قطعی است، پس API می‌تواند پیش از استعلام غلط تایپی را بگیرد.

برای شناسه ملی اشخاص حقوقی، الگوریتم رقم کنترلی در منابع عمومی یکدست نیست. عمداً هیچ الگوریتمی را حدس نزده‌ایم، چون الگوریتم غلط، شناسه‌های درست را رد می‌کند.

نتیجه‌اش این است: اگر شناسه از نظر ساختاری اشتباه باشد، این را از پاسخ استعلام می‌فهمیم نه از اعتبارسنجی ورودی. در آن حالت پاسخ invalid_input برمی‌گردد و هزینه‌ای کسر نمی‌شود: بابت استعلامی که به‌خاطر ورودی نامعتبر انجام نشده، پول نمی‌گیریم.

در نتیجه چه می‌آید

• نام شرکت
• نوع شرکت، مثلاً سهامی خاص
• شماره ثبت
• تاریخ ثبت
• تاریخ صدور
• نشانی کامل
• کد پستی
• شماره تلفن
• شماره فکس
• نشانی ایمیل
• تاریخ پایان فعالیت، اگر ثبت شده باشد

بعضی فیلدها ممکن است خالی باشند

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

تاریخ پایان فعالیت هم معمولاً خالی است؛ پرشدنش حالت خاص است، نه حالت عادی.

شناسه ملی و شماره ثبت یکی نیستند

هر دو در پاسخ می‌آیند و اشتباه‌گرفتنشان رایج است:

• شناسه ملی همان عدد ۱۱ رقمی است که برای استعلام وارد می‌کنید و در سراسر کشور یکتاست.
• شماره ثبت عددی است که هنگام ثبت شرکت به آن داده شده و معمولاً کوتاه‌تر است.

با شماره ثبت نمی‌توانید این استعلام را انجام دهید.

هیئت‌مدیره در این نتیجه نیست

اعضای هیئت‌مدیره و تاریخچه تغییراتشان، هر کدام سرویس جداگانه‌ای دارند، با همان ورودی شناسه ملی ۱۱ رقمی.

اگر این را در برنامه‌تان لازم دارید، استعلام اطلاعات شرکت همان کار را با API انجام می‌دهد.