Parigi.it é um portal de informação e reservas sobre Paris em língua italiana, gerido pela Cuma Travel e em atividade há mais de vinte anos, que vende bilhetes para museus e monumentos, passes de transporte, cruzeiros no Sena, entradas na Disneyland Paris e visitas guiadas em italiano. Para os operadores, traz viajantes italianos que pesquisam sobre Paris no seu próprio idioma e compram antes da partida, um canal de mercado único para atrações, cruzeiros e visitas guiadas em Paris.

Ligar Parigi.it à Ventrata sincroniza a sua disponibilidade e os seus preços e entrega reservas, alterações e cancelamentos, com bilhetes emitidos automaticamente.

Para saber mais sobre uma parceria com Parigi.it, visite parigi.it.

Website principal	parigi.it
Etiquetas	Cultural & Museum Tickets
Mercados de destino	🌎 Global
Mercados emissores	🌎 Global
Especialidades	Viajantes de língua italiana que planeiam viagens a Paris
Funcionalidades da conexão	Availability Sync · Bookings Sync
GMV reservado via Ventrata (últimos 12 meses)	US$10k+
Desenvolvido por	Parigi.it (através da API OCTO da Ventrata)

Esta conexão de revendedor permite-lhe vender os seus produtos através de Parigi.it sem gerir manualmente a disponibilidade e as reservas. As funcionalidades desta conexão incluem:

Availability Sync – Parigi.it consulta a sua disponibilidade em tempo real na Ventrata.
Bookings Sync – as reservas, atualizações e cancelamentos de Parigi.it são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

Criar a conexão com Parigi.it

🔐 Permissões de função necessárias: See Connections, Modify Connections, See Connection Key

Antes de começar:

Tem de ter um acordo comercial com Parigi.it para que vendam os seus produtos. Para se informar sobre uma parceria, contacte-os através de parigi.it.
Tem de criar Parigi.it como Reseller na Ventrata, com os respetivos preços (venda ao público, por grosso/comissão) corretamente definidos. Tenha em atenção que esta conexão API exige que o revendedor esteja configurado com o método de liquidação "Bill to my account".

No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Parigi.it na lista de parceiros.
Selecione o Reseller Parigi.it na lista dos seus revendedores (tem de ser criado antes de criar a conexão). A conexão herda a configuração do revendedor, como preços, destinos permitidos, produtos, etc.
(Opcional) Também pode definir um Name à sua escolha para a conexão, o que pode ser útil se planear ter várias conexões com Parigi.it e quiser distingui-las mais facilmente no futuro.
Clique no botão Create Octo Connection.

📗 DICA

Se necessário, também pode permitir ou excluir produtos ou destinos ao nível da conexão, além do que configurou no revendedor.

Mapear produtos para Parigi.it

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto em Parigi.it e peça-lhe que mapeie os seus produtos através da API OCTO da Ventrata, com os preços (octo/pricing) ativados. Normalmente, a equipa de Parigi.it não demora mais do que alguns dias úteis a concluir este processo.

A sua configuração na Ventrata está concluída. Não precisa de dar mais nenhum passo.

📗 DICA

Parigi.it pode aceder a todos os produtos ativados na conexão, mas também pode indicar os IDs de produto e de opção apresentados na página da conexão quando os contactar, para especificar o que deve ser mapeado.

Gerir a conexão com Parigi.it

Permitir ou excluir produtos: limite os destinos, produtos e opções a que Parigi.it pode aceder. Veja como permitir ou excluir produtos.
Mude o nome da conexão para distinguir várias conexões com Parigi.it.

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Parigi.it: que chamadas à API OCTO da Ventrata Parigi.it faz, quando as faz e o que isso significa para si. Cada chamada tem uma ligação para a documentação da API da Ventrata.

Em resumo: Parigi.it obtém da Ventrata tudo aquilo de que precisa. Lê os seus produtos, consulta a sua disponibilidade (e os seus preços, quando os pede) e envia reservas e cancelamentos. A Ventrata não envia alterações para Parigi.it, pelo que tudo o que alterar na Ventrata chega a Parigi.it na consulta seguinte.

Os tempos indicados são os habituais para Parigi.it e estão arredondados, podendo mudar se Parigi.it alterar a forma como sincroniza.

Product Mapping	❌	Não é possível mapear produtos a partir da Ventrata. Parigi.it mapeia-os do seu lado, através do seu gestor de conta ou do portal de Parigi.it. Funciona da seguinte forma: Get Products (`GET /products`) – quando Parigi.it configura a sua conexão, e sempre que atualiza os seus anúncios, lê todos os produtos ativados na conexão, com as respetivas opções e unidades (tipos de bilhete, como Adulto ou Criança). Get Product (`GET /products/{productId}`) – Parigi.it volta a ler um único produto para obter alterações às suas opções, unidades, prazos limite de reserva e definições. Mapeamento do lado de Parigi.it – Parigi.it associa cada opção e unidade da Ventrata ao seu próprio anúncio e aos seus tipos de bilhete. O seu gestor de conta em Parigi.it faz isto por si, ou pode fazê-lo no portal de Parigi.it, se Parigi.it disponibilizar um. Só precisa de partilhar a chave API da conexão. O que isto significa para si: Parigi.it só pode vender o que tiver mapeado. Quando adiciona um produto, opção ou unidade na Ventrata, Parigi.it pode vê-lo na atualização seguinte, mas não o venderá enquanto não estiver mapeado. Por isso, informe o seu gestor de conta em Parigi.it sempre que adicionar um.
Content Sync	❌	Parigi.it não lê o conteúdo dos seus produtos a partir da Ventrata. Parigi.it utiliza as descrições, imagens e outros conteúdos configurados do seu próprio lado, por isso atualize o seu conteúdo diretamente com Parigi.it.
Availability Sync	✅	Parigi.it consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para Parigi.it. Funciona da seguinte forma: Availability Check (`POST /availability`) – Parigi.it envia um produto, uma opção e uma data ou intervalo de datas. A Ventrata responde com cada dia ou horário reservável, o respetivo estado (`AVAILABLE`, `LIMITED`, `SOLD_OUT`, `CLOSED` ou `FREESALE`), as vagas restantes, o prazo limite de reserva e um `availabilityId`, de que Parigi.it precisa para reservar esse horário. Availability Calendar (`POST /availability/calendar`) – devolve um resumo por dia em vez de cada horário, normalmente para mostrar que datas estão abertas num seletor de datas. Verificação no momento da reserva – quando um cliente reserva, a Ventrata volta a verificar a capacidade antes de criar a reserva, pelo que Parigi.it não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada. Normalmente, com Parigi.it: Availability Check: Parigi.it verifica os seus produtos ao longo do dia, normalmente a partir de 16 dias de antecedência e abrangendo um único dia por pedido, consulta até cerca de 3 meses de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 12 horas. Availability Calendar: Parigi.it verifica cada produto aproximadamente a cada 2 horas, normalmente a partir de cerca de 5 meses de antecedência e abrangendo um único dia por pedido, e consulta até cerca de 5 meses de antecedência. As verificações concentram-se entre as 10:00 e as 16:00 UTC, o que sugere que a maioria é feita em tempo real, enquanto os clientes navegam em Parigi.it. O que isto significa para si: quando fecha uma data, altera a capacidade ou um horário esgota na Ventrata, Parigi.it mostra-o após a consulta seguinte. Para as datas que consulta regularmente, isso acontece em cerca de 2 horas. As datas mais distantes são normalmente consultadas com menos frequência.
Pricing Sync	❌	Parigi.it não obtém os seus preços a partir da Ventrata. Os preços em Parigi.it são geridos do lado de Parigi.it, pelo que deve mantê-los atualizados diretamente com Parigi.it.
Promotions Sync	❌	As suas promoções Ventrata não se aplicam em Parigi.it. Os preços em Parigi.it não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com Parigi.it.
Bookings Sync	✅	As reservas e os cancelamentos feitos em Parigi.it são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata. Funciona da seguinte forma: Retenção: Booking Reservation (`POST /bookings`) – quando um cliente inicia o checkout em Parigi.it, Parigi.it envia o produto, a opção, o horário escolhido (`availabilityId`) e um item de unidade por pessoa. A Ventrata volta a verificar a capacidade e cria uma reserva `ON_HOLD`, que retém os lugares enquanto o cliente paga. Se já não houver lugar, a Ventrata rejeita a retenção. Confirmação: Booking Confirmation (`POST /bookings/{uuid}/confirm`) – assim que o pagamento é aprovado, Parigi.it confirma a retenção, com a sua própria referência de reserva e os dados de contacto do cliente. A reserva passa a `CONFIRMED` na Ventrata, e a Ventrata devolve a sua referência de reserva e os bilhetes (um por pessoa) ou um voucher (um por reserva), consoante a configuração do seu produto, cada um com um código QR e uma ligação para PDF. Parigi.it entrega-os ao cliente, que os apresenta à sua entrada como qualquer bilhete Ventrata. Expiração: se o cliente não concluir o pagamento, Parigi.it nunca confirma, e a retenção expira por si só e liberta os lugares. Cancelamento: Booking Cancellation (`POST /bookings/{uuid}/cancel`) – quando um cliente cancela em Parigi.it, Parigi.it cancela a reserva na Ventrata. A Ventrata só aceita o cancelamento se a reserva ainda puder ser cancelada e o prazo limite de cancelamento da opção não tiver passado. Caso contrário, rejeita o pedido e Parigi.it terá de o contactar. Alteração: Parigi.it não utiliza Booking Update (`PATCH /bookings/{uuid}`), pelo que uma alteração chega muito provavelmente à Ventrata como um cancelamento seguido de uma nova reserva. Normalmente, com Parigi.it: Parigi.it não define um tempo de retenção, pelo que se aplica o tempo de retenção predefinido. Uma reserva típica em Parigi.it é para cerca de 2 pessoas. Parigi.it também verifica as reservas que efetuou, com Get Booking (`GET /bookings/{uuid}`) aproximadamente a cada 4 horas, por exemplo, para reconciliar os seus registos. ‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, de Parigi.it para a Ventrata. Se cancelar, alterar ou voltar a reservar uma reserva de Parigi.it na Ventrata, por exemplo no Dashboard, Parigi.it não recebe qualquer notificação. Contacte Parigi.it para que a reserva seja também cancelada ou alterada do lado de Parigi.it, ou peça ao cliente que cancele através de Parigi.it.
Pickups/Dropoff Sync	❌	Parigi.it não envia dados de recolha ou largada com as suas reservas. Se os seus produtos incluírem recolhas, confirme com Parigi.it como recolhe os dados de recolha, ou combine-os com o cliente.
Custom Questions Sync	❌	Parigi.it não envia as respostas às suas perguntas de reserva. Se depender de perguntas de reserva, por exemplo nomes ou necessidades alimentares, confirme com Parigi.it como recolhe essa informação.
Extras Sync	❌	Não é possível reservar extras e complementos através de Parigi.it. Em Parigi.it, os clientes só podem reservar os seus produtos e opções principais. Venda os extras separadamente, por exemplo à chegada.
Redemption Sync	❌	Os resgates não são comunicados a Parigi.it. A Ventrata não notifica Parigi.it quando um bilhete é digitalizado ou resgatado. Parigi.it só vê um resgate se voltar a ler a reserva a partir da Ventrata.
Pass Walkup Scanning Sync	❌	Os passes de Parigi.it não podem ser digitalizados à sua entrada sem uma reserva. Os clientes de Parigi.it precisam de uma reserva feita através de Parigi.it antes da visita.
Gift Card Sync	❌	Os cartões-oferta Ventrata não podem ser vendidos nem resgatados através de Parigi.it. Os cartões-oferta comprados na Ventrata não podem ser utilizados em Parigi.it, e Parigi.it não pode vender cartões-oferta Ventrata.

✅ suportado · ❌ não suportado

Bom saber: limites e detalhes da conexão com Parigi.it

Atrasos: a disponibilidade e os preços só chegam a Parigi.it no momento em que são consultados, pelo que há sempre um pequeno atraso depois de alterar algo na Ventrata.
Prazo limite de cancelamento: Parigi.it só pode cancelar através da API antes do prazo limite de cancelamento da sua opção. Os cancelamentos posteriores têm de ser acordados consigo.
O que Parigi.it pode ver: apenas os destinos, produtos e opções permitidos no revendedor e na conexão, e ativados para venda na fonte Direct API. Veja como permitir ou excluir produtos.
Bilhetes: Parigi.it emite os bilhetes ou o voucher Ventrata que recebe na confirmação, pelo que a digitalização e o resgate habituais funcionam normalmente.
Reservas de teste: Parigi.it pode enviar reservas de teste enquanto configura a conexão. As reservas de teste não consomem a sua disponibilidade e não são faturadas.

Perguntas frequentes

Não são apresentados produtos na página da conexão.

Verifique que destinos, produtos e opções estão permitidos no seu revendedor e na conexão. Em seguida, confirme que os seus produtos e opções estão ativados para venda na fonte Direct API. Se o problema persistir, contacte o nosso Suporte técnico.

Os meus produtos Ventrata utilizam tarifas Booking Size e os preços não estão a funcionar corretamente em Parigi.it.

Após cada alteração de tarifa, atualize o mapeamento do produto para garantir que as contagens de escalões do parceiro estão sincronizadas com a Ventrata. Certifique-se de que a tarifa está ativada para venda através de Direct API.

📚 Mais sobre as conexões Ventrata

Informações do parceiro

Cuma Travel s.r.l.

parigi.it

ID de parceiro Ventrata: b2dcfecc-c90b-4c73-9d46-9a777601f84d

Parigi.it: conexão de revendedor