Tarifas y hora de la entrega

En este instructivo, se explica lo siguiente:

  1. Una descripción general de qué tarifa y se admiten casos de uso de tiempo de entrega
  2. Instrucciones específicas sobre cómo especificar el tiempo de entrega y las tarifas de los pedidos para Feeds de servicios.
  3. Expectativas de precisión

Para ver una muestra de feed completa en la que se muestra el uso de las tarifas y el tiempo de entrega del pedido, consulta la Cómo pedir un ejemplo de EPA de redireccionamiento de pedidos.

Tarifas

Ofrecemos varias formas diferentes de especificar las tarifas, como las siguientes:

  • Tarifa fija: "Tarifa de entrega de USD 5" o "Cargos del servicio de USD 5"
  • Tarifa de porcentaje: “Tarifa de entrega del 5%” o "Cargos del servicio del 5%"
  • Rangos de tarifas: “Tarifas de entrega de USD 2 a USD 10” o "Cargos del servicio del 3% al 6%"
  • Rangos finales abiertos: “Las tarifas de entrega comienzan en un 5%” o "Cargos del servicio de hasta USD 20"

Las tarifas se pueden especificar como cargos de entrega o cargos del servicio. También es posible especificar varias tarifas (p.ej., “Cargos del servicio del 5% al 10%, cargos de entrega de USD 5”).

No se admiten casos de uso en los que se requiere que se apliquen tarifas para cambiar en función de la información sobre el usuario.

Ejemplos de tarifas

Tarifas de entrega y retiro

La aplicación admite los tipos de tarifa "ENTREGA" y "SERVICIO".

Entrega

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

Servicio

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

A continuación, se presentan algunos ejemplos fáciles de usar para especificar una tarifa elegida el tipo de letra.

Fijo

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

Porcentaje del carrito

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

Rango

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

Hora de entrega

Permitimos varios formatos diferentes para especificar el horario de disponibilidad y, así, asegurar que tu proporcionando datos exactos. En los siguientes puntos, se describen los distintos casos de uso admitidos, junto con con algún ejemplo de lenguaje similar al que verá el usuario en el frontend.

  • Tiempos fijos: “Entrega en 30 min” o "Retiro en 15 min"
  • Intervalos de tiempo: “Entrega en 30 min-1 h”. o “Retiro en 15-20 min”

El tiempo de entrega se puede especificar para el retiro y la entrega con un formato común (como se describe a continuación).

No se admiten los casos de uso que requieren que los ETA cambien en función de la información del usuario.

Ejemplos de hora de entrega

El tiempo de entrega del pedido para los vínculos de acciones se incluye en el feed de servicios. ETA mensaje, como parte del FoodOrderingService .

Fijo

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

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

Períodos de entrega

Con ServiceHours, se pueden establecer los tiempos de entrega para un período específico. Predeterminado Se estableció lead_time en el FoodOrderingService está en uso cuando está fuera de los períodos de horario de servicio.

En este ejemplo, la lead_time de 2400s se mostrará de 11:00 a.m. a 1:30 p.m.
Los lead_time de 1200s se mostrarán antes del desde las 11:00 a.m. hasta la 1:30 p.m.
{
  "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"
            }
          }
        ]
      }
    }
  ]
}

Tarifa y precisión en el tiempo de entrega

Precisión de las tarifas

Cuando proporciona datos de tarifas para un comercio, esperamos que proporcione una representación precisa de tus tarifas. Debes incluir todos los cargos del servicio y de entrega que podrían aplicarse a un pedido.

Reconocemos que las tarifas pueden variar con el tiempo y según el usuario. Por este motivo, ofrecemos la capacidad de especificar tarifas como rangos, incluidos los rangos abiertos. En los casos en que las tarifas pueden variar asegurarse significativamente de que el intervalo proporcionado incluya las tarifas que un usuario podría ver durante su transacción.

Si no estás seguro específicamente de qué se requiere en tu caso, comunícate con tu Contacto del Centro de acciones.

Precisión del tiempo de entrega de los pedidos

Entendemos que los detalles específicos de la entrega de pedidos el cambio temporal basado en diversos factores. Entre estos factores, se incluyen los siguientes:

  • Cambios en el tiempo de entrega del pedido según su tamaño
  • Los cambios en el tiempo de entrega del pedido en función del tiempo necesario para completar el pedido confirmación de la compra
  • La latencia entre el momento en que los cambios en el tiempo de entrega del pedido se actualizan a través de feeds
  • Es la dirección de entrega del usuario.

Cualquiera de estos factores puede dar lugar a situaciones en las que la entrega del pedido el tiempo que se muestra al usuario inicialmente no es el tiempo de entrega exacto que en la confirmación de la compra. El objetivo de la implementación del tiempo de entrega para eliminarlos por completo, sino para proporcionar información clara a los usuarios con la mayor frecuencia posible.

Se espera que los socios proporcionen una implementación que conduzca el tiempo de entrega que se muestra a los usuarios con la mayor frecuencia posible, según base. Si hay una variabilidad significativa en el tiempo debido a estos factores, sugerimos proporciona un rango de períodos que abarcan esa variabilidad. Además, si el tiempo de entrega cambia debido a los detalles del pedido, Esto debe mostrarse claramente a los usuarios cuando llegues a tu flujo de pedidos.

Si no estás seguro específicamente de qué es obligatoria en tu caso, comunícate con tu contacto del Centro de Actions.

Actualizaciones oportunas de las tarifas y los ETA

Los cambios que se realicen con una carga de feed normal pueden demorar, al menos, 2 horas. para procesarlos. Es especialmente importante tener esto en cuenta si planeas cambiar los ETA. con frecuencia.

Se recomienda a los socios que implementen las actualizaciones en tiempo real, que permite que una llamada a la API cambie el feed de servicio (incluidas las tarifas y los ETA) en 5 minutos o menos.