В этом уроке рассматриваются:
- Высокоуровневое описание того, какие варианты использования комиссий и времени выполнения поддерживаются.
- Конкретные инструкции о том, как указать время выполнения заказа и комиссию для сервисных фидов .
- Ожидания от точности
Полный образец фида, показывающий использование времени выполнения заказа и сборов, см. в примере перенаправления заказов 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"]
}
}
Различные типы комиссий
Ниже приведены несколько простых в использовании примеров указания выбранного типа комиссии.Зафиксированный
{
"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 минут–1 часа» или «Самовывоз через 15–20 минут».
Время выполнения может быть указано как для самовывоза, так и для доставки, используя общий формат (описанный ниже).
Не поддерживаются варианты использования, требующие изменения ETA на основе информации о пользователе.
Примеры сроков выполнения
Время выполнения заказа для ссылок на действия включается в сообщение 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"
}
},
Точность комиссии и времени выполнения
Точность комиссии
Когда вы предоставляете данные о комиссиях для продавца, мы ожидаем, что вы предоставите точное представление о ваших комиссиях. Вы должны включить все сборы за доставку и обслуживание, которые могут применяться к заказу.
Мы понимаем, что сборы могут меняться с течением времени и среди разных пользователей. По этой причине мы предлагаем возможность указывать комиссии в виде диапазонов, включая открытые диапазоны. В случаях, когда комиссии могут значительно различаться, убедитесь, что указанный диапазон включает комиссии, которые пользователь может видеть во время транзакции.
Если вы не уверены в том, что именно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.
Точность сроков выполнения заказа
Мы понимаем, что особенности сроков выполнения заказов меняются в зависимости от множества факторов. Эти факторы включают в себя:
- Изменения времени выполнения заказа в зависимости от размера заказа
- Изменения времени выполнения заказа в зависимости от времени завершения заказа и оформления заказа.
- Задержка между обновлениями времени выполнения заказа через каналы
- Адрес доставки пользователя.
Любой из этих факторов может привести к ситуациям, когда время выполнения заказа, отображаемое пользователю изначально, не будет точным временем выполнения, которое он увидит при оформлении заказа. Целью реализации времени выполнения является не полное их устранение, а предоставление пользователям четкой информации как можно чаще.
Ожидается, что партнеры обеспечат реализацию, которая приведет к тому, что пользователи будут видеть точное время выполнения как можно чаще и приложит все усилия. Если из-за этих факторов существует значительная изменчивость во времени, мы предлагаем вам указать диапазон времени, охватывающий эту изменчивость. Кроме того, если время выполнения меняется из-за деталей заказа, это должно быть ясно показано пользователям, когда они появятся в вашем потоке заказов.
Если вы не уверены в том, что именно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.
Своевременные обновления сборов и расчетных сроков исполнения
Обработка любых изменений с использованием обычной загрузки фида может занять не менее двух часов. Это особенно важно отметить, если вы планируете часто менять расчетное время прибытия.
Партнерам настоятельно рекомендуется внедрить обновления в реальном времени , которые позволяют вызову API изменять фид службы (включая комиссии и расчетное время прибытия) в течение 5 минут или меньше.