Tarifas y hora de la entrega

En este instructivo, se explica lo siguiente:

  1. Una descripción general de los casos de uso de tarifas y tiempo de entrega que se admiten
  2. Instrucciones específicas para especificar el tiempo de entrega y las tarifas de los pedidos de action_link en sus feeds
  3. Expectativas de precisión

Para ver una muestra de feed completo en la que se muestre el uso del tiempo de entrega del pedido y las tarifas, consulta la muestra de EPA de Ordering Redirect.

Casos de uso de tarifas y tiempo de entrega

Casos de uso de tarifas

Proporcionamos varias formas diferentes de especificar tarifas. 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.

  • Tarifa fija: "Costo de envío de USD 5" o "Cargos del servicio de USD 5"
  • Tarifa porcentual: "Cargos de entrega del 5%" o "Cargos del servicio del 5%"
  • Rangos de tarifas: "Cargos de entrega de USD 2 a USD 10" o "Cargos del servicio del 3% al 6%"
  • Rangos abiertos: “Cargos de entrega a partir del 5%” o “Cargos del servicio de hasta USD 20”

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

No se admiten los casos de uso que requieren que las tarifas se actualicen durante el día o que cambien en función de la información del usuario.

Casos de uso de tiempo de entrega

Permitimos varios formatos diferentes para especificar el horario de disponibilidad, a fin de 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: “Se entrega en 30 min” o “Retiro en 15 min”
  • Intervalos: “Entrega en 30 min a 1 h” o “Retiro en 15 a 20 min”
  • Intervalos de tiempo abierto: "Se entrega en más de 10 min" o "Retiro en menos de 1 h"

La hora de entrega se puede especificar para el retiro 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 mostrará a los usuarios reflejará el tipo de entrega especificado en el vínculo de acción.

No se admiten los casos de uso que requieren que se actualicen durante el día o que se modifiquen en función de la información del usuario.

Cómo especificar el tiempo de entrega de un pedido a través de feeds

El tiempo de entrega del pedido para los vínculos de acción se incluye en el mensaje action_link del feed de Merchant 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 rutas de acceso de los mensajes.

Tiempo de entrega fijo

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

Estos mensajes deben estar en el siguiente formato:

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

Tiempo de cumplimiento de 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
    }
  }
}
.

Especificación de tarifas a través de feeds

Al igual que el tiempo de entrega del pedido, las tarifas se pueden incluir en el 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 del mensaje:

merchant.action_link.food_ordering_metadata.fee_details

A continuación, se muestran varios ejemplos de los distintos casos de uso.
  • Una tarifa fija de entrega de USD 1.99: 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • Un porcentaje de la tarifa de entrega del 5.6%. 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • Los cargos del servicio varían 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"
        }
      }
    }
  }
]
  • El porcentaje de cargos del servicio varía del 1.2% al 2.7%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • Dos tarifas, un cargo del servicio de USD 5 y un cargo de entrega del 1.2%. 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

Precisión en las tarifas y el tiempo de entrega

Precisión de las tarifas

Cuando proporcionas datos de tarifas a un comercio, esperamos que brindes una representación precisa de tus tarifas. Debes incluir todos los cargos del servicio y de entrega que se puedan aplicar a un pedido.

Reconocemos que las tarifas pueden variar con el tiempo y según el usuario. Por esta razón, ofrecemos la capacidad de especificar tarifas como rangos, incluidos los rangos abiertos. En los casos en que las tarifas puedan variar de forma significativa, asegúrate de que el rango proporcionado abarque las tarifas que el usuario podría ver durante la transacción.

Si no estás seguro 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 del tiempo de entrega de un pedido cambian en función de varios factores. Entre estos factores, se incluyen los siguientes:

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

Cualquiera de estos factores puede dar lugar a situaciones en las que el tiempo de entrega del pedido que se muestra inicialmente al usuario no es el horario exacto que verá cuando confirme 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 lleve a un tiempo de entrega exacto que se muestre a los usuarios con la mayor frecuencia posible, según el criterio del mejor esfuerzo. Si hay una variabilidad significativa en el tiempo debido a estos factores, te sugerimos que proporciones un rango de horarios que abarquen esa variabilidad. Además, si el tiempo de entrega cambia debido a los detalles del pedido, se debería mostrar claramente a los usuarios al momento de llegar al flujo de pedidos.

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