Ir para conteúdo principal

Zenchef: backend de operador

Ligue Zenchef à Ventrata para revender produtos de operadores de Zenchef com disponibilidade e reservas em tempo real. Reservas de restaurantes e gestão de mesas.

Zenchef logo

 

Zenchef é uma plataforma europeia de reservas e gestão de mesas para restaurantes, que reúne reservas, pagamentos, perfis de clientes, marketing e análise na sua suite ZenchefOS. Opera em sete idiomas em França, Países Baixos, Alemanha, Bélgica, Espanha, Itália e Portugal, com uma aplicação de reservas para clientes e integrações com sistemas de ponto de venda de restaurantes, e serve restaurantes independentes e grupos de restauração.

 

Ligar Zenchef à Ventrata permite-lhe revender produtos de operadores que utilizam Zenchef como sistema de reservas. A Ventrata lê a disponibilidade em tempo real a partir de Zenchef, e cada reserva que recebe é criada diretamente na conta do operador em Zenchef.

 

Para saber mais sobre Zenchef, visite zenchef.com.

 

📒 NOTA

Esta conexão está em fase de testes e pode não estar disponível para todos os utilizadores.

‼️ IMPORTANTE

Na conexão da Ventrata com Zenchef, as salas de restaurante de Zenchef (e uma entrada adicional 'All Rooms') são devolvidas como produtos para mapeamento.

 

Website principal

Etiquetas

Booking / Ticketing System

Funcionalidades da conexão

Availability Sync · Bookings Sync

Desenvolvido por

Ventrata (através da API de Zenchef)

 

Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Zenchef como sistema de reservas principal, com cada reserva criada diretamente em Zenchef. As funcionalidades desta conexão incluem:

  • Availability Sync – a disponibilidade em tempo real vem da conta do operador em Zenchef.

  • Bookings Sync – as reservas são enviadas da Ventrata para Zenchef, e Zenchef emite os bilhetes ou vouchers.

 

A API externa de Zenchef utilizada nesta conexão é uma API personalizada que não segue o padrão OCTO API, o que pode limitar certas funcionalidades e capacidades.

 

Criar a conexão com Zenchef

🔐 Permissões de função necessárias: See Operators, Modify Operators, See Products, Modify Products

Antes de começar:

  • Tem de ter um acordo comercial com o operador relativo às respetivas tarifas e condições.

  • Tem de ter o Zenchef Restaurant ID e o Zenchef API Token do operador. Consulte os passos abaixo.

  • Tem de recriar os produtos do operador na Ventrata. Veja como criar produtos. A conexão sincroniza a disponibilidade, os preços e as reservas, mas não cria produtos na Ventrata.

 

Passo 1: configurar o operador na Ventrata

Peça as credenciais ao seu operador. O restaurante encontra-as no respetivo painel de Zenchef, em Partners > Integrations, ou obtém-nas junto da equipa de Zenchef.

 

  1. No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.

  2. Na secção Backend Partner, selecione Zenchef e introduza o Zenchef Restaurant ID e o Zenchef API Token.

  3. Press Update Operator.

 

 

Passo 2: conecte cada produto

  1. Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.

  2. Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de Zenchef.

  3. Press Update Product.

📒 NOTA

Zenchef envia preços de venda ao público e preços líquidos. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público como o seu preço de venda e o preço líquido como o seu preço de custo, independentemente da percentagem de custo definida no operador.

 

Marque Backend Availability para obter a disponibilidade de Zenchef.

 

Sem esta opção, o produto utiliza a disponibilidade definida na Ventrata, mas continua a enviar as reservas para Zenchef.

 

Mapear produtos para Zenchef

‼️ IMPORTANTE

O mapeamento indica à Ventrata o produto, a opção e as unidades de Zenchef cuja disponibilidade deve consultar e que deve reservar. Se um produto ligado ao backend não estiver corretamente mapeado, as respetivas reservas falham. Um destaque a vermelho em toda a linha do produto indica um produto mal mapeado.

 

  1. No Ventrata Dashboard, aceda a Products → Products e abra o produto.

  2. Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.

  3. Para cada opção e unidade Ventrata, selecione o produto, a opção e as unidades correspondentes de Zenchef nas listas pendentes, que a Ventrata carrega a partir de Zenchef. Não deixe nenhum campo vazio.

  4. Press Save Changes.

📒 NOTA

Nas listas pendentes de Mappings, os produtos de Zenchef correspondem às salas de Zenchef.

 

📗 DICA

Faça uma reserva de teste depois do mapeamento e peça ao operador que confirme que esta chegou à sua conta em Zenchef.

 

Gerir a conexão com Zenchef

  • Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Zenchef.

  • Substitua a chave no operador se Zenchef ou o operador emitirem uma nova.

  • Desative Backend Availability ou Backend Pricing num produto para utilizar a disponibilidade ou os preços da própria Ventrata. As reservas continuam a ser enviadas para Zenchef.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Zenchef. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Zenchef, através da API de Zenchef. Para cada funcionalidade, explica que chamadas a Ventrata faz, quando as faz e o que isso significa para si.

 

Em resumo: a Ventrata pede a Zenchef a disponibilidade sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em Zenchef. Zenchef não envia alterações de volta para a Ventrata.

 

Os prazos são os habituais para Zenchef, estão arredondados e podem mudar.

 

Product Mapping

✅

No Ventrata Dashboard, cada produto, opção e unidade Ventrata é mapeado para o produto do operador em Zenchef.

Funciona da seguinte forma:

  • Produtos – a Ventrata lê os produtos, opções e unidades do operador em Zenchef para preencher as listas pendentes no separador Mappings.

  • Caminhos observados: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em Zenchef. Peça-lhe que o faça.

Content Sync

❌

A Ventrata não importa o conteúdo dos produtos de Zenchef.

A Ventrata não importa o conteúdo dos produtos de Zenchef. É o próprio utilizador que cria e descreve os produtos na Ventrata.

Availability Sync

✅

Com Backend Availability ativado, a Ventrata consulta a disponibilidade do operador em tempo real em Zenchef.

Funciona da seguinte forma:

  • Disponibilidade – quando alguém utiliza o calendário de disponibilidade na Ventrata, por exemplo no Dashboard, no seu web checkout ou num terminal, a Ventrata pede a Zenchef, em tempo real, a disponibilidade das datas apresentadas no ecrã.

  • Sincroniza a disponibilidade a partir do sistema Zenchef do operador.

  • Caminhos observados: GET /api/v1/restaurants/{n}, GET /api/v1/restaurants/{n}/bookingrooms.

 

Normalmente, com Zenchef:

  • Os pedidos abrangem 7 dias de cada vez, desde hoje até cerca de um ano depois, à medida que as pessoas navegam e a Ventrata carrega o calendário.

 

O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Zenchef, pelo que não pode vender em excesso um horário que o operador já vendeu noutro lado.

Pricing Sync

❌

A Ventrata não lê os preços de Zenchef.

A Ventrata não lê os preços de Zenchef. Os produtos utilizam os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para Zenchef.

Zenchef envia preços de venda ao público e preços líquidos. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público como o seu preço de venda e o preço líquido como o seu preço de custo, independentemente da percentagem de custo definida no operador.

Promotions Sync

❌

As promoções não são enviadas para Zenchef.

As promoções não são enviadas para Zenchef. As suas promoções Ventrata continuam a aplicar-se ao preço que o seu cliente paga na Ventrata.

Bookings Sync

✅

As reservas feitas na Ventrata para um produto ligado ao backend são criadas na conta do operador em Zenchef.

Funciona da seguinte forma:

  1. Reter e confirmar: quando o produto é adicionado ao carrinho, a Ventrata verifica a reserva junto de Zenchef e, após o pagamento, cria a reserva na conta do operador em Zenchef com os dados do cliente.

  2. Bilhetes: a referência ou os bilhetes devolvidos por Zenchef ficam guardados na reserva Ventrata.

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

Envia reservas, atualizações e cancelamentos da Ventrata para Zenchef. Recebe vouchers/bilhetes de Zenchef e emite-os para os seus clientes.

 

‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Zenchef. Se o operador alterar ou cancelar uma reserva em Zenchef, a Ventrata não é notificada. Peça ao operador que o informe de quaisquer alterações que faça.

Pickups/Dropoff Sync

❌

Os dados de recolha e largada não são transmitidos a Zenchef.

Os dados de recolha e largada não são transmitidos a Zenchef. Partilhe-os com o operador por outra via se um produto precisar deles.

Custom Questions Sync

❌

As respostas às suas perguntas de reserva não são transmitidas a Zenchef.

As respostas às suas perguntas de reserva não são transmitidas a Zenchef. Partilhe-as com o operador por outra via se este precisar delas.

Extras Sync

❌

Os extras e complementos não são reservados em Zenchef.

Os extras e complementos não são reservados em Zenchef. Apenas o produto, a opção e as unidades principais o são.

Redemption Sync

❌

Os resgates e outras alterações de estado em Zenchef não são enviados de volta para a Ventrata depois de uma reserva ser confirmada.

Os resgates e outras alterações de estado em Zenchef não são enviados de volta para a Ventrata depois de uma reserva ser confirmada.

Pass Walkup Scanning Sync

❌

A digitalização de passes sem reserva (walk-up) não está disponível com Zenchef.

A digitalização de passes sem reserva (walk-up) não está disponível com Zenchef.

Gift Card Sync

❌

Os cartões-oferta Ventrata não são transmitidos a Zenchef.

Os cartões-oferta Ventrata não são transmitidos a Zenchef. Os pagamentos com cartão-oferta ficam na Ventrata.

✅ suportado · ❌ não suportado

 

Bom saber: limites e detalhes da conexão com Zenchef

  • Disponibilidade em tempo real: a disponibilidade vem de Zenchef à medida que as pessoas navegam.

  • Reservas num só sentido: as alterações que o operador faz em Zenchef não chegam à Ventrata.

  • API personalizada: a API de Zenchef não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.

  • Destina-se a atrações que também gerem um restaurante que precisa de reservas; os produtos de restauração podem ser revendidos e incluídos em pacotes através da Ventrata.

 

Perguntas frequentes

Recebo um erro quando guardo a configuração do backend do operador.

Muito provavelmente, o Zenchef Restaurant ID e o Zenchef API Token ou o endpoint estão incorretos. Verifique-os com o seu operador. Se o problema persistir, contacte o nosso Suporte técnico.

Não existe a caixa Backend Connected nas definições do produto.

O mais provável é que o operador definido no produto não tenha um backend configurado. Verifique as definições de Backend Partner do operador e tente novamente. Se o problema persistir, contacte o nosso Suporte técnico.

O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.

As listas pendentes mostram o que o operador disponibilizou para si em Zenchef. Fale com o operador. Se o problema persistir, contacte o nosso Suporte técnico.

As reservas de um produto ligado ao backend falham.

Verifique primeiro o mapeamento do produto: todas as opções e unidades têm de estar mapeadas. Depois, verifique se o horário ainda está disponível em Zenchef. Se o problema persistir, contacte o nosso Suporte técnico.

Recebo um erro ao guardar a configuração do backend do operador.

Muito provavelmente, o Zenchef Restaurant ID e o Zenchef API Token não são válidos. Confirme-os com o seu operador. Se o problema persistir, contacte o suporte.

Não existe a caixa de verificação Backend Connected nas definições do produto.

Muito provavelmente, o operador selecionado no produto não tem nenhum backend configurado. Verifique a configuração do backend e tente novamente. Se o problema persistir, contacte o suporte.

O fornecedor, produto, opção ou unidade que pretendo mapear não aparece na lista pendente.

A lista pendente é obtida com base nas salas de restaurante em Zenchef disponibilizadas para si. Confirme com o seu operador e com Zenchef. Se o problema persistir, contacte o suporte.

 

Recursos úteis

 

 

Informações do parceiro

ZENCHEF SAS (Paris Trade and Companies Register 528389794)

63 Av. de Villiers

75017 Paris, France

 

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

Isto respondeu à sua pergunta?