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

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

1. id:

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

2. registrationNo:

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

3. title:

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

4. registrationTypeId:

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

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

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