Details: Hotel (HTL)

Resposta do Details para reservas de hotel, identificadas por um TransactionUniqueId com prefixo HTL (TransactionType = 2, Hotel).

A resposta traz informações da reserva, hóspedes, hotel, estadia, pagamento e valores, além do contexto do fornecedor e da organização.

Requisição

Campo	Obrigatório	Descrição
TransactionUniqueId	Sim	UniqueId retornado pelo List (prefixo HTL).
AccessCredentials	Sim	Credenciais de autenticação da empresa.
OffSet	Não	Fuso horário desejado.

{
  "TransactionUniqueId": "HTL-CE569F58-962A-4B3C-9320-A269AE8AF5B2",
  "AccessCredentials": {
    "Company": { "Identifier": "{{identifier}}", "Password": "{{password}}" }
  }
}

Objeto Transaction

Header

Campo	Descrição
TransactionTypeDescription	Tipo da transação (Hotel).
UniqueId	Identificador único da transação de hotel.
Locator	Localizador da reserva de hotel.
TransactionStateDescription	Status atual (ex.: Issued).
LastUpdate	Data / hora da última atualização.

Context

Contexto comercial e organizacional (Organização, Unidade operacional, Agência, Cliente). Usado para propriedade da venda, relatórios e processamento de backoffice.

User

Campo	Descrição
Id	Identificador do usuário.
Name	Login / nome do usuário.
Email	E-mail do usuário.

Payments

Campo	Descrição
PaymentTypeDescription	Responsável pelo pagamento (ex.: Customer).
PaymentFormDescription	Forma de pagamento (ex.: Invoice).
CurrencyCode	Moeda do pagamento.
Amount	Valor total do pagamento.
PaymentStateDescription	Status do pagamento (ex.: Confirmed).

Os Payment Links referenciam a própria transação HTL, o que permite a conciliação.

CommercialDetail

Campo	Descrição
Tourcode	Tour code (quando houver).
MonetaryDetail	Detalhes monetários comerciais.

ProductDetail: HotelReservationDetail

Principais informações da reserva de hotel.

HotelDetail

Campo	Descrição
Name	Nome do hotel.
Category	Categoria / classificação.
ImageUrl	Imagem do hotel.
Address	Endereço completo (cidade, país, coordenadas).

Estadia

Campo	Descrição
Checkin	Data de check-in.
Checkout	Data de check-out.
Nights	Número de noites.

MonetaryDetail

Composição financeira da reserva. Tipos mais comuns:

• DailyRate: diária
• FarePrice: tarifa
• Total

Pode trazer valores em várias moedas (ex.: USD e BRL) e inclui a taxa de câmbio quando aplicável.

Políticas e prazos

Campo	Descrição
Comments	Observações da reserva.
CancellationPolicies	Regras e multas de cancelamento.
Deadline	Data / hora limite para cancelamento sem custo.

Rooms

Campo	Descrição
RoomName	Descrição do quarto.
Board.Name	Regime de alimentação.
Guests	Hóspedes (nome, documento, tipo).

Cada hóspede traz dados pessoais, documento (CPF / Passaporte) e tipo de passageiro (ex.: ADT).

Provider

Fornecedor que processou a reserva: nome, contexto da entidade, credenciais / PCC e metadados da integração.

Tratamento de erros

Campo	Descrição
Errors	Vazio em caso de sucesso.
Success	true indica resposta válida.

Resumo de boas práticas

• Obtenha sempre o TransactionUniqueId pelo List.
• Faça uma requisição de Details por transação HTL.
• Use o MonetaryDetail para a conciliação financeira.
• Consulte CancellationPolicies e Deadline antes de qualquer alteração.
• Espere dados de conversão de moeda nas reservas de hotel.