Conectar un canal

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. Si te faltan, pulsa el signo de interrogación que está al lado del título «Credenciales de …»: abre el aviso «De dónde salen estos datos» con la explicación de esa plataforma.
  • Ten creada la sucursal que va a cocinar. Sin ella no vas a poder habilitar 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.

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

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.»
  • 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.»

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. Enciende «Habilitar este canal».
  4. En «Ambiente», elige «Sandbox (pruebas)» 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».
  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», elige la sede que va a cocinar. No la dejes en «Sin asignar».
  11. En «Usuario al que se atribuyen las comandas», elige un usuario o deja «El primero disponible».
  12. Revisa los dos tiempos de la sección «Estado» (ver Fijar el tiempo de preparación y cada cuánto se consulta).
  13. Comprueba que «Consultar pedidos nuevos periódicamente» esté encendido.
  14. Pulsa «Guardar canal», abajo a la derecha. Mientras trabaja dice «Guardando...».
  15. Espera el aviso «Canal guardado» con el texto «La configuración de … quedó actualizada.».

Al guardar, el campo de la clave secreta se vacía y pasa a mostrar «Guardado — escribe para cambiarlo». 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: la pantalla te lo dice con «Déjalo vacío para conservar el actual.».

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 sandbox 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.

Ojo: después de una prueba exitosa la pantalla vuelve a cargar el canal desde lo guardado. Cualquier cambio que tuvieras escrito y sin guardar se pierde, incluidos los dos campos de secretos. Guarda antes de probar.

  1. Comprueba que ya pulsaste «Guardar canal». Si al lado del botón sale «Guarda primero las credenciales para poder probar la conexión.», es que falta guardar.
  2. Pulsa «Probar conexión». Mientras trabaja dice «Probando...».
  3. Si todo está bien, sale «Conexión exitosa» con el texto «Conexión establecida con …».
  4. Si no, sale «Sin conexión» con el motivo. Corrige y repite desde el paso 1.

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

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 canal».

Ojo: cambiar de pestaña sin guardar borra todo lo que escribiste, incluidos los secretos.

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. Apaga «Habilitar este canal».
  3. Pulsa «Guardar canal».

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 habilitar el canal hace falta el Client ID.» Habilitaste 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 credenciales» — «Ingresa el Client Secret del canal.» Canal nuevo, sin secreto guardado, y lo estás habilitando. 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.
«Falta la sucursal» — «Sin sucursal asignada no se sabe qué cocina prepara los pedidos de este canal.» «Sucursal que atiende el canal» quedó en «Sin asignar». Elige la sede que va a cocinar.
«Error» — «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» — «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 bloqueado en vez de dar este error. Sal de la pantalla, vuelve a entrar y guarda el canal con sus dos claves.
«Sin conexión» — «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.
«Sin conexión» — «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.
«Sin conexión» — 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.
«Sin conexión» — 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.
«Sin conexión» — «La plataforma no respondió como se esperaba.» Este es el mensaje sin detalle: la pantalla no recibió una respuesta que pudiera leer. Casi siempre es que el servidor del local está caído. Comprueba que el equipo del restaurante esté encendido y repite.
«Error» — «No se pudo guardar la configuración.» El guardado no llegó. Revisa la conexión y vuelve a pulsar «Guardar canal».
Guardaste 10 en «Consultar cada (segundos)» y aparece 30 El sistema no consulta más rápido que cada 30 segundos. Nada. Es a propósito.
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 debajo diga «Déjalo vacío para conservar el actual.».
«Acceso denegado» Tu usuario no es ADMIN ni DUENO. Pídeselo a un administrador o al dueño.

Relacionado