Demo ao vivo

API de acomodações

Uma API de hospedagens para hotéis, apartamentos e casas de temporada

Uma API de hospedagens leva todo tipo de acomodação ao seu site de reservas: quartos de hotel, apart-hotéis, casas de temporada, hostels e pousadas. Esta página explica os dados por trás de uma hospedagem, as regras que diferenciam aluguéis de hotéis e como a PHPTRAVELS vende seus imóveis próprios e o estoque de fornecedores em uma única busca.

  • Imóvel, unidade, tarifa, calendário
  • Estadia mínima e taxas
  • Janelas de cancelamento
  • Estoque próprio e oferta via API

O modelo de dados

Quatro camadas em cada hospedagem

Seja um hotel de 300 quartos ou uma única casa de praia, uma API de acomodações o descreve nas mesmas quatro camadas aninhadas. Cada camada responde a uma pergunta que o hóspede faz antes de reservar.

01Imóvel

O lugar em si: nome, tipo, endereço e posição no mapa, fotos, comodidades, classificação por estrelas ou qualidade, regras da casa e horários de check-in.

property_id · type · address · geo · photos · amenities · check_in_from

02Quarto ou unidade

O que de fato é reservado: um tipo de quarto, um apartamento inteiro ou uma cama em dormitório, com tamanho, camas e ocupação máxima.

unit_id · beds · size_m2 · max_adults · max_children

03Plano tarifário

Como essa unidade é vendida: o regime de alimentação, a política de cancelamento, as condições de pagamento e quem pode reservar, como público geral ou só agentes.

rate_plan_id · board · cancel_policy · payment · channel

04Disponibilidade

Uma linha por noite: o preço, as unidades restantes, a estadia mínima e se chegada ou saída são permitidas naquele dia.

date · price · units_left · min_stay · closed_to_arrival

Um prédio, um quarto, uma etiqueta de tarifa e um calendário desenhados como camadas empilhadas de uma mesma acomodação

A PHPTRAVELS chama seu módulo de acomodações de Stays porque o mesmo modelo cobre muito mais do que hotéis. Um imóvel contém unidades, uma unidade é vendida por um ou mais planos tarifários, e cada plano tem um calendário noite a noite com preço e disponibilidade. Com essas quatro camadas bem resolvidas, uma cama de hostel, uma suíte de hotel e uma villa de três quartos cabem na mesma busca e no mesmo checkout.

Os fornecedores dão nomes diferentes às camadas, e alguns fundem duas delas, mas a estrutura está sempre lá. O Hospedagens mapeia cada fonte para ela, e o hóspede vê uma página consistente.

Noite a noite

É no calendário de disponibilidade que as vendas de hospedagem são ganhas ou perdidas

Toda API de hospedagens termina em um calendário. A busca só retorna um imóvel quando todas as noites da estadia solicitada estão livres, com preço e permitidas pelas regras de estadia.

Apartamento de dois quartos · Tarifa padrãoNovembro 2026 · Preço por noite
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Livre, com preço por noite
  • Já reservado
  • Fechado pelo proprietário
  • Estadia mínima a partir desta chegada
  • Fechado para chegada

Dados ilustrativos, simplificados

  • Os preços são por noiteO total da estadia é a soma de cada noite, então uma sexta e um sábado com tarifa de fim de semana custam mais que dois dias úteis. Os preços por dia e por temporada ficam no calendário, não no imóvel.
  • Regras de estadia mínimaUm mínimo de três noites para chegadas na sexta oculta a unidade em buscas de duas noites. Os aluguéis usam essas regras muito mais que os hotéis, e costumam ser mais rígidas nos fins de semana e na alta temporada.
  • Fechado para chegada ou saídaUma noite pode ser reservável dentro de uma estadia mais longa, mas não como primeira ou última noite. Os dias de troca das casas de temporada funcionam assim.
  • Noites fechadas e stop-sellOs proprietários bloqueiam datas para uso próprio ou manutenção, e um stop-sell tira a unidade da venda na hora. Qualquer noite fechada dentro das datas pedidas remove a unidade dos resultados.

Nem toda hospedagem é um hotel

Hotéis, apartamentos e casas de temporada

O modelo de dados é o mesmo, mas cada tipo de hospedagem o preenche de um jeito. Estas são as diferenças que seu fluxo de reservas precisa tratar quando você vende mais do que quartos de hotel.

Hotéis

Incluindo hostels e pousadas

O que é reservado
Um tipo de quarto com vários quartos idênticos, ou uma cama em dormitório compartilhado.
Preço
Uma diária por quarto e regime de alimentação; adultos ou crianças extras podem alterá-la.
Regras de estadia
Estadia mínima só em datas de pico; a maioria das noites pode ser reservada isoladamente.
Taxas e caução
Taxa de turismo ou municipal, às vezes uma taxa de resort paga no local.
Chegada
Recepção 24 horas ou com atendimento; basta o horário de check-in no voucher.
Fonte típica
Bedbanks e atacadistas, contratos diretos, channel managers.

Apartamentos com serviços

Apart-hotéis e apartamentos urbanos

O que é reservado
Um tipo de unidade, geralmente com cozinha e quartos separados.
Preço
Uma diária por unidade, com preços semanais ou mensais para estadias longas.
Regras de estadia
Estadias mínimas são comuns, e as estadias longas são grande parte da demanda.
Taxas e caução
Taxa de limpeza por estadia e caução reembolsável são comuns.
Chegada
O horário da recepção varia; chegadas tardias exigem cofre de chaves ou código.
Fonte típica
Channel managers, contratos diretos e alguns atacadistas.

Casas de temporada

Casas, villas e chalés

O que é reservado
Uma casa específica. Normalmente existe só uma.
Preço
Uma diária pela casa inteira, mais uma cobrança por hóspede extra acima de um número-base.
Regras de estadia
Estadia mínima, dias fixos de troca e datas fechadas para chegada são a regra.
Taxas e caução
Taxa de limpeza, caução reembolsável contra danos e impostos locais, cada um exibido antes do pagamento.
Chegada
Instruções de check-in, endereço e contato são enviados antes da chegada, nunca na página pública.
Fonte típica
Proprietários e administradores de imóveis, diretamente ou por um channel manager.

Vender casas de vários anfitriões, e não de contratos seus? Isso é um marketplace, tratado na página Portal BnB.

Janelas da política de cancelamento

Uma reserva, três janelas de cancelamento

Uma política de cancelamento é uma linha do tempo contada a partir da data de chegada. Cada janela define o que o hóspede recebe de volta se cancelar dentro dela.

ReservaCheck-in
  1. 01 · Até 14 dias antes da chegadaCancelamento gratuitoO hóspede cancela e recebe o reembolso integral. É o prazo que os viajantes procuram primeiro, então mostre-o como uma data, não como uma regra.
  2. 02 · De 14 a 3 dias antesMulta parcialAplica-se uma multa, geralmente a primeira noite ou um percentual da estadia. Os aluguéis podem reter a caução nesta janela.
  3. 03 · Últimos 3 dias e no-showNão reembolsávelO valor total é retido. As tarifas vendidas como não reembolsáveis começam nesta janela desde o momento da reserva.
Janelas de exemplo; cada plano tarifário tem as suas.
  • Por plano tarifário, não por imóvelO mesmo apartamento pode ter uma tarifa flexível e outra não reembolsável mais barata, por isso a política pertence à camada do plano tarifário.
  • Datas no fuso horário do imóvel"14 dias antes" conta a partir da data de chegada no local do imóvel. Converta isso em uma data e hora claras na página e no voucher.
  • Vale a política do fornecedorCom estoque via API, você não pode oferecer condições mais brandas que as do fornecedor. Com contratos próprios, você define as janelas.

Estoque próprio e via API

Seus imóveis contratados e as APIs de fornecedores em uma só busca

A maioria dos vendedores de acomodações faz as duas coisas: cadastra os lugares que contrata diretamente e acrescenta APIs de fornecedores para todo o resto. O viajante nunca deve perceber de onde veio a hospedagem.

Seus próprios imóveis

  • Cadastre imóveis, unidades e planos tarifários você mesmo no admin
  • Dê a proprietários e hotéis um login de extranet para gerenciar o calendário
  • Defina preços, estadias mínimas, datas fechadas e janelas de cancelamento
  • Allotments com dias de liberação e stop-sell
  • Ou receba tarifas e disponibilidade de um channel manager

Estoque de fornecedores via API

  • Grandes catálogos em destinos que você jamais conseguiria contratar
  • Preços e disponibilidade em tempo real no momento da busca
  • Regimes, políticas e taxas do fornecedor em cada tarifa
  • Ativado com seu próprio contrato e suas credenciais de fornecedor
  • Reserva e cancelamento enviados direto ao fornecedor

O que o hóspede recebe

  • Uma lista de resultados com uma página de imóvel por lugar
  • O mesmo quarto de várias fontes exibido uma vez, pelo seu preço
  • Seus markups por fornecedor, destino ou canal, e tarifas para agentes B2B
  • Um único formato de voucher, seja qual for a fonte que confirmou

A conexão de um channel manager está em Integração com channel managers. Para quartos que você tem sob contrato, veja Sistema de inventário de reservas.

Pronto na PHPTRAVELS

Fornecedores de hospedagem já conectados

Estes fornecedores de acomodações já estão conectados ao módulo Stays. Você assina com o fornecedor, insere suas credenciais no admin, testa no sandbox dele e entra no ar. A lista vem ao vivo do nosso diretório de integrações.

Precisa de um fornecedor que não está na lista, como uma rede regional de aluguéis? Qualquer API de acomodações com documentação pode ser adicionada, veja Integração de API personalizada. Para os tipos de fornecedor de hotéis e o mapeamento de conteúdo, leia a página API de hotéis, e os dois maiores guias de bedbank: Integração da API RateHawk e Integração da API Hotelbeds.

Reserve uma hospedagem como seus hóspedes farão

Pesquise, compare tarifas e reserve na demo ao vivo, depois conte quais imóveis e fornecedores você pretende vender.

Testar a demo ao vivoPergunte sobre seus fornecedores

Está criando seu próprio app ou feed para parceiros? A REST API da PHPTRAVELS entrega todas as fontes de hospedagem conectadas em um único formato, com webhooks para eventos de reserva. Ela vem com o plano Enterprise, veja Preços e a documentação para desenvolvedores. O panorama completo está em APIs de viagens.

Perguntas frequentes

API de hospedagens: perguntas de desenvolvedores e agências

Fale com vendas

Uma API de hospedagens é um conjunto de serviços web que permite a um site de reservas pesquisar acomodações, ler preços e disponibilidade para datas e hóspedes determinados, e criar, consultar e cancelar reservas. Ela cobre hotéis e todos os outros tipos de hospedagem: apartamentos, casas de temporada, hostels e pousadas.

As chamadas básicas são as mesmas. Uma API de hospedagens também precisa tratar o que as hospedagens fora do modelo hoteleiro exigem: reservas da unidade inteira, estadias mínimas e dias de troca, cobrança por hóspede extra, taxas de limpeza, cauções reembolsáveis e instruções de check-in enviadas antes da chegada.

Sim. Na PHPTRAVELS, o módulo Stays usa um único modelo de imóvel, unidade, plano tarifário e disponibilidade para todo tipo de acomodação, então hotéis, apartamentos e casas de temporada aparecem na mesma busca, cada um com suas regras.

Cada noite do calendário pode ter uma duração mínima de estadia, geralmente atrelada à data de chegada. Se o hóspede pesquisa menos noites que o mínimo, a unidade não é retornada. Os indicadores de fechado para chegada e fechado para saída funcionam da mesma forma nos dias de troca.

Sim. Você pode adicionar imóveis, unidades, planos tarifários e calendários, dar aos proprietários um login de extranet ou receber tarifas de um channel manager, e vendê-los ao lado do estoque de fornecedores em uma única lista de resultados.

Do plano tarifário. O estoque de fornecedores traz a política do fornecedor, e seus imóveis próprios usam as janelas que você define. O prazo é mostrado ao hóspede antes do pagamento e impresso no voucher.

Não. Você assina com cada fornecedor de acomodações e insere suas próprias credenciais no admin. A PHPTRAVELS fornece a plataforma de reservas, o módulo Stays e os conectores prontos.

Sim. No plano Enterprise, a REST API da PHPTRAVELS expõe busca e reserva de todas as fontes conectadas em um único formato, com webhooks para eventos de reserva e o código-fonte completo para estendê-la.

Uma licença PHPTRAVELS, seu próprio domínio e pelo menos uma fonte de estoque: imóveis que você contrata diretamente, um channel manager ou um contrato de fornecedor com um atacadista de acomodações. A demo ao vivo mostra primeiro o fluxo completo.

Continue a explorar

Mais sobre a plataforma