Saltar al contenido principal

Configuración y contenido del menú

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 ver datos de ejemplo para un menú anidado?

Consulta la sección Referencia.

¿Cuál es el tamaño máximo que se acepta para el menú?

Se pueden procesar correctamente los menús con un tamaño máximo de 25 MB.

¿Cómo se completa la sección “Favoritos”?

Esta sección se completa a partir de un cálculo realizado por DoorDash mediante el aprendizaje automático. Si falla la fase de menú, no se creará un menú y el ID del menú será nulo.

¿Cómo puedo eliminar un menú?

Para eliminar un menú de la plataforma de DoorDash, envía una solicitud PATCH de menú y configura active en false.

¿Puedo controlar el estado de un menú?

Sí, para activar o desactivar un menú, envía una solicitud de actualización del menú y configura el campo active como true o false según el resultado deseado.

¿Cuál es la diferencia entre price y base_price?

base_price es un campo opcional que se guarda el artículo y en la opción extra del artículo, y se puede utilizar para habilitar el precio doble para las opciones de retiro del cliente. Este campo incluirá el precio de la tienda para un artículo u opción, sin incluir el incremento que pueda aplicarse al precio de la entrega. El campo price seguirá siendo un campo obligatorio y deberá incluir el precio de entrega de un artículo u opción (que la tienda podrá incrementar si lo desea). Si existe base_price para un artículo u opción, se aplicará este precio para los menús con servicio de retiro. Si el cliente cambia entre Retiro y Entrega en el sitio, los precios se actualizarán en consecuencia entre base_price (Retiro) y price (Entrega). Se recomienda crear un respaldo para los precios de retiro a fin de proteger la experiencia compartida de los clientes. Puedes encontrar más información aquí. Si te interesa utilizar esta función, comunícate con tu contacto de DoorDash para habilitarla a nivel empresarial.

¿Qué es un artículo, un artículo extra o una opción?

ItemExtra

¿Cómo se especifica una tasa impositiva?

A partir de 2020, se admite el envío de tasas impositivas de los artículos y de las opciones extra de los artículos en el menú. Si se envía este valor, DoorDash utilizará esta tasa impositiva para calcular los impuestos de los estados que no requieren un facilitador del mercado. La tasa se debe enviar como un número entero. Por ejemplo, mi tasa impositiva es del 5 % para un artículo. El parámetro tax_rate se debe enviar como 5 en la carga del menú (no como .05). Si las tasas impositivas no se envían en el menú, confiaremos en el sistema de impuestos externo de DoorDash para calcularlos. Comunícate con su contacto de DoorDash para obtener más información si tienes pensado enviar tasas impositivas en el menú. De forma predeterminada, solo se aplicarán las tasas impositivas a nivel de artículo proporcionadas en la carga del menú para las tiendas de estados que no requieren un facilitador del mercado. Para las tiendas de estados que requieren un facilitador del mercado, se utilizan los cálculos de impuestos de DoorDash, ya que es responsable de remitir y pagar los montos de los impuestos en nombre de la tienda. Si crees que una o más de tus tiendas deberían estar exentas de utilizar los montos de los impuestos calculados por DoorDash en un estado que requiere un facilitador del mercado, comunícate con tu contacto principal de DoorDash. Esta exención se concede únicamente en casos excepcionales tras la aprobación del equipo de impuestos de DoorDash.

¿Dónde puedo encontrar una lista de los estados que requieren un facilitador del mercado?

Puedes consultar la lista actualizada de los estados que requieren un facilitador del mercado aquí.

¿El sistema de impuestos de DoorDash incluye recargos como el impuesto sobre las bebidas azucaradas y los depósitos de botellas?

Por el momento, el sistema de impuestos de DoorDash no incluye ninguno de estos recargos cuando se calculan los impuestos de las órdenes. La tienda deberá pasar estos impuestos en el menú si quiere que se apliquen.

¿Cómo puedo crear un parámetro itemOption de forma predeterminada?

Para tener un itemOption activado de forma predeterminada, debes incluir el valor predeterminado como un parámetro con el valor establecido en true en la carga del menú.

¿Cómo se clasifican las categorías, los artículos y las opciones de artículos?

Todas las entidades se ordenan según el parámetro sort_id que se define en la carga del menú. Si no se define este campo, se ordenarán alfabéticamente de forma predeterminada.

¿Cómo puedo crear un botón de opción?

Para crear un botón de opción, deberás establecer max_num_options = 1 y min_num_options = 1 de manera que solo haya una opción disponible para seleccionar.

¿Qué controla cada uno de los campos Mín./Máx.?

Asegúrate de que estos campos están configurados correctamente para que funcionen a la vez. De lo contrario, se producirán errores cuando un cliente no pueda cumplir los requisitos de cada campo y no podrá agregar un artículo al carrito. Por ejemplo, no se puede tener min_nim_options = 1 (es decir, el cliente debe seleccionar al menos 1 opción) y max_option_choice_quantity = 0 (es decir, el cliente no puede seleccionar más de 0 en todas las opciones).

A continuación, se detallan los campos:

_num_options: controla la cantidad de Opciones que se pueden seleccionar. El valor máximo nunca será mayor que el número de opciones disponibles para un determinado artículo extra. En el ejemplo se muestra min_num_options = 2 y max_num_options = 2 para “Elegir sabores de alitas de pollo deshuesadas”. De este modo, el extra es obligatorio y obliga al cliente a no hacer más de 2 elecciones

_option_choice_quantity: controla la cantidad máxima de una sola opción permitida. Si tiene un valor que no sea nulo, se mostrará un selector de cantidad múltiple en lugar de una casilla de verificación o un botón de opción (ver la captura de pantalla más abajo). En el ejemplo se muestra min_option_choice_quantity = 2. Esto significa que un cliente puede seleccionar no menos de 2 alitas por sabor elegido. En el ejemplo se muestra max_option_choice_quantity = 10. Esto significa que un cliente puede seleccionar no más de 10 alitas por sabor elegido.

_aggregate_choice_quantity: controla la suma máxima de las cantidades de opciones permitidas. En el ejemplo se muestra min_aggregate_choice_quantity = 10 y max_aggregate_choice_quantity = 10. Esto obliga al cliente a seleccionar 10 alitas en total entre su elección de sabores.

num_free_options: se asocia con option_choice_quantity. Cuando una orden supera la cantidad designada de opciones elegidas, entonces a cada opción consecutiva se le aplica un precio. En el ejemplo se muestra _num_free_options = 4. Esto significa que si el cliente selecciona más de 4 opciones, se le cobrará por cada opción adicional según el precio enviado. Si los precios de las opciones son diferentes y la cantidad seleccionada supera el parámetro num_free_options, DoorDash cobrará al cliente la opción más cara.

¿Cómo puedo tener varios menús (franja horaria)?

Si utilizas POST para varios menús con horarios diferentes (menús con franja horaria), se mostrará de forma predeterminada el menú que corresponda al horario actual. La lógica del menú continuo se aplicará a estos menús si el tiempo entre la hora de finalización del Menú 1 y la hora de inicio del Menú 2 es inferior a 1 minuto, lo que significa que DoorDash no aplicaría el margen de 20 minutos a la hora de finalización del Menú 1.

Si utilizas POST para varios menús con horarios superpuestos, todos ellos se mostrarán en la plataforma de DoorDash, como se muestra en el menú desplegable de la siguiente captura de pantalla. De forma predeterminada, se mostrará el menú que se haya creado más recientemente durante el periodo de tiempo en el que se superpongan los horarios. Por ejemplo: si tienes un menú de desayuno y un menú para todo el día, el menú que se mostrará de forma predeterminada en DoorDash será el que se haya creado más recientemente.

¿Cómo agrego fotos a mi menú?

Mejoramos nuestra integración POS para extraer las fotos directamente de la fuente junto con el resto del menú que se extrae actualmente. Si el sistema reconoce que la URL de la foto proporcionada con un artículo es la misma URL que la de la última actualización del menú, no se incorporará una nueva foto. Si el sistema reconoce una nueva URL de foto, el producto procesará la imagen en los sistemas de DoorDash y la pasará al equipo interno de Fotos. El equipo revisará y aprobará, recortará y vinculará las fotos o las rechazará según las Pautas de calidad para imágenes. Este proceso de vinculación utiliza el mapeo de Item<>PhotoURL de la carga del menú del POS para definir la foto que se vinculará con determinado artículo. Todas las imágenes aprobadas deberían aparecer en un plazo de 3 días laborables.

Requisitos de la URL

  1. Formato http o https
  2. Sin parámetros de consulta en la URL
  3. Termina en .jpg, .jpeg o .png
  4. DoorDash debe poder acceder a la imagen, y esta no debe estar bloqueada por los requisitos de permiso, por ejemplo, los errores 403.

Especificaciones de las fotos

La plataforma DoorDash exige que las fotos cumplan ciertos criterios para que se muestren correctamente en el sitio. Estos requisitos son los siguientes:

  1. Relación de aspecto 16:9

  2. Tamaño máximo del archivo de 2MB

  3. Formato JPG, JPEG o PNG

    Si no se cumplen los criterios del tamaño del archivo, el formato del archivo o la URL, la nueva característica no funcionará como se espera y no se vinculará ninguna foto al artículo. Si una foto no cumple con los requisitos de relación de aspecto, DoorDash intentará recortar la foto manteniendo una imagen de calidad. Si el recorte genera un mal encuadre, se rechazará la foto.

¿Puedo vender bebidas alcohólicas en mi menú de DoorDash?

DoorDash permite que las tiendas vendan alcohol en la plataforma una vez que se firme un anexo sobre el alcohol. Comunícate con tu contacto de DoorDash para revisar y firmar el anexo. Una vez firmado, aparecerá un indicador en la carga del menú denominado is_alcohol para indicar los artículos que contienen alcohol. Cuando se establece como true, marcamos el artículo como 21+ en el backend. Asegúrate de que todos los artículos con alcohol se marcan como true en el menú para evitar cualquier problema legal.

¿Existe un límite en la cantidad de artículos/modificadores/submodificadores que puede contener mi menú?

DoorDash permite hasta 600 000 artículos en total (incluidos los modificadores y submodificadores) en el menú (ItemOptions, ItemExtraOptions). Si ves que se alcanza este límite, asegúrate de que estás utilizando los mismos valores de merchant_supplied_id en todas las actualizaciones PATCH del menú que los valores que se utilizan en POST del menú inicial. Si los valores de merchant_supplied_id cambian entre el POST y cualquier PATCH del menú siguiente, cada valor único se contaría como un nuevo artículo y se alcanzaría el límite de 600 000 mucho más rápido de lo esperado.