Saltar al contenido principal

Órdenes

Marketplace APIs are limited access

En este momento, el proceso de integración en Marketplace se encuentra al máximo de su capacidad. No estamos aceptando nuevos socios por ahora, ya que estamos desarrollando herramientas de autogestión para la incorporación de tiendas. Completa el formulario para interesados en la integración de Marketplace para ponerte en contacto con DoorDash antes de realizar tu integración.

¿Dónde puedo encontrar un ejemplo de datos de órdenes?

Ejemplo de datos de órdenes

¿Qué es un error de orden POS?

Un error de orden POS es cuando se envía una orden al POS, pero no se pudo introducir en el POS. Esto puede ocurrir por diversas razones, tales como problemas de conectividad con el POS, artículos agotados, configuración incorrecta del menú, etc.

¿Cómo puedo diferenciar una orden que retira el cliente de una orden de entrega con Dasher normal?

Hay un campo en la carga de la orden denominado is_pickup. Este campo será verdadero para los órdenes que retira el cliente. También hay un campo en la carga de la orden denominado fulfillment_type, que se puede utilizar para saber si la orden se entrega con Dasher, si la entrega la tienda (entrega automática) o si la retira el cliente.

¿Cómo puedo diferenciar una orden realizada con Dasher de una orden con entrega automática (entregada por la tienda)?

Hay un campo en la carga de la orden denominado fulfillment_type, que se puede utilizar para saber si la orden se entrega con Dasher, si la entrega la tienda (entrega automática) o si la retira el cliente.

¿Existe un tamaño máximo para las órdenes (tamaño de la canasta)?

No hay tamaño máximo para las órdenes en función de la cantidad, pero podemos establecer un monto máximo en dólares a nivel de la tienda. Esto lo puede configurar el equipo de DoorDash cuando se incorporan las tiendas. Comunícate con su contacto de DoorDash para configurarlo.

¿Hay un importe mínimo en dólares para una orden?

Si el subtotal de la orden es $0, la orden no se validará en DoorDash. Más allá de eso, no hay un importe mínimo en dólares para una orden.

¿Cómo funcionan las órdenes programadas?

DoorDash mantiene una lógica para determinar cuándo enviar las órdenes programadas a las tiendas según la hora estimada de retiro, el tamaño de la orden y el horario de atención de la tienda. De acuerdo con esto, DoorDash retendrá la orden y solo la enviará cuando la tienda la considere una orden con entrega “tan pronto como sea posible”.

¿Se pueden aceptar pedidos a través de la tableta con la integración de OpenAPI?

Una vez que tengas la integración con OpenAPI, ya no deberías utilizar la tableta para aceptar órdenes, sino que solo deberías utilizarla para ver las órdenes a modo de respaldo. En ocasiones especiales, se puede configurar una tienda con la tableta como protocolo de recuperación si se produce un fallo en la inyección de órdenes en el POS. Comunícate con el equipo de DoorDash si te interesa este tema para determinar si es una buena opción.

Si una tienda tiene varios menús, ¿hay alguna manera de saber de qué menú es la orden?

Por el momento, no hay ningún indicador en la carga de la orden que indique el menú en el que se realizó la orden.

¿Cómo puedo activar el webhook de notificación para la cancelación de órdenes?

Deberás proporcionar un punto de conexión con el token de autorización asociado que configurará el equipo de DoorDash. Tras configurarlo, el equipo de DoorDash te ayudará a realizar una orden de prueba. Cuando la tienda la confirme, el equipo de DoorDash iniciará una cancelación, y ya podrás confirmar que recibiste la notificación de cancelación.

¿Cómo funciona la liberación automática en las órdenes para llevar?

El flujo para el retiro es el mismo que el de la entrega si el cliente tiene los servicios de ubicación activados en su dispositivo. Una vez que el cliente cruza el área geográfica de la tienda, se activa la liberación de la orden. Si el cliente no tiene activados los servicios de ubicación, puede registrarse de forma manual haciendo clic en un botón de la aplicación. Al hacer clic en el botón de registro, se activará el evento de liberación.

¿DoorDash repetirá la solicitud POST de la orden si el socio no la procesa correctamente?

DoorDash repetirá las órdenes, las cancelaciones de órdenes y las solicitudes de menú por lo menos tres veces con un intervalo de 0,3 segundos si el socio devuelve un estado de respuesta 5xx a la solicitud inicial.

En la confirmación asincrónica de órdenes, ¿se requiere algún tipo de cuerpo de carga en la respuesta inicial?

No, solo es necesario un estado 202 para el reconocimiento inicial durante la confirmación asincrónica de la orden. Para confirmar la orden correctamente, es necesario que la respuesta sea válida.

¿Cómo se indica del precio de un artículo en la carga de la orden?

El precio de un artículo en la carga de la orden se calcula como el precio del artículo más la suma de los precios de todos los modificadores seleccionados dentro de ese artículo. En el siguiente ejemplo del fragmento de código JSON de la orden, el precio del Burrito Scram Bowl es de $5.00 (como lo indica el menú), por lo que el precio del artículo en la carga de la orden se calcula como $5.00 + $0.10 [ketchup] + $0.00 [sal] = $5.10.

{
"items": [
{
"extras": [
{
"merchant_supplied_id": "INDIVIDUAL_SAUCES",
"name": "Signature Sauces",
"options": [
{
"extra": [
{
"merchant_supplied_id": "BREAKFAST_CONDIMENTS",
"name": "Breakfast Condiments",
"options": [
{
"merchant_supplied_id": "ADD_SALT",
"name": "Salt",
"price": 0,
"quantity": 1
}
]
}
],
"merchant_supplied_id": "ADD_KETCHUP_INDIVIDUAL",
"name": "KETCHUP",
"price": 10,
"quantity": 1
}
]
}
],
"merchant_supplied_id": "26d3fce0-efd2-46d3-832c-ced5bc956401",
"name": "Burrito Scram-Bowl",
"price": 510,
"quantity": 1
}
]
}

¿Cómo puedo saber si la orden se realizó en DoorDash, Caviar o Storefront?

Hay un campo en la carga de la orden denominado experience que indica en qué plataforma se realizó la orden.

¿Cómo puedo saber si un cliente dejó propina en una orden?

Hay un campo en la carga de la orden denominado merchant_tip_amount que será mayor que 0 (relevante solo para órdenes para retirar) si el cliente dejó propina.

¿Cómo se envían las promociones en la orden?

Algunos tipos de promociones se pueden enviar con información de descuento en la carga de la orden. Ponte en contacto con el administrador técnico de cuentas para obtener más información.

¿Cómo funcionan las cancelaciones de los clientes?

Consulta nuestra política de cancelaciones aquí para obtener más información sobre las cancelaciones de los clientes y cómo afectan a la tienda.

¿Las tiendas deberían aceptar o rechazar las órdenes de forma manual con una Integración POS?

No, las órdenes enviadas desde DoorDash al POS se deberían confirmar o rechazar automáticamente como parte de la integración. Las tiendas no deberían poder aceptar o rechazar las órdenes manualmente.