يشرح هذا البرنامج التعليمي ما يلي:
- وصف عام لحالات استخدام الرسوم ووقت التنفيذ المتاحة
- تعليمات محدّدة حول كيفية تحديد وقت إتمام الطلب ورسومه في خلاصات الخدمات
- توقّعات الدقة
للاطّلاع على نموذج خلاصة كامل يعرض استخدام وقت إتمام الطلب ورسومه، يُرجى الاطّلاع على نموذج Ordering Redirect EPA.
الرسوم
نوفّر عدة طرق مختلفة لتحديد الرسوم، مثل:
- رسوم ثابتة: "رسوم التوصيل 5 دولار أمريكي" أو "رسوم الخدمة 5 دولار أمريكي"
- الرسوم كنسبة مئوية: "رسوم التوصيل %5" أو "رسوم الخدمة %5"
- نطاقات الرسوم: "رسوم التوصيل من 2 إلى 10 دولار أمريكي" أو "رسوم الخدمة من %3 إلى %6"
- النطاقات المفتوحة "تبدأ رسوم التوصيل من %5" أو "رسوم الخدمة تصل إلى 20 دولار أمريكي"
يمكن تحديد الرسوم كرسوم توصيل أو رسوم خدمة. من الممكن أيضًا تحديد رسوم متعدّدة (مثل "رسوم الخدمة من %5 إلى %10، رسوم التوصيل 5 دولار أمريكي").
لا تتوافق هذه السياسة مع حالات الاستخدام التي تتطلّب تغيير الرسوم استنادًا إلى معلومات حول المستخدم.
أمثلة على الرسوم
رسوم التوصيل والاستلام
يتوافق التطبيق مع نوعَي رسوم "التسليم" و"الخدمة".إرسال المحتوى
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
الخدمة
{ "fee": { "fee_id": "12345/service_fee", "fee_type": "SERVICE", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
أنواع الرسوم المختلفة
في ما يلي بعض الأمثلة السهلة الاستخدام لتحديد نوع الرسوم المحدّدة.Fixed
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
النسبة المئوية لسلة التسوّق
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "cart_percentage": { "base_value": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "percentage_of_cart_value": 10 }, "service_ids": [ "service/entity002" ] } }
النطاق
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "range_amount": { "min_amount": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "max_amount": { "currency_code": "USD", "units": 5, "nanos": 600000000 } }, "service_ids": [ "service/entity002" ] } }
وقت توصيل الطلب
نسمح باستخدام عدة تنسيقات مختلفة لتحديد وقت التوفّر للمساعدة في ضمان تقديم بيانات دقيقة. توضّح النقاط التالية حالات الاستخدام المختلفة المتاحة، بالإضافة إلى بعض الأمثلة على اللغة المشابهة لما سيراه المستخدم في الواجهة الأمامية.
- أوقات ثابتة: "سيتم التوصيل خلال 30 دقيقة" أو "يمكنك استلام الطلب خلال 15 دقيقة"
- النطاقات الزمنية: "يتم التوصيل خلال 30 دقيقة إلى ساعة واحدة" أو "يمكن استلام الطلب خلال 15 إلى 20 دقيقة"
يمكن تحديد وقت التنفيذ لكلّ من الاستلام والتسليم باستخدام تنسيق مشترك (موضّح أدناه).
لا تتوافق هذه الميزة مع حالات الاستخدام التي تتطلّب تغيير "تقديرات الوقت للوصول" استنادًا إلى معلومات حول المستخدم.
أمثلة على وقت توصيل الطلب
يتم تضمين وقت تنفيذ الطلب الخاص بروابط الإجراءات في رسالة خلاصة "الخدمات" ضمن الحقل FoodOrderingService.ETA
Fixed
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" }, "action_link_id": "action-link-id" } },
النطاق الزمني
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" "max_lead_time_duration": "1200s" }, "action_link_id": "action-link-id" } },
فترات توصيل الطلب
باستخدام ServiceHours،
يمكن ضبط أوقات التنفيذ لفترة زمنية محدّدة. يتم استخدام مجموعة
lead_time التلقائية المحدّدة في
FoodOrderingService
خارج النطاقات الزمنية لساعات العمل.
lead_time 2400s من الساعة 11:00 صباحًا إلى الساعة 1:30 ظهرًا.
سيتم عرض
lead_time 1200s قبل الساعة 11:00 صباحًا وبعد الساعة 1:30 ظهرًا.
{ "data": [ { "service": { "service_id": "merchant-1-service-delivery", "service_type": "DELIVERY", "parent_entity_id": "merchant-1", "lead_time": { "min_lead_time_duration": "1200s" }, "action_link_id": "merchant-1-takeout-delivery-action" } }, { "service_hours": { "hours_id": "merchant-1-advance-hours-delivery", "service_ids": ["merchant-1-service-delivery"], "asap_hours": [ { "time_windows": { "time_windows": { "open_time": { "hours": 11 }, "close_time": { "hours": 13, "minutes": 30 } } }, "lead_time": { "min_lead_time_duration": "2400s" } } ] } } ] }
دقة الرسوم ووقت توصيل الطلب
دقة الرسوم
عند تقديم بيانات الرسوم الخاصة بتاجر، نتوقّع منك تقديم وصف دقيق لهذه الرسوم. عليك تضمين جميع رسوم التوصيل والخدمات التي قد تنطبق على الطلب.
ندرك أنّ الرسوم قد تختلف بمرور الوقت ومن مستخدم إلى آخر. لهذا السبب، نتيح تحديد الرسوم كنطاقات، بما في ذلك النطاقات المفتوحة. في الحالات التي يمكن أن تختلف فيها الرسوم بشكل كبير، احرص على أن يشمل النطاق المقدَّم الرسوم التي يمكن أن يراها المستخدم أثناء معاملته.
إذا لم تكن متأكدًا من المتطلبات المحدّدة في حالتك، يُرجى التواصل مع جهة الاتصال في "مركز الإجراءات".
دقة وقت توصيل الطلب
ندرك أنّ تفاصيل وقت تنفيذ الطلب تتغيّر استنادًا إلى مجموعة متنوّعة من العوامل. وتشمل هذه العوامل ما يلي:
- تغييرات على وقت تنفيذ الطلب استنادًا إلى حجم الطلب
- تغييرات على وقت تنفيذ الطلب استنادًا إلى الوقت المستغرَق لإكمال عملية الطلب والدفع
- مدة التأخير بين تعديل وقت إتمام الطلب من خلال الخلاصات
- عنوان التسليم الخاص بالمستخدم
قد تؤدي أيّ من هذه العوامل إلى حالات لا يكون فيها وقت تنفيذ الطلب المعروض للمستخدم في البداية هو وقت التنفيذ الدقيق الذي سيراه عند الدفع. لا يهدف تنفيذ وقت التنفيذ إلى إزالة هذه الحالات تمامًا، بل إلى تقديم معلومات واضحة للمستخدمين قدر الإمكان.
على الشركاء تقديم عملية تنفيذ تؤدي إلى عرض وقت التنفيذ الدقيق للمستخدمين قدر الإمكان، وذلك على أساس بذل قصارى الجهد. إذا كان هناك تفاوت كبير في التوقيت بسبب هذه العوامل، نقترح عليك تقديم نطاق زمني يشمل هذا التفاوت. بالإضافة إلى ذلك، إذا تغيّر وقت التنفيذ بسبب تفاصيل الطلب، يجب أن يظهر ذلك بوضوح للمستخدمين عند وصولهم إلى مسار الطلب.
إذا لم تكن متأكدًا من المعلومات المطلوبة في حالتك، يُرجى التواصل مع جهة الاتصال في "مركز الإجراءات".
تعديلات في الوقت المناسب على الرسوم وتقديرات الوقت
قد تستغرق معالجة أي تغييرات يتم إجراؤها باستخدام عملية تحميل عادية للخلاصة ساعتين على الأقل. ويجب الانتباه إلى ذلك بشكل خاص إذا كنت تخطّط لتغيير المدة المقدّرة للوصول بشكل متكرّر.
ننصح الشركاء بشدة بتنفيذ التعديلات في الوقت الفعلي، ما يتيح إجراء طلب من واجهة برمجة التطبيقات لتغيير خلاصة الخدمة (بما في ذلك الرسوم وتقديرات الوقت للوصول) في غضون 5 دقائق أو أقل.