Ir para conteúdo principal

FareHarbor: backend de operador

Ligue FareHarbor à Ventrata para revender produtos de operadores de FareHarbor com disponibilidade, preços e reservas em tempo real. Utilizado por mais de 20 000 empresas.

FareHarbor logo

 

FareHarbor, parte da Booking Holdings, é uma plataforma de reservas e gestão empresarial utilizada por mais de 20 000 empresas de tours, atividades, aluguer e atrações, com maior adoção entre pequenos e médios operadores na América do Norte e na Europa. O seu produto abrange vendas online e presenciais, gestão de inventário, pagamentos, eventos privados, relatórios, planeamento de pessoal, uma aplicação móvel e programas de parceiros para afiliados e APIs.

 

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

 

Para saber mais sobre FareHarbor, visite fareharbor.com.

 

📒 NOTA

Pretende, em vez disso, que FareHarbor revenda os seus produtos? Consulte FareHarbor: conexão de revendedor.

 

‼️ IMPORTANTE

FareHarbor cobra-lhe, a si, distribuidor ou revendedor, taxas pela utilização desta conexão. Para mais informações, contacte diretamente FareHarbor. A Ventrata não cobra taxas adicionais por esta conexão.

 

Website principal

Etiquetas

Booking / Ticketing System

Funcionalidades da conexão

Availability Sync · Pricing Sync · Bookings Sync

Desenvolvido por

Ventrata (através da FareHarbor External API)

 

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

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

  • Pricing Sync – os preços de venda ao público e os preços líquidos vêm de FareHarbor, ou são definidos por si na Ventrata.

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

 

A API externa de FareHarbor 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 FareHarbor

🔐 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 um acordo de distribuidor com FareHarbor e a sua FareHarbor User Key. Consulte o Passo 1.

  • 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: Registar-se como distribuidor de FareHarbor

Se ainda não se ligou a nenhum operador de FareHarbor, envie um email para [email protected] com cópia para [email protected] e [email protected] a pedir um acordo de distribuidor. Inclua:. Mencione que é utilizador da Ventrata.

  • O nome comercial, o número de IVA e a morada da sua empresa

  • O nome completo, o endereço de email e o cargo da pessoa que assina

  • Os operadores de FareHarbor aos quais pretende ligar-se

  • As páginas do seu website onde tenciona vender os respetivos produtos (se aplicável)

  • Que é utilizador da Ventrata

 

Quando o acordo estiver em vigor, [email protected] ou [email protected] envia-lhe a sua FareHarbor User Key. Se já se ligou a operadores de FareHarbor anteriormente, já tem uma.

 

Passo 2: configurar o operador na Ventrata

  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 FareHarbor e introduza a chave. Mantenha o campo do endpoint com o valor predefinido, a menos que o operador lhe indique o contrário.

  3. Clique em Update Operator.

 

 

Passo 3: 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 FareHarbor e Backend Pricing para utilizar os preços de FareHarbor.

  3. Clique em Update Product.

📒 NOTA

FareHarbor 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.

 

Mapear produtos para FareHarbor

‼️ IMPORTANTE

O mapeamento indica à Ventrata o produto, a opção e as unidades de FareHarbor 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 da Ventrata, selecione o item e os tipos de cliente correspondentes de FareHarbor nas listas pendentes, que a Ventrata carrega a partir de FareHarbor. Não deixe nenhum campo vazio.

  4. 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 FareHarbor.

 

Gerir a conexão com FareHarbor

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

  • Substitua a chave no operador se FareHarbor 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 FareHarbor.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com FareHarbor. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama FareHarbor, através da External API de FareHarbor. 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 FareHarbor a disponibilidade e os preços sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em FareHarbor. FareHarbor não envia alterações de volta para a Ventrata.

 

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

 

Product Mapping

✅

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

Funciona da seguinte forma:

  • Company (GET /companies/{shortname}/) – a Ventrata lê os dados da empresa do operador em FareHarbor, que verifica regularmente.

  • Items (GET /companies/{shortname}/items/) – a Ventrata lê os itens (produtos) FareHarbor do operador e os respetivos tipos de cliente para preencher as listas pendentes no separador Mappings.

 

O que isto significa para si: se faltar um item ou tipo de cliente na lista pendente, o operador não o disponibilizou para si em FareHarbor. Peça-lhe que o faça.

Availability Sync

✅

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

Funciona da seguinte forma:

  • Availabilities by date range (GET /companies/{shortname}/items/{pk}/minimal/availabilities/date-range/{start}/{end}/) – quando alguém utiliza o calendário de disponibilidade na Ventrata, a Ventrata pede a FareHarbor, em tempo real, a disponibilidade das datas apresentadas no ecrã.

  • Availabilities by date (GET /companies/{shortname}/items/{pk}/minimal/availabilities/date/{date}/) – a Ventrata volta a verificar a data escolhida imediatamente antes de criar uma reserva.

 

Normalmente, com FareHarbor:

  • Normalmente, os pedidos abrangem um único dia ou um intervalo de 7 dias, desde hoje até cerca de um ano depois, à medida que as pessoas navegam.

 

O que isto significa para si: os clientes reservam sempre com base na disponibilidade em tempo real do operador em FareHarbor.

Pricing Sync

✅

Com Backend Pricing ativado, a Ventrata obtém as tarifas do operador em FareHarbor, de venda ao público e líquidas, a partir da disponibilidade.

Funciona da seguinte forma:

  • Availabilities – cada disponibilidade de FareHarbor inclui as tarifas de cada tipo de cliente, que a Ventrata utiliza como preços do produto.

  • Com Backend Pricing desativado, o produto utiliza os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para FareHarbor.

FareHarbor 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.

Bookings Sync

✅ / ❌

As reservas feitas na Ventrata são criadas em FareHarbor. FareHarbor não tem passo de retenção, e os cancelamentos têm de ser verificados com o operador.

Funciona da seguinte forma:

  1. Retenção: Validate booking (POST /companies/{shortname}/availabilities/{pk}/bookings/validate/) – quando o produto é adicionado ao carrinho, a Ventrata verifica a reserva junto de FareHarbor. FareHarbor não retém lugares, pelo que a Ventrata os retém do seu lado apenas enquanto o cliente paga.

  2. Confirmação: Create booking (POST /companies/{shortname}/availabilities/{pk}/bookings/) – após o pagamento, a Ventrata valida novamente a reserva e cria-a na conta FareHarbor do operador com os dados do cliente. A referência da reserva de FareHarbor fica guardada na reserva da Ventrata.

  3. Cancelamento: quando cancela uma reserva na Ventrata, confirme também com o operador que foi cancelada em FareHarbor.

 

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

📒 NOTA – Como FareHarbor não retém lugares durante o checkout, um horário pode esgotar em FareHarbor enquanto o seu cliente está a pagar. A Ventrata volta a verificar antes de criar a reserva e interrompe-a se já não houver lugar.

Content Sync

❌

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

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

Promotions Sync

❌

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

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

Pickups/Dropoff Sync

❌

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

Os dados de recolha e largada não são transmitidos a FareHarbor. 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 FareHarbor.

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

Extras Sync

❌

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

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

Redemption Sync

❌

Os resgates e outras alterações de estado em FareHarbor 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 FareHarbor 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 FareHarbor.

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

Gift Card Sync

❌

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

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

✅ suportado · ✅ / ❌ limitado · ❌ não suportado

 

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

  • Taxas: FareHarbor cobra aos distribuidores por esta conexão. A Ventrata não cobra.

  • Sem retenção em FareHarbor: os lugares só ficam retidos na Ventrata durante o checkout, e a Ventrata volta a verificar a disponibilidade antes de reservar.

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

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

 

Perguntas frequentes

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

Muito provavelmente, a sua FareHarbor User Key está incorreta. Verifique-a e, 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 os itens e os tipos de cliente que o operador disponibilizou para si em FareHarbor. Confirme 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 FareHarbor. Se o problema persistir, contacte o nosso Suporte técnico.

 

Recursos úteis

 

 

Informações do parceiro

FareHarbor B.V.

Vijzelstraat 66-80

1017 HL Amsterdam, Netherlands

 

ID de parceiro Ventrata: 11496205-33a3-470e-9449-13f00f85c8d5

Isto respondeu à sua pergunta?