0

توضیحات فیلدهای خروجی وب سرویس اطلاعات شرکت‌ها

  • مستندات API

در این قسمت به بررسی دقیق‌تر جزئیات خروجی‌های وب سرویس اطلاعات شرکت‌ها (Company Info API) می‌پردازیم. این وب سرویس اطلاعات ثبت‌شده شرکت‌ها از جمله شناسه ملی، شماره ثبت، تاریخ ثبت، سرمایه، و وضعیت شرکت را به شما ارائه می‌دهد.

1. id:

  • نوع: عدد
  • توضیح: شناسه ملی شرکت که به عنوان کلید اصلی برای شناسایی شرکت در سیستم استفاده می‌شود.

2. registrationNo:

  • نوع: متن
  • توضیح: شماره ثبت شرکت که توسط اداره ثبت شرکت‌ها و موسسات غیرتجاری صادر شده است.

3. title:

  • نوع: متن
  • توضیح: نام رسمی شرکت که در سیستم ثبت شده است.

4. registrationTypeId:

  • نوع: عدد
  • توضیح: شناسه نوع ثبت شرکت (مثلاً شرکت سهامی خاص یا مسئولیت محدود).

انواع آن به شرح زیر است:

Id Title
1 نامشخص
2 موسسه
3 تعاونی
4 سهامی عام
5 سهامی خاص
6 بامسئولیت محدود
19 شعبه شرکت خارجی
20 مختلط غیر سهامی
21 صندوق سرمایه گذاری
22 نسبی
23 تضامنی
24 نمایندگی شرکت خارجی
25 مختلط سهامی
46 واحد عملیاتی دستگاه اجرایی
47 شعبه خارجی
48 دهیاری
50 مرکز
53 اداره کل
60 نهاد
61 سازمان های وابسته به شهرداری
62 سازمان
64 دفتر معاونت
67 وزارت
73 سازمان های وابسته به استان
81 سهامی زراعی
90 نمایندگی موسسه غیرتجاری خارجی
103 تعاونی سهامی عام
115 عادی
116 دولتی
117 شرکت بامسیولیت محدود
118 شهرداری
119 نهاد عمومی غیردولتی
120 بیمارستان
121 شرکت سهامی زراعی
122 وزارتخانه
123 موسسه دولتی
124 نظام  حرفه ای
125 انجمن
160 مدارس حوزه‌های علمیه برادران
161 دفتر حوزه
162 کانون
163 انجمن صنفی کارفرمایی یا کانون های مربوط
164 مدیریت
165 دانشگاه
166 حوزه علمیه
167 شناسه ملی نامعتبر

5. registrationDate:

  • نوع: تاریخ (فرمت YYYY-MM-DD)
  • توضیح: تاریخ رسمی ثبت شرکت.

6. capital:

  • نوع: عدد
  • توضیح: سرمایه ثبتی شرکت به واحد ریال.

7. address:

  • نوع: متن
  • توضیح: آدرس رسمی ثبت‌شده شرکت.

8. postalCode:

  • نوع: متن
  • توضیح: کد پستی شرکت.

9. taxNumber:

  • نوع: متن
  • توضیح: کد اقتصادی شرکت که برای امور مالیاتی استفاده می‌شود.

10. lat/lng:

  • **نوع:** عدد اعشار
  • **توضیح**: عرض و طول جغرافیایی محل ثبت شرکت (در صورت وجود)

11. website:

  • **نوع:** متن
  • **توضیح:** وبسایت شرکت (در صورت وجود)

12. tel/fax/mobile:

markdownCopy code- **نوع**: متن- **توضیح**: شماره‌های تماس، فکس و موبایل ثبت‌شده شرکت.

13. email:

markdownCopy code- **نوع**: متن
- **توضیح**: ایمیل رسمی شرکت.

14. status:

markdownCopy code- **نوع**: متن
- **توضیح**: وضعیت ثبت شرکت (فعال، منحل‌شده و غیره).

15. edareKol:

markdownCopy code- **نوع**: متن
- **توضیح**: اداره کل ثبت شرکت‌ها که مسئولیت ثبت شرکت را داشته است.

16. vahedSabti:

markdownCopy code- **نوع**: متن
- **توضیح**: واحد ثبتی شرکت در زیر مجموعه اداره کل ثبت.

17. lastUpdate:

markdownCopy code- **نوع**: تاریخ
- **توضیح**: تاریخ آخرین به‌روزرسانی اطلاعات شرکت.

18. pictureUrl:

markdownCopy code- **نوع**: متن (URL)
- **توضیح**: لینک تصویر ثبت‌شده شرکت (در صورت وجود).

19. persianRegistrationDate:

markdownCopy code- **نوع**: تاریخ (تقویم شمسی)
- **توضیح**: تاریخ ثبت شرکت به تقویم شمسی.

نکات کلیدی:

  1. استفاده از تاریخ‌های شمسی و میلادی: در این وب سرویس، تاریخ ثبت شرکت به هر دو فرمت شمسی و میلادی ارائه می‌شود. شما می‌توانید با توجه به نیاز خود از فرمت مناسب استفاده کنید.
  2. اعتبارسنجی داده‌های تماس: اطلاعات تماس شرکت‌ها ممکن است خالی باشد یا در برخی موارد تغییر کرده باشد، بنابراین قبل از استفاده از این اطلاعات در سیستم‌های خود، بهتر است صحت آن‌ها بررسی شود.
  3. سرمایه و وضعیت شرکت: اطلاعات مربوط به سرمایه شرکت و وضعیت ثبت آن، برای تحلیل‌های حقوقی و مالی بسیار مفید هستند. شما می‌توانید از این داده‌ها برای بررسی ثبات و سلامت مالی شرکت استفاده کنید.

نمونه درخواست و پاسخ

درخواست:

curl --location --request GET 'https://api.rasm.io/API/Company/14009396050' \
--header 'X-Key: {{XKEY}}'

پاسخ نمونه:

{
    "id": 14009396050,
    "registrationNo": "564196",
    "title": "پیشگامان رسمی پردازش دانا",
    "registrationTypeId": 5,
    "registrationDate": "2020-08-31T00:00:00",
    "capital": 1000000000,
    "address": "تهران، خیابان سهروردی شمالی، پلاک 15",
    "postalCode": "1577956614",
    "taxNumber": "14009396050",
    "lat": null,
    "lng": null,
    "website": null,
    "tel": "02191304041",
    "fax": null,
    "mobile": null,
    "email": "salam@rasm.io",
    "status": "فعال",
    "edareKol": "اداره کل ثبت شرکت‌ها و موسسات غیرتجاری",
    "vahedSabti": "اداره ثبت شرکت‌های غیرتجاری تهران",
    "lastUpdate": "2022-06-19T00:00:00",
    "persianRegistrationDate": "1399/6/10"
}

نتیجه‌گیری:

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

دسته‌بندی‌ها
  • مستندات API