Saltar para o conteúdo

Reservas

Integração FareHarbor

Operadores de tours e atividades: cada reserva FareHarbor gera o documento certo no software de faturação, sem exportações manuais.

Visão geral

FareHarbor

O FareHarbor é um sistema de reservas para tours, passeios de barco, aluguer de equipamento e atividades ao ar livre. Gere a disponibilidade por item e horário, recebe reservas no site do operador e de revendedores, e trata do pagamento online.

Muitos operadores em Portugal exportam as reservas para uma folha de cálculo e passam-nas à mão para o programa de faturação. A Tejobit elimina esse passo: a ligação recebe as reservas do FareHarbor e cria o documento no Moloni, no Sage ou noutro software, com o nome do cliente, o item, a data da atividade e o valor pago. O documento é emitido e comunicado à AT pelo programa certificado.

O acesso à API externa do FareHarbor não é imediato: é pedido ao FareHarbor e só fica ativo depois de aprovado. A Tejobit acompanha esse pedido com o operador.

Casos de uso

Para que serve

  • Empresa de passeios de barco em Lagos que quer uma fatura-recibo por reserva paga, sem copiar dados ao fim do dia.
  • Operador de walking tours em Lisboa que vende através de agências e precisa de separar reservas diretas das de revenda.
  • Escola de surf na Ericeira que fatura aulas e aluguer de prancha com taxas de IVA diferentes.
  • Empresa de jipe safari que trata cancelamentos com reembolso e precisa da nota de crédito correspondente.
  • Operador com contabilista externo que quer um resumo diário de reservas e documentos emitidos.
IN

O que a ligação escuta

  • Notificações de reservas do FareHarbor (novas reservas, alterações e cancelamentos), conforme a configuração aprovada.
  • Consultas periódicas à API para reservas e pagamentos que não chegam por notificação.
  • Fecho do dia, para gerar o resumo enviado à contabilidade.
OUT

O que a ligação faz

  • Cria o cliente e o documento no Moloni, no Sage ou noutro software com os dados da reserva.
  • Aplica a taxa de IVA certa por tipo de item (atividade, aluguer, extras).
  • Prepara a nota de crédito quando uma reserva paga é cancelada e reembolsada.
  • Distingue reservas diretas de reservas de revendedores para tratar comissões e clientes de faturação.
  • Envia um resumo diário por email ou para uma folha de cálculo.

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Conta FareHarbor ativa e pedido de acesso à API externa aprovado pelo FareHarbor.
  • Lista de itens com a correspondência a artigos e taxas de IVA no software de faturação.
  • Regras para cancelamentos, reembolsos parciais e reservas de revendedores.
  • Acesso ao software de faturação e às séries a usar.

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • A API externa do FareHarbor só está disponível após aprovação, e o prazo depende do próprio FareHarbor.
  • Nem todas as alterações chegam por notificação (por exemplo, alguns movimentos de pagamento), por isso a ligação também consulta a API periodicamente.
  • Reservas de grupo com vários tipos de cliente (adulto, criança) são faturadas por linha; preços personalizados manuais exigem regras definidas antes.

Perguntas frequentes

Antes de começar

Preciso de pedir acesso à API ao FareHarbor?

Sim. O FareHarbor aprova cada integração. A Tejobit prepara a descrição técnica do pedido e trata da configuração depois da aprovação.

E as reservas vendidas por agências?

Podem ser faturadas ao cliente final ou à agência, conforme o acordo comercial. A ligação identifica a origem da reserva e aplica a regra certa.

Funciona com Sage em vez de Moloni?

Sim. O fluxo é o mesmo; muda apenas o software que recebe os dados e emite o documento.

As reservas antigas também são faturadas?

Só se for pedido. Por norma a ligação começa numa data acordada para não duplicar documentos já emitidos à mão.

Ativar a integração FareHarbor?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.