API استعلام اطلاعات شرکت
اطلاعات ثبتی یک شخص حقوقی را با شناسه ملی یازدهرقمی برمیگرداند: نام، نوع، شمارهٔ ثبت، نشانی و کد پستی.
این سرویس چه می‌کند
مشتری حقوقی در فرم ثبت‌نام نام شرکت را «راهکار نوین هیوا» می‌نویسد و شناسهٔ ملی را در کادر بعد. اینکه این دو به هم بخورند را نمیشود از روی ظاهر فرم فهمید، اما یک فراخوان به این سرویس نام ثبتی همان شناسه را در name برمیگرداند و مقایسه با آنچه کاربر نوشته را ممکن می‌کند.
خروجی اطلاعات ثبتی است، نه گزارش وضعیت مالی یا فعالیت؛ هدف سرویس این است که پیش از قرارداد و فاکتور، طرف مقابل را با شناسه‌اش به یک نام و یک نشانی ثبتی وصل کنید.
ورودی و اولین خطا
ورودی companyNationalId است، یازده رقم. سرویس فقط طول را میسنجد و رقم کنترل را بررسی نمی‌کند؛ شناسهٔ یازده‌رقمیِ غلط تا سرویس مرجع می‌رود و همان‌جا با خطای شناسهٔ نامعتبر رد میشود. این خطا برای شما invalid_input است و هزینه‌ای ندارد.
فیلدهای پاسخ و فیلدهای خالی
در data این‌ها را انتظار داشته باشید: name، company_type، national_id، register_number، register_date، postal_code و address. بعضی پاسخ‌ها فیلدهای بیشتری دارند: issuance_date، created_at، phone_number، fax_number، email_address و activity_end_date. در نمونهٔ پاسخ، ایمیل و فکس رشتهٔ خالی‌اند، تلفن null است و تاریخ پایان فعالیت خالی است. پس کدتان نباید وجود تلفن یا ایمیل را شرط ادامهٔ کار کند. created_at ساعت هم دارد و قالبش با register_date فرق می‌کند؛ هر دو را با هم مقایسه نکنید.
مصرف کش و هزینه
اطلاعات ثبتی کند تغییر می‌کند، پس پاسخ تا چند روز ممکن است از کش بیاید. source.fetchedAt می‌گوید داده مال چه زمانی است. هزینه به‌ازای هر پاسخ موفق است؛ مبلغش در billing.amountRial می‌آید.
چه چیزی را نمی‌دهد
اعضای هیئتمدیره، بازرسان و حق امضا در این پاسخ نیستند و سرویس جداگانه‌ای دارند. بدهی مالیاتی، سابقهٔ چک برگشتی و اعتبار مالی شرکت هم نیست. وضعیت فعال یا منحل‌بودن را هم صریح نمی‌گوید؛ فقط فیلد activity_end_date هست که در صورت پر بودن باید خودتان معنا کنید.
کجا به کار می‌آید
- واحد مالی یک شرکت بازرگانیپیش از صدور فاکتور برای مشتری حقوقی، نام ثبتی و نشانی را با اطلاعات وارد‌شده در سفارش تطبیق میدهد.
- کارگزار بیمهٔ شرکتیهنگام صدور بیمه‌نامه برای شرکت، شناسه ملی و نام ثبتی در پرونده با پاسخ سرویس یکی میشود و غلط تایپی همان لحظه پیدا میشود.
- پلتفرم تأمین مالی زنجیره‌ایپیش از افزودن تأمین‌کننده یا خریدار به شبکه، وجود شخص حقوقی با شناسه‌اش بررسی و شمارهٔ ثبت ذخیره میشود.
ورودی و خروجی
ورودی
companyNationalIdstringشناسهٔ ملی شخص حقوقییازده رقم.خروجی
activity_end_datestringaddressstringاستان تهران، شهرستان تهران، بخش مرکزی، شهر تهران، انقلاب-فلسطین، خیابان 12 فروردین، خیابان انقلاب اسلامی، پلاک 1500، طبقه 1، واحد 1company_typestringشرکت سهامی خاصcreated_atstring1400/01/01-12:00email_addressstringfax_numberstringissuance_datestring1400/01/01namestringراهکار نوین هیواnational_idstring1400XXXXXX0phone_numbernullpostal_codestring131XXXXXX3register_datestring1400/01/01register_numberstring43XXX0قیمت و شرط پرداخت
قیمت هر فراخوان API استعلام اطلاعات شرکت ۷٬۷۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۷٬۷۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینه‌ای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
استعلام شرکت با شناسه ملی چه چیزی برمیگرداند؟
نام، نوع شرکت، شمارهٔ و تاریخ ثبت، نشانی و کد پستی را برمیگرداند. بسته به پاسخ مرجع، تلفن، فکس، ایمیل و تاریخ پایان فعالیت هم ممکن است بیاید.
شناسه ملی شرکت چند رقم است؟
یازده رقم. سرویس فقط طول را میسنجد؛ شناسهٔ یازدهرقمی غلط به سرویس مرجع میرسد و خطای ورودی نامعتبر میگیرد که هزینه ندارد.
میشود شرکت را با نام یا شمارهٔ ثبت جستوجو کرد؟
نه. ورودی فقط شناسهٔ ملی یازدهرقمی است. جستوجو با نام یا شمارهٔ ثبت در این سرویس نیست.
آیا فعال یا منحل‌بودن شرکت را می‌گوید؟
صراحتاً نه. فقط activity_end_date در پاسخ هست و گاهی خالی است. وضعیت فعالیت را نباید از خالی‌بودن یک فیلد نتیجه گرفت.
اعضای هیئتمدیره در همین پاسخ هستند؟
نه. آنها را سرویس جداگانهٔ اعضای هیئتمدیره با همان شناسهٔ ملی میدهد.
چرا تلفن یا ایمیل شرکت گاهی خالی است؟
چون در نمونهٔ پاسخ هم ایمیل و فکس رشتهٔ خالی و تلفن null است. کدتان باید نبودِ این فیلدها را عادی بداند.
داده‌ای که برمی‌گردد آخرین وضعیت ثبتی است؟
نه الزاماً. پاسخ ممکن است تا چند روز از کش بیاید. source.cached و source.fetchedAt مشخص می‌کنند داده مال چه زمانی است.
اگر موجودی کم باشد چه میشود؟
پاسخ ۴۰۲ با کد insufficient_funds میگیرید و چیزی از حساب کسر نمیشود. بعد از شارژ میتوانید دوباره بفرستید.