Este tutorial explica:
- Uma descrição geral dos custos e há suporte para casos de uso de tempo de fulfillment
- 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 um exemplo completo do feed que mostra o uso do tempo de atendimento e das taxas do pedido, consulte o Amostra de EPA de redirecionamento do pedido:
Taxas
Oferecemos várias maneiras de especificar taxas, como:
- Taxa fixa: "Taxa de entrega de R $5,00" ou "Taxa de serviço de US $5".
- Taxa percentual: "Taxa de entrega de 5%". ou "Taxa de serviço de 5%"
- Intervalos de taxas: "Taxas de entrega de R $2,00 a R$ 10,00" 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 a taxa escolhida não é válido.Fixo
{ "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 ajudar a garantir que você esteja fornecendo dados precisos. Os pontos a seguir descrevem os diferentes casos de uso com suporte, além com algum exemplo de linguagem semelhante ao que o usuário verá no front-end.
- Horários fixos: "Entrega em 30 min" ou "Retirada em 15 min"
- Intervalos de tempo: "Entrega em 30 min a 1 h" 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 horário de atendimento do pedido para links de ação está incluído no feed de serviços
ETA
da mensagem, como parte
FoodOrderingService
.
Fixo
{ "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" } },
Período
{ "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" } },
Janelas de tempo de atendimento
Com o ServiceHours
,
os tempos de atendimento podem ser definidos para um período específico. O padrão
lead_time
definido no
FoodOrderingService
é usado.
fora do horário de funcionamento.
lead_time
do
2400s
será exibido das 11h às 13h30.
O
lead_time
de 1200s
será exibido antes de
às 11h e depois das 13h30.
{ "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" } } ] } } ] }
Taxa e precisão do tempo de atendimento
Taxa de precisão
Ao fornecer dados de taxas a um comerciante, esperamos que você apresente informações precisas das taxas. 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 o capacidade de especificar taxas como intervalos, incluindo intervalos abertos. Nos casos em que as taxas podem variar verifique se a faixa fornecida abrange 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, entre em contato com seu Contato da Central de ações.
Precisão do tempo de atendimento do pedido
Entendemos que os detalhes do atendimento do pedido a mudança de horário 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 para concluir o pedido e pagamento
- 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 atendimento o tempo inicialmente mostrado para o usuário não é o horário de atendimento exato vai ver na finalização da compra. A meta da implementação do tempo de atendimento não é para eliminá-los completamente, mas também para fornecer informações claras aos usuários, sempre que possível.
Os parceiros devem fornecer uma implementação que leve a resultados tempo de atendimento exibido aos usuários com a maior frequência possível, da melhor maneira possível base. Se houver uma variabilidade significativa no tempo devido a esses fatores, sugerimos você fornece um intervalo de tempos que abrangem essa variabilidade. Além disso, se o tempo de atendimento mudar devido aos detalhes do pedido, Isso deve ser mostrado claramente aos usuários quando a chegada em seu fluxo de pedidos é feita.
Se você não tiver certeza do que no seu caso, converse com seu contato da Central de ações.
Atualizações em tempo hábil de taxas e ETAs
As mudanças feitas com um upload normal de feed podem levar pelo menos duas horas processar. É importante observar isso especialmente se você planeja alterar os HECs. com frequência.
É altamente recomendável que os parceiros implementem atualizações em tempo real, que permite que uma chamada de API mude o feed de serviços (incluindo taxas e ETAs) em até cinco minutos.