API استعلام شخص حقوقی
استعلام شخص حقوقی با API بازارپی: اطلاعات پایه ثبتی شرکت را از روی شناسه ملی بگیرید؛ مناسب احراز هویت مشتریان سازمانی.
سرویس استعلام شخص حقوقی اطلاعات پایه ثبتی یک شرکت را از روی شناسه ملی آن برمی‌گرداند. با این سرویس می‌توانید اطلاعات مشتریان یا تأمین‌کنندگان سازمانی را هنگام ثبت‌نام بررسی کنید و نام و مشخصات ثبتی درست را در قرارداد یا فاکتور به کار ببرید.
درخواست با متد GET به مسیر /ide/v1/services/identity/legal ارسال میشود. افزودنی‌هایی مانند مدیرعامل، اعضای هیئت مدیره و صاحبان امضای مجاز با پارامترهای جداگانه (مثلاً ceo=true) درخواست می‌شوند و هر افزودنی جداگانه محاسبه میشود.
برای استفاده، در بازارپی ثبت‌نام کنید، سرویس را درخواست دهید و پس از تأیید، کلید API بسازید. یک جفت کلید برای همه سرویس‌ها کار میکند، دسترسی هر کلید را می‌توانید به IP سرورهای خود محدود کنید و با «کلید تست» پاسخ نمونه بدون کسر هزینه بگیرید. هزینه به ریال و فقط برای درخواست‌های موفق از کیف پول (پیش‌پرداخت) یا سقف اعتبار (پس‌پرداخت) کسر میشود؛ خطاهای سمت ارائه‌دهنده (۵xx) هرگز محاسبه نمی‌شوند.
کاربردها
- احراز هویت مشتریان سازمانی هنگام ثبت‌نام
- بررسی مشخصات ثبتی تأمین‌کننده یا طرف قرارداد
- ثبت نام رسمی شرکت در فاکتور و قرارداد
سرویس‌ها و قیمت
جزئیات کامل درخواست و پاسخ در مرجع API و نحوه دریافت توکن در راهنمای فنی آمده است.
سؤالات متداول
ورودی سرویس چیست؟
شناسه ملی شخص حقوقی.
پارامتر ceo=true چه تأثیری در هزینه دارد؟
در این حالت درخواست دو سرویس را مصرف میکند و هزینه هر دو محاسبه میشود.
هزینه این سرویس چطور محاسبه میشود؟
قیمت هر سرویس به ریال در همین صفحه و کاتالوگ آمده است. فقط درخواست‌های موفق (و طبق قوانین هر سرویس) محاسبه می‌شوند، خطاهای سمت ارائه‌دهنده و قطعی ارتباط هرگز هزینه ندارند و مالیات بر ارزش افزوده جداگانه در صورتحساب می‌آید.