API e webhooks para software de gestão hoteleira

Ligue o QuartoVerde à sua contabilidade, dashboards, automatizações e ferramentas de IA. Consulte reservas, hóspedes e pagamentos através de uma API REST e receba um webhook assim que algo mudar.

POST https://your-app.com/webhooks/lodgehog
X-Lodgehog-Event: reservation.created
X-Lodgehog-Signature: t=1790000000,v1=5f2c9a…

{
  "event": "reservation.created",
  "data": {
    "reservation": {
      "booking_code": "845D400246",
      "status": "confirmed",
      "source": { "channel_name": "Booking.com" },
      "checkin_date": "2026-10-10",
      "checkout_date": "2026-10-12",
      "guest": { "name": "Ana Souza" },
      "totals": { "total_price": "340.00", "payment_status": "unpaid" }
    }
  }
}

Os seus dados, nas suas ferramentas

Deixe de copiar reservas para folhas de cálculo. Envie-as diretamente para a contabilidade, relatórios ou CRM, sem exportações manuais.

Em tempo real, não no dia seguinte

Os webhooks avisam os seus sistemas de uma nova reserva, alteração ou cancelamento em segundos, seja qual for o canal de origem.

Preparada para IA

Documentação escrita para modelos de IA, para que o ChatGPT, o Claude ou o Cursor criem uma integração por si a partir de uma única ligação.

O que pode criar com ela

Algumas formas de pôr os dados do QuartoVerde a trabalhar.

Contabilidade

Envie cada pagamento e extra para o seu software de contabilidade ou para a folha de cálculo do seu contabilista, com os totais já calculados.

Dashboards

Crie os seus próprios relatórios de ocupação e receita no Looker Studio, Power BI ou Metabase, de uma ou várias propriedades.

Automatizações

Acione fluxos no Zapier, Make ou n8n a cada reserva: avise a equipa de limpeza, adicione o hóspede à sua newsletter, publique no Slack.

Aplicações próprias

Ligue fechaduras, aplicações para hóspedes ou o seu próprio site aos dados de reservas em tempo real, desenvolvidos pela sua equipa ou por uma agência.

Terminal
curl https://api.lodgehog.com/v1/reservations/ -G \
  -d modified_since=2026-10-01T00:00:00Z \
  -H "Authorization: Bearer lh_live_…"

{
  "next": "https://api.lodgehog.com/v1/reservations/?cursor=…",
  "results": [
    {
      "booking_code": "845D400246",
      "status": "checked_in",
      "rooms": [ { "room": { "name": "302" }, "price": "170.00" } ],
      "charges": [ { "name": "Minibar", "total": "50.00" } ],
      "payments": [ { "method": "credit_card", "value": "340.00" } ],
      "totals": { "total_due": "50.00", "payment_status": "partial" }
    }
  ]
}

Uma API REST que lhe dá a estadia completa

Cada reserva vem completa, com quartos, hóspedes, extras, pagamentos e totais, pelo que um único pedido diz-lhe tudo sobre a estadia.

Reservas, hóspedes, quartos e tipologias de quarto.
Filtre por estado, datas de check-in ou check-out, hóspede ou quarto.
Peça apenas o que mudou desde a última sincronização, incluindo pagamentos e extras.
Esquema OpenAPI, para que os programadores gerem um cliente em qualquer linguagem.
Eventos de webhook
reservation.created
Uma nova reserva, vinda do sistema, do seu motor de reservas, do chatbot ou de qualquer OTA.
reservation.updated
Datas, quartos, hóspedes, extras ou pagamentos foram alterados.
reservation.deleted
A reserva foi cancelada.

Webhooks assim que algo muda

Sem ter de consultar a API constantemente. Registe um URL e o QuartoVerde envia-lhe a reserva completa e atualizada sempre que uma for criada, alterada ou cancelada.

Um webhook por edição, e não um por cada campo alterado.
Assinados com HMAC-SHA256, para ter a certeza de que vieram de nós.
As entregas falhadas são repetidas automaticamente durante cerca de uma hora.
Envie um evento de teste e acompanhe cada entrega nas definições.
Lê https://api.lodgehog.com/llms.txt e escreve um script que exporte as reservas e os pagamentos do mês passado para uma folha de cálculo.
A ler a referência da API…

Documentação que o seu assistente de IA entende

Além da documentação para pessoas, a API publica o llms.txt: uma referência escrita para modelos de IA. Cole uma ligação no ChatGPT, Claude ou Cursor e ele passa a conhecer cada endpoint, campo e webhook.

Deixe um assistente de IA escrever a sua integração, mesmo que não saiba programar.
Dê a agentes de IA acesso seguro e só de leitura às suas reservas.
Só leitura

Nada pode ser alterado através da API

1:1

Cada chave acede a uma única propriedade

120/min

Pedidos por chave, por omissão

HMAC

Webhooks assinados

Documentação

Tudo é público: leia a documentação antes de se registar.

Ponha os dados do seu alojamento a trabalhar.

Registe-se, crie uma chave de API e faça o seu primeiro pedido em minutos.

Perguntas Frequentes

A API permite que outros programas leiam os seus dados do QuartoVerde: enviar reservas e pagamentos para a contabilidade, criar dashboards em ferramentas como Looker Studio ou Power BI, sincronizar hóspedes com o seu e-mail marketing ou acionar automatizações no Zapier, Make ou n8n sempre que entra uma reserva.

Reservas, hóspedes, quartos e tipologias de quarto. Cada reserva vem completa, com quartos, hóspedes, extras, pagamentos e totais calculados, pelo que um único pedido lhe dá tudo sobre a estadia.

Não. A API é só de leitura: lê os seus dados, mas nunca os altera. Por isso é seguro entregar uma chave a um contabilista, a uma agência ou a uma ferramenta de IA.

Regista um URL no QuartoVerde e nós enviamos-lhe a reserva completa sempre que uma for criada, alterada ou cancelada. Um novo pagamento ou extra conta como alteração. Várias edições feitas em conjunto chegam como um único webhook, e as entregas falhadas são repetidas durante cerca de uma hora.

Um administrador da propriedade cria as chaves em Sua propriedade > API e Webhooks. A chave é mostrada uma única vez, apenas um hash dela é guardado, e pode revogá-la a qualquer momento, com efeito imediato.

Sim. Além da referência interativa, a API publica o llms.txt e uma referência completa escrita para modelos de IA. Dê essa ligação ao ChatGPT, Claude ou Cursor e eles podem escrever uma integração por si ou ligar-se diretamente aos seus dados.

Cada chave pertence a uma única propriedade e só lê os dados dessa propriedade. As chaves podem ser revogadas de imediato, os pedidos têm limite de taxa e cada webhook é assinado com HMAC-SHA256, para que o seu servidor confirme que veio mesmo de nós.

Nem sempre. Ferramentas de automatização como Zapier, Make e n8n recebem webhooks e chamam APIs REST sem código, e os assistentes de IA conseguem escrever uma pequena integração a partir da nossa documentação. Para uma integração à medida, qualquer programador que conheça APIs REST vai sentir-se em casa.

O acesso à API e os webhooks estão incluídos em todos os planos pagos do QuartoVerde. Pode experimentá-los grátis durante 14 dias, sem cartão de crédito.

Parte de uma plataforma completa para hotelaria

Cada reserva de todos os canais chega ao QuartoVerde e, daí, à sua API.

Os nossos planos

Básico, sem custo
Gestão de Propriedade

Software gratuito com todas as funcionalidades essenciais:

  • Calendário de reservas
  • Reservas e hóspedes ilimitados
  • Planos de tarifas: automatize os preços dos quartos
€0/mês para sempre
Registe-se sem custos
MELHOR OFERTA
Alcance Total
+ Gestor de Canais & Motor de Reservas

Venda em todos os canais e no seu próprio site

  • Venda no Booking.com, Airbnb e mais de 50 sites
  • Nunca mais tenha overbooking
  • Reservas sem comissão pelo site
A partir de €34,90 /mês
Experimente sem custo por 14 dias

Acreditamos na transparência de preços. Utilize a nossa calculadora de preços para estimar o custo da sua subscrição.