Tiempo de entrega y tarifas (solo para contenido heredado)

En este instructivo, se explica lo siguiente:

Una descripción general de los casos de uso de tarifas y tiempos de entrega admitidos
Instrucciones específicas para especificar el tiempo de entrega y las tarifas de los action_link en tus feeds
Expectativas de precisión

Para ver un ejemplo de feed completo que muestre el uso de las tarifas y el tiempo de entrega de pedidos, consulta el ejemplo de la EPA de redireccionamiento de pedidos.

Casos de uso de tarifas y tiempos de entrega

Casos de uso de tarifas

Proporcionamos varias formas diferentes de especificar las tarifas. En los siguientes puntos, se describen los diferentes casos de uso compatibles, junto con un lenguaje de ejemplo similar al que el usuario verá en el frontend.

Tarifa fija: "Tarifa de envío de USD 5" o "Tarifa del servicio de USD 5"
Tarifa porcentual: "Tarifa de entrega 5%" o "Tarifa de servicio 5%"
Rangos de tarifas: "Tarifas de entrega de USD 2 a USD 10" o "Tarifas del servicio del 3% al 6%"
Rangos abiertos: “Los costos de entrega comienzan en un 5%” o “Cargos del servicio de hasta USD 20”

Como se muestra en los ejemplos anteriores, las tarifas se pueden especificar como una tarifa de entrega o una tarifa de servicio. También es posible especificar varias tarifas (p.ej., "Tarifa del servicio del 5% al 10%, Tarifa de entrega de USD 5").

No se admiten casos de uso que requieran que las tarifas se actualicen a lo largo del día o que cambien según la información del usuario.

Casos de uso de tiempo de entrega

Permitimos varios formatos diferentes para especificar el tiempo de disponibilidad para garantizar que proporciones datos precisos. En los siguientes puntos, se describen los diferentes casos de uso admitidos, junto con un lenguaje de ejemplo similar al que el usuario verá en el frontend.

Horarios fijos: “Entrega en 30 min” o “Retiro en 15 min”
Intervalos de tiempo: "Entrega en 30 min-1 hr" o "Retiro en 15-20 min"
Intervalos de tiempo abiertos: “Entrega en más de 10 minutos” o “Retiro en menos de 1 hora”

El tiempo de entrega se puede especificar para la recolección y la entrega con un formato común (que se describe a continuación). Como se muestra en los ejemplos anteriores, el texto que se muestra a los usuarios reflejará el tipo de entrega especificado en el vínculo de acción.

No se admiten casos de uso que requieran que los horarios se actualicen a lo largo del día o que cambien según la información del usuario.

Cómo especificar el tiempo de entrega de los pedidos a través de feeds

El tiempo de entrega de pedidos para los vínculos de acción se incluye en el mensaje action_link del feed de Merchant Center, como parte del campo food_ordering_metadata. Para cada action_link asociado con el comercio, debes proporcionar información de entrega mediante una de las instrucciones de enrutamiento de mensajes.

Tiempo de entrega fijo

Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Estos mensajes deben tener el siguiente formato:

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

Tiempo de entrega del rango

Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

Este mensaje debe tener el siguiente formato:

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

Advertencia: No especifiques fulfillment_lead_time_duration ni fulfillment_lead_time_duration_range como parte de un solo objeto action_link.

Nota: fulfillment_lead_time_duration, fulfillment_lead_time_duration_range.min_duration y fulfillment_lead_time_duration_range.max_duration son de tipo google.protobuf.Duration y les proporcionan a los usuarios una hora de llegada estimada para su acción de entrega.

Cómo especificar las tarifas a través de feeds

Al igual que con el tiempo de preparación del pedido, las tarifas se pueden incluir como parte del mensaje action_link en el campo food_ordering_metadata. Para cada action_link asociado con un comercio, puedes proporcionar información sobre las tarifas mediante la ruta de mensajes:

merchant.action_link.food_ordering_metadata.fee_details

A continuación, se muestran varios ejemplos de los diferentes casos de uso.

Una tarifa de entrega fija de USD 1.99:

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]

Un porcentaje del costo de entrega del 5.6%.

[
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]

Un cargo del servicio de entre USD 1.99 y USD 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"
        }
      }
    }
  }
]

Un porcentaje de cargo del servicio de entre el 1.2% y el 2.7%

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]

Dos tarifas: una de servicio de USD 5 y una de envío del 1.2%.

[
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Nota: Las entradas amount y amount_range son de tipo google.type.Money.

Exactitud de las tarifas y los tiempos de entrega

Precisión de las tarifas

Cuando proporciones datos de tarifas de un comercio, esperamos que proporciones una representación precisa de tus tarifas. Debes incluir todas las tarifas de entrega y servicio que puedan aplicarse a un pedido.

Reconocemos que las tarifas pueden variar con el tiempo y entre los usuarios. Por este motivo, ofrecemos la posibilidad de especificar las tarifas como rangos, incluidos los rangos abiertos. En los casos en que las tarifas pueden variar de forma significativa, asegúrate de que el rango proporcionado incluya las tarifas que un usuario podría ver durante su transacción.

Si no sabes con exactitud qué se requiere en tu caso, comunícate con tu contacto de Acciones Center.

Exactitud del tiempo de entrega de los pedidos

Entendemos que los detalles del tiempo de entrega de los pedidos cambian según varios factores. Entre estos factores, se incluyen los siguientes:

Cambios en el tiempo de preparación de pedidos según el tamaño
Cambios en el tiempo de entrega de pedidos según el tiempo para completar el pedido y el pago
Latencia entre el momento en que se actualizan los cambios en el tiempo de entrega de los pedidos a través de los feeds
Es la dirección de entrega del usuario.

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

Se espera que los socios proporcionen una implementación que genere un tiempo de entrega preciso que se muestre a los usuarios con la mayor frecuencia posible, según el criterio del mejor esfuerzo. Si hay una variabilidad significativa en los tiempos debido a estos factores, te sugerimos que proporciones un rango de tiempos que incluya esa variabilidad. Además, si el tiempo de entrega cambia debido a los detalles del pedido, se debe mostrar claramente a los usuarios cuando lleguen a tu flujo de pedidos.

Si no sabes con exactitud qué se requiere en tu caso, comunícate con tu contacto de Actions Center.