В этом уроке рассматриваются:
- Высокоуровневое описание того, какие варианты использования комиссий и времени выполнения поддерживаются.
- Конкретные инструкции о том, как указать время выполнения заказа и комиссию для сервисных фидов .
- Ожидания от точности
Полный образец фида, показывающий использование времени выполнения заказа и сборов, см. в примере перенаправления заказов 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"
}
},
Временные окна выполнения
С помощью ServiceHours время выполнения можно установить для определенного временного окна. Значение lead_time по умолчанию, установленное в FoodOrderingService используется, когда время обслуживания находится за пределами часов обслуживания.
lead_time , равное 2400s , будет отображаться с 11:00 до 13:30.lead_time , равный 1200s будет отображаться до 11:00 и после 13: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"
}
}
]
}
}
]
}
Точность комиссии и времени выполнения
Точность комиссии
Когда вы предоставляете данные о комиссиях для продавца, мы ожидаем, что вы предоставите точное представление о ваших комиссиях. Вы должны включить все сборы за доставку и обслуживание, которые могут применяться к заказу.
Мы понимаем, что сборы могут меняться с течением времени и в зависимости от пользователя. По этой причине мы предлагаем возможность указывать комиссии в виде диапазонов, включая открытые диапазоны. В случаях, когда комиссии могут значительно различаться, убедитесь, что указанный диапазон включает комиссии, которые пользователь может видеть во время транзакции.
Если вы не уверены в том, что конкретно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.
Точность сроков выполнения заказа
Мы понимаем, что особенности сроков выполнения заказов меняются в зависимости от множества факторов. Эти факторы включают в себя:
- Изменения времени выполнения заказа в зависимости от размера заказа
- Изменения времени выполнения заказа в зависимости от времени завершения заказа и оформления заказа.
- Задержка между обновлениями времени выполнения заказа через каналы
- Адрес доставки пользователя.
Любой из этих факторов может привести к ситуациям, когда время выполнения заказа, отображаемое пользователю изначально, не будет точным временем выполнения, которое он увидит при оформлении заказа. Целью реализации времени выполнения является не полное их устранение, а предоставление пользователям четкой информации как можно чаще.
Ожидается, что партнеры обеспечат реализацию, которая приведет к тому, что пользователи будут видеть точное время выполнения как можно чаще и приложит все усилия. Если из-за этих факторов существует значительная изменчивость сроков, мы предлагаем вам указать диапазон времени, охватывающий эту изменчивость. Кроме того, если время выполнения меняется из-за деталей заказа, это должно быть ясно показано пользователям, когда они появятся в вашем потоке заказов.
Если вы не уверены в том, что именно требуется в вашем случае, обратитесь к контактному лицу в Центре действий.
Своевременные обновления сборов и расчетных сроков прибытия
Обработка любых изменений при обычной загрузке фида может занять не менее двух часов. Это особенно важно отметить, если вы планируете часто менять расчетное время прибытия.
Партнерам настоятельно рекомендуется внедрить обновления в реальном времени , которые позволяют вызову API изменять фид службы (включая комиссии и расчетное время прибытия) в течение 5 минут или меньше.