Importar un menú y resolver errores
La importación de menús envía información autenticada del negocio y del origen a un servicio configurado por separado. La disponibilidad depende de ese servicio y de la configuración del proyecto.
No uses negocios, menús, cuentas de proveedores, URL, credenciales, tokens ni registros de importación reales en pruebas. La importación, sincronización, descarga o eliminación de registros, los reintentos y las llamadas al proveedor pueden producir cambios o exponer datos confidenciales.
Disponibilidad y navegación
La ruta /connect/importers está limitada a administradores de nivel 0 y vuelve a la página de inicio de Dashboard cuando la capacidad de importación no está disponible. La barra lateral aplica condiciones adicionales:
- el elemento principal Connect debe estar disponible para un proyecto Enterprise con la marca Dashboard Connect o para un proyecto Pro elegible en modo Connect Pro;
- el usuario no puede ser administrador de solo lectura, gerente de entregas de solo lectura, propietario de negocio de solo lectura o de solo lectura, ni pertenecer a un nivel excluido por el elemento principal Connect;
- el elemento Importers requiere la marca Importers, la marca POS & Menu Sync o el modo Connect Pro elegible.
La elegibilidad de una ruta y su visibilidad en la barra lateral se comprueban por separado. Que una ruta esté presente o visible no demuestra que esté disponible el servicio de importación configurado.
Selecciona un negocio y un origen
Al seleccionar esta sección, Dashboard carga una lista paginada y autenticada de negocios. La lista puede incluir la página, el tamaño de página, el estado activo y el ID del negocio seleccionado; la búsqueda puede usar el nombre, correo electrónico y teléfono del negocio. Trata estos datos autenticados como confidenciales y no los incluyas en materiales compartidos.
Después de seleccionar un negocio, puedes elegir uno de estos orígenes de importación:
| Origen | Datos de entrada |
|---|---|
| DoorDash | Una URL del dominio esperado del proveedor; el formulario también permite incluir variantes. |
| Uber Eats | Una URL del dominio esperado del proveedor; el formulario también permite incluir variantes. |
| GloriaFood | Restaurant Key y Master Key, además de una opción relacionada con los límites de elección del proveedor. Ambos campos son necesarios para enviar. |
| OrderingPlus | Una URL compatible del negocio o el par completo de proyecto y negocio. |
Usa únicamente las credenciales del proveedor autorizadas para el proyecto. No compartas claves ni valores de acceso.
Ambas claves de GloriaFood son necesarias para iniciar la importación. Aunque Master Key no se incluye en la solicitud al servicio de importación, un servicio opcional de registros puede guardar Restaurant Key y Master Key para completar el formulario después. Si el registro falla, la importación aún puede aparecer como exitosa.
Límites de solicitud y resultado
Dashboard envía una solicitud al servicio de importación configurado para el origen seleccionado. Incluye el contexto autenticado del proyecto, el negocio seleccionado, el contexto base de Ordering API y los valores específicos del formulario. El formulario queda deshabilitado mientras la solicitud está pendiente.
La interfaz distingue estos estados:
- si falta la configuración del servicio, el envío se bloquea localmente;
- la validación local puede rechazar datos de origen ausentes o con estructura no válida;
- una respuesta fallida del servicio se convierte en un error general o específico del origen;
- una respuesta que el cliente interpreta como exitosa cambia el cuadro de diálogo a la vista de éxito y ofrece navegar a la página Products del negocio seleccionado.
La vista de éxito aparece cuando el servicio devuelve una respuesta que Dashboard acepta como correcta. Confirma el menú importado y los registros resultantes antes de depender de ellos; el aviso por sí solo no garantiza que se hayan conciliado ni que sea seguro repetir la importación.
Clasificación de errores
| Situación | Qué hacer |
|---|---|
| Falta un dato requerido o tiene un formato incorrecto | Completa el formulario sin compartir URL, claves, proyecto ni ID de negocio reales. |
| Falta la configuración del servicio de importación de menús | El flujo no está disponible para el proyecto. Pide al administrador que confirme la configuración. |
| GloriaFood informa un problema de acceso, tiempo de espera agotado o menú vacío | Anota la clase de error. No deduzcas el estado del proveedor ni reintentes de inmediato. |
| El servicio devuelve un error general | No se garantiza que reintentar sea seguro ni que el cambio anterior se haya revertido. |
| La solicitud vence o el resultado no está claro | Comprueba el menú y el estado de importación antes de volver a intentarlo para evitar cambios duplicados o parciales. |
Límites de las fuentes y los registros guardados
Cuando está configurado el servicio opcional de registros de importación, puede recuperar metadatos anteriores de un negocio y usar valores guardados para completar un cuadro de diálogo. También permite descargar o eliminar registros sin procesar. Estos registros pueden contener credenciales, respuestas del proveedor, identificadores del negocio y archivos.
Los registros de importación pueden contener información confidencial; limita su acceso y uso a personas autorizadas. El flujo genérico de archivos CSV y trabajos de importación de Ordering API es independiente de este servicio de importación de menús.
La disponibilidad y el comportamiento de las importaciones dependen del proveedor y del servicio desplegado del proyecto. Una respuesta por sí sola no confirma que se hayan completado los cambios del menú. Antes de reintentarlo, comprueba el menú y el estado de la importación para evitar cambios duplicados o parciales.
Guías relacionadas: Importadores · Resumen de POS & Menu Sync · Resumen de productos