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
| Campo | Obrigatório | Descrição |
|---|
TransactionUniqueId | Sim | UniqueId retornado pelo List (prefixo CAR). |
AccessCredentials | Sim | Credenciais de autenticação da empresa. |
OffSet | Não | Fuso horário desejado. |
{
"TransactionUniqueId": "CAR-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AccessCredentials": {
"Company": { "Identifier": "{{identifier}}", "Password": "{{password}}" }
}
}
Objeto Transaction
| Campo | Descrição |
|---|
TransactionTypeDescription | Tipo da transação (Car). |
UniqueId | Identificador único da locação. |
Locator | Localizador da locação. |
TransactionStateDescription | Status atual (ex.: Issued). |
LastUpdate | Data / 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
| 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 pago. |
PaymentStateDescription | Status do pagamento (ex.: Confirmed). |
Os Payment Links referenciam a própria transação CAR, para conciliação.
CommercialDetail
| Campo | Descrição |
|---|
Tourcode | Tour code (quando houver). |
MonetaryDetail | Detalhes monetários comerciais. |
ProductDetail: CarReservationDetail
Período da locação
| Campo | Descrição |
|---|
PickupDate / PickupTime | Data e hora da retirada. |
ReturnDate / ReturnTime | Data e hora da devolução. |
Deadline | Prazo para cancelamento. |
Locais de retirada e devolução
| Campo | Descrição |
|---|
Code | Código do local. |
Name | Nome do local. |
City | Cidade. |
Address | Endereço completo. |
Airport | Indica se o local fica em aeroporto. |
Driver
| Campo | Descrição |
|---|
FirstName / Surname | Nome do condutor. |
Document.TypeDescription | Tipo de documento (DriverLicense). |
Document.Number | Número da CNH. |
Vehicle
| Campo | Descrição |
|---|
Name | Modelo do veículo. |
Code | Categoria do veículo. |
Vendor.Name | Locadora. |
TransmissionTypeDescription | Câmbio (ex.: Manual). |
DoorCount | Número de portas. |
AirConditioning | Possui ar-condicionado. |
VehicleRate e coberturas
| Campo | Descrição |
|---|
RateQualifier | Identificador da tarifa. |
Coverages | Coberturas incluídas (ex.: taxa aeroportuária). |
Terms | Condiçõ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
| 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 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.