استعلام اطلاعات شرکتها
خدمتدهنده
رسمیو
مقدمه
در این سرویس امکان استعلام اطلاعات اصناف و شرکت ها بر اساس شناسه ملی شرکت و شخص آخرین تغییرات روزنامه رسمی کشور فراهم می نماید.
پیش از شروع
- URL فراخوانی سرویسها:
Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall
Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall
- تمامی درخواستها با متد POST ارسال میشوند.
- فیلدهای زیر درHeader تمامی درخواستها ثابت است:
پارامتر | توضیحات |
_token_ | توکن کسبوکاری دریافتی از پنل |
_token_issuer_ | مقدار ثابت "1" |
- فیلدهای زیر در بدنهی تمامی درخواستها ثابت است (با فرمت x-www-form-urlencoded):
پارامتر | توضیحات |
scProductId | شناسهی سرویس مدنظر |
scApiKey | راهنمای دریافت این پارامتر در این لینک موجود است. |
- علاوه بر موارد بالا که ثابت هستند، اگر سرویس نیاز به پارامتر دیگری داشته باشد در داکیومنت مربوطه ذکر شده است.
- خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.
نکته: پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی میکنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتساپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.
استعلام اصناف یک کد ملی
این سرویس با توجه به اصناف ثبت شده هر شخص در مرجع رسمی سازمان های صنفی کشور، لیست اصناف هر شخص و اطلاعات هر واحد صنفی را برمیگرداند.
-
شناسه سرویس : 2396696
- شناسه سرویس سندباکس: 165112
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
PersonId | String | اجباری | کد ملی شخص |
- پارامتر های خروجی :
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result :
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
- مشخصات پارامتر پاسخ
نام پارامتر | نوع | توضیحات |
SenfId | String | شناسه صنفی |
Company | String | شناسه ملی یا نام شرکت صاحب واحد صنفی |
نکته: در بعضی واحدهای صنفی قدیمی، شناسه ملی شرکت ثبت نشده و فقط نام شرکت ثبت شده است.
مجوزهای صنفی یک فرد
این سرویس با توجه به اصناف ثبت شده هر شخص در مرجع رسمی سازمان های صنفی کشور، لیست اصناف هر شخص و اطلاعات هر واحد صنفی را برمیگرداند.
-
شناسه سرویس : 2396760
- شناسه سرویس سندباکس: 165113
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
SenfId | String | اجباری | شناسه صنفی |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result :
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
مشخصات پارامتر پاسخ
نام پارامتر | نوع | توضیحات |
Id | String | شناسه صنفی |
RequestType | String | آخرین نوع تقاضا )مثل صدور یا تمدید( |
LicenseRequestType | String | نوع پروانه |
PersonalityType | String | نوع شخصیتی )حقیقی/حقوقی( |
IssueDate | String | تاریخ صدور |
ExpireDate | String | تاریخ انقضا |
LicenseStatus | String | وضعیت پروانه |
JobType | String | نوع فعالیت )تولیدی/توزیعی( |
CardPaymentStatus | String | آخرین وضعیت پردات ح ق عضویت |
FullName | String | نام متقاضی |
Guild | String | رسته |
IsicCoding | String | کد آیسیک |
UnitOstan | String | استان واحد صنفی |
UnitShahrestan | String | شهر ستان واحد صنفی |
UnitShahr | String | شهر واحد صنفی |
Address | String | آدرس واحد صنفی |
PhoneNo | String | تلفن واحد صنفی |
PostalCode | String | کد پستی واحد صنفی |
OrganStruct | String | سازمان صادر کننده |
Organ | String | عنوان اتحادیه |
Ostan | String | استان اتحادیه |
Shahrestan | String | شهرستان اتحادیه |
OrganAddress | String | آدرس اتحادیه |
Phone | String | تلفن تحادیه |
صاحبین امضا شرکت
این سرویس با توجه به آخرین آگهی روزنامه رسمی هر شرکت مبنی بر معرفی صاحبین امضا و تحلیل آن، اطلاعات تحلیل شده آن را در خروجی ارسال می کند. بر اساس متون اعلام صاحبین امضا در آگهی ها، سه حالت پرکاربرد وجود دارد که اکثر شرکت ها از آنها استفاده میکنند
- صاحبین امضا برای اسناد مالی تعهدآور
- صاحبین امضا برای اسناد عادی
- صاحبین امضا برای همه انواع اسناد در هر آگهی ممکن یک حالت یا بیشتر از این انواع استفاده شود.
به همین جهت هر سه این مورد به صورت آرایه ای از اشخاص معرفی شده در خروجی آورده می شود. برای مثال (که در پایین هم آورده شده است) صاحبین امضای اسناد مالی تعهدآور، اشخاص A و B باشند که در این متن توضیحی درباره اسناد عادی ذکر نشده و در جمله دیگری راجع به اسناد عادی نوشته شده باشد که در آن راجع به اسناد مالی توضیحی داده نشده است.
-
شناسه سرویس : 2396655
- شناسه سرویس سندباکس: 165114
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
CompanyId | Integer | اجباری | شناسه ملی شرکت |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result:
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
- مشخصات پارامتر پاسخ:
نام پارامتر | نوع | توضیحات |
ad number | String | شناسه صنفی |
Obligatory Signature Holders | String | آخرین نوع تقاضا )مثل صدور یا تمدید( |
Normal Signature Holders | String | نوع پروانه |
signature item full text | String | نوع شخصیتی )حقیقی/حقوقی( |
Obligatory and Normal Signature Holders | String | تاریخ صدور |
newspaperDate | String | تاریخ انقضا |
newsletterDate | String | وضعیت پروانه |
minutesDate | String | نوع فعالیت )تولیدی/توزیعی( |
نکته: در بعضی شرکتها سخت گیری کمتری برای صاحبین امضا دارند و ممکن است از اعضای غیر رسمی شرکت مانند مدیر مالی یا قائم مقام نام ببرند.
حالت دیگر این است که یکی یا چند نفر از صاحبین امضا را از بین گروهی از افراد انتخاب کنند.
ساده ترین آن "احدی از مدیران" یا "یکی از اعضا هیئت مدیره" است و حالت های پیچیده تر نیز وجود دارد: تعریف گروه الف و ب و انتخاب "یکی از اعضای گروه الف و دو نفر از اعضای گروه ب به همراه مدیرعامل و مهر شرکت".
در این شرایط به دلیل پیچیدگی و حساسیت موضوع، نیاز به خواندن متن اصلی (Full text) است.
در این شرایط، با توجه به تنوع و استثناهای متعدد و امکان جایگزینی افراد بدون سمت رسمی، نیاز به خواندن متن اصلی (Full Text) است.
دریافت اطلاعات کلی شرکت
این سرویس برای دریافت اخرین آگهی های شرکت و همچنین مشخصات ثبتی آن استفاده میشود
-
شناسه سرویس : 2396648
- شناسه سرویس سندباکس: 165115
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
companyid | String | اجباری | شناسه ملی شرکت |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
پارامتر های پاسخ سرویس در Result :
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
دریافت آگهیهای روزنامه رسمی شرکت
این سرویس برای دریافت اخرین آگهی های شرکت استفاده میشود.
-
شناسه سرویس : 2396649
- شناسه سرویس سندباکس: 165116
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
companyid | String | اجباری | شناسه ملی شرکت |
- پارامتر های خروجی :
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result :
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
اطلاعات اعضای هیئت مدیره شرکت
این سرویس برای دریافت اعضا و سهام داران یک شرکت استفاده میشود.
-
شناسه سرویس : 2396654
- شناسه سرویس سندباکس: 165117
- پارامتر ورودی سرویس:
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
companyid | String | اجباری | شناسه ملی شرکت |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result:
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
استعلام شرکتهای یک فرد
-
شناسه سرویس : 2396656
- شناسه سرویس سندباکس: 165118
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
nationalid | String | اجباری | کد ملی شخص |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result:
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
استعلام جزئیات آگهی تغییرات شرکت
-
شناسه سرویس : 2396657
- شناسه سرویس سندباکس: 165119
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
Newsid | String | اجباری | شناسه آگهی تغییرات |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result:
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
جستجوی نام شرکت یا اشخاص حقیقی و حقوقی
توسط این سرویس امکان جستجوی نام شرکت ها ، اشخاص حقیقی و حقوقی می باشد. با این تفاوت که در پاسخ سرویس تمام شرکت هایی که در لیست اعضا یا نام آن به کار رفته باشد بازگردانده می شود.
-
شناسه سرویس : 2396658
- شناسه سرویس سندباکس: 165120
- پارامتر ورودی سرویس
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
Name | String | اجباری | نام شخص |
- پارامتر های خروجی:
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result:
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
استعلام مجوزهای یک شرکت
-
شناسه سرویس : 2396660
- شناسه سرویس سندباکس: 165121
- پارامتر ورودی سرویس:
نام پارامتر | نوع | اختیاری / اجباری | توضیحات |
companyid | String | اجباری | شناسه ملی شرکت |
- پارامتر های خروجی :
نام پارامتر | نوع | توضیحات |
hasError | bool | نشان دهنده ی این است که آیا سرویس با موفقیت از روی پلتفرم پاد فراخوانی شده است یا خیر. |
messageId | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
referenceNumber | string | شناسه ی درخواست در پلتفرم پاد. |
errorCode | int | کد ارور پلتفرمی. |
Count | int | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Ott | string | پارامتر درون پلتفرمی ای که با توجه به این سرویس خاص موضوعیت ندارد. |
Result | object | نتیجه ی فراخوانی سرویس در این آبجکت نمایش داده می شود که در ادامه شرح داده خواهد شد. |
نکته: طبق موارد مطرح شده، پاسخ مد نظر سرویس دریافت اطلاعات آدرس در فیلد result موجود است.
به صورت دقیق تر، بدنه ی پاسخ را میتوان در فیلد result مشاهده کرد که دارای ساختار زیر است:
- پارامتر های پاسخ سرویس در Result:
به صورت کلی پاسخ خروجی result صورتی زیر میباشد.
کدهای خطای سرویس اصلی
کد خطا | عنوان | توضیحات |
429 | اتمام اعتبار |
|
121 | خطایrovider |
|
122 | خطایrovider |
|
123 | خطایrovider |
|
124 | خطایrovider |
|
125 | خطایrovider |
|
101 | شناسه ملی اشتباه |
|
102 | شرکت بدون هیچ آگهی |
|
103 | شرکت بدون آگهی از نوع تغییر صاحبین امضا |
|