Tempo de processamento e taxas (somente legado)

Este tutorial orienta sobre:

Uma descrição geral dos casos de uso de taxa e tempo de atendimento com suporte
Instruções específicas sobre como especificar o tempo de entrega do pedido e as taxas para action_link(s) nos seus feeds
Expectativas de precisão

Para conferir um exemplo de feed completo que mostra o uso do tempo de fulfillment do pedido e das taxas, consulte o exemplo de EPA de redirecionamento de pedidos.

Casos de uso de taxas e tempo de fulfillment

Casos de uso de taxas

Oferecemos várias maneiras diferentes de especificar as taxas. Os pontos abaixo descrevem os diferentes casos de uso com suporte, além de alguns exemplos de linguagem semelhante ao que o usuário vai encontrar 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%"
Faixas de taxas: "Taxas de entrega de US $2 a US$ 10" ou "Taxas de serviço de 3% a 6%"
Intervalos abertos: "As taxas de entrega começam em 5%" ou "Taxas de serviço de até US $20"

Como mostrado nos exemplos acima, as taxas podem ser especificadas como taxa de entrega ou de serviço. Também é possível especificar várias taxas (por exemplo, "Taxa de serviço 5%-10%, taxa de entrega US $5").

Não há suporte para casos de uso que exigem que as taxas sejam atualizadas ao longo do dia ou que mudem com base nas informações sobre o usuário.

Casos de uso do tempo de fulfillment

Permitimos vários formatos diferentes para especificar o tempo de disponibilidade para garantir que você forneça dados precisos. Os pontos abaixo descrevem os diferentes casos de uso aceitos, além de alguns exemplos de linguagem semelhante ao que o usuário vai encontrar no front-end.

Tempos fixos: "Entrega em 30 minutos" ou "Retirada em 15 minutos"
Períodos: "Entrega em 30 minutos a 1 hora" ou "Retirada em 15 a 20 minutos"
Intervalos de tempo abertos: "Entrega em mais de 10 minutos" ou "Retirada em menos de 1 hora"

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

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

Como especificar o tempo de atendimento do pedido nos feeds

O tempo de entrega 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, é necessário fornecer informações de fulfillment usando um dos caminhos de mensagem.

Tempo de atendimento fixo

Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

As mensagens precisam estar no seguinte formato:

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

Intervalo de tempo de atendimento

Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

A mensagem precisa ter o seguinte formato:

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

Aviso:não especifique fulfillment_lead_time_duration e fulfillment_lead_time_duration_range como parte de um único objeto action_link.

Observação:fulfillment_lead_time_duration, fulfillment_lead_time_duration_range.min_duration e fulfillment_lead_time_duration_range.max_duration são do tipo google.protobuf.Duration e fornecem aos usuários um HEC para a ação de cumprimento.

Como especificar taxas nos feeds

Assim como o tempo de processamento 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, é possível fornecer informações de taxas usando o caminho da mensagem:

merchant.action_link.food_ordering_metadata.fee_details

Confira abaixo vários exemplos de casos de uso diferentes.

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"
      }
    }
  }
]

Uma 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"
        }
      }
    }
  }
]

Uma porcentagem de taxa de serviço 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 de serviço de US $5 e uma 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"
      }
    }
  }
]

Observação:as entradas amount e amount_range são do tipo google.type.Money

Precisão da taxa e do tempo de atendimento

Precisão da taxa

Ao fornecer dados de taxas para um comerciante, esperamos que você forneça uma representação precisa das suas taxas. Inclua todas as taxas de entrega e de serviço que possam ser aplicadas a um pedido.

Sabemos que as taxas podem variar ao longo do tempo e entre os usuários. Por esse motivo, oferecemos a possibilidade de especificar taxas como intervalos, incluindo intervalos abertos. Nos casos em que as taxas podem variar significativamente, verifique se o intervalo fornecido inclui as taxas que um 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 do Centro de ações.

Precisão do tempo de atendimento do pedido

Entendemos que os detalhes do tempo de entrega 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 processamento do pedido com base no tempo para concluir o pedido e finalizar a compra
Latência entre as mudanças no tempo de atendimento de pedidos atualizadas nos feeds
O endereço de entrega do usuário.

Qualquer um desses fatores pode levar a situações em que o tempo de entrega mostrado ao usuário inicialmente não é o tempo de entrega exato que ele vai ver na finalização da compra. O objetivo da implementação do tempo de atendimento não é eliminar esses problemas completamente, mas fornecer informações claras aos usuários o máximo possível.

Espera-se que os parceiros forneçam uma implementação que leve a um tempo de atendimento preciso mostrado aos usuários sempre que possível, com o melhor esforço possível. Se houver uma variabilidade significativa no tempo devido a esses fatores, sugerimos que você forneça um intervalo de tempos que inclua essa variabilidade. Além disso, se o tempo de entrega mudar devido aos detalhes do pedido, isso precisa ser mostrado claramente aos usuários quando eles chegarem ao fluxo de pedidos.