Marketplace, ubicaciones y configuración de la cuenta

Este capítulo cubre todo lo que está bajo el botón Marketplace, la página de barra lateral Delivery Dispatch y la sección Account de la barra lateral (Locations y Settings). Aquí conectas servicios externos (redes de delivery y tu POS), editas las ubicaciones de tu restaurante, configuras cómo se despachan los pedidos y controlas la configuración de toda la cuenta: contraseña, idioma predeterminado, dual pricing, procesador de pagos y cómo funcionan los pedidos para llevar y a domicilio.

Qué puedes hacer aquí

• Conectar o desconectar redes de delivery: Uber Direct, InhouseDelivery (IHD) y RouteMasters.
• Conectar tu POS Shift4 e importar su catálogo a Eatsy.
• Ver tarjetas informativas de otros servicios (DoorDash, Uber Eats, Toast, Clover y — si tienes Microsites/WhiteLabel — Facebook, Google, Instagram, TikTok Shop, WhatsApp).
• Configurar Delivery Dispatch desde la barra lateral (estrategia, horarios, cobertura, operadores) una vez conectado en Marketplace.
• Ver la lista de tus ubicaciones y editar una ubicación (nombre, dirección, contacto, horarios, estado, fotos).
• Editar tu Profile de administrador y cambiar tu password (dentro de la app, o mediante Forgot password / restablecimiento en el primer inicio de sesión en la pantalla de login).
• Activar Dual Pricing (una diferencia de precio efectivo/tarjeta) por ubicación.
• Definir el idioma predeterminado y los idiomas a los que se puede traducir tu menú.
• Elegir tu pasarela de pago (Shift4 o NMI) e ingresar las credenciales del procesador.
• Configurar las reglas de Payment (impuesto sobre ventas, propinas, tarjetas de regalo) y Takeout/Delivery (tipos de pedido, tiempo de preparación, recargos, zonas de delivery, tarifas, mínimos).

Dónde encontrarlo

• Marketplace — barra lateral Marketplace (un solo botón), URL https://admin.eatsyorders.com/marketplace
  • Detalle de IHD: https://admin.eatsyorders.com/marketplace/details/ihd
  • Detalle de Shift4: https://admin.eatsyorders.com/marketplace/details/shift4
• Delivery Dispatch — barra lateral Delivery Dispatch, URL https://admin.eatsyorders.com/delivery-dispatch
• Locations — barra lateral Account → Locations, URL https://admin.eatsyorders.com/account/locations
  • Editar ubicación: https://admin.eatsyorders.com/account/locations/…/edit
• Settings — barra lateral Account → Settings, URL https://admin.eatsyorders.com/account/settings (cada pestaña agrega ?tab=...)

Visibilidad (Marketplace): El botón Marketplace y ambas páginas de detalle requieren el permiso see-marketplace. Sin él verás "You do not have permission."

Visibilidad (Delivery Dispatch): El ítem de la barra lateral aparece cuando tienes acceso de marketplace/dispatch (see-marketplace o manage-delivery-dispatch).

Visibilidad (Account): Locations requiere see-place. Editar una ubicación necesita edit-place. La sección Settings aparece si tienes alguno de: see-account, see-dual, see-language, see-leads, see-place, see-payment, see-provider, see-takeout.

---

Marketplace

El Marketplace lista cada integración agrupada en cuatro secciones: Third party deliveries, Third party orders, POS y E-commerce, Social media and Chats. Todo lo que ves refleja la ubicación seleccionada actualmente (el place activo en la parte superior de la app): al cambiar de ubicación se recargan las tarjetas.

Cada tarjeta (la tarjeta en ES muestra las mismas etiquetas) tiene un logo, una descripción breve y un botón principal:

• Si la integración está conectada/activa, el botón dice Disconnect (ES: "Desconectar").
• Si no está conectada, el botón dice Connect (ES: "Conectar") o Configure (ES: "Configurar") según el servicio.
• Un menú "kebab" (tres puntos) puede ofrecer See detail (ES: "Ver detalle") e Instructions (ES: "Instrucciones").

Third party deliveries

Estas permiten que Eatsy entregue tus pedidos a domicilio a una red de mensajeros externa. Límite importante: solo un proveedor de delivery puede estar activo a la vez. Si conectas un segundo, la app desconecta automáticamente el que estaba activo y muestra primero una advertencia: "Connecting {newProvider} will automatically disconnect {activeProvider}. Only one delivery provider can be active at a time."

Cuando desconectas el último proveedor de delivery activo, la app cambia automáticamente tu modo de delivery de nuevo a Own Delivery (para que no quedes en "Integrated" sin nada integrado). Si otro proveedor sigue activo, tu modo de delivery no cambia.

Uber Direct

Envía tus pedidos a tus clientes usando la red de mensajeros de Uber con seguimiento en tiempo real.

Para conectar:

1. Haz clic en Connect en la tarjeta de Uber Direct. Se abre el diálogo Connect to Uber Direct.
2. Si otro proveedor de delivery está activo, aparece un banner de advertencia amarillo en la parte superior: confirmar desconectará ese proveedor.
3. Completa tus cuatro credenciales de Uber Direct (todas obligatorias):

1. Haz clic en Connect (el botón muestra Connecting… mientras trabaja). Si tiene éxito, la tarjeta pasa a Disconnect y cualquier otro proveedor de delivery activo se desactiva automáticamente.

Para desconectar:

1. Haz clic en Disconnect en la tarjeta de Uber Direct. Se abre el diálogo Disconnect Uber Direct con una advertencia amarilla: "Are you sure you want to disconnect Uber Direct? This will deactivate the integration."
2. Haz clic en Confirm para desconectar, o Cancel para mantenerlo.
3. (Si la integración ya está apagada de algún modo, el diálogo en su lugar dice "The Uber Direct integration is not currently active" y solo ofrece Close.)

DoorDash (informativo)

Se muestra solo como referencia. En la build actual no hay acción de conectar en esta tarjeta.

InhouseDelivery (IHD)

Una plataforma de agregación de delivery que se conecta a varios proveedores de mensajería a través de una sola API. Úsala cuando quieras que Eatsy elija automáticamente el mejor mensajero disponible.

Para conectar desde el listado:

1. Haz clic en Connect en la tarjeta de InhouseDelivery.
2. La app primero revisa los datos de tu ubicación. Si falta algo obligatorio, aparece el diálogo Incomplete data to connect with IHD. Muestra una alerta roja, una lista de Required fields (cada una con el nombre del campo y el motivo por el que se necesita) y, cuando corresponde, una lista de Recommended fields (advertencias amarillas). Tiene dos botones: Cancel y Go to Location Settings (que te lleva directo a Account → Settings → pestaña Settings para corregir los datos).
   • Required fields para IHD: nombre de la ubicación, teléfono, dirección completa, coordenadas GPS y zona horaria.
   • Recommended (optional): dirección de correo (para notificaciones de delivery).
3. Si los datos están completos, se abre el formulario Connect to InhouseDelivery. Si otro proveedor de delivery está activo, aparece un banner de advertencia amarillo en la parte superior (confirmar desconectará ese proveedor). Ingresa las cuatro credenciales de IHD (todas obligatorias):

1. Haz clic en Connect (muestra Connecting… mientras trabaja). Si tiene éxito, la tarjeta muestra Disconnect y cualquier otro proveedor de delivery activo se desactiva automáticamente.

Nota — el diálogo de confirmación de IHD: Cuando vuelves a conectar una ubicación IHD que ya se había configurado antes (por ejemplo desde la página de detalle de IHD), en lugar del formulario de credenciales puedes ver un diálogo Confirm connection. Previsualiza la ubicación que se enviará a IHD — Name, Phone, Address, Email y Timezone — tomada de la configuración actual de tu ubicación, con un banner de advertencia si otro proveedor está activo. Revisa los valores y haz clic en Connect (o Cancel). Si los valores están mal, vienen de la configuración de tu ubicación: corrígelos primero en la pestaña Settings.

Otras acciones en la tarjeta: See detail abre la página de detalle de IHD; Instructions abre la guía Before setting up InhouseDelivery (un resumen de 3 pasos: 1. Verify your location information, 2. Connect your location, 3. Start managing deliveries) con un solo botón Close.

Para desconectar:

1. Haz clic en Disconnect en la tarjeta de InhouseDelivery. Se abre el diálogo Disconnect InhouseDelivery con una advertencia amarilla: "Are you sure you want to disconnect InhouseDelivery? This will deactivate the integration."
2. Haz clic en Confirm para desconectar, o Cancel para mantenerlo. (Si IHD ya está apagado, el diálogo muestra "The InhouseDelivery integration is not currently active" con solo un botón Close.)

Página de detalle de IHD (/marketplace/details/ihd)

Esta página (la flecha atrás regresa a Marketplace) explica qué es IHD, lista las funciones clave (agregar varios proveedores, seguimiento unificado, enrutamiento automático), muestra los pasos de configuración y un FAQ. El botón superior derecho es Connect cuando IHD está apagado y Disconnect cuando está encendido; el menú kebab tiene Instructions. Si ya te conectaste y luego lo apagaste, reconectar aquí puede reactivar la misma ubicación sin volver a ingresar todos los datos. Se aplica la misma regla de un solo proveedor activo (reactivar IHD desactivará Uber Direct si está encendido).

RouteMasters

Un socio de delivery nacional independiente.

Para conectar:

1. Haz clic en Connect en la tarjeta de RouteMasters. (Si tu ubicación no tiene nombre, recibes un toast de error y el diálogo no se abre: primero define el nombre de la ubicación.)
2. Se abre el diálogo de confirmación Connect to RouteMasters. Previsualiza el Name y la Address de tu ubicación, y muestra un campo Merchant ID de solo lectura (completado automáticamente desde tu ubicación). Aparece un banner de advertencia amarillo si otro proveedor de delivery está activo.
3. Haz clic en Connect (muestra Connecting… mientras trabaja). El botón se deshabilita si no se pudo construir un Merchant ID. Si tiene éxito, la tarjeta muestra Disconnect y cualquier otro proveedor de delivery activo se desactiva.

Para desconectar:

1. Haz clic en Disconnect en la tarjeta de RouteMasters. Se abre el diálogo Disconnect RouteMasters con una advertencia amarilla: "Are you sure you want to disconnect RouteMasters? This will deactivate the integration."
2. Haz clic en Confirm para desconectar, o Cancel para mantenerlo. (Si RouteMasters ya está apagado, el diálogo muestra "The RouteMasters integration is not currently active" con solo un botón Close.)

Third party orders

• Uber Eats y DoorDash — tarjetas informativas que describen centralizar esos pedidos dentro del Admin. Sin acción de conectar en la build actual.

POS

Shift4

Conecta tu punto de venta Shift4 para que Eatsy pueda importar y mantenerse sincronizado con tu catálogo de productos (categorías, ítems, modificadores).

Desde la tarjeta de Marketplace:

• Configure abre el flujo de importación.
• El menú kebab ofrece Instructions y Disconnect.

Instructions — diálogo "Before setting up Shift4". Un resumen de 3 pasos con un botón Close: 1. Verify your Shift4 account (necesitas acceso administrativo a Shift4); 2. Authorize the connection (en el marketplace de Shift4, otorga a Eatsy Orders permiso para acceder a tu catálogo); 3. Catalog import (una vez conectado puedes importar productos, categorías y modificadores; tu menú se mantiene sincronizado).

La página de detalle de Shift4 (/marketplace/details/shift4) muestra una descripción general, funciones clave, la configuración en 3 pasos y un FAQ. Desde ahí puedes:

• Configure — abre el modal de import.
• Ejecutar Run audit (busca problemas del catálogo / ítems faltantes / huérfanos), Check sync status (salud general, hora de la última sincronización, conteos de categorías/ítems/modificadores sincronizados) y Resync catalog (abre el diálogo Resync Catalog Configuration, más abajo). Estos botones están deshabilitados hasta que haya una ubicación Shift4 conectada.
• Menú kebab: Instructions, Disconnect.

El diálogo de importación ("Configure Shift4") — paso a paso. Es un asistente de dos pasos:

1. Step 1 — Merchant ID. Ingresa tu Merchant ID de Shift4 (obligatorio; numérico) y deja el interruptor Active encendido (predeterminado). Haz clic en Continue.
   • Si ya importaste esta ubicación antes, el diálogo se abre con el Merchant ID lleno y de solo lectura y un mensaje de que la configuración/importación ya está hecha; el botón dice Save y solo guarda la configuración de la integración.
   • La app valida el Merchant ID antes de avanzar. Bloqueos comunes mostrados como alerta roja: la instalación no está en un estado válido (cumplido) ("The installation state for the entered merchant ID is not valid"), el catálogo ya se importó, o no se pudo encontrar la ubicación.
2. Step 2 — Confirm catalog import. Elige al menos un sales channel al que importar (obligatorio: solo se listan canales Microsites/WhiteLabel). Elige si quieres publish the menu after import (radio Yes/No). Un acordeón muestra el conteo de categorías que se importarán y te permite expandir la lista de categorías. Haz clic en Confirm import para traer tus categorías/ítems/modificadores, o Go back para volver al paso 1.

El diálogo "Resync Catalog Configuration" (desde la página de detalle de Shift4 → Resync catalog): elige al menos un valor de Channels (Microsites y/o WhiteLabel, obligatorio), activa o desactiva Publish Menu, luego haz clic en Start Resync (o Cancel). Un toast de éxito confirma que la sincronización comenzó.

Para desconectar Shift4:

1. Elige Disconnect en el menú kebab de la tarjeta (o en la página de detalle). Se abre el diálogo "Are you sure you want to disconnect Shift4?" con una alerta roja: "The process of disconnecting from the Shift4 marketplace is irreversible, and once the process is complete, the catalog will no longer be automatically synchronized."
2. Haz clic en Confirm para desconectar, o Cancel para mantenerlo. (Si Shift4 nunca se configuró para esta ubicación, el diálogo en su lugar dice que no está configurado y solo ofrece Close.)

Atención: Desconectar Shift4 desinstala la integración y es irreversible. La sincronización del catálogo se detiene; volver a importar es una configuración nueva.

• Toast y Clover — solo tarjetas informativas de POS.

E-commerce, Social media and Chats

Visibilidad: Toda esta sección solo aparece si tu cuenta tiene el producto Microsites o WhiteLabel.

Tarjetas: Facebook, Google, Instagram, TikTok Shop, WhatsApp. Facebook abre Facebook Login cuando haces clic en Configure; las demás pueden ser solo informativas hasta que estén conectadas por completo en tu cuenta.

Cómo funciona el acceso por producto (importante): Algunas secciones se desbloquean cuando tu cuenta incluye un producto cuyo nombre contiene una palabra requerida (por ejemplo Microsites o WhiteLabel), no solo con un nombre exacto. Consecuencias prácticas:

• Un producto cuyo nombre oficial solo incluye Microsites o WhiteLabel como parte de un nombre más largo (por ejemplo un paquete o un complemento) desbloqueará estas áreas restringidas, aunque no sea el producto independiente que esperabas.
• La ortografía importa: un nombre de producto escrito de otra forma no desbloqueará la sección. Si una sección aparece o desaparece de forma inesperada para una cuenta, revisa los nombres exactos de los productos asignados.

---

Locations

La página Locations lista cada ubicación de restaurante de tu compañía en una tabla.

• Cada fila enlaza a la pantalla de edición de esa ubicación (requiere edit-place).

Editar una ubicación

Dónde: Locations → haz clic en una fila → editar (/account/locations/…/edit).

Este es el formulario principal del perfil de la ubicación. En pantallas anchas los botones de acción están en un panel lateral; en pantallas estrechas aparecen arriba. Hay una flecha atrás en el encabezado del formulario, y aparece un diálogo de confirmación si intentas salir con cambios sin guardar.

En la parte superior del formulario hay dos interruptores:

• Hide prices (ES: "Ocultar precios") — oculta los precios en el sitio público para esta ubicación.
• Active (ES: "Activo") — si la ubicación está en vivo.

Campo por campo:

Debajo de los campos de dirección el formulario también tiene una sección SEO (título de página y meta descripción para buscadores) y un selector de idioma para que puedas ingresar el título/descripción en cada idioma habilitado.

Para guardar: haz clic en Save (ES: "Guardar"). Aparece un diálogo de confirmación; confirma para escribir los cambios. Un toast de éxito muestra el nombre de la ubicación.

Atención: Latitude/Longitude solo vienen de seleccionar una dirección real en el autocompletado. Borrar la dirección restablece las coordenadas a 0, lo que puede bloquear IHD (que requiere coordenadas GPS).

---

Delivery Dispatch

Dónde: barra lateral Delivery Dispatch, URL https://admin.eatsyorders.com/delivery-dispatch.

Visibilidad: El ítem de la barra lateral aparece cuando tienes acceso de marketplace/dispatch (see-marketplace o manage-delivery-dispatch).

Esta página configura cómo se despachan los pedidos para la ubicación activa: tu flota propia, operadores externos o un modelo híbrido. Todo aquí está acotado a la ubicación seleccionada en la parte superior de la app: al cambiar de ubicación se recarga la configuración.

Requisitos previos

Delivery Dispatch debe estar conectado para la ubicación en Marketplace. Si no está conectado, la página muestra un estado vacío con un mensaje para conectarlo desde Marketplace y un enlace Go to Marketplace (ES: "Ir al Mercado").

Permiso de edición

• Con manage-delivery-dispatch (permiso de edición), puedes cambiar Strategy, Schedules y Coverage. Un botón Save changes aparece en esas pestañas.
• Sin permiso de edición, la página es de solo lectura: una alerta informativa indica que no tienes permiso para administrar Delivery Dispatch, y el botón Save no aparece para Strategy / Schedules / Coverage.

Pestañas

Usa estas pestañas para configurar la estrategia de delivery, los horarios, la cobertura (polígonos/radio) y los operadores. Guarda Strategy, Schedules o Coverage con Save changes arriba cuando tengas permiso de edición. Operators y Own fleet rates usan sus propios controles de guardado en esas pestañas.

---

Settings

Dónde: Account → Settings (/account/settings). La pantalla es una fila de pestañas; cuáles ves depende de tus permisos y productos. Cada pestaña también vuelve a verificar su propio permiso, así que una pestaña puede ser visible pero de solo lectura si puedes "ver" pero no "editar".

Las pestañas (en orden) y su gating:

Pestaña Account

La pestaña Account (ES: "Cuenta") tiene sus propias dos sub-pestañas a la izquierda: Profile y Security.

Profile (ES: "Perfil")

Edita el perfil de administrador tuyo (no el del restaurante). Muestra tu avatar y nombre arriba.

Haz clic en Save, confirma en el diálogo. Los campos son de solo lectura a menos que tengas edit-account.

Security (ES: "Seguridad")

Cambia tu contraseña de inicio de sesión.

Un indicador de fortaleza en vivo se muestra abajo. Haz clic en Submit new password (ES: "Enviar nueva contraseña") y confirma. (La nota en pantalla dice "at least 1 letter, 1 number, and 1 symbol, minimum 12 characters" — el mínimo aplicado es 8 más las clases de caracteres anteriores.) Editar requiere edit-account.

Ayuda con la contraseña en la pantalla de login (antes de iniciar sesión)

La pestaña Account → Security de arriba es la forma de cambiar tu contraseña mientras tienes sesión iniciada. Otros dos flujos de contraseña viven en la propia página de login (https://admin.eatsyorders.com, antes de entrar) — útiles cuando no puedes acceder:

Forgot password (restablecimiento de autoservicio). En la pantalla de login, haz clic en Forgot password. Se abre el diálogo Password Recovery y te guía en tres pasos:

1. Enter your email. Escribe el correo de tu cuenta y haz clic en Recovery password. Se te envía un código de verificación de 6 dígitos por correo (el diálogo confirma la dirección de destino enmascarada).
2. Enter the code. Escribe el código de 6 dígitos. Haz clic en Resend verify code si no llegó, luego Validate code.
3. Set a new password. Ingresa la nueva contraseña y confírmala. Se aplican las mismas reglas (minúscula + mayúscula + número + símbolo !+@#$%^&*, mínimo 8 caracteres), y se muestra un medidor de fortaleza en vivo. Haz clic en Change password. Un mensaje de éxito confirma el cambio y el diálogo se cierra. (Si el código era incorrecto, vuelves al paso 2 para reingresarlo.)

First-time login (define tu contraseña). Cuando una cuenta de administrador nueva inicia sesión por primera vez, la app muestra un diálogo Update your password en lugar de dejarte entrar. Ingresa una New password y Confirm password (mismas reglas y medidor de fortaleza que arriba), luego haz clic en Login. Una vez aceptada, entras directo al backoffice. Aquí no hay "current password" porque la cuenta es nueva.

Nota: Estos dos flujos se alcanzan desde la pantalla de login, no desde la barra lateral: no hay un ítem de menú para ellos. La pestaña Account → Security dentro de la app es la única herramienta de contraseña disponible una vez que iniciaste sesión.

Pestaña Billing

La pestaña Billing (ES: "Facturación") contiene una sola sub-pestaña izquierda, Dual Pricing.

Dual Pricing (diferencia de precio efectivo/tarjeta)

Dual Pricing te permite cobrar un precio ligeramente diferente a quien paga con tarjeta para traspasar las comisiones de tarjeta. Una vista previa en vivo Example muestra un producto de $20 con el precio de tarjeta ajustado.

• Interruptor Dual Pricing (arriba a la derecha) — activa/desactiva la función para esta ubicación.
• Adjustment percentage — elige uno de: 3%, 3.25%, 3.5%, 3.75%, 4%.

Haz clic en Save y confirma. Guardar con el interruptor on almacena el porcentaje; guardar con él off elimina la configuración de dual pricing de la ubicación. Editar requiere edit-dual; sin él la sección es de solo lectura.

Nota: Hay un interruptor separado "Credit card fee" con las mismas opciones del 3%–4% en la pestaña Payment providers — ver más abajo. Dual Pricing aquí controla la diferencia de visualización efectivo/tarjeta.

Pestaña Language

La pestaña Language (ES: "Idioma") define los idiomas de tu menú.

• Native language — el idioma predeterminado que se carga cuando los clientes abren el sitio. Elige English (en-US) o Spanish (es-CO) con el interruptor de bandera.
• Language to translate — el otro idioma (o idiomas) a los que se pueden traducir los nombres/descripciones de tus productos. Al elegir un idioma nativo, aquí se ofrece automáticamente el opuesto.

Haz clic en Save y confirma. Editar requiere edit-language.

Pestaña Settings (perfil operativo de la ubicación)

La pestaña Settings (ES: "Configuración") edita el perfil operativo de la ubicación activa — su información de restaurante más horarios de apertura y fotos. (Se solapa con el formulario de edición de Locations, pero se centra en la operación.)

Parte superior del formulario:

• Interruptor Hide prices.
• Botón Save (solo si puedes editar).

Opening hours — debajo de la tarjeta de información, define los días y rangos de horario en que la ubicación está abierta. Se requiere al menos un día/configuración, y la hora de fin de cada rango debe ser posterior a su hora de inicio.

Restaurant Image (panel lateral) — sube una foto de la ubicación. Tipos admitidos: JPG, PNG, GIF, BMP (la zona de arrastre acepta archivos de imagen). Una imagen a la vez; la app advierte si excedes el límite.

Haz clic en Save y confirma. Editar requiere edit-place; de lo contrario el formulario es de solo lectura.

Pestaña Payment

Visibilidad: requiere el producto Microsites y see-payment (editar necesita edit-payment).

La pestaña Payment (ES: "Pago") controla las reglas de dinero para pedidos en línea. Tiene cuatro secciones:

Sales Tax

Allow payments by gift card

• Interruptor Active — activa/desactiva los pagos con tarjeta de regalo.

Tips

• Interruptor Allow Tips.
• Tip 1/2/3 (%) — tres porcentajes de propina predefinidos (cada uno required, debe ser un número).
• Interruptor CUSTOM TIP — permite que los clientes ingresen su propia propina.
• DEFAULT TIP — cuál predefinición está preseleccionada (menú desplegable).

Haz clic en Save en la parte superior de la sección Payment Settings y confirma.

Pestaña Payment providers

Visibilidad: requiere see-provider (editar necesita edit-provider).

La pestaña Payment providers (ES: "Proveedores de pago") es donde eliges cómo se procesan las tarjetas. (Referencia completa para desarrolladores: docs/payment-providers.md.)

Secciones:

Payment services (gateway)

• Menú desplegable Gateway — Shift4 o NMI. (El procesador se define automáticamente para coincidir con la pasarela.)
• Si es Shift4 y la ubicación es nueva (sin access token): un botón Generate Access Token inicia el flujo del token; se muestra el campo Access token.
• Si es NMI:
  • Siempre se muestra un campo Processor ID (tu ID de procesador SignaPay u otro).
  • Si aún no tienes credenciales NMI y puedes editar, un botón NMI credentials abre un modal para ingresar la NMI Private API Key y la NMI Tokenization Key. El botón está deshabilitado hasta que se complete el Processor ID.
  • Una vez guardadas las credenciales, el botón se reemplaza por una nota de éxito que te recuerda guardar la configuración de pago para persistir todo.

El diálogo "Generate Access Token" (pasarela Shift4). Haz clic en Generate Access Token para abrir el diálogo. Pega tu Auth Token de Shift4 en el campo y haz clic en Generate (el botón permanece deshabilitado hasta que escribas algo; aparece un spinner mientras trabaja). Si tiene éxito, el access token se llena en el formulario y el diálogo se cierra con un toast de éxito; si falla, una alerta roja en el diálogo muestra el detalle del error. Haz clic en Cancel para cerrar sin generar.

El diálogo "NMI credentials". Haz clic en NMI credentials para abrir el diálogo. Contiene:

1. Campos NMI Private API Key y NMI Tokenization Key (ambos required).
2. Una advertencia amarilla permanente: "Once you save these credentials, you will not be able to edit them again from this screen. Double-check the values before saving."
3. Botones Cancel y Save credentials. Save credentials permanece deshabilitado hasta que ambas claves estén llenas y exista un Processor ID en el formulario detrás. Si falta el Processor ID al guardar, recibes el error "Enter the Processor ID in the form before saving NMI credentials." Si tiene éxito, las claves se escriben de vuelta en el formulario, el diálogo se cierra y aparece un toast de éxito.

Credit card fee

• Un interruptor más un selector de porcentaje (3%, 3.25%, 3.5%, 3.75%, 4%) para agregar una tarifa de tarjeta.

Enable 3D Secure

• Interruptor Active — activa la autenticación 3-D Secure de tarjetas.

Enable Card on File

• Interruptor Active — permite guardar tarjetas en archivo.

Haz clic en Save (en el encabezado de Payment providers) y confirma. Guardar actualiza la configuración de pago del place y sincroniza la pasarela/procesador con el servicio de pagos.

Atenciones (NMI):

• Debes ingresar un Processor ID antes de poder guardar las credenciales NMI.
• Una vez que guardas las claves NMI, el modal advierte que es posible que no puedas editarlas de nuevo desde esa pantalla: verifica dos veces antes de guardar.
• Guardar solo el modal de credenciales NMI no basta; también haz Save en el formulario de Payment providers para que todos los cambios persistan juntos.

Pestaña Takeout/Delivery

Visibilidad: requiere el producto Microsites y see-takeout (editar necesita edit-takeout).

La pestaña Takeout/Delivery (ES: "Para llevar/Domicilio") controla cómo la ubicación acepta pedidos en línea. El formulario muestra distintas secciones según los Order types que selecciones, de modo que solo configuras lo que aplica.

Order Settings (siempre visible)

Takeout Settings (se muestra si Takeout está seleccionado)

Delivery Settings (se muestra si Delivery está seleccionado)

• Future orders (required) y Opening hours (mismas reglas que arriba), más la elección de Delivery mode abajo.

Delivery mode (Own vs Integrated)

Cuando hay un proveedor de delivery conectado, eliges cómo se manejan los domicilios:

• Own Delivery — se aplican tus propias zonas de cobertura, tiempos de entrega y tarifas.
• Integrated Delivery — los domicilios van por tu proveedor conectado (IHD / Uber Direct / RouteMasters), que agrega mensajeros. (El título de la tarjeta muestra el nombre del proveedor activo.)

Si eliges Own Delivery, configuras zonas de Coverage (hasta 3):

Usa Add new coverage para agregar una zona (máximo 3). Se requiere al menos una configuración de coverage cuando se usa Own Delivery.

Si eliges Integrated Delivery con IHD, una sección IHD Delivery Service Providers te permite elegir a qué redes de mensajería puede enrutar IHD (debes seleccionar al menos una).

Custom delivery (se muestra si Custom delivery está seleccionado)

Para enviar pedidos a destinos externos con nombre:

• Custom delivery configuration: Future orders + Opening hours.
• Custom delivery destinations: agrega uno o más destinos, cada uno con un destination name y location ID (solo letras, números, _ y - — sin espacios/símbolos), más tipo de tarifa opcional, monto, tiempo de entrega y (cuando está activo) montos mínimo/máximo del pedido.

Haz clic en Save y confirma. El formulario ignora errores de validación de secciones que no aplican a los tipos de pedido seleccionados.

---

Tips and limits

• Un solo proveedor de delivery activo: IHD, Uber Direct y RouteMasters son mutuamente excluyentes. Conectar uno desconecta automáticamente los demás (con una advertencia), y desconectar el último restablece el modo de delivery a Own.
• GPS solo por autocompletado: Latitude/Longitude se llenan desde el autocompletado de direcciones y son de solo lectura; borrar la dirección las pone en cero. IHD no se conectará sin coordenadas.
• Visibilidad de pestaña ≠ derechos de edición: Una pestaña de Settings puede ser visible (see-…) pero de solo lectura sin el permiso de edición correspondiente (edit-account, edit-place, edit-dual, edit-language, edit-payment, edit-provider, edit-takeout).
• Las credenciales NMI son efectivamente de escritura única desde la pantalla de providers y requieren un Processor ID primero; recuerda guardar el formulario principal después.
• Desconectar Shift4 desinstala la integración y es irreversible; volver a importar es una configuración nueva.
• Delivery Dispatch debe estar conectado en Marketplace antes de que la página de la barra lateral muestre la configuración; de lo contrario verás un estado vacío con enlace a Marketplace.
• Guardar Delivery Dispatch en Strategy / Schedules / Coverage requiere manage-delivery-dispatch; sin él la página es de solo lectura.
• Los gates de producto usan coincidencia por subcadena: Microsites/WhiteLabel (y cualquier otro gate de producto) desbloquean una sección si alguno de tus nombres de producto contiene la palabra requerida, no solo con una coincidencia exacta — así que un nombre de producto más largo/en paquete que incluya la palabra también desbloquea el área restringida.

---