Este tutorial explica:
- Uma descrição detalhada dos casos de uso de taxas e tempo de atendimento do pedido
- Instruções específicas sobre como especificar o tempo de atendimento e as taxas do pedido para feeds de serviço.
- Expectativas de precisão
Para ver uma amostra completa do feed que mostra o uso do tempo de atendimento e das taxas do pedido, consulte a amostra de EPA de redirecionamento do pedido.
Taxas
Oferecemos várias maneiras de especificar taxas, como:
- Taxa fixa: "Taxa de entrega de R $5" ou "Taxa de serviço de R $5".
- Taxa percentual: "Taxa de entrega de 5%" ou "Taxa de serviço de 5%".
- Intervalos de taxas: "Taxas de entrega de US $2 a US$ 10" ou "Taxas de serviço de 3% a 6%"
- Intervalos abertos "Taxas de entrega a partir de 5%" ou "Taxas de serviço de até US $20"
As taxas podem ser especificadas como taxas de entrega ou de serviço. Também é possível especificar várias taxas (por exemplo, "Taxa de serviço de 5% a 10%, taxa de entrega de US $5").
Não compatíveis são casos de uso que exigem que as taxas mudem com base nas informações sobre o usuário.
Exemplos de taxas
Taxas de entrega e retirada
O aplicativo é compatível com os tipos de taxa "ENTREGA" e "SERVIÇO".Entrega
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Serviço
{
"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 taxas
Confira a seguir alguns exemplos fáceis de usar para especificar o tipo de taxa escolhido.Corrigido
{
"fee": {
"fee_id": "12345/delivery_fee",
"fee_type": "DELIVERY",
"fixed_amount": {
"currency_code": "USD",
"units": 10,
"nanos": 0
},
"service_ids": ["service/entity002"]
}
}
Porcentagem do carrinho
{
"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"
]
}
}
Intervalo
{
"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"
]
}
}
Tempo de atendimento do pedido
Permitimos vários formatos diferentes para especificar o tempo de disponibilidade para garantir o fornecimento de dados precisos. Os pontos a seguir descrevem os diferentes casos de uso aceitos, junto com alguns exemplos de linguagem semelhantes à que o usuário verá no front-end.
- Horários fixos: "Entrega em 30 min" ou "Retirada em 15 minutos".
- Intervalos de tempo: "Entrega em 30 min a 1 hora" ou "Retirada em 15 a 20 minutos"
O tempo de atendimento pode ser especificado para retirada e entrega usando um formato comum (descrito abaixo).
Incompatível são casos de uso que exigem que os ETAs mudem com base nas informações do usuário.
Exemplos de tempo de atendimento
O tempo de atendimento do pedido para links de ação está incluído na mensagem ETA do feed de serviços, como parte do campo FoodOrderingService.
Corrigido
{
"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 tempo
{
"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"
}
},
Precisão da taxa e do tempo de atendimento
Taxa de precisão
Ao fornecer dados de taxas a um comerciante, esperamos que você informe seus valores de maneira precisa. Inclua todas as taxas de entrega e serviço aplicáveis a um pedido.
Sabemos que as tarifas podem variar com o tempo e de acordo com os usuários. Por esse motivo, oferecemos a capacidade de especificar taxas como intervalos, incluindo intervalos abertos. Nos casos em que as taxas podem variar significativamente, verifique se a faixa fornecida inclui as taxas que o usuário pode ver durante a transação.
Se você não tiver certeza do que é necessário no seu caso, procure seu contato da Central de ações.
Precisão do tempo de atendimento do pedido
Entendemos que os detalhes do tempo de atendimento do pedido mudam com base em vários fatores. Entre esses fatores estão:
- Mudanças no tempo de processamento do pedido com base no tamanho
- Mudanças no tempo de atendimento do pedido com base no tempo de conclusão do pedido e da finalização da compra
- Latência entre a atualização das mudanças no horário de atendimento do pedido pelos feeds
- O endereço de entrega do usuário.
Qualquer um desses fatores pode levar a situações em que o tempo de processamento do pedido exibido inicialmente ao usuário não é o tempo exato que ele verá na finalização da compra. O objetivo da implementação do tempo de atendimento não é eliminá-los completamente, mas fornecer informações claras aos usuários com a maior frequência possível.
Os parceiros precisam fornecer uma implementação que mostre aos usuários o tempo de atendimento com precisão e com base no melhor esforço. Se houver uma variabilidade significativa no tempo devido a esses fatores, sugerimos que você forneça um intervalo de períodos que abranja essa variabilidade. Além disso, se o tempo de atendimento mudar devido aos detalhes do pedido, isso precisa ser mostrado claramente aos usuários quando chegarem no fluxo de pedido.
Se você não tiver certeza do que é necessário especificamente no seu caso, converse com seu contato da Central de ações.
Atualizações em tempo hábil de taxas e ETAs
Qualquer alteração feita usando um upload de feed normal pode levar pelo menos duas horas para ser processada. É importante observar isso especialmente se você planeja alterar os ETAs com frequência.
É altamente recomendável que os parceiros implementem atualizações em tempo real, que permitem que uma chamada de API altere o feed de serviço (incluindo taxas e ETAs) em até cinco minutos.