منتج واحد.
كل تفاصيله مترابطة.

امنح برامج التجزئة والمخزون والكتالوجات مرجعاً مشتركاً للمنتج. اربط الباركود والأسماء العربية والإنجليزية والوحدات والعبوات عبر API واحد.

استكشف مساحة عملك

تشغيل أولي للكتالوج. الدفع الفعلي معطل.

REST + GraphQLالعربية + الإنجليزية
01 / Catarefسجل منتج مترابط
الأسماء المحليةOrange drinkمشروب برتقال
ENAR
GTIN9990000000012
علاقات العبوات
1قنينة6عبوة24كرتون
هوية واحدة تربط الأسماء والوحدات والعبوات.بيانات توضيحية
من بحث واحد إلى كتالوج مشترك
  • هوية المنتج
  • علاقات العبوات
  • مساهمات تخضع للمراجعة

سجل واحد. تفاصيل مترابطة.

استكشف عبوات منتج توضيحي وأسماءه وبنية API الخاصة به، دون تسجيل دخول أو تنفيذ طلب.

Cataref / مرجع المنتجسجل توضيحي · بيانات اصطناعية
المشروبات / مشروبات الفاكهة

مشروب برتقال

Orange drink

قنينة · ١ لتر
الباركود / GTIN
9990000000012
عائلة المنتج
مشروب فاكهة
المتغير
برتقال

يربط المرجع الواحد الأسماء والمعرّف والوحدة الفعلية. القيم المعروضة للتوضيح.

المنتج نفسه. وحدات فعلية مختلفة.

  1. 1
    قنينة مفردة١ لتر · الوحدة التجارية
    الوحدة الأساسية
  2. 6
    عبوة سداسيةتحتوي ٦ قناني مفردة
    ٦ لترات إجمالاً
  3. 24
    كرتون خارجييحتوي ٤ عبوات سداسية
    ٢٤ لتراً إجمالاً

تبقى علاقات العبوات وتحويلات المحتوى واضحة.

من الباركود إلى سجل مترابطGET /v1/identifiers/lookup

مرجع واحد.
لكل أنظمتك.

تصل بيانات المنتجات على شكل باركود وصفوف موردين وأسماء مترجمة وأوصاف عبوات. يمنح Cataref هذه المعلومات بنية مترابطة يستطيع برنامجك قراءتها.

تعرّف على المنتج نفسه

قد يصف المورد ونظام البيع ونظام المخزون المنتج نفسه بأسماء مختلفة. استخدم المعرّف المرجعي لربط هذه الأوصاف بدلاً من مطابقة الأسماء وحدها.

ميّز العبوة عن الوحدة

القنينة والعبوة السداسية والكرتون وحدات فعلية مختلفة. اقرأ العلاقات بينها وتحويلات محتواها الدقيقة قبل استخدامها في إجراءات نظامك.

اعرض اللغتين من مرجع واحد

اربط الأسماء العربية والإنجليزية بالمنتج نفسه. تساعد الأسماء والتصنيفات المحلية واجهتك على استخدام لغة المستخدم، مع الحفاظ على هوية ثابتة داخل التكامل.

راجع المساهمة قبل مشاركتها

إضافة صف لا تعني نشر معلومة. تدخل المساهمات والملفات المستوردة مساراً خاصاً يشمل التحقق وسياق المصدر والمراجعة المستقلة قبل قبولها في الكتالوج المشترك.

اعرف البيانات
التي تربط نظامك بها.

اقرأ سجلاً محدداً أو اطلب تفاصيله المرتبطة. تعتمد الحقول على نقطة API والبيانات المتاحة وصلاحيات مساحة عملك.

البيانات الأساسية لمرجع المنتج
البياناتما الذي تتضمنهكيف تستفيد منها
الهوية والأسماءعائلة المنتج ومتغيره ووحدته التجارية ومعرّفاته وأسماء العرض المحلية.اربط الباركود أو الاسم بالمرجع الصحيح.
العبوات والمقاييسنوع العبوة وصافي المحتوى ووحدته وعلاقات الاحتواء والتحويل.ميّز محتويات العبوة عن العبوة نفسها.
التصنيفات والخصائصتصنيفات محلية وخصائص ذات أنواع محددة وإثراء إضافي حيث يتوفر في السجل.صف المنتج بما يتجاوز اسمه دون افتراض حقول غير متوفرة.
سياق المصدر والتغييرسياق المصدر المتاح والتصحيحات المراجعة والسحب وإشعارات التغيير المرتبة.افهم مصدر البيانات وحدّث نسختك عند تغيرها.

قد تتضمن بعض السجلات بيانات تغذية أو مكونات أو وسائط مرخّصة أو مشاهدات أسعار. يختلف التوفر بين السجلات. الحقل الغائب ليس قيمة متحققاً منها، ومطابقة منتج لا تثبت تغطية السوق.

ابدأ بالبحث.
وابنِ على النتيجة.

اختبر البيانات قبل البدء بالتكامل. تجمع مساحة العمل مفاتيح API ومستكشف الطلبات وسجل الاستخدام وأدوات المزامنة.

  1. 01

    افتح مساحة عمل

    استخدم حسابك الحالي أو اقبل دعوة بريدية. تجمع مساحة العمل الأعضاء وبيانات الوصول والاستخدام في مكان واحد.

  2. 02

    افحص نتيجة البحث الأولى

    ابحث بالباركود أو الاسم في الكتالوج. استخدم المستكشف لفحص نتائج REST أو GraphQL واللغة المختارة وإيصال الطلب.

  3. 03

    اربط تطبيقك

    أنشئ مفتاح API بالصلاحيات التي يحتاجها التكامل. استخدم اللقطات وإشعارات الويب الموقعة عندما يحتاج تطبيقك إلى متابعة تغييرات الكتالوج.

REST / identifier lookupGET
# Synthetic example
curl 'https://cataref.com/v1/identifiers/lookup?value=9990000000012' \
  -H 'Authorization: Bearer YOUR_TEST_KEY' \
  -H 'Idempotency-Key: YOUR_REQUEST_KEY'
RESTGraphQLPython SDK

طلب توضيحي بمعرّف اصطناعي. استبدل القيمة التوضيحية بمفتاحك التجريبي ذي الصلاحيات المحددة. لا تضع مفتاح API سرياً في عميل متاح للعامة.

اقرأ دليل التكامل

REST

استخدم نقاطاً واضحة للبحث بالمعرّف أو النص وقراءة تفاصيل المنتج المرتبطة. تساعد التوسعات المحدودة والبحث الدفعي على تحديد شكل القراءة.

GraphQL

حدد الحقول التي تحتاجها واجهتك ضمن قراءة محدودة. افحص التقدير قبل تنفيذ الاستعلام واحتفظ بإيصال الاستخدام مع النتيجة.

حزمة Python

استخدم العميل ذا الأنواع المحددة عندما تحتاج إلى نماذج Python لعمليات API المدعومة والاستجابات وبيانات الاستخدام.

أحضر بياناتك.
واعرف ما يحتاج إلى تصحيح.

ساهم بمنتج واحد أو بملف منظم. يوضح المسار الموجّه مراحل التحقق والمراجعة قبل انضمام البيانات إلى المرجع المشترك.

  • أضف منتجاً واحداً

    أدخل الأسماء والمعرّفات وتفاصيل العبوة وسياق المصدر في نموذج. عاين المساهمة قبل إرسالها للمراجعة.

  • استورد ملف كتالوج

    اختر CSV أو XLSX أو JSON، وطابق الأعمدة، وافحص الصفوف الصالحة وأخطاء الصفوف قبل بدء الاستيراد.

  • تابع العمل

    عد إلى المساهمات وسجل الاستيراد. تابع التقدم وأوقف الاستيراد مؤقتاً أو استأنفه دون نسخ معرّفات المهام بين النماذج.

CSV
كتالوجكصفوف منظمة بأسماء أعمدتك
1

طابق الأعمدة

name_en
اسم المنتج بالإنجليزية
name_ar
اسم المنتج بالعربية
gtin
معرّف الباركود
2

عاين الصفوف

يمكن متابعة الصف الصالح. أما الصف الذي يحتوي باركود أو قيمة محتوى غير صحيحة فيُظهر مشكلة تحتاج إلى تصحيح.

التحقق قبل الاستيراد
3

أرسل للمراجعة المستقلة

يجهز الاستيراد مساهمة للمراجعة. ولا ينشر المنتج أو يمنح مكافأة قابلة للاستخدام تلقائياً.

توضيح لمسار العمل. قدّم فقط البيانات التي لديك إذن باستخدامها.

en

Orange drink

ar

مشروب برتقال

اسمان. ومعرّف منتج واحد.

العربية جزء
من السجل نفسه.

الأسماء بيانات وليست طبقة ترجمة مضافة إلى الواجهة. اطلب أسماء المنتجات وتصنيفاتها باللغة المطلوبة مع الحفاظ على ارتباطها بالمرجع نفسه.

تعمل مساحة العمل بالعربية والإنجليزية، بما في ذلك التنقل والنماذج وتخطيط يتبع اتجاه القراءة بالعربية. افحص اللغة المسترجعة عند استخدام اسم بلغة بديلة.

احتفظ بهوية المنتج.
واربط التفاصيل.

امنح كل شخص الوصول
الذي يحتاجه عمله.

افصل بيانات وصول التكامل عن الوصول الشخصي. ادعُ الزملاء بالبريد الإلكتروني، وامنح المطورين والمساهمين وأعضاء الفوترة مكاناً واضحاً للعمل.

سجّل الدخول ثم اختر مساحة العمل

يتولى Clerk تسجيل دخول الأشخاص. ويتحقق Cataref من العضوية والصلاحيات. يتحقق الزميل المدعو من البريد المحدد ويقبل الوصول، دون حاجة إلى مشغّل لربط كل حساب جديد.

اعرف كيف يُحتسب الطلب

تستهلك قراءات الكتالوج المشترك رصيد استخدام. تساعدك التقديرات على فحص الطلب قبل تنفيذه، وتعرض الإيصالات التكلفة المسجلة والرصيد المتبقي. يبقى سجل الاستخدام ضمن مساحة العمل.

تفاصيل
تحتاج إلى معرفتها.

إجابات واضحة عن البيانات ومسار العمل والتشغيل الأولي للكتالوج.

ما البيانات التي يوفرها Cataref فعلياً؟

يوفر Cataref بيانات مرجعية للمنتجات بدلاً من أرصدة مخزونك أو معاملات مبيعاتك. بحسب نقطة API والسجل، تشمل البيانات عائلات المنتجات ومتغيراتها ووحداتها التجارية ومعرّفاتها وأسماءها وتصنيفاتها المحلية وعبواتها ومقاييسها والإثراء المتاح. راجع عقد API للحقول الدقيقة.

هل يغطي كل باركود أو منتج في سوقي؟

لا يوجد ضمان للتغطية. ينمو الكتالوج بالمساهمات المصرح بها والخاضعة لمراجعة مستقلة. أمثلة الموقع توضيحية، ونجاح البحث لا يثبت اكتمال كتالوج السوق.

ماذا يحدث إذا لم يُعثر على الباركود؟

يجب أن يتعامل التكامل صراحةً مع المعرّف غير المطابق. تشابه الأسماء ليس إثباتاً لهوية المنتج. يستطيع مساهم الكتالوج إعداد منتج مقترح مع سياق المصدر للتحقق والمراجعة بدلاً من إنشاء مطابقة مشتركة بصمت.

هل يميز القنينة عن الكرتون؟

يميز نموذج البيانات عائلة المنتج ومتغيره ووحدته التجارية وعبواته. تربط علاقات الاحتواء الواضحة الوحدات الفعلية، وتصف التحويلات الدقيقة العدد والمحتوى. يظل تطبيقك مسؤولاً عن استخدام هذه المراجع في قواعد الشراء والمخزون والمبيعات.

كيف تعمل العربية والإنجليزية؟

تبقى الأسماء والتصنيفات المحلية مرتبطة بهوية المنتج نفسها. حدد اللغة وافحص اللغة المسترجعة، بما في ذلك البديل عند غياب الاسم المطلوب. تدعم مساحة العمل العربية والإنجليزية مع اتجاه قراءة عربي.

هل يمكن استيراد كتالوج موجود؟

نعم. يقبل الاستيراد الموجّه ملفات CSV وXLSX وJSON حتى ١ ميبيبايت. طابق الأعمدة وافحص المعاينة وصحح أخطاء الصفوف. يمكن تجهيز الصفوف الصالحة للمراجعة. يدعم المحلل الحالي حتى ٢٠٠٠ صف بيانات و٦٤ عموداً، ويتوقع القيم الدقيقة مثل الباركود وصافي المحتوى العشري كنصوص.

هل يؤدي رفع البيانات إلى نشرها فوراً؟

لا. تبدأ المساهمات بشكل خاص وتمر بالتحقق والمراجعة المستقلة قبل قبولها في الكتالوج المشترك. لا ينشر الرفع سجلاً تلقائياً ولا يمنح مكافأة قابلة للاستخدام. سياق المصدر وحقوق إعادة التوزيع جزء من مسار المساهمة.

هل يستطيع عدة أشخاص استخدام مساحة واحدة؟

نعم. يستطيع المالك دعوة الزملاء بالبريد الإلكتروني بصلاحيات مطور أو مساهم أو فوترة. يسجّل المستلم دخوله عبر Clerk ويتحقق من البريد المدعو ويقبل الدعوة. تظل صلاحيات المساحة هي المرجع؛ تسجيل الدخول وحده لا يمنح وصولاً للكتالوج أو الفوترة.

كيف يُحتسب استخدام API؟

تستخدم قراءات الكتالوج رصيد استخدام. افحص التقديرات وإيصالات الطلبات وسجل مساحة العمل. تبقى الفوترة في وضع الاختبار مع تعطيل الدفع الفعلي.

كيف أبدأ إذا لم تكن لدي مساحة عمل؟

يمكن للأعضاء الحاليين فتح مساحاتهم، وللزملاء المدعوين قبول دعوة بريدية. يُنشئ المشغّل مساحات المالك الجديدة حالياً. لا يتوفر تسجيل عام تلقائي لمساحات العمل في هذه النسخة. بعد توفر الوصول، ابدأ بالكتالوج ودليل المطورين السريع.

اعثر على المرجع.
ثم ابنِ التكامل.

افتح مساحة عملك لفحص منتج أو اختبار طلب أو إرسال كتالوج للمراجعة. تحقق من ملاءمة البيانات لبرنامجك قبل البناء عليها.

استكشف مساحة عملك

للأعضاء الحاليين والزملاء المدعوين. مراجعة مستقلة. الدفع الفعلي معطل.