Saltar para o conteúdo
Tejobit
Logótipo Guesty

Reservas

Integração Guesty

Gestoras com portefólio grande no Guesty: reservas faturadas no InvoiceXpress e alertas operacionais no Slack.

Pedir esta integração Ver todas as integrações

Visão geral

Guesty

O Guesty é um PMS para arrendamento de curta duração usado por gestoras com portefólios grandes e equipas organizadas por função: reservas, operações, finanças e apoio ao hóspede. Inclui channel manager, motor de reservas diretas, automações de mensagens, gestão de tarefas e contabilidade por proprietário.

A Tejobit liga o Guesty ao software de faturação e aos canais internos da equipa. A Open API do Guesty envia webhooks quando há reservas novas ou alteradas; como o payload não traz tudo, a ligação vai buscar os dados em falta à API (hóspede, valores, taxas, canal) e cria o documento no InvoiceXpress, que o emite e comunica à AT. Em paralelo, publica no Slack o que a operação precisa de saber.

Casos de uso

Para que serve

  • Gestora com mais de 100 unidades em Lisboa e no Porto que precisa de faturar cada reserva sem uma pessoa dedicada a isso.
  • Equipa financeira que concilia o pagamento do canal com a fatura emitida e precisa do ID da reserva nos dois lados.
  • Canal #operacoes no Slack que recebe reservas de última hora e pedidos de check-in antecipado.
  • Gestora que trabalha com proprietários em regimes diferentes e usa séries de documentos por tipo de contrato.
  • Empresa que mede o tempo entre reserva e fatura e quer esse indicador abaixo de um minuto.
IN

O que a ligação escuta

  • Webhooks da Open API do Guesty para reservas novas e reservas atualizadas.
  • Alterações de estado (confirmada, cancelada) e de valores numa reserva.
  • Consultas de reconciliação para apanhar eventos que não tenham sido entregues.
OUT

O que a ligação faz

  • Completa os dados da reserva pela API e cria o documento no InvoiceXpress.
  • Escolhe a série e o tipo de documento com base na propriedade e no canal.
  • Publica alertas no Slack com regras por propriedade, canal ou antecedência da reserva.
  • Grava o número do documento num campo personalizado da reserva no Guesty.

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 Guesty com acesso à Open API e credenciais de cliente OAuth geradas no painel.
  • Mapeamento entre listings do Guesty, proprietários e séries no InvoiceXpress.
  • Canais do Slack definidos para cada tipo de alerta.
  • Regras de faturação para cancelamentos, alterações de datas e reservas de longa duração.

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 Open API do Guesty tem limites partilhados por toda a conta (por segundo, por minuto e por hora); a ligação controla o ritmo dos pedidos.
  • O payload do webhook não inclui todos os campos, por isso cada evento implica pedidos adicionais à API.
  • A entrega de webhooks pode falhar em picos de volume; a reconciliação periódica evita reservas por faturar.

Perguntas frequentes

Antes de começar

A ligação consome a quota da API que outras ferramentas usam?

A quota do Guesty é partilhada pela conta. A ligação limita o seu próprio ritmo e agrupa pedidos para não prejudicar o channel manager nem outras integrações.

Posso continuar a usar a contabilidade de proprietários do Guesty?

Sim. A ligação trata do documento fiscal no InvoiceXpress; os extratos de proprietário continuam no Guesty.

E se uma reserva mudar depois de faturada?

A ligação deteta a alteração e avisa no Slack. A correção é feita com nota de crédito e novo documento, porque um documento emitido não se altera.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Guesty?

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

Fale sobre o projeto geral@tejobit.com