الوقت والرسوم لاستيفاء الطلب

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

  1. وصف عالي المستوى لحالات الاستخدام المتوافقة مع الرسوم ووقت توصيل الطلب
  2. تعليمات محدَّدة حول كيفية تحديد وقت توصيل الطلبات والرسوم في خلاصات الخدمات.
  3. التوقّعات بشأن الدقة

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

الرسوم

نقدّم العديد من الطُرق المختلفة لتحديد الرسوم، مثلاً:

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

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

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

أمثلة على الرسوم

رسوم التسليم والاستلام

يتيح التطبيق نوعَي رسوم "DELIVERY" و"SERVICE".

خدمة توصيل

{
  "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"]
  }
}

أنواع الرسوم المختلفة

يمكنك الاطّلاع أدناه على بعض الأمثلة السهلة الاستخدام لتحديد نوع رسوم تم اختياره.

ثابت

{
  "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 دقيقة"

يمكن تحديد وقت توصيل الطلب لكل من استلام الطلب وتوصيله باستخدام تنسيق شائع (على النحو الموضّح أدناه).

حالات الاستخدام غير المتاحة هي حالات الاستخدام التي تتطلب تغيير الوقت المقدّر للوصول بناءً على معلومات المستخدم.

أمثلة على وقت توصيل الطلب

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

ثابت

{
    "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"
    }
},

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

دقة الرسوم

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

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

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

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

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

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

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

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

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

تعديلات في الوقت المناسب على "الرسوم" و"الإعلانات النصية الموسَّعة"

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

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

السابق
خلاصة الخدمة
التالي
حزمة Proto للخلاصة