Tempo e taxas de atendimento

Neste tutorial, vamos abordar:

  1. Uma descrição de alto nível dos casos de uso de taxa e tempo de atendimento compatíveis
  2. Instruções específicas sobre como especificar o tempo de atendimento e as taxas de atendimento do pedido para action_link(s) nos seus feeds
  3. Expectativas de precisão

Para uma amostra completa de feed que mostra o uso do tempo e das taxas de atendimento do pedido, consulte Exemplo de EPA de redirecionamento de pedidos.

Casos de uso de taxa e tempo de atendimento

Casos de uso de taxas

Oferecemos várias maneiras diferentes de especificar taxas. Os pontos abaixo descrevem os diferentes casos de uso compatíveis, além de uma linguagem de exemplo semelhante à que o usuário verá no front-end.

  • Taxa fixa: "Taxa de entrega de US $5" ou "Taxa de serviço de US $5"
  • Taxa percentual: "Taxa de entrega 5%" ou "Taxa de serviço 5%"
  • Intervalos de taxa: "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"

Conforme mostrado nos exemplos acima, 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 R $5").

Não há suporte para casos de uso que exigem a atualização de taxas ao longo do dia ou que são alteradas com base nas informações sobre o usuário.

Casos de uso de tempo de atendimento

Permitimos vários formatos diferentes para especificar o tempo de disponibilidade e garantir o fornecimento de dados precisos. Os pontos abaixo descrevem os diferentes casos de uso compatíveis, além de alguns exemplos de linguagem semelhantes à 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 hora" ou "Retirada em 15 a 20 min"
  • Períodos abertos: "Entrega em mais de 10 min" ou "Retirada em menos de 1 h"

O tempo de atendimento pode ser especificado para retirada e entrega usando um formato comum (descrito abaixo). Conforme mostrado nos exemplos acima, o texto mostrado aos usuários vai refletir o tipo de atendimento especificado no link de ação.

Não há suporte para casos de uso que exigem a atualização de horários ao longo do dia ou a mudança com base nas informações sobre o usuário.

Como especificar o tempo de atendimento do pedido por meio de feeds

O tempo de atendimento do pedido para links de ação é incluído na mensagem action_link do feed do comerciante, como parte do campo food_ordering_metadata. Para cada action_link associado ao comerciante, você precisa fornecer informações de fulfillment usando um dos caminhos da mensagem.

Tempo de atendimento fixo

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Essas mensagens devem estar no seguinte formato:

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

Tempo de atendimento do intervalo

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Essa mensagem deve estar no seguinte formato:

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

Como especificar taxas por meio de feeds

Assim como o tempo de atendimento do pedido, as taxas podem ser incluídas como parte da mensagem action_link no campo food_ordering_metadata. Para cada action_link associado a um comerciante, você pode fornecer informações de taxa usando o caminho da mensagem:

merchant.action_link.food_ordering_metadata.fee_details

Veja abaixo vários exemplos de diferentes casos de uso.
  • Uma taxa de entrega fixa de US $1,99: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • Uma taxa de entrega percentual de 5,6%. 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • A taxa de serviço varia de US $1,99 a US $9,99. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]
  • A porcentagem da taxa de serviço varia de 1,2% a 2,7%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • Duas taxas: uma taxa de serviço de US $5 e uma taxa de entrega de 1,2%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Precisão da taxa e do tempo de atendimento

Precisão da taxa

Quando você fornece dados de taxas para um comerciante, precisamos fazer uma representação precisa. Inclua todas as taxas de entrega e serviço aplicáveis a um pedido.

Sabemos que as taxas podem variar com o tempo e entre 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 o intervalo fornecido abrange as tarifas que o usuário pode consultar durante a transação.

Se você não tiver certeza do que é necessário no seu caso, fale com seu contato na Central de ações.

Precisão do tempo de atendimento do pedido

Entendemos que as especificidades do tempo de atendimento dos pedidos mudam com base em vários fatores. Entre esses fatores estão:

  • Mudanças no tempo de atendimento do pedido com base no tamanho do pedido
  • Mudanças no tempo de atendimento do pedido com base no tempo de conclusão do pedido e finalização da compra
  • Latência entre o momento em que as alterações no tempo de atendimento do pedido são atualizadas por feeds
  • É o endereço de entrega do usuário.

Qualquer um desses fatores pode levar a situações em que o tempo de atendimento do pedido mostrado inicialmente para o usuário não seja o tempo exato que ele vai encontrar na finalização da compra. O objetivo da implementação do tempo de atendimento não é eliminá-los completamente, mas oferecer informações claras aos usuários com a maior frequência possível.

Os parceiros precisam fornecer uma implementação que leve a um tempo de atendimento preciso mostrado aos usuários com a maior frequência possível, da melhor maneira possível. Se houver uma variabilidade significativa no tempo por causa desses fatores, sugerimos que você forneça um intervalo de períodos que inclua essa variabilidade. Além disso, se o tempo de atendimento mudar devido aos detalhes do pedido, isso vai ser mostrado claramente aos usuários quando chegar ao fluxo de pedidos.

Se você não tiver certeza do que é necessário no seu caso, fale com seu contato da Central de ações.