تُوفّر خلاصة المستودع قائمة بكلّ المنتجات (يُشار إليها من خلال سمة id
) التي يتمّ بيعها في كلّ متجر (يُشار إليه باستخدام سمة store_code
) لبائع تجزئة معيّن (يُشار إليه باستخدام سمة target_customer_id
). وننصحك بتعديل خلاصة المستودع مرّة في اليوم على الأقل.
في كلّ مرة تحمّل فيها خلاصة المستودع، يتمّ تعديل معلومات المنتجات بشكل تدريجي. ويجب فقط تضمين المنتجات التي تغيّر مدى توفّرها أو سعرها منذ التعديل السابق.
الحقل المطلوب | الوصف | النوع | مثال |
target_customer_id |
معرّف التاجر لبائع التجزئة هذا | عدد صحيح | 112339909 |
store_code |
المعرّف الفريد للمتجر (هذه القيمة حسّاسة لحالة الأحرف) استخدِم رمز المتجر المُدرَج في الملف التجاري الخاص ببائع التجزئة أو المعرّف الداخلي لمزوِّد بيانات المستودع/نقطة البيع. ملاحظة: إذا كنت تستخدم رمز متجر داخليًا، عليك ربطه بعنوان المتجر في خلاصة المتجر. |
سلسلة | "465278" |
id |
المعرّف الفريد للمنتج (يُنصح باستخدام رمز التخزين التعريفي للمنتج) ملاحظة: إذا كان بائع التجزئة يبيع المنتج نفسه جديدًا ومُستعملاً، يجب أن يكون له معرّف مختلف في كل حالة. |
سلسلة <= 50 حرفًا |
"1029384" |
gtin (رقم_GTIN) |
الرقم التجاري العالمي للسلعة الخاص بالمنتج |
سلسلة | "885787364684" |
availability |
تُحدِّد حالة مستودعك (ما إذا كان منتجك متوفّرًا وكيفية توفّره). ملاحظة: في حال عدم توفّر سمة "مدى التوفّر"، سنستخدم سمة "الكمية" بدلاً منها. |
التعداد:
|
In_stock |
price |
سعر المنتج بالعملة المحلية | سلسلة | "28.00 SAR" |
timestamp |
الطابع الزمني لتسجيل المستودع في منطقة زمنية محدّدة، وفقًا لمعيار ISO 8601 التنسيق: yyyy-mm-ddThh:mm:ss+المنطقة الزمنية |
سلسلة | "2016-05-09T14:08:45+00:00" |
الحقل الاختياري | الوصف | النوع | مثال |
quantity |
كمية المنتج المتوفّرة في المستودع | عدد صحيح >= 0 |
5 |
Pickup SLA |
التاريخ المتوقّع الذي سيكون فيه الطلب جاهزًا للاستلام، وذلك حسب وقت تقديمه | نص (سلسلة نصية): يجب استخدام إحدى القيم الـ 8 المقبولة: "اليوم نفسه" أو "اليوم التالي" أو "يومان" أو "3 أيام" أو "4 أيام" أو "5 أيام" أو "6 أيام" "عدّة أسابيع" | اليوم نفسه |
pickup method |
خيار الاستلام لهذه السلعة ملاحظة: اعتبارًا من 1 سبتمبر 2024، ليس عليك إرسال سمة "طريقة الاستلام" من أجل تفعيل ميزة "استلام الطلب". |
نص (سلسلة نصية): يجب استخدام إحدى القيم الأربع المقبولة: "شراء" أو "حجز" أو "الشحن إلى المتجر" أو "غير متاح" |
شراء |