Hellenic Heritage Tickets é a plataforma oficial de bilhética do Ministério da Cultura da Grécia e da ODAP, abrangendo uma rede de mais de 350 sítios arqueológicos, museus e monumentos em toda a Grécia, incluindo vinte sítios classificados como Património Mundial da UNESCO. O seu bilhete eletrónico unificado reúne 108 locais num único sistema, com entrada com hora marcada, acesso por QR no telemóvel e passes regionais e temáticos.
Ligar Hellenic Heritage à Ventrata permite-lhe revender produtos de operadores que utilizam Hellenic Heritage como sistema de reservas. A Ventrata lê a disponibilidade em tempo real a partir de Hellenic Heritage, e cada reserva que recebe é criada diretamente na conta do operador em Hellenic Heritage.
Para saber mais sobre Hellenic Heritage, visite tickets.hh.gr.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça a Hellenic Heritage Tickets que confirme que esta chegou ao respetivo sistema.
Website principal | |
Etiquetas | Booking / Ticketing System |
Funcionalidades da conexão | Availability Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da Hellenic Heritage Tickets API) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Hellenic Heritage como sistema de reservas principal, com cada reserva criada diretamente em Hellenic Heritage. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em Hellenic Heritage.
Bookings Sync – as reservas são enviadas da Ventrata para Hellenic Heritage, e Hellenic Heritage emite os bilhetes ou vouchers.
A API externa de Hellenic Heritage 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 Hellenic Heritage
🔐 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 as credenciais API de Hellenic Heritage Tickets (o artigo não indica os campos individuais) para o operador. Veja 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: pedir as credenciais API
Contacte Hellenic Heritage Tickets e peça as credenciais API para poder revender os respetivos produtos através da Ventrata.
Passo 2: configurar o operador na Ventrata
Contacte Hellenic Heritage Tickets e peça as credenciais API para poder revender os respetivos produtos através da Ventrata.
No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.
Na secção Backend Partner, selecione Hellenic Heritage e introduza as credenciais API de Hellenic Heritage Tickets (o artigo não indica os campos individuais).
Clique em Update Operator.
Passo 3: conecte cada produto
Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.
Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de Hellenic Heritage.
Clique em Update Product.
Certifique-se de que o Operator do produto está definido como Hellenic Heritage Tickets.
Marque Backend Connected. Para obter a disponibilidade a partir de Hellenic Heritage Tickets, marque também Backend Availability; para obter os preços, marque Backend Pricing.
Sem Backend Availability e Backend Pricing, o produto utiliza a disponibilidade e os preços configurados na Ventrata, mas continua a enviar as reservas para Hellenic Heritage Tickets.
Mapear produtos para Hellenic Heritage
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de Hellenic Heritage 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.
No Ventrata Dashboard, aceda a Products → Products e abra o produto.
Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.
Para cada opção e unidade Ventrata, selecione o produto, a opção e as unidades correspondentes de Hellenic Heritage nas listas pendentes, que a Ventrata carrega a partir de Hellenic Heritage. Não deixe nenhum campo vazio.
Clique em Save Changes.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça ao operador que confirme que esta chegou à sua conta em Hellenic Heritage.
Gerir a conexão com Hellenic Heritage
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Hellenic Heritage.
Substitua a chave no operador se Hellenic Heritage 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 Hellenic Heritage.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Hellenic Heritage. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Hellenic Heritage, através da API de Hellenic Heritage Tickets. 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 Hellenic Heritage a disponibilidade sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em Hellenic Heritage. Hellenic Heritage não envia alterações de volta para a Ventrata.
Os prazos são os habituais para Hellenic Heritage, 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 Hellenic Heritage. Funciona da seguinte forma:
O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em Hellenic Heritage. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de Hellenic Heritage. A Ventrata não importa o conteúdo dos produtos de Hellenic Heritage. É 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 Hellenic Heritage. Funciona da seguinte forma:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Hellenic Heritage, 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 Hellenic Heritage. A Ventrata não lê os preços de Hellenic Heritage. Os produtos utilizam os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para Hellenic Heritage. |
Promotions Sync | ❌ |
As promoções não são enviadas para Hellenic Heritage. As promoções não são enviadas para Hellenic Heritage. 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 Hellenic Heritage. Funciona da seguinte forma:
Envia reservas, atualizações e cancelamentos da Ventrata para Hellenic Heritage Tickets.
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Hellenic Heritage. Se o operador alterar ou cancelar uma reserva em Hellenic Heritage, 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 Hellenic Heritage. Os dados de recolha e largada não são transmitidos a Hellenic Heritage. 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 Hellenic Heritage. As respostas às suas perguntas de reserva não são transmitidas a Hellenic Heritage. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em Hellenic Heritage. Os extras e complementos não são reservados em Hellenic Heritage. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em Hellenic Heritage 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 Hellenic Heritage 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 Hellenic Heritage. A digitalização de passes sem reserva (walk-up) não está disponível com Hellenic Heritage. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a Hellenic Heritage. Os cartões-oferta Ventrata não são transmitidos a Hellenic Heritage. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com Hellenic Heritage
Bom saber: limites e detalhes da conexão com Hellenic Heritage
Disponibilidade em tempo real: a disponibilidade vem de Hellenic Heritage à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em Hellenic Heritage não chegam à Ventrata.
API personalizada: a API de Hellenic Heritage não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.
A conexão não cria produtos automaticamente; recrie-os primeiro na Ventrata.
Sobre o parceiro (da introdução do artigo): plataforma oficial de bilhética do Ministério da Cultura da Grécia e da ODAP, que abrange mais de 350 sítios arqueológicos, museus e monumentos, incluindo vinte sítios classificados como Património Mundial da UNESCO. A implementação de um bilhete eletrónico unificado em 2026 reuniu 108 locais num único sistema, com entrada com hora marcada, acesso por QR no telemóvel e passes regionais e temáticos.
Perguntas frequentes
Recebo um erro quando guardo a configuração do backend do operador.
Recebo um erro quando guardo a configuração do backend do operador.
O mais provável é que as credenciais API de Hellenic Heritage Tickets (o artigo não indica os campos individuais) ou o endpoint estejam incorretos. Confirme-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.
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.
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 Hellenic Heritage. Fale com o operador. Se o problema persistir, contacte o nosso Suporte técnico.
As reservas de um produto ligado ao backend falham.
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 Hellenic Heritage. Se o problema persistir, contacte o nosso Suporte técnico.
Recebo um erro ao guardar a configuração do backend do operador.
Recebo um erro ao guardar a configuração do backend do operador.
O mais provável é que as credenciais estejam incorretas. Confirme-as com Hellenic Heritage Tickets. Se o problema persistir, contacte o Suporte técnico.
Não existe a caixa de verificação Backend Connected nas definições do produto.
Não existe a caixa de verificação Backend Connected nas definições do produto.
O mais provável é que o operador selecionado no produto não tenha nenhum backend configurado. Verifique a configuração do backend do operador e tente novamente.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Hellenic Heritage Tickets
Eleftheriou Venizelou 57
105 64 Athens, Greece
ID de parceiro Ventrata: 086db963-6786-4ca6-b86f-e01408d945c4