أدلة السجل التجاري السعودي
تعرّف على الاستعلام عن سجلات المنشآت وربط واجهة API وفهم بيانات وزارة التجارة الرسمية المنشورة.
كيفية الاستعلام عن سجل تجاري سعودي
تعرّف على طريقة الاستعلام برقم السجل التجاري السعودي وقراءة بيانات المنشأة المنشورة والتحقق من فترة المصدر قبل استخدامها في إجراءات العمل.
اقرأ الدليلالفرق بين رقم السجل التجاري والرقم الوطني الموحد في السعودية
افهم أرقام السجلات التجارية والأرقام الوطنية الموحدة للمنشآت في السعودية، وميّزها عن أرقام الهوية الشخصية لاختيار مدخل الاستعلام الصحيح.
اقرأ الدليلتكامل واجهة برمجة تطبيقات السجل التجاري السعودي
أنشئ استعلامات سجلات تجارية سعودية من الخادم لتسجيل الموردين وعملاء المنشآت، مع مفاتيح API محمية ونتائج مؤرخة ومعالجة واضحة للأخطاء.
اقرأ الدليلفهم سجلات المنشآت السعودية الربع سنوية
اقرأ تقارير السجلات التجارية السعودية الربع سنوية وقارن أعداد السجلات المنشورة وافهم توزيعات الأشكال القانونية ورأس المال المسجل في سياق المصدر.
اقرأ الدليلأرقام المنشآت وأرقام السجل التجاري والهويات الشخصية
يتعامل سعودي سي آر برو مع معرّفات المنشآت فقط: رقم سجل تجاري من 10 خانات أو رقم وطني موحد لمنشأة.
الهويات الوطنية الشخصية وأرقام الإقامة فئة مختلفة من المعرّفات. وهي غير مدعومة ولا ينبغي إرسالها إلى هذه الخدمة.
أبقِ النوعين في حقلين منفصلين داخل أنظمتك. رقم المنشأة يحدد كياناً، والهوية الشخصية تحدد شخصاً.
فهم سجلات الوزارة المنشورة
تأتي النتائج من السجلات الرسمية المنشورة من وزارة التجارة التي استوردناها إلى قاعدة بياناتنا. تعرض كل نتيجة فترة البيانات ووقت الاستعلام.
سعودي سي آر برو خدمة مستقلة. تعكس النتائج الإصدار المنشور، ولا تشمل التغييرات التي جرت بعده.
لمعرفة الحالة الرسمية الحالية أو الحصول على مستخرج معتمد، استخدم خدمة الاستعلام لدى وزارة التجارة.
كيف تفسّر «موجود» و«غير موجود»
«موجود» يعني أن الرقم في اللقطة. ولا يثبت ذلك أن المنشأة نشطة.
«غير موجود» يعني أن الرقم غير موجود في تلك اللقطة. فالتسجيل الأحدث أو السجل الذي لا ينشره المصدر لن يظهر.
اعتبر «غير موجود» دافعاً لمزيد من التحقق، لا دليلاً على عدم وجود المنشأة.
من أين تأتي تحديثات اللقطة
ينشر المصدر بيانات السجل بجدول ربع سنوي. ويستورد المسؤول ملفاً ويربط أعمدته صراحةً ويسجّل الفترة ورابط المصدر الدقيق.
لا يُفعَّل الاستيراد إلا إذا فعّله المسؤول. والاستيراد الفاشل لا يغيّر اللقطة النشطة.
تظهر الفترة النشطة دائماً بجانب النتائج وفي بيانات الواجهة الوصفية.
أول استدعاء للواجهة من الخادم
أنشئ مفتاحاً في لوحة حسابك، ثم استدعِ GET /api/v1/lookup/{number} من خادمك باستخدام Authorization: Bearer أو x-api-key.
تعامل مع استجابتي «موجود» و«غير موجود»، واحفظ فترة اللقطة مع النتيجة التي تحتفظ بها.
لا تستدعِ الواجهة من شيفرة المتصفح.
أمان المفاتيح والحدود
تظهر المفاتيح مرة واحدة. احفظها في أسرار الخادم، لا في إدارة الإصدارات ولا شيفرة المتصفح ولا الروابط. دوّر المفتاح إن شككت في تسريبه.
تسمح الواجهة بـ 60 طلباً في الدقيقة لكل حساب، مع سقف تراكمي قدره 1,000,000 طلب بحث أو استعلام مقبول، مشترك بين المفاتيح والجلسات المخوّلة، ولا يُعاد ضبطه.
يخضع العرض التجريبي لحماية استخدام منصف مشتركة على مستوى الخدمة واليوم والساعة. إذا قُيّد الطلب، فاتبع Retry-After عند توفرها.