توفر واجهة برمجة التطبيقات لكتالوج المنتجات من شركة Schneider Electric للموزعين والشركاء القدرة على استرداد بيانات عروض المنتجات.
تم تحديث هذا الإصدار الجديد إلى إيتيم-9.0 (المعيار الدولي لتصنيف المنتجات التقنية).
حاليًا، تتمتع واجهة برمجة التطبيقات بالقدرة على:
1- ستتم إعادة جميع المنتجات المشمولة في نطاق الموزع مع المعلومات الضرورية الأخرى إذا قدمنا مُعرِّف المورد، مُعرِّف العميل، نوع مُعرِّف المورد، ونوع مُعرِّف العميل في معلمات المسار.
2- ستتم إعادة جميع المعلومات المتعلقة بالمنتج عبر هذه الواجهة البرمجية إذا قمنا بالاستدعاء باستخدام المرجع التجاري للمنتج، مُعرِّف المورد، مُعرِّف العميل، نوع مُعرِّف المورد، ونوع مُعرِّف العميل في معلمات المسار.
3- إذا قُمنا بطلب الواجهة البرمجية باستخدام مُعرِّف المورد، مُعرِّف العميل، نوع مُعرِّف المورد، نوع مُعرِّف العميل، تاريخ الإشارة، ونوع التغيير كمعلمات في المسار، فسيتم إعادة جميع المنتجات المشمولة في نطاق الموزع، إذا كان وقت إنشاء المنتج أكبر من التاريخ المعطى في معلمة تاريخ الإشارة.
سيتطلب الوصول إلى واجهة برمجة التطبيقات مصادقة OAuth، يُرجى الاطلاع على التفاصيل في البوابة.
التوفُّر حسب الدولة - قائمة بالدول التي قمنا باختبار أداء وتوفر وزمن الاستجابة للواجهة البرمجية:
- الأرجنتين، أستراليا، بلجيكا، البرازيل، بلغاريا، كندا، تشيلي، كولومبيا، كرواتيا، الدنمارك، فنلندا، فرنسا، ألمانيا، الهند، إيطاليا، المكسيك، هولندا، نيوزيلندا، النرويج، بيرو، البرتغال، رومانيا، سلوفينيا، إسبانيا، السويد، سويسرا، تركيا والمملكة المتحدة.
إذا لم يتم ذكر بلدك في القائمة، يمكنك التواصل معنا مباشرةً أو مع نقطة الاتصال لدى شنايدر (POC) للتحقق مما إذا كان بلدك لديه الوصول إلى هذه الواجهة البرمجية.
الحصول على المنتجات
| Method | GET |
| BaseURL | https://api.se.com/v2/reference-data/product/product-catalog |
| ResourcePath | /products |
QueryParams:
| Param | Data-type | Mandatory | Example | Description |
| supplierid | string | Y | 99887766 | معرّف مورد المنتج، الذي تم تكوينه في النظام الرئيسي لمنتجات شنايدر إلكتريك. |
| supplierid-type | string | Y |
specific |
رقم المعرّف بنظام ترقيم البيانات العالمي (DUNS) إذا كان متوفرًا، وإلا فالمعرّف الخاص بالقيم المتاحة: خاص، DUNS |
| customerid | string | Y | 1122334455 | معرّف العميل الخاص بك (بنظام Duns إذا كان متوفرًا) أو الذي تم تكوينه في النظام الرئيسي لمنتجات شنايدر إلكتريك (تم تسليمه لك من قبل جهة اتصال المبيعات الخاصة بك) |
| customerid-type | string | Y | specific |
رقم المعرّف بنظام ترقيم البيانات العالمي (DUNS) إذا كان متوفرًا، وإلا فالمعرّف الخاص القيم المتاحة: خاص، DUNS |
| date-of-reference | string | N | 2021-12-01 | تاريخ بدء أي تغييرات تم إجراؤها على بيانات المنتج، والتي تُستخدم للاستعلام عن تغييرات دلتا. |
| change-type | string | N | all |
نوع التغييرات المهمة منذ تاريخ الرقم المرجعي. القيم المتاحة: جديد، تحديث، حذف، كل |
| product-reference | string | N | QA_4659_DES_22 |
رقم مرجعي واحد أو أكثر للمنتج، يتم إدخاله في صورة معلمات استعلام فردية. |
| product-identifier | string | N |
commercialReference |
نوع الرقم المرجعي للمنتج، أو الرقم المرجعي التجاري أو رقم البند التجاري العالمي (GTIN). القيم المتاحة: commercialReference، GTIN |
| etim-version | string | N |
ETIM-9.0 |
إصدار ETIM، حيث يعتبر ETIM معيارًا لتصنيف بيانات المنتج. |
| english-descriptions | boolean | N |
true |
ما إذا كانت الأوصاف باللغة الإنجليزية مضمنة أم لا إضافة إلى اللغة المحلية |
| mime-filtering | string | N | MD36 |
في عامل التصفية هذا، قم بتقديم رمز واصف mime بأشكال متعددة مثل MD01، MD04، MD99، إلخ بالنسبة لعامل التصفية المطلوب mime، سيتم إرجاع جميع أنواع المستندات المرتبطة برمز واصف mime مع نوع المستند المسموح به لعوامل تصفية البيانات ذات الصلة. - MD01 لصورة المنتج - MD04 لرابط صفحة المنتج - MD05 لقانون REACh (تسجيل وتقييم وترخيص وتقييد المواد الكيميائية) - MD14 لدليل المستخدم - MD14 لدليل مستخدم النظام - MD14 لدليل البدء السريع - MD21 لورقة التعليمات - MD22 لورقة بيانات المنتج - MD36 لتوجيه RoHs (الحد من المواد الخطرة) / توجيه الصين RoHS - MD99 لـ CAD (التصميم بمساعدة الحاسوب) / نموذج ثلاثي الأبعاد / فيديو إرشادي / فيديو ترويجي / مجموعة صور بتقنية عرض 360 درجة / بيئة المنتج / دليل نهاية العمر الافتراضي / بحث موجز / كتالوج |
| data-filtering | string | N | up-selling |
عامل تصفية بيانات المنتج. يتم إرجاع جميع البيانات بشكل افتراضي، ولكن هذا يسمح بطلب مجموعة محددة من البيانات. هذه هي القيم المدعومة التي يمكن استخدامها لإرجاع البيانات التي تمت تصفيتها: كل، وetim، وتسويق، ومبيعات لوجستية، ومتابعة، ووسائط أصول رقمية، وعلاقة، وملحقات، وإلزامي، ومحدد، وقطع غيار، ومماثل، ومكمل، وإضافي التعريف: ملاحظة: إذا تم استخدام تصفية البيانات = وسائط الوسائط الرقمية وتصفية ال MIME • بعد ذلك، ستقوم الخدمة الخلفية بإرجاع جميع أكواد الوصف الوسائط الرقمية (كيفية الفيديو، صورة المنتج، صورة المنتج في حالة حياة واقعية، فيديو ترويجي) + أكواد الوصف التي لا يتم اعتبارها من قِبل وسائط الوسائط الرقمية. إذا كنت تريد إرجاع علاقة منتج معينة، فيمكن استخدام هذه القيم بدلاً من العلاقة : |
