En este instructivo, se explica lo siguiente:
- Una descripción de alto nivel de los casos de uso de tarifas y tiempo de entrega compatibles
- Instrucciones específicas para especificar el tiempo de entrega y las tarifas de los pedidos para los feeds de servicio.
- Expectativas de precisión
Para ver una muestra de feed completa en la que se muestra el uso del tiempo de entrega y las tarifas de los pedidos, consulta la muestra de la EPA de redireccionamiento de pedidos.
Tarifas
Ofrecemos varias formas diferentes de especificar las tarifas, como las siguientes:
- Tarifa fija: "Tarifa de entrega de USD 5" o "Tarifa de servicio de USD 5"
- Tarifa de porcentaje: “Tarifa de entrega del 5%” o “Cargos del servicio del 5%”
- Rangos de tarifas: “Tarifas de entrega de USD 2 a USD 10” o “Cargos del servicio del 3% al 6%”
- Rangos finales abiertos: “Tarifas de envío a partir del 5%” o “Cargos del servicio de hasta USD 20”
Las tarifas se pueden especificar como cargos de entrega o cargos del servicio. También es posible especificar varias tarifas (p.ej., “Cargos del servicio del 5% al 10%, cargos de entrega de USD 5”).
No se admiten los casos de uso en los que se requiere que se apliquen tarifas para cambiar en función de la información del usuario.
Ejemplos de tarifas
Tarifas de entrega y retiro
La aplicación admite los tipos de tarifa "ENTREGA" y "SERVICIO".Entrega
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Servicio
{
"fee": {
"fee_id": "12345/service_fee",
"fee_type": "SERVICE",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Diferentes tipos de tarifas
A continuación, se presentan algunos ejemplos fáciles de usar para especificar un tipo de tarifa elegido.Fijo
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Porcentaje del carrito
{
"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"
]
}
}
Rango
{
"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"
]
}
}
Hora de entrega
Permitimos varios formatos diferentes para especificar el tiempo de disponibilidad a fin de garantizar que proporciones datos precisos. En los siguientes puntos, se describen los diferentes casos de uso admitidos, junto con un lenguaje de ejemplo similar al que el usuario verá en el frontend.
- Horarios fijos: “Entrega en 30 min” o “Retiro en 15 min”
- Intervalos de tiempo: “Entrega entre 30 min y 1 h” o “Retiro en 15 a 20 min”.
El tiempo de entrega se puede especificar para el retiro y la entrega con un formato común (que se describe a continuación).
No se admiten los casos de uso que requieren que los ETA cambien en función de la información del usuario.
Ejemplos de hora de entrega
El tiempo de entrega del pedido para los vínculos de acciones se incluye en el mensaje ETA del feed de servicios, como parte del campo FoodOrderingService.
Fijo
{
"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"
}
},
Intervalo de tiempo
{
"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"
}
},
Precisión de las tarifas y el tiempo de entrega
Precisión de las tarifas
Cuando proporciona datos de tarifas para un comercio, esperamos que proporcione una representación precisa de sus tarifas. Debes incluir todos los cargos del servicio y de entrega que podrían aplicarse a un pedido.
Reconocemos que las tarifas pueden variar con el tiempo y según el usuario. Por este motivo, ofrecemos la capacidad de especificar tarifas como rangos, incluidos los abiertos. En los casos en que las tarifas pueden variar significativamente, asegúrate de que el rango proporcionado incluya las tarifas que un usuario podría ver durante la transacción.
Si no estás seguro de qué se requiere en tu caso, comunícate con tu contacto del Centro de Actions.
Precisión del tiempo de entrega de los pedidos
Entendemos que los detalles del tiempo de entrega de los pedidos cambian en función de diversos factores. Entre estos factores, se incluyen los siguientes:
- Cambios en el tiempo de entrega del pedido según su tamaño
- Cambios en el tiempo de entrega de los pedidos en función del tiempo necesario para completar el pedido y la confirmación de la compra
- La latencia entre el momento en que los cambios en el tiempo de entrega de los pedidos se actualizan a través de feeds
- Es la dirección de entrega del usuario.
Cualquiera de estos factores puede generar situaciones en las que el tiempo de entrega del pedido que se muestra al usuario inicialmente no es el tiempo de entrega exacto que verá en la confirmación de la compra. El objetivo de la implementación del tiempo de entrega no es eliminarlos por completo, sino proporcionar información clara a los usuarios con tanta frecuencia como sea posible.
Se espera que los socios proporcionen una implementación que conduzca a tiempos de entrega exactos que se muestren a los usuarios con la mayor frecuencia posible y en función del mejor esfuerzo. Si hay una variabilidad significativa en el tiempo debido a estos factores, te sugerimos que proporciones un rango de períodos que abarquen esa variabilidad. Además, si el tiempo de entrega cambia debido a los detalles del pedido, esto debería mostrarse claramente a los usuarios cuando llegue al flujo de pedidos.
Si no estás seguro de qué se requiere en tu caso, comunícate con tu contacto del Centro de Actions.
Actualizaciones oportunas de las tarifas y los ETA
Los cambios que se realicen con una carga normal de un feed pueden tardar, al menos, 2 horas en procesarse. Es muy importante tener esto en cuenta si planeas cambiar los ETA con frecuencia.
Se recomienda que los socios implementen las actualizaciones en tiempo real, que permiten que una llamada a la API cambie el feed de servicio (incluidas las tarifas y los ETA) en 5 minutos o menos.