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

در این قسمت به بررسی دقیق‌تر جزئیات خروجی‌های وب سرویس اطلاعات شرکت‌ها (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 را به‌درستی تحلیل کرده و در سیستم‌های خود استفاده کنید. برای کاربردهای بیشتر، می‌توانید از ترکیب این اطلاعات با سایر داده‌های مربوط به شرکت‌ها بهره‌مند شوید.