Opera Romana Pellegrinaggi é a organização de peregrinações do Vicariato de Roma, ao serviço dos peregrinos desde 1933 com itinerários em Roma e no Vaticano, viagens à Terra Santa, Lourdes, Fátima e Santiago, e o cartão OMNIA Vatican and Rome. Atrai viajantes religiosos italianos e internacionais, grupos paroquiais e escolas que reservam programas religiosos e culturais guiados em Roma e no Vaticano, em italiano, inglês, espanhol, francês e alemão.
Ligar Opera Romana Pellegrinaggi à Ventrata permite-lhe revender produtos de operadores que utilizam Opera Romana Pellegrinaggi como sistema de reservas. A Ventrata lê a disponibilidade em tempo real a partir de Opera Romana Pellegrinaggi, e cada reserva que recebe é criada diretamente na conta do operador em Opera Romana Pellegrinaggi.
Para saber mais sobre Opera Romana Pellegrinaggi, visite operaromanapellegrinaggi.org.
Website principal | |
Etiquetas | Custom / Proprietary Operator System |
Funcionalidades da conexão | Availability Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da Opera Romana Pellegrinaggi API) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Opera Romana Pellegrinaggi como sistema de reservas principal, com cada reserva criada diretamente em Opera Romana Pellegrinaggi. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em Opera Romana Pellegrinaggi.
Bookings Sync – as reservas são enviadas da Ventrata para Opera Romana Pellegrinaggi, e Opera Romana Pellegrinaggi emite os bilhetes ou vouchers.
A API externa de Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi
🔐 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 a chave API do 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: configurar o operador na Ventrata
Peça ao operador a chave API para a sua conta.
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 Opera Romana Pellegrinaggi e introduza a chave API.
Press Update Operator.
Passo 2: 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 Opera Romana Pellegrinaggi.
Press Update Product.
Mapear produtos para Opera Romana Pellegrinaggi
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi nas listas pendentes, que a Ventrata carrega a partir de Opera Romana Pellegrinaggi. Não deixe nenhum campo vazio.
Press 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 Opera Romana Pellegrinaggi.
Gerir a conexão com Opera Romana Pellegrinaggi
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Opera Romana Pellegrinaggi.
Substitua a chave no operador se Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Opera Romana Pellegrinaggi. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Opera Romana Pellegrinaggi, através da API de Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi a disponibilidade sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em Opera Romana Pellegrinaggi. Opera Romana Pellegrinaggi não envia alterações de volta para a Ventrata.
Os prazos são os habituais para Opera Romana Pellegrinaggi, 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 Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de Opera Romana Pellegrinaggi. A Ventrata não importa o conteúdo dos produtos de Opera Romana Pellegrinaggi. É 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 Opera Romana Pellegrinaggi. Funciona da seguinte forma:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Opera Romana Pellegrinaggi, 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 Opera Romana Pellegrinaggi. A Ventrata não lê os preços de Opera Romana Pellegrinaggi. Os produtos utilizam os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para Opera Romana Pellegrinaggi. |
Promotions Sync | ❌ |
As promoções não são enviadas para Opera Romana Pellegrinaggi. As promoções não são enviadas para Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi. Funciona da seguinte forma:
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Opera Romana Pellegrinaggi. Se o operador alterar ou cancelar uma reserva em Opera Romana Pellegrinaggi, 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 Opera Romana Pellegrinaggi. Os dados de recolha e largada não são transmitidos a Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi. As respostas às suas perguntas de reserva não são transmitidas a Opera Romana Pellegrinaggi. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em Opera Romana Pellegrinaggi. Os extras e complementos não são reservados em Opera Romana Pellegrinaggi. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi 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 Opera Romana Pellegrinaggi. A digitalização de passes sem reserva (walk-up) não está disponível com Opera Romana Pellegrinaggi. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a Opera Romana Pellegrinaggi. Os cartões-oferta Ventrata não são transmitidos a Opera Romana Pellegrinaggi. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com Opera Romana Pellegrinaggi
Bom saber: limites e detalhes da conexão com Opera Romana Pellegrinaggi
Disponibilidade em tempo real: a disponibilidade vem de Opera Romana Pellegrinaggi à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em Opera Romana Pellegrinaggi não chegam à Ventrata.
API personalizada: a API de Opera Romana Pellegrinaggi não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.
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 a chave API 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 Opera Romana Pellegrinaggi. 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 Opera Romana Pellegrinaggi. Se o problema persistir, contacte o nosso Suporte técnico.
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Opera Romana Pellegrinaggi
Via della Pigna
13/a, 00186 Roma (RM), Italy
ID de parceiro Ventrata: 71406b6f-be42-4a0e-82bf-8ff5d63c156a


