Pular para o conteúdo principal

Details: Carro (CAR)

Resposta do Details para locações de carro, identificadas por um TransactionUniqueId com prefixo CAR (TransactionType = 3, Car).

A resposta traz período de locação, locais de retirada e devolução, condutor, veículo, composição de valores, pagamento e fornecedor.

Requisição​

CampoObrigatórioDescrição
TransactionUniqueIdSimUniqueId retornado pelo List (prefixo CAR).
AccessCredentialsSimCredenciais de autenticação da empresa.
OffSetNãoFuso horário desejado.
{
"TransactionUniqueId": "CAR-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AccessCredentials": {
"Company": { "Identifier": "{{identifier}}", "Password": "{{password}}" }
}
}

Objeto Transaction​

CampoDescrição
TransactionTypeDescriptionTipo da transação (Car).
UniqueIdIdentificador único da locação.
LocatorLocalizador da locação.
TransactionStateDescriptionStatus atual (ex.: Issued).
LastUpdateData / hora da última atualização.

Context​

Propriedade organizacional e comercial (Organização, Unidade operacional, Agência, Cliente). Usado para faturamento, relatórios e backoffice.

User​

CampoDescrição
IdIdentificador do usuário.
NameLogin / nome do usuário.
EmailE-mail do usuário.

Payments​

CampoDescrição
PaymentTypeDescriptionResponsável pelo pagamento (ex.: Customer).
PaymentFormDescriptionForma de pagamento (ex.: Invoice).
CurrencyCodeMoeda do pagamento.
AmountValor total pago.
PaymentStateDescriptionStatus do pagamento (ex.: Confirmed).

Os Payment Links referenciam a própria transação CAR, para conciliação.

CommercialDetail​

CampoDescrição
TourcodeTour code (quando houver).
MonetaryDetailDetalhes monetários comerciais.

ProductDetail: CarReservationDetail​

Período da locação​

CampoDescrição
PickupDate / PickupTimeData e hora da retirada.
ReturnDate / ReturnTimeData e hora da devolução.
DeadlinePrazo para cancelamento.

Locais de retirada e devolução​

CampoDescrição
CodeCódigo do local.
NameNome do local.
CityCidade.
AddressEndereço completo.
AirportIndica se o local fica em aeroporto.

Driver​

CampoDescrição
FirstName / SurnameNome do condutor.
Document.TypeDescriptionTipo de documento (DriverLicense).
Document.NumberNúmero da CNH.

Vehicle​

CampoDescrição
NameModelo do veículo.
CodeCategoria do veículo.
Vendor.NameLocadora.
TransmissionTypeDescriptionCâmbio (ex.: Manual).
DoorCountNúmero de portas.
AirConditioningPossui ar-condicionado.

VehicleRate e coberturas​

CampoDescrição
RateQualifierIdentificador da tarifa.
CoveragesCoberturas incluídas (ex.: taxa aeroportuária).
TermsCondições da locação (quando informadas).

MonetaryDetail​

Composição financeira da locação:

  • FarePrice: valor base da locação
  • Coverage: seguros / coberturas
  • Tax: impostos (quando aplicável)
  • Total: valor final

Cada valor traz moeda, valor e indicador de retenção.

Provider​

GDS ou fornecedor responsável pela reserva (ex.: Amadeus), contexto da entidade, PCC e credenciais da integração.

Tratamento de erros​

CampoDescrição
ErrorsVazio em caso de sucesso.
Successtrue 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 CAR.
  • Valide as datas e os locais de retirada / devolução.
  • Use o MonetaryDetail para a conciliação financeira.
  • Consulte o Deadline antes de cancelamentos ou alterações.