En esta página8 secciones

Conectar un canal

Restaurante · Lectura de 10 minutos

Para quién: ADMIN y DUENO. Dónde está: Configuración → Canales de delivery. Hace falta comprarlo aparte: sí.

Esto se hace una vez por plataforma. Al final el canal queda encendido, con sus claves guardadas y probado contra la plataforma, y los pedidos empiezan a caer en Salón → Delivery.

Vuelve a la portada de Canales de delivery para lo demás.

Antes de empezar

  • Ten a la mano las claves de la plataforma. Este sistema no las genera: las entrega el agregador. De dónde sale cada una lo dice la pantalla, debajo del título «Credenciales de …» de cada pestaña.
  • Ten creada la sucursal que va a cocinar. Sin ella no vas a poder encender el canal.
  • Decide primero si vas a trabajar en pruebas o de verdad. El ambiente se cambia después, pero las claves de uno no sirven en el otro: «Cada ambiente tiene sus propias credenciales: las de pruebas no sirven en producción.».

Qué le pide cada plataforma

Los campos son los mismos, pero cada plataforma los llama a su manera. Estos son los nombres que vas a ver en pantalla:

Uber Eats DiDi Food Rappi
Primera clave «Client ID» «App ID» «Client ID»
Clave secreta «Client Secret» «App Secret» «Client Secret»
Tu tienda allá «Store ID» «Shop ID» «Store ID»
«URL base de la API» Déjala vacía La de tu región, según el convenio La de tu país, obligatoria en producción

Y de dónde salen, según lo que dice la propia pantalla:

  • Uber Eats. «Uber entrega el Client ID y el Client Secret al aprobar la integración en su portal de desarrolladores. El Store ID sale del panel de la tienda. El mismo Client Secret es el que firma las notificaciones push, así que no hace falta un secreto de webhook aparte.»
  • DiDi Food. «DiDi Food entrega el App ID, el App Secret y el host de tu región al aprobar la integración. El acceso no es de autoservicio: hay que solicitarlo a través del ejecutivo comercial.»
  • Rappi. «Rappi entrega el Client ID y el Client Secret tras el alta como aliado con integración. El secreto del webhook se configura aparte, al registrar la URL de notificaciones.»

Debajo de cada campo de la tienda y de la URL, la pantalla también dice qué va ahí. Por ejemplo, en Uber Eats el «Store ID» es «El UUID de la tienda en Uber Eats (no el nombre del local).», y en Rappi la URL es «Obligatoria en producción: Rappi tiene un dominio por país (https://api.rappi.com.co, .mx, .br…). En pruebas se usa https://api.dev.rappi.com.». Cuando el campo de la URL está vacío, en gris se ve la que el sistema va a usar.

Paso a paso

  1. Entra a Configuración → Canales de delivery.
  2. Pulsa la pestaña de la plataforma: Uber Eats, DiDi Food o Rappi.
  3. Toca la fila «Uber Eats encendido» —con el nombre de la plataforma— para encenderlo.
  4. En «Ambiente», toca «Pruebas (sandbox)» o «Producción».
  5. Escribe la primera clave en el campo «Client ID» — en DiDi Food se llama «App ID».
  6. Escribe la clave secreta en «Client Secret» — en DiDi Food, «App Secret». El ojo de la derecha muestra lo que estás escribiendo, para comprobarlo.
  7. Escribe el identificador de tu tienda en «Store ID» — en DiDi Food, «Shop ID». En Rappi puedes dejarlo vacío para recibir los pedidos de toda la cuenta, pero entonces no vas a poder cerrar ni abrir la tienda desde aquí.
  8. Llena «URL base de la API» solo si tu plataforma lo pide (mira la tabla de arriba).
  9. Baja hasta «Dónde caen los pedidos».
  10. En «Sucursal que atiende el canal», toca la sucursal que va a cocinar. No la dejes en «Sin asignar».
  11. En «Usuario al que se atribuyen las comandas», elige un usuario. Si lo dejas en «El primero disponible», la pantalla avisa que se toma el primer usuario del sistema y las comandas le quedan a alguien al azar.
  12. Revisa los dos tiempos de «Estado del canal» (ver Fijar el tiempo de preparación y cada cuánto se pregunta).
  13. Comprueba que «Preguntar cada tanto si hay pedidos nuevos» esté encendido.
  14. Pulsa «Guardar Uber Eats» —con el nombre de la plataforma—, arriba a la derecha. Mientras trabaja dice «Guardando…».
  15. Espera el aviso de abajo «Uber Eats guardado». La pestaña pasa a llevar «Encendido» y debajo del título se lee «Uber Eats: encendido · pruebas (sandbox)» —o «producción»—.

Al guardar, el campo de la clave secreta se vacía y pasa a mostrar «Guardado: escribe para cambiarlo», con «En blanco se conserva el guardado.» debajo. Eso es normal: la clave quedó guardada y la pantalla no la vuelve a mostrar nunca.

Ojo: si más adelante escribes un secreto nuevo y guardas, el anterior se pierde. No hay forma de recuperarlo desde esta pantalla. Si solo quieres cambiar otra cosa, deja ese campo vacío.

Ojo: en «Producción» los pedidos que entren son de clientes reales, con dinero de por medio. Pasa a producción solo cuando la prueba en pruebas haya salido bien y tengas las claves reales del canal.

Probar la conexión

En Uber Eats y DiDi Food el botón hace dos cosas de una vez: comprueba que las claves sirven y que la tienda que escribiste es de tu cuenta. Ese segundo punto es el error más común al dar de alta un canal. En Rappi solo comprueba las claves: la tienda no entra en la prueba.

  1. Comprueba que ya guardaste. Al lado del botón, «Prueba las credenciales guardadas contra Uber Eats.» quiere decir que está todo guardado; «Prueba lo guardado: guarda antes los cambios para probarlos.», que tienes cambios pendientes.
  2. Pulsa «Probar conexión». Mientras trabaja dice «Probando…».
  3. Si todo está bien, sale abajo «Uber Eats respondió» con «Conexión establecida con Uber Eats.».
  4. Si no, junto al botón se queda escrito en rojo «La plataforma no respondió como se esperaba» con el motivo. Corrige, guarda y repite desde el paso 1.

La prueba no toca el pie de la tarjeta ni el aviso rojo de arriba: «Última consulta:» y «La última comunicación falló» solo cambian cuando el sistema pregunta por pedidos, no cuando pulsas «Probar conexión». Tampoco borra nada de lo que tengas escrito.

Cambiar algo de un canal ya conectado

  1. Entra a Configuración → Canales de delivery.
  2. Pulsa la pestaña del canal.
  3. Cambia lo que necesites. Deja vacíos los dos campos de secretos si no los vas a cambiar.
  4. Pulsa «Guardar …».

Si te arrepientes antes de guardar, «Descartar» deja el canal como estaba guardado.

Apagar un canal sin borrarlo

No hay forma de eliminar un canal, y no hace falta: apagarlo lo deja quieto y conserva las claves.

  1. Pulsa la pestaña del canal.
  2. Toca «Uber Eats encendido» —o el canal que sea— para apagarlo.
  3. Pulsa «Guardar …».

A partir de ahí no se consulta nada ni se le reporta nada a esa plataforma. Los pedidos que ya estén en Salón → Delivery siguen ahí, pero no van a poder confirmarse: el sistema responde «El canal de … está deshabilitado.».

Cuando algo no sale

Lo que ves Por qué pasa Qué hacer
«Faltan datos para encender Uber Eats» — «Escribe el Client ID.», y el campo en rojo con «Hace falta para encender el canal.» Encendiste el canal con el primer campo de credenciales vacío. En DiDi Food el mensaje nombra «App ID». Llénalo y vuelve a guardar.
«Faltan datos para encender Uber Eats» — «Escribe el Client Secret.» Canal sin secreto guardado, y lo estás encendiendo. En DiDi Food el mensaje nombra «App Secret». Escribe el secreto. Si crees que ya lo guardaste, mira si el campo dice «Guardado: escribe para cambiarlo»: si no lo dice, no está guardado.
«Faltan datos para encender Uber Eats» — «Elige la sucursal: sin ella no se sabe qué cocina prepara los pedidos.» «Sucursal que atiende el canal» quedó en «Sin asignar». Toca la sucursal que va a cocinar.
«No se pudo guardar» — «No hay empresa configurada: primero completa los datos de la empresa.» Faltan los datos de la empresa. Complétalos en Empresa y sucursales.
«Sin conexión con el servidor» — «El canal no se guardó.» El guardado no llegó. Revisa la conexión y vuelve a pulsar «Guardar …».
«Probar conexión» apagado, con «Guarda primero las credenciales para poder probarlas.» Ese canal todavía no tiene credenciales guardadas. Guarda el canal con sus dos claves.
«La plataforma no respondió como se esperaba» — «Todavía no hay configuración para Rappi.» o «Faltan credenciales de Uber Eats para probar la conexión.» Raro: mientras tenías la pantalla abierta, la configuración guardada de ese canal desapareció o se quedó sin claves. Estando bien, el botón sale apagado en vez de dar este error. Sal de la pantalla, vuelve a entrar y guarda el canal con sus dos claves.
«La plataforma no respondió como se esperaba» — «Falta el identificador de tienda (store_id) de Uber Eats en la configuración.» El campo «Store ID» está vacío. En DiDi Food el mensaje es el mismo pero dice «shop_id». En Rappi no sale: su prueba no mira la tienda. Escribe el identificador de la tienda y guarda.
«La plataforma no respondió como se esperaba» — «Uber Eats no devolvió un token de acceso.» La plataforma no aceptó las claves. Casi siempre es un Client Secret mal copiado, o claves de pruebas usadas en producción. Vuelve a copiar las dos claves del panel de la plataforma, comprobando que sean las del ambiente que elegiste.
«La plataforma no respondió como se esperaba» — un mensaje que empieza por «HTTP 401» o «HTTP 403» La plataforma rechazó las claves o el permiso. Revisa las claves y confirma con la plataforma que la integración está aprobada.
«La plataforma no respondió como se esperaba» — un mensaje que empieza por «HTTP 404» La tienda que escribiste no existe en esa cuenta, o la dirección del canal no es la correcta. En DiDi Food esto es frecuente: sus rutas llegan en el convenio. Confirma el identificador de la tienda. Si es DiDi Food, confirma también la dirección de tu región con ellos.
«La plataforma no respondió como se esperaba» — «No se pudo contactar a la plataforma desde el servidor.» La pantalla no recibió respuesta. Casi siempre es que el servidor del local está caído. Comprueba que el equipo del restaurante esté encendido y repite.
El campo del secreto vuelve a estar vacío después de guardar Es lo normal: la clave quedó guardada y no se vuelve a mostrar. Comprueba que diga «Guardado: escribe para cambiarlo».
«Solo un administrador o el dueño configuran los canales de delivery» / «Pídele a uno de ellos que cambie estos datos.» Tu usuario no es ADMIN ni DUENO. Pulsa «Volver a Configuración» y pídeselo a un administrador o al dueño.

Relacionado