تعرّف على المنتج نفسه
قد يصف المورد ونظام البيع ونظام المخزون المنتج نفسه بأسماء مختلفة. استخدم المعرّف المرجعي لربط هذه الأوصاف بدلاً من مطابقة الأسماء وحدها.
مرجع المنتجات للبرامج التي تطورها
امنح برامج التجزئة والمخزون والكتالوجات مرجعاً مشتركاً للمنتج. اربط الباركود والأسماء العربية والإنجليزية والوحدات والعبوات عبر API واحد.
استكشف مساحة عملكتشغيل أولي للكتالوج. الدفع الفعلي معطل.
نظرة أقرب
استكشف عبوات منتج توضيحي وأسماءه وبنية API الخاصة به، دون تسجيل دخول أو تنفيذ طلب.
Orange drink
قنينة · ١ لتريربط المرجع الواحد الأسماء والمعرّف والوحدة الفعلية. القيم المعروضة للتوضيح.
المنتج نفسه. وحدات فعلية مختلفة.
تبقى علاقات العبوات وتحويلات المحتوى واضحة.
تتغير اللغة. ويبقى معرّف المنتج.
حدد اللغة المطلوبة وتحقق من لغة الاسم المسترجع، بما في ذلك اللغة البديلة عند عدم توفر الاسم المطلوب.
حقول توضيحية من الاستجابة
{
"display_name": {
"value": "Orange drink",
"locale": "en"
},
"package_type": "bottle",
"net_content": "1",
"content_unit": "L",
"identifiers": [
{
"scheme": "gtin",
"raw_value": "9990000000012"
}
]
}مقتطف توضيحي وليس طلباً مباشراً. راجع دليل المطورين للعقد الكامل.
GET /v1/identifiers/lookup01نقطة بداية مشتركة
تصل بيانات المنتجات على شكل باركود وصفوف موردين وأسماء مترجمة وأوصاف عبوات. يمنح Cataref هذه المعلومات بنية مترابطة يستطيع برنامجك قراءتها.
قد يصف المورد ونظام البيع ونظام المخزون المنتج نفسه بأسماء مختلفة. استخدم المعرّف المرجعي لربط هذه الأوصاف بدلاً من مطابقة الأسماء وحدها.
القنينة والعبوة السداسية والكرتون وحدات فعلية مختلفة. اقرأ العلاقات بينها وتحويلات محتواها الدقيقة قبل استخدامها في إجراءات نظامك.
اربط الأسماء العربية والإنجليزية بالمنتج نفسه. تساعد الأسماء والتصنيفات المحلية واجهتك على استخدام لغة المستخدم، مع الحفاظ على هوية ثابتة داخل التكامل.
إضافة صف لا تعني نشر معلومة. تدخل المساهمات والملفات المستوردة مساراً خاصاً يشمل التحقق وسياق المصدر والمراجعة المستقلة قبل قبولها في الكتالوج المشترك.
02داخل المرجع
اقرأ سجلاً محدداً أو اطلب تفاصيله المرتبطة. تعتمد الحقول على نقطة API والبيانات المتاحة وصلاحيات مساحة عملك.
| البيانات | ما الذي تتضمنه | كيف تستفيد منها |
|---|---|---|
| الهوية والأسماء | عائلة المنتج ومتغيره ووحدته التجارية ومعرّفاته وأسماء العرض المحلية. | اربط الباركود أو الاسم بالمرجع الصحيح. |
| العبوات والمقاييس | نوع العبوة وصافي المحتوى ووحدته وعلاقات الاحتواء والتحويل. | ميّز محتويات العبوة عن العبوة نفسها. |
| التصنيفات والخصائص | تصنيفات محلية وخصائص ذات أنواع محددة وإثراء إضافي حيث يتوفر في السجل. | صف المنتج بما يتجاوز اسمه دون افتراض حقول غير متوفرة. |
| سياق المصدر والتغيير | سياق المصدر المتاح والتصحيحات المراجعة والسحب وإشعارات التغيير المرتبة. | افهم مصدر البيانات وحدّث نسختك عند تغيرها. |
قد تتضمن بعض السجلات بيانات تغذية أو مكونات أو وسائط مرخّصة أو مشاهدات أسعار. يختلف التوفر بين السجلات. الحقل الغائب ليس قيمة متحققاً منها، ومطابقة منتج لا تثبت تغطية السوق.
03للمطورين
اختبر البيانات قبل البدء بالتكامل. تجمع مساحة العمل مفاتيح API ومستكشف الطلبات وسجل الاستخدام وأدوات المزامنة.
استخدم حسابك الحالي أو اقبل دعوة بريدية. تجمع مساحة العمل الأعضاء وبيانات الوصول والاستخدام في مكان واحد.
ابحث بالباركود أو الاسم في الكتالوج. استخدم المستكشف لفحص نتائج REST أو GraphQL واللغة المختارة وإيصال الطلب.
أنشئ مفتاح API بالصلاحيات التي يحتاجها التكامل. استخدم اللقطات وإشعارات الويب الموقعة عندما يحتاج تطبيقك إلى متابعة تغييرات الكتالوج.
# Synthetic example
curl 'https://cataref.com/v1/identifiers/lookup?value=9990000000012' \
-H 'Authorization: Bearer YOUR_TEST_KEY' \
-H 'Idempotency-Key: YOUR_REQUEST_KEY'طلب توضيحي بمعرّف اصطناعي. استبدل القيمة التوضيحية بمفتاحك التجريبي ذي الصلاحيات المحددة. لا تضع مفتاح API سرياً في عميل متاح للعامة.
اقرأ دليل التكامل04لفرق الكتالوج
ساهم بمنتج واحد أو بملف منظم. يوضح المسار الموجّه مراحل التحقق والمراجعة قبل انضمام البيانات إلى المرجع المشترك.
أدخل الأسماء والمعرّفات وتفاصيل العبوة وسياق المصدر في نموذج. عاين المساهمة قبل إرسالها للمراجعة.
اختر CSV أو XLSX أو JSON، وطابق الأعمدة، وافحص الصفوف الصالحة وأخطاء الصفوف قبل بدء الاستيراد.
عد إلى المساهمات وسجل الاستيراد. تابع التقدم وأوقف الاستيراد مؤقتاً أو استأنفه دون نسخ معرّفات المهام بين النماذج.
يمكن متابعة الصف الصالح. أما الصف الذي يحتوي باركود أو قيمة محتوى غير صحيحة فيُظهر مشكلة تحتاج إلى تصحيح.
التحقق قبل الاستيراديجهز الاستيراد مساهمة للمراجعة. ولا ينشر المنتج أو يمنح مكافأة قابلة للاستخدام تلقائياً.
توضيح لمسار العمل. قدّم فقط البيانات التي لديك إذن باستخدامها.
Orange drink
مشروب برتقال
اسمان. ومعرّف منتج واحد.
05مصمم للغتين
الأسماء بيانات وليست طبقة ترجمة مضافة إلى الواجهة. اطلب أسماء المنتجات وتصنيفاتها باللغة المطلوبة مع الحفاظ على ارتباطها بالمرجع نفسه.
تعمل مساحة العمل بالعربية والإنجليزية، بما في ذلك التنقل والنماذج وتخطيط يتبع اتجاه القراءة بالعربية. افحص اللغة المسترجعة عند استخدام اسم بلغة بديلة.
المنتج نفسه، مفهوم في كل نظام
06مساحة عمل تجمع العمل
افصل بيانات وصول التكامل عن الوصول الشخصي. ادعُ الزملاء بالبريد الإلكتروني، وامنح المطورين والمساهمين وأعضاء الفوترة مكاناً واضحاً للعمل.
يتولى Clerk تسجيل دخول الأشخاص. ويتحقق Cataref من العضوية والصلاحيات. يتحقق الزميل المدعو من البريد المحدد ويقبل الوصول، دون حاجة إلى مشغّل لربط كل حساب جديد.
تستهلك قراءات الكتالوج المشترك رصيد استخدام. تساعدك التقديرات على فحص الطلب قبل تنفيذه، وتعرض الإيصالات التكلفة المسجلة والرصيد المتبقي. يبقى سجل الاستخدام ضمن مساحة العمل.
07قبل ربط نظامك
إجابات واضحة عن البيانات ومسار العمل والتشغيل الأولي للكتالوج.
يوفر Cataref بيانات مرجعية للمنتجات بدلاً من أرصدة مخزونك أو معاملات مبيعاتك. بحسب نقطة API والسجل، تشمل البيانات عائلات المنتجات ومتغيراتها ووحداتها التجارية ومعرّفاتها وأسماءها وتصنيفاتها المحلية وعبواتها ومقاييسها والإثراء المتاح. راجع عقد API للحقول الدقيقة.
لا يوجد ضمان للتغطية. ينمو الكتالوج بالمساهمات المصرح بها والخاضعة لمراجعة مستقلة. أمثلة الموقع توضيحية، ونجاح البحث لا يثبت اكتمال كتالوج السوق.
يجب أن يتعامل التكامل صراحةً مع المعرّف غير المطابق. تشابه الأسماء ليس إثباتاً لهوية المنتج. يستطيع مساهم الكتالوج إعداد منتج مقترح مع سياق المصدر للتحقق والمراجعة بدلاً من إنشاء مطابقة مشتركة بصمت.
يميز نموذج البيانات عائلة المنتج ومتغيره ووحدته التجارية وعبواته. تربط علاقات الاحتواء الواضحة الوحدات الفعلية، وتصف التحويلات الدقيقة العدد والمحتوى. يظل تطبيقك مسؤولاً عن استخدام هذه المراجع في قواعد الشراء والمخزون والمبيعات.
تبقى الأسماء والتصنيفات المحلية مرتبطة بهوية المنتج نفسها. حدد اللغة وافحص اللغة المسترجعة، بما في ذلك البديل عند غياب الاسم المطلوب. تدعم مساحة العمل العربية والإنجليزية مع اتجاه قراءة عربي.
نعم. يقبل الاستيراد الموجّه ملفات CSV وXLSX وJSON حتى ١ ميبيبايت. طابق الأعمدة وافحص المعاينة وصحح أخطاء الصفوف. يمكن تجهيز الصفوف الصالحة للمراجعة. يدعم المحلل الحالي حتى ٢٠٠٠ صف بيانات و٦٤ عموداً، ويتوقع القيم الدقيقة مثل الباركود وصافي المحتوى العشري كنصوص.
لا. تبدأ المساهمات بشكل خاص وتمر بالتحقق والمراجعة المستقلة قبل قبولها في الكتالوج المشترك. لا ينشر الرفع سجلاً تلقائياً ولا يمنح مكافأة قابلة للاستخدام. سياق المصدر وحقوق إعادة التوزيع جزء من مسار المساهمة.
نعم. يستطيع المالك دعوة الزملاء بالبريد الإلكتروني بصلاحيات مطور أو مساهم أو فوترة. يسجّل المستلم دخوله عبر Clerk ويتحقق من البريد المدعو ويقبل الدعوة. تظل صلاحيات المساحة هي المرجع؛ تسجيل الدخول وحده لا يمنح وصولاً للكتالوج أو الفوترة.
تستخدم قراءات الكتالوج رصيد استخدام. افحص التقديرات وإيصالات الطلبات وسجل مساحة العمل. تبقى الفوترة في وضع الاختبار مع تعطيل الدفع الفعلي.
يمكن للأعضاء الحاليين فتح مساحاتهم، وللزملاء المدعوين قبول دعوة بريدية. يُنشئ المشغّل مساحات المالك الجديدة حالياً. لا يتوفر تسجيل عام تلقائي لمساحات العمل في هذه النسخة. بعد توفر الوصول، ابدأ بالكتالوج ودليل المطورين السريع.
ابدأ بالمنتج الذي أمامك
افتح مساحة عملك لفحص منتج أو اختبار طلب أو إرسال كتالوج للمراجعة. تحقق من ملاءمة البيانات لبرنامجك قبل البناء عليها.
استكشف مساحة عملكللأعضاء الحاليين والزملاء المدعوين. مراجعة مستقلة. الدفع الفعلي معطل.