API DOCS

Innprices

Resumo do payload e regras de precificacao.

Endpoint

POST /omnibees/:id

POST /hbook/:id

Base URL: https://prices.innsights.com.br

O service recebe um provider do tipo HotelPriceProvider; por padrao usa Omnibees.

O endpoint /hbook/:id usa o provider Hbook e envia um POST para /Booking/GetAvailability.

O controller do Hbook segue o mesmo fluxo do Omnibees, trocando apenas o provider.

A implementacao do controller do Hbook replica o do Omnibees, mudando somente o provider injetado.

No provider Omnibees, a URL de consulta e o fetch sao executados dentro de getData no crawler.

O helper buildOmnibeesUrl e exportado do crawler e pode ser injetado no response builder para incluir omnibeesUrl na resposta.

O service aceita um buildUrl opcional; quando null, o response builder nao gera a URL. No Hbook, o controller injeta buildHbookUrl e define urlField como url para retornar a URL do motor sem quebrar o campo omnibeesUrl.

Token obrigatorio via query string: ?token={{secreto}}

Token invalido retorna status 401.

Body esperado

{
  "checkin": "2025-12-15T03:15:00.000Z",
  "checkout": "2025-12-18T03:00:00.000Z",
  "adults": 1,
  "childrens": 0,
  "ages": "",
  "code": "",
  "template": [
    "*PARA:* {{adults}} adulto(s)",
    "Periodo: {{checkin|date}} a {{checkout|date}}"
  ],
  "order": {
    "nameList": ["Suite Luxo", "Suite premium"],
    "rateNameList": ["Tarifa VIP", "Tarifa Flex"],
    "ratePrice": "asc"
  },
  "filters": {
    "roomName": "Suite Luxo"
  },
  "rules": {
    "markup": { "value": 10 },
    "discount": { "value": 10, "category": "discount" },
    "bookingWindow": {
      "window": 21,
      "less": { "midweek": 20, "weekend": 25 },
      "more": 25,
      "category": "discount"
    },
    "installment": { "times": 4, "withEntry": true, "entryPercent": 30 }
  }
}

Campos

RoomPriceDTO: estrutura base usada pelo crawler e pelas regras para representar quartos e tarifas.
id (path): valor usado no parametro q da URL Omnibees.
checkin / checkout: datas ISO; sao convertidas para formato ddmmyyyy.
period: calculado pelo dia do checkin (midweek ou weekend).
adults: precisa ser maior ou igual a 1.
childrens: numero de criancas.
ages: string com idades separadas por virgula (ex.: "1,3"); quantidade deve bater com childrens.
code: codigo opcional que vai para o parametro Code da Omnibees; quando informado ignora regras com category igual a discount.
discount: percentual retornado pelas regras ou pelo code (ex.: WEB05 retorna 5). No Hbook, quando a tarifa possui AppliedOffer.OfferName (ex.: 40% OFF), o percentual e convertido para numero e preenchido em discount.
template: string, array de strings ou null com placeholders (retorna message ou message_1, message_2...).
order: objeto opcional ou null que define o criterio de ordenacao dos quartos.
filters: objeto opcional ou null com filtros adicionais sobre os quartos retornados.
rules: objeto opcional ou null com regras de markup, discount, bookingWindow e installment.
price: valor base do crawler; ao ler atributo data-price-before-discount de cada .rate_plan; finalPrice vem do atributo data-original-price-after-tax. O texto dentro de .price-total-bold e ignorado.

Order (Strategy)

O order define como a lista de quartos e ordenada antes de escolher o primeiro item. Ele segue o mesmo padrao Strategy das regras.

A aplicacao de order e filters e feita no service, antes de selecionar o quarto retornado pelo crawler.

nameList

Lista de nomes em ordem de prioridade. O primeiro nome encontrado vira o resultado. Qualquer nome fora da lista fica depois, mantendo a ordem original.

"order": {
  "nameList": ["Suite Luxo", "Suite premium", "Standard"]
}

rateNameList

Lista de nomes de tarifas em ordem de prioridade. Reordena o campo rates dentro de cada quarto e usa a primeira tarifa como base do preco.

"order": {
  "rateNameList": ["Tarifa VIP", "Tarifa Flex", "Tarifa Standard"]
}

ratePrice

Ordena as tarifas por preco dentro de cada quarto e usa a primeira tarifa como base. Valores: "asc" (menor preco) ou "desc" (maior preco).

"order": {
  "ratePrice": "desc"
}

price

Ordena por preco quando nameList nao e informado. Valores: "asc" ou "desc".

A ordenacao por preco usa o valor selecionado das tarifas; se nenhuma regra de tarifa for aplicada, o preco pode ficar nulo e a ordem original e mantida.

"order": {
  "price": "asc"
}

Filters

Os filtros sao aplicados apos o order e antes das regras. Se nenhum quarto atender ao filtro, retorna room_unavailable.

roomName

Filtra pelo nome exato do quarto retornado pela Omnibees.

Se vazio, o filtro nao e aplicado.

"filters": {
  "roomName": "Suite Luxo"
}

Rules (Strategy)

As regras sao aplicadas no retorno do crawler via Strategy. Cada regra transforma o item (nome e preco) e retorna o mesmo item ajustado.

O campo comments e normalizado para um array antes de adicionar novas mensagens de regras.

Regras de desconto nao se somam: cada nova regra sobrescreve o finalPrice gerado pela anterior.

markup

Corrige o preco base usando markup. Formula: preco_corrigido = preco / (1 - percentual/100). Exemplo: 10% => divide por 0.90.

Quando markup e aplicado, o campo discount retorna o mesmo percentual para facilitar templates que exibem desconto.

"rules": {
  "markup": { "value": 10 }
}

discount

rules.discount.value e um percentual (ex.: 10 = 10%). O desconto e aplicado diretamente no finalPrice de cada item.

Categoria: discount. Quando code e informado, regras com essa categoria nao sao aplicadas.

bookingWindow

Aplica desconto com base na antecedencia entre hoje e o check-in. Usa window para decidir entre less e more.

less aplica quando dias_antecedencia <= window. more aplica quando dias_antecedencia > window. Os valores podem ser numero (percentual fixo) ou objeto { midweek, weekend }.

Weekend: qui, sex, sab. Midweek: dom, seg, ter, qua.

Categoria: discount. Quando code e informado, regras com essa categoria nao sao aplicadas.

installment

Divide o valor final em parcelas. Quando withEntry e verdadeiro, calcula entrada com base no percentual e parcela o restante.

"rules": {
  "installment": { "times": 4, "withEntry": true, "entryPercent": 30 }
}

Code

Quando code e informado, regras com category igual a discount nao sao aplicadas.

Codigos no formato WEB## (ex.: WEB05) retornam o percentual no campo discount.

Erros

adults_required: adults precisa ser maior ou igual a 1.
ages_required: ages e obrigatorio quando childrens > 0.
ages_count_mismatch: quantidade de idades nao bate com childrens.
invalid_date: checkin ou checkout invalido.
unavailable: hotel sem disponibilidade.
minimum_nights: reserva exige minimo de noites.
room_unavailable: nenhum quarto atende ao filtro de nome.
too_many_people: ha quartos, mas a ocupacao solicitada e alta.
unknown_error: erro inesperado.
internal_server_error: falha inesperada no controller (retorna status 500 e registra no log.error junto com params e body da requisicao).

Template (Message)

O campo template permite montar um texto usando as variaveis do resultado. Use {{'{{'}}campo{{'}}'}} para interpolar valores.

Aceita string unica ou array de strings. Quando for array, o retorno inclui message_1, message_2 e assim por diante.

*PARA:* {{adults}} adulto(s){{childrens|if: e {{childrens}} crianca(s) com idades {{ages}}:}}
*PERIODO:* {{checkin|date}} a {{checkout|date}}

*Check-in:* A partir das 16h
*Check-out:* Ate as 14h

*Acomodacao:* _{{name}}_ - {{finalPrice|currency}}

*Forma de pagamento:*
Sinal de {{entryValue|currency}} via Pix no ato da reserva;
Saldo restante em ate {{times}}x de {{installment|currency}} sem juros no check-in.

*Tarifa valida somente ate as 23h59 de hoje!*

Filtros disponiveis:

currency: formata numero como moeda BRL.
date: formata data ISO para dd/mm/aaaa.
if:THEN:ELSE: renderiza o texto se o valor for verdadeiro (numero > 0).

Campos disponiveis no template:

Campo	Descricao	Quando aparece
`name`	Nome da acomodacao.	Sempre, quando ha resultado.
`price`	Preco original (sem desconto).	Sempre, quando ha resultado.
`finalPrice`	Preco final apos regras.	Sempre, quando ha resultado.
`discount`	Percentual aplicado (discount/bookingWindow/markup) ou code (ex.: `WEB05`).	Quando alguma regra alterar o preco.
`checkin`	Data de check-in (ISO).	Sempre (input).
`period`	Periodo calculado pelo dia do check-in (`midweek` ou `weekend`).	Sempre (gerado).
`checkout`	Data de check-out (ISO).	Sempre (input).
`adults`	Numero de adultos.	Sempre (input).
`childrens`	Numero de criancas.	Sempre (input).
`ages`	Idades das criancas (texto).	Sempre (input).
`code`	Codigo promocional enviado para a Omnibees.	Somente quando informado.
`rules`	Objeto com regras recebidas.	Sempre (input).
`template`	Texto original do template.	Sempre (input).
`omnibeesUrl`	URL final gerada pelo `buildUrl` injetado (Omnibees por padrao ou Hbook quando o controller injeta `buildHbookUrl` e `urlField` permanece como `omnibeesUrl`); pode ficar vazia quando o builder estiver desativado.	Quando o builder estiver ativo.
`url`	URL final quando o controller define `urlField` como `url` (ex.: Hbook).	Quando o builder estiver ativo.
`comments`	Lista de aplicacoes de regras. Inclui "promotional code is applied" quando `code` e informado no service. Quando uma regra for ignorada, inclui o motivo em texto.	Quando alguma regra rodar ou for ignorada.
`entryValue`	Valor da entrada.	Somente com regra `installment` e `withEntry`.
`entryPercent`	Percentual de entrada.	Somente com regra `installment` e `withEntry`.
`remaining`	Valor restante apos a entrada.	Somente com regra `installment`.
`installment`	Valor de cada parcela.	Somente com regra `installment`.
`times`	Quantidade de parcelas.	Somente com regra `installment`.

Exemplo completo

Request

{
  "checkin": "2026-01-17T03:15:00.000Z",
  "checkout": "2026-01-18T03:00:00.000Z",
  "adults": 2,
  "childrens": 0,
  "ages": "",
  "code": "",
  "rules": {
    "discount": { "value": 50, "category": "discount" },
    "installment": { "times": 4, "withEntry": true, "entryPercent": 30 }
  },
  "template": [
    "*🏨 PARA:* {{adults}} adulto(s){{childrens|if: e {{childrens}} criança(s) com idades {{ages}}:}}\n📅 *PERÍODO:* {{checkin|date}} a {{checkout|date}}\n\n*Check-in:* A partir das 16h\n*Check-out:* Até as 14h\n\n*Acomodação:* _{{name}}_ - {{finalPrice|currency}}\n\n*💳 Forma de pagamento:*\nSinal de {{entryValue|currency}} via Pix no ato da reserva;\nSaldo restante em até {{times}}x de {{installment|currency}} sem juros no check-in.\n\n*⏳ Tarifa válida somente até as 23h59 de hoje!*",
    "Estamos concedendo *{{discount}}% de desconto* e sua reserva sai de {{price|currency}} por apenas *{{finalPrice|currency}}*.\n\nSinal de {{entryPercent}}% no valor de {{entryValue|currency}} e o restante parcelado em {{times}}x de {{installment|currency}} pagos no check-in.\n\n*Oferta exclusiva para fechamento hoje!*"
  ]
}

Response

{
  "status": "available",
  "name": "Superior Casal",
  "price": 687,
  "finalPrice": 343.5,
  "comments": [
    "discount: 50%",
    "installment: entry 30% + 4x 60.11"
  ],
  "entryValue": 103.05,
  "entryPercent": 30,
  "remaining": 240.45,
  "installment": 60.11,
  "times": 4,
  "discount": 50,
  "id": "6605",
  "checkin": "2026-01-17T03:15:00.000Z",
  "period": "weekend",
  "checkout": "2026-01-18T03:00:00.000Z",
  "adults": 2,
  "childrens": 0,
  "ages": "",
  "code": "",
  "omnibeesUrl": "https://book.omnibees.com/hotelresults?q=6605¤cyId=16&lang=pt-BR&hotel_folder=&NRooms=1&version=4&CheckIn=17012026&CheckOut=18012026&ad=2&ch=0&ag=&Code=",
  "rules": {
    "discount": { "value": 50, "category": "discount" },
    "installment": { "times": 4, "withEntry": true, "entryPercent": 30 }
  },
  "template": [
    "*🏨 PARA:* {{adults}} adulto(s){{childrens|if: e {{childrens}} criança(s) com idades {{ages}}:}}\n📅 *PERÍODO:* {{checkin|date}} a {{checkout|date}}\n\n*Check-in:* A partir das 16h\n*Check-out:* Até as 14h\n\n*Acomodação:* _{{name}}_ - {{finalPrice|currency}}\n\n*💳 Forma de pagamento:*\nSinal de {{entryValue|currency}} via Pix no ato da reserva;\nSaldo restante em até {{times}}x de {{installment|currency}} sem juros no check-in.\n\n*⏳ Tarifa válida somente até as 23h59 de hoje!*",
    "Estamos concedendo *{{discount}}% de desconto* e sua reserva sai de {{price|currency}} por apenas *{{finalPrice|currency}}*.\n\nSinal de {{entryPercent}}% no valor de {{entryValue|currency}} e o restante parcelado em {{times}}x de {{installment|currency}} pagos no check-in.\n\n*Oferta exclusiva para fechamento hoje!*"
  ],
  "message_1": "*🏨 PARA:* 2 adulto(s)\n📅 *PERÍODO:* 17/01/2026 a 18/01/2026\n\n*Check-in:* A partir das 16h\n*Check-out:* Até as 14h\n\n*Acomodação:* _Superior Casal_ - R$ 343,50\n\n*💳 Forma de pagamento:*\nSinal de R$ 103,05 via Pix no ato da reserva;\nSaldo restante em até 4x de R$ 60,11 sem juros no check-in.\n\n*⏳ Tarifa válida somente até as 23h59 de hoje!*",
  "message_2": "Estamos concedendo *50% de desconto* e sua reserva sai de R$ 687,00 por apenas *R$ 343,50*.\n\nSinal de 30% no valor de R$ 103,05 e o restante parcelado em 4x de R$ 60,11 pagos no check-in.\n\n*Oferta exclusiva para fechamento hoje!*"
}