Ir al contenido principal

Zenchef: backend de operador

Conecte Zenchef con Ventrata para revender productos de operadores de Zenchef con disponibilidad y reservas en tiempo real. Reservas de restaurante y gestión de mesas.

Zenchef logo

 

Zenchef es una plataforma europea de reservas y gestión de mesas para restaurantes, que reúne reservas, pagos, perfiles de clientes, marketing y analítica en su suite ZenchefOS. Opera en siete idiomas en Francia, los Países Bajos, Alemania, Bélgica, España, Italia y Portugal, con una app de reservas para los clientes e integraciones con los sistemas de punto de venta de los restaurantes, y presta servicio a restaurantes independientes y grupos de restauración.

 

Conectar Zenchef con Ventrata le permite revender productos de operadores que utilizan Zenchef como sistema de reservas. Ventrata lee su disponibilidad en tiempo real desde Zenchef, y cada reserva que recibe se crea directamente en la cuenta de Zenchef del operador.

 

Para obtener más información sobre Zenchef, visite zenchef.com.

 

📒 NOTA

Esta conexión está en fase de pruebas y puede que no esté disponible para todos los usuarios.

‼️ IMPORTANTE

En la conexión de Ventrata con Zenchef, las salas de restaurante de Zenchef (y una entrada adicional «All Rooms») se devuelven como productos para el mapeo.

 

Sitio web principal

Etiquetas

Booking / Ticketing System

Funciones de la conexión

Availability Sync · Bookings Sync

Desarrollado por

Ventrata (mediante la API de Zenchef)

 

Esta conexión de operador (también llamada backend) le permite revender productos de operadores que utilizan Zenchef como su sistema de reservas principal, y cada reserva se crea directamente en Zenchef. Entre las funcionalidades de esta conexión se incluyen:

  • Availability Sync: la disponibilidad en tiempo real procede de la cuenta de Zenchef del operador.

  • Bookings Sync: las reservas se envían de Ventrata a Zenchef, y Zenchef emite las entradas o los vouchers.

 

La API externa de Zenchef que se utiliza para esta conexión es una API personalizada que no sigue el estándar de la API OCTO, lo que puede limitar determinadas funcionalidades y capacidades.

 

Crear la conexión con Zenchef

🔐 Permisos de rol necesarios: See Operators, Modify Operators, See Products, Modify Products

Antes de empezar:

  • Debe tener un acuerdo comercial con el operador sobre sus tarifas y condiciones.

  • Debe disponer del Restaurant ID y el API Token de Zenchef del operador. Consulte los pasos siguientes.

  • Debe volver a crear los productos del operador en Ventrata. Consulte cómo crear productos. La conexión sincroniza la disponibilidad, los precios y las reservas, pero no crea productos en Ventrata.

 

Paso 1: Configurar el operador en Ventrata

Pida las credenciales a su operador. El restaurante las encuentra en su panel de Zenchef, en Partners > Integrations, o las obtiene del equipo de Zenchef.

 

  1. En el Ventrata Dashboard, vaya a Productos → Operadores (Products → Operators) y abra el operador. Si todavía no existe, primero créelo como operador.

  2. En la sección Socio de backend (Backend Partner), seleccione Zenchef e introduzca el Restaurant ID y el API Token de Zenchef.

  3. Haga clic en Actualizar Operador (Update Operator).

 

 

Paso 2: conecte cada producto

  1. Abra el producto del operador en Productos → Productos (Products → Products) y edítelo. Compruebe que el Operador sea este operador.

  2. Marque Backend conectado (Backend Connected). Marque Disponibilidad del backend (Backend Availability) para usar la disponibilidad de Zenchef.

  3. Haga clic en Actualizar Producto (Update Product).

📒 NOTA

Zenchef envía tanto los precios de venta al público como los precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público como su precio de venta y el precio neto como su precio de coste, independientemente del porcentaje de coste configurado en el operador.

 

Marque Disponibilidad del backend (Backend Availability) para obtener la disponibilidad de Zenchef.

 

Sin esta opción, el producto utiliza la disponibilidad configurada en Ventrata, pero sigue enviando las reservas a Zenchef.

 

Mapear productos con Zenchef

‼️ IMPORTANTE

El mapeo indica a Ventrata para qué producto, opción y unidades de Zenchef debe consultar la disponibilidad y realizar la reserva. Si un producto conectado al backend no está bien mapeado, sus reservas fallan. Un resaltado en rojo en toda la fila del producto indica que el producto está mal mapeado.

 

  1. En el Ventrata Dashboard, vaya a Productos → Productos (Products → Products) y abra el producto.

  2. Abra la pestaña Mapeos (Mappings). Aparece una vez que el producto tiene marcado Backend conectado (Backend Connected).

  3. Para cada opción y unidad de Ventrata, seleccione el producto, la opción y las unidades correspondientes de Zenchef en las listas desplegables, que Ventrata carga desde Zenchef. No deje ningún campo vacío.

  4. Haga clic en Save Changes.

📒 NOTA

En las listas desplegables de Mapeos (Mappings), los productos de Zenchef corresponden a las salas de Zenchef.

 

📗 CONSEJO

Haga una reserva de prueba después del mapeo y pida al operador que confirme que ha llegado a su cuenta de Zenchef.

 

Gestionar la conexión con Zenchef

  • Actualice el mapeo cuando el operador cambie productos, opciones o unidades en Zenchef.

  • Sustituya la clave en el operador si Zenchef o el operador emiten una nueva.

  • Desactive Disponibilidad del backend o Precios del backend (Backend Availability / Backend Pricing) en un producto para usar la disponibilidad o los precios propios de Ventrata. Las reservas se siguen enviando a Zenchef.

 

Funciones de la conexión en detalle

Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Zenchef. Aquí el sentido es el contrario al de una conexión de revendedor: Ventrata llama a Zenchef mediante la API de Zenchef. Para cada funcionalidad, se explica qué llamadas realiza Ventrata, cuándo y qué significa para usted.

 

En resumen: Ventrata solicita a Zenchef la disponibilidad cada vez que alguien consulta un producto conectado al backend, y crea cada reserva en la cuenta de Zenchef del operador. Zenchef no envía cambios de vuelta a Ventrata.

 

Los tiempos son los habituales en Zenchef, están redondeados y pueden cambiar.

 

Product Mapping

✅

Usted mapea cada producto, opción y unidad de Ventrata con el producto de Zenchef del operador en el Ventrata Dashboard.

Funciona así:

  • Productos: Ventrata lee los productos, opciones y unidades de Zenchef del operador para rellenar las listas desplegables de la pestaña Mapeos (Mappings).

  • Rutas observadas: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Qué significa esto para usted: si falta algo en la lista desplegable, el operador no se lo ha puesto a su disposición en Zenchef. Pídale que lo haga.

Content Sync

❌

Ventrata no importa el contenido de los productos desde Zenchef.

Ventrata no importa el contenido de los productos desde Zenchef. Usted mismo crea y describe los productos en Ventrata.

Availability Sync

✅

Con Disponibilidad del backend (Backend Availability) activada, Ventrata consulta la disponibilidad en tiempo real del operador en Zenchef.

Funciona así:

  • Disponibilidad: cuando alguien usa el calendario de disponibilidad en Ventrata, por ejemplo en el Dashboard, en su Web Checkout o en un terminal, Ventrata consulta a Zenchef en tiempo real las fechas que aparecen en pantalla.

  • Sincroniza la disponibilidad desde el sistema Zenchef del operador.

  • Rutas observadas: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Lo habitual con Zenchef:

  • Las solicitudes abarcan 7 días cada vez, desde hoy hasta aproximadamente un año vista, a medida que los usuarios navegan y Ventrata carga el calendario.

 

Qué significa esto para usted: los clientes reservan sobre la disponibilidad en tiempo real del operador en Zenchef, por lo que no puede vender de más una franja que el operador ya ha vendido en otro canal.

Pricing Sync

❌

Ventrata no lee los precios desde Zenchef.

Ventrata no lee los precios desde Zenchef. Los productos usan los precios que usted establece en Ventrata, y las reservas se siguen enviando a Zenchef.

Zenchef envía tanto los precios de venta al público como los precios netos. Con Precios del backend (Backend Pricing) marcado, Ventrata registra el precio de venta al público como su precio de venta y el precio neto como su precio de coste, independientemente del porcentaje de coste configurado en el operador.

Promotions Sync

❌

Las promociones no se envían a Zenchef.

Las promociones no se envían a Zenchef. Sus promociones de Ventrata siguen aplicándose al precio que paga su cliente en Ventrata.

Bookings Sync

✅

Las reservas realizadas en Ventrata para un producto conectado al backend se crean en la cuenta de Zenchef del operador.

Funciona así:

  1. Bloqueo y confirmación: cuando el producto se añade al carrito, Ventrata comprueba la reserva con Zenchef y, tras el pago, crea la reserva en la cuenta de Zenchef del operador con los datos del cliente.

  2. Entradas: la referencia o las entradas que devuelve Zenchef se guardan en la reserva de Ventrata.

  3. Llamadas observadas: Cancel Booking, Confirm Booking, Create Booking, Get Booking, Update Booking.

Envía reservas, modificaciones y cancelaciones de Ventrata a Zenchef. Recibe vouchers o entradas de Zenchef y los emite a sus clientes.

 

‼️ IMPORTANTE – Las reservas se sincronizan en un solo sentido, de Ventrata a Zenchef. Si el operador modifica o cancela una reserva en Zenchef, Ventrata no recibe ningún aviso. Pida al operador que le informe de cualquier cambio que haga.

Pickups/Dropoff Sync

❌

Los datos de recogida y regreso no se transmiten a Zenchef.

Los datos de recogida y regreso no se transmiten a Zenchef. Compártalos con el operador por otra vía si un producto los necesita.

Custom Questions Sync

❌

Las respuestas a sus preguntas de reserva no se transmiten a Zenchef.

Las respuestas a sus preguntas de reserva no se transmiten a Zenchef. Compártalas con el operador por otra vía si las necesita.

Extras Sync

❌

Los extras y complementos no se reservan en Zenchef.

Los extras y complementos no se reservan en Zenchef. Solo se reservan el producto principal, la opción y las unidades.

Redemption Sync

❌

Los canjes y otros cambios de estado en Zenchef no se envían de vuelta a Ventrata una vez confirmada la reserva.

Los canjes y otros cambios de estado en Zenchef no se envían de vuelta a Ventrata una vez confirmada la reserva.

Pass Walkup Scanning Sync

❌

El escaneo de pases sin reserva previa no está disponible con Zenchef.

El escaneo de pases sin reserva previa no está disponible con Zenchef.

Gift Card Sync

❌

Las tarjetas regalo de Ventrata no se transmiten a Zenchef.

Las tarjetas regalo de Ventrata no se transmiten a Zenchef. Los pagos con tarjeta regalo se quedan en Ventrata.

✅ compatible · ❌ no compatible

 

Conviene saber: límites y detalles de la conexión con Zenchef

  • Disponibilidad en tiempo real: la disponibilidad se obtiene de Zenchef mientras los clientes navegan.

  • Reservas en un solo sentido: los cambios que el operador hace en Zenchef no llegan a Ventrata.

  • API personalizada: la API de Zenchef no es OCTO, por lo que algunas funcionalidades pueden estar limitadas en comparación con los backends OCTO.

  • Pensado para atracciones que también gestionan un restaurante que necesita reservas; los productos de restaurante se pueden revender y empaquetar a través de Ventrata.

 

Preguntas frecuentes

Recibo un error al guardar la configuración del backend del operador.

Lo más probable es que el Restaurant ID y el API Token de Zenchef, o el endpoint, sean incorrectos. Compruébelos con su operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.

Lo más probable es que el operador asignado al producto no tenga un backend configurado. Revise la configuración de Socio de backend (Backend Partner) del operador y vuelva a intentarlo. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.

Las listas desplegables muestran lo que el operador le ha puesto a su disposición en Zenchef. Consulte al operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Las reservas de un producto conectado al backend fallan.

Compruebe primero el mapeo del producto: todas las opciones y unidades deben estar mapeadas. Después, compruebe que la franja horaria sigue disponible en Zenchef. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.

Recibo un error al guardar la configuración del backend del operador.

Lo más probable es que el Restaurant ID y el API Token de Zenchef no sean válidos. Compruébelos con su operador. Si el problema persiste, póngase en contacto con el soporte.

No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.

Lo más probable es que el operador seleccionado en el producto no tenga ningún backend configurado. Compruebe la configuración del backend y vuelva a intentarlo. Si el problema persiste, póngase en contacto con el soporte.

El proveedor, el producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.

La lista desplegable se obtiene en función de las salas de restaurante de Zenchef puestas a su disposición. Compruébelo con su operador y con Zenchef. Si el problema persiste, póngase en contacto con el soporte.

 

Recursos útiles

 

 

Información del partner

ZENCHEF SAS (Registro Mercantil de París 528389794)

63 Av. de Villiers

75017 Paris, Francia

 

ID de partner de Ventrata: a7fb0c12-9a0a-49ed-87f6-97813ec681f9

¿Ha quedado contestada tu pregunta?