Tempo e taxas de atendimento

Este tutorial explica:

1. Uma descrição geral dos custos e há suporte para casos de uso de tempo de fulfillment
2. Instruções específicas sobre como especificar o tempo de atendimento e as taxas do pedido para Feeds de serviço.
3. 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

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

{
  "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

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

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

{
  "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 .

{
    "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"
    }
},

{
    "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.

{
  "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.