API استعلام اطلاعات صنف

فروشنده‌ای حقیقی که شرکت ندارد، با «جواز کسب» وارد بازارگاه شما می‌شود. شناسهٔ ملی شرکت برایش وجود ندارد، اما شناسهٔ صنفی ده‌رقمی دارد. این سرویس با همان شناسه، مشخصات پروانه را از سرویس مرجع می‌گیرد و برمی‌گرداند.

ورودی تنها guildCode است و باید ده رقم باشد. فهرست فیلدهای خروجی در data از این قرار است: guild_code، business_name، owner_name، father_name، union_name، business_type، license_state، license_issue_date، license_expire_date، province، city، address، postal_code و phone_number.

کد ملی و موبایل دارنده در پاسخ نیست

نام و نام پدر دارنده می‌آید، اما کد ملی و موبایل او عمداً در خروجی نیست. اگر محصولتان برای ثبت‌نام کد ملی دارنده را لازم دارد، از سرویس هویت جداگانه‌ای بگیرید، نه از این پاسخ. نام دارنده را هم نباید تنها مبنای هویت‌سنجی بگیرید، چون نام تکراری زیاد است.

فیلد غایب با فیلد خالی فرق دارد

فیلدی که مرجع مقداری برایش نداشته باشد، ممکن است اصلاً در data نیاید. کدتان باید برای هر فیلد پیش‌فرض داشته باشد و فرض نکند business_type یا phone_number همیشه هست. اگر دارندهٔ شناسه بیش از یک پروانه داشته باشد، فیلدهای بالا مال پروانهٔ اول‌اند و فهرست همهٔ پروانه‌ها جدا در licenses می‌آید؛ با یک پروانه این آرایه نمی‌آید.

تاریخ انقضا را خودتان بسنجید

license_state عبارت متنی مرجع است و license_expire_date تاریخ انقضا. پروانه‌ای که وضعیتش معتبر اعلام شده ولی تاریخ انقضایش گذشته، حالتی است که محصولتان باید برایش تصمیم داشته باشد. قالب تاریخ‌ها را در پاسخ واقعی خودتان ببینید و پیش از مقایسه، به تاریخ تبدیل کنید.

تازگی و هزینه

این سرویس کش ندارد و هر فراخوان به مرجع می‌رسد. هزینه به‌ازای هر پاسخ موفق است و رکوردنیافتن هم، چون استعلام انجام شده، هزینه دارد.

چه چیزی را نمی‌دهد

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