وقت توصيل الطلب والرسوم (الإصدار القديم فقط)

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

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

يشرح هذا البرنامج التعليمي ما يلي:

1. وصف عام لحالات استخدام الرسوم ووقت التسليم المتوافقة
2. تعليمات محدّدة حول كيفية تحديد وقت تسليم الطلبات والرسوم المتعلّقة بموضوعات action_link في خلاصاتك
3. توقّعات الدقة

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

حالات استخدام الرسوم ووقت التسليم

حالات استخدام الرسوم

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

• رسوم ثابتة: "رسوم التسليم 5 ريال سعودي" أو "رسوم الخدمة 5 ريال سعودي"
• الرسوم المئوية: "رسوم التسليم ‎5%" أو "رسوم الخدمة ‎5%"
• نطاقات الرسوم: "رسوم التسليم من 2 إلى 10 دولار أمريكي" أو "رسوم الخدمة من 3% إلى 6%"
• النطاقات المفتوحة: "تبدأ رسوم التسليم من %5" أو "رسوم الخدمة تصل إلى 20 ريال سعودي"

كما هو موضّح في الأمثلة أعلاه، يمكن تحديد الرسوم على أنّها رسوم تسليم أو رسوم خدمة. من الممكن أيضًا تحديد رسوم متعدّدة (مثل "رسوم الخدمة من %5 إلى %10، رسوم التسليم 5 ريال سعودي").

لا تتوفّر حالات الاستخدام التي تتطلّب تعديل الرسوم على مدار اليوم أو تغييرها استنادًا إلى معلومات عن المستخدم.

حالات استخدام "وقت توصيل الطلب"

نسمح بعدة تنسيقات مختلفة لتحديد وقت التوفّر للمساعدة في ضمان تقديم data دقیقة. توضّح النقاط أدناه حالات الاستخدام المختلفة المتوافقة، بالإضافة إلى بعض أمثلة اللغة المشابهة لما سيظهر للمستخدم في الواجهة الأمامية.

• أوقات ثابتة: "سيتم التسليم خلال 30 دقيقة" أو "سيتم الاستلام خلال 15 دقيقة"
• النطاقات الزمنية: "يتم التوصيل خلال فترة تتراوح بين 30 دقيقة و1 ساعة" أو "يتم الاستلام خلال فترة تتراوح بين 15 و20 دقيقة"
• النطاقات الزمنية المفتوحة: "يتم التوصيل خلال أكثر من 10 دقائق" أو "يتم الاستلام خلال أقل من ساعة واحدة"

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

لا تتوفّر حالات الاستخدام التي تتطلّب تعديل الأوقات على مدار اليوم أو تغييرها استنادًا إلى معلومات عن المستخدم.

تحديد وقت تسليم الطلبات من خلال الخلاصات

يتم تضمين وقت تسليم الطلبات للروابط التي تؤدي إلى إجراءات في رسالة خلاصة التاجر action_link ، كجزء من الحقل food_ordering_metadata. بالنسبة إلى كل action_link مرتبط بالتاجر، عليك تقديم معلومات عن خدمة التوصيل باستخدام أحد مسارات الرسائل.

وقت ثابت لاستيفاء الطلب

• Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

يجب أن تكون هذه الرسائل بالتنسيق التالي:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

وقت استيفاء النطاق

• Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

يجب أن تكون هذه الرسالة بالتنسيق التالي:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

تحذير: لا تحدِّد كلّ من fulfillment_lead_time_duration و fulfillment_lead_time_duration_range كجزء من ملف واحد action_link.

ملاحظة: fulfillment_lead_time_duration و fulfillment_lead_time_duration_range.min_duration و fulfillment_lead_time_duration_range.max_duration من النوع google.protobuf.Duration وتوفّر للمستخدمين وقتًا مقدَّرًا للتسليم للإجراء المتعلّق بتنفيذ الطلب.

ملاحظة: إذا كان لدى تاجر واحد خيارات متعددة للتسليم (الاستلام والتسليم)، يجب تحديد وقت تسليم الطلب بشكل منفصل باستخدام action_linkَين منفصلَين. يُرجى مراجعة الدليل التعليمي للتمييز بين خدمة استلام الطعام وخدمته لفهم كيفية تقديم عدة action_link لكل تاجر.

ملاحظة: للاطّلاع على التعريف المرجعي لسمة food_ordering_metadata، يُرجى الاطّلاع على مرجع خلاصة التاجر. للحصول على نموذج خلاصة يتضمّن وقت معالجة الطلب بتنسيق JSON، يمكنك الاطّلاع على نموذج رمز البيانات الوصفية لطلب الطعام

.

تحديد الرسوم من خلال الخلاصات

على غرار وقت معالجة الطلبات، يمكن تضمين الرسوم كجزء من رسالة action_link ضمن الحقل food_ordering_metadata. لكل action_link مرتبط بتاجر، يمكنك تقديم معلومات الرسوم باستخدام مسار الرسالة:

merchant.action_link.food_ordering_metadata.fee_details

في ما يلي عدة أمثلة على حالات الاستخدام المختلفة.

• رسوم تسليم ثابتة تبلغ 1.99 دولار أمريكي:

  [
    {
      "type": "DELIVERY",
      "fee_amount": {
        "amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        }
      }
    }
  ]

• رسوم تسليم بنسبة مئوية تبلغ %5.6

  [
    {
      "type": "DELIVERY",
      "fee_amount": {
        "cart_percentage": {
          "value": "5.6"
        }
      }
    }
  ]

• تتراوح رسوم الخدمة بين 1.99 دولار أمريكي و9.99 دولار أمريكي.

  [
    {
      "type": "SERVICE",
      "fee_amount": {
        "amount_range": {
          "min_amount": {
            "currency_code": "USD",
            "units": "1",
            "nanos": "990000000"
          },
          "max_amount": {
            "currency_code": "USD",
            "units": "9",
            "nanos": "990000000"
          }
        }
      }
    }
  ]

• تتراوح النسبة المئوية لرسوم الخدمة بين ‎1.2% و‎2.7%.

  [
    {
      "type": "SERVICE",
      "fee_amount": {
        "cart_percentage": {
          "value_range": {
            "min_value": "1.2",
            "max_value": "2.7"
          }
        }
      }
    }
  ]

• رسومان، هما رسوم الخدمة التي تبلغ 5 دولار أمريكي ورسوم التوصيل التي تبلغ ‎1.2%.

  [
    {
      "type": "SERVICE",
      "fee_amount": {
        "amount": {
          "currency_code": "USD",
          "units": "5",
          "nanos": "0"
        }
      }
    },
    {
      "type": "DELIVERY",
      "fee_amount": {
        "cart_percentage": {
          "value": "1.2"
        }
      }
    }
  ]

ملاحظة: الإدخالان amount وamount_range من النوع google.type.Money

دقة الرسوم ووقت توصيل الطلب

دقة الرسوم

عند تقديم بيانات الرسوم للتاجر، نتوقع منك تقديم تمثيل دقيق لرسومك. يجب تضمين جميع رسوم التسليم والخدمة التي قد تنطبق على طلب معيّن.

ندرك أنّ الرسوم قد تختلف بمرور الوقت وحسب المستخدمين. لهذا السبب، نوفّر إمكانية تحديد الرسوم كنطاقات، بما في ذلك النطاقات المفتوحة. في الحالات التي يمكن أن تختلف فيها الرسوم بشكل كبير، تأكَّد من أنّ النطاق المقدَّم يتضمّن الرسوم التي يمكن أن يراها المستخدم أثناء معاملته.

إذا لم تكن متأكدًا من المتطلبات المحدّدة في حالتك، يُرجى التواصل مع جهة التواصل التي تتعامل معها في "مركز الإجراءات".

دقة وقت توصيل الطلبات

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

• تغييرات في وقت معالجة الطلبات استنادًا إلى حجم الطلب
• تغييرات في وقت تسليم الطلبات استنادًا إلى الوقت المستغرَق لإكمال عملية الطلب والدفع
• وقت الاستجابة بين تعديل التغييرات في وقت معالجة الطلبات من خلال الخلاصات
• عنوان تسليم المستخدم

قد يؤدي أيّ من هذه العوامل إلى حدوث حالات يكون فيها وقت تنفيذ الطلب الذي يظهر للمستخدم في البداية مختلفًا عن الوقت الدقيق الذي سيظهر له عند الدفع. إنّ الهدف من تنفيذ وقت التسليم ليس القضاء على هذه الأخطاء تمامًا، بل تقديم معلومات واضحة للمستخدمين قدر الإمكان.

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

إذا لم تكن متأكّدًا من الخطوات التي يجب اتّخاذها في حالتك، يُرجى التواصل مع جهة التواصل التي تتعامل معها في "مركز الإجراءات".