Utilitários, Filas e Notificações

Endpoints de apoio operacional para sincronização de cadastros de aeroportos, consulta a limites de crédito financeiro de agências, auditoria de filas de reservas e consumo de notificações operacionais da plataforma.

---

1. Listagem de Aeroportos (/GetAeroportos)

Retorna a relação de aeroportos cadastrados na base do Travellink, permitindo auto-completar formulários de pesquisa com códigos IATA, cidades e descrições formatadas.

• Método: POST
• Rota: /api/V2/Voos/GetAeroportos

1.1 Parâmetros da Requisição (GetAeroportosRQ)

Campo	Tipo	Obrigatório	Descrição
Filter	String	Não	Filtro textual por código IATA ou nome da cidade/aeroporto (ex: "SAO" ou "Guarulhos"). Se omitido, retorna a base padrão.

Exemplo de Requisição

{
  "Filter": "SAO"
}

1.2 Estrutura da Resposta (GetAeroportosRS)

{
  "Airports": [
    {
      "Iata": "GRU",
      "Description": "GRU - Guarulhos Intl - São Paulo, Brasil"
    },
    {
      "Iata": "CGH",
      "Description": "CGH - Congonhas - São Paulo, Brasil"
    },
    {
      "Iata": "VCP",
      "Description": "VCP - Viracopos - Campinas/São Paulo, Brasil"
    }
  ],
  "Exception": null
}

---

2. Consultar Limite de Crédito (/ConsultarLimiteDeCredito)

Consulta a situação financeira e os saldos disponíveis da agência autenticada junto à consolidadora ou operadora, tanto para faturamento quanto para cartões corporativos.

• Método: POST
• Rota: /api/V2/Voos/ConsultarLimiteDeCredito

2.1 Parâmetros da Requisição

Não requer parâmetros no corpo além dos headers de autenticação (developer-token / developer-access-code).

Exemplo de Requisição

{}

2.2 Estrutura da Resposta (ConsultarLimiteDeCreditoRS)

Campo	Tipo	Descrição
CreditLimit	Objeto	Detalhamento dos limites de crédito e saldos.
...BilledLimit	Decimal	Limite total de faturamento aprovado para a agência.
...BilledLimitUsed	Decimal	Total de faturamento atualmente comprometido/em aberto.
...SpecialBilledLimit	Decimal	Limite de faturamento emergencial/especial concedido.
...SpecialBilledLimitUsed	Decimal	Limite emergencial utilizado.
...CreditCardLimit	Decimal	Limite de cartão virtual/corporativo concedido.
...CreditCardLimitUsed	Decimal	Limite de cartão utilizado.
...BilledBalance	Decimal	Saldo livre remanescente para emissão faturada imediata.
...CreditCardBalance	Decimal	Saldo livre remanescente para emissão via cartão.
...CanDisplayBilledBalance	Boolean	Sinaliza se a agência tem autorização para visualizar seu saldo faturado.
...InformativeText	String	Avisos financeiros emitidos pelo departamento de crédito.
Exception	Objeto / null	Objeto de erro.

Exemplo de Resposta

{
  "CreditLimit": {
    "BilledLimit": 50000.00,
    "BilledLimitUsed": 12450.80,
    "SpecialBilledLimit": 0.0,
    "SpecialBilledLimitUsed": 0.0,
    "CreditCardLimit": 0.0,
    "CreditCardLimitUsed": 0.0,
    "BilledBalance": 37549.20,
    "CreditCardBalance": 0.0,
    "CanDisplayBilledBalance": true,
    "CanDisplayCreditCardBalance": false,
    "InformativeText": "Crédito regular. Fatura quinzenal vence em 5 dias."
  },
  "Exception": null
}

---

3. Gestão de Filas do Fornecedor (/BuscarFila)

Inspeciona reservas ou bilhetes que foram direcionados para filas operacionais (queues) no GDS ou consolidadora (ex: alterações de horário, cancelamentos de voo ou pendências de bilhetagem).

• Método: POST
• Rota: /api/V2/Voos/BuscarFila

3.1 Parâmetros da Requisição (BuscarFilaRQ)

Campo	Tipo	Obrigatório	Descrição
Id	Integer	Sim	Identificador da fila a ser consultada no motor.

Exemplo de Requisição

{
  "Id": 12
}

3.2 Estrutura da Resposta (BuscarFilaRS)

Campo	Tipo	Descrição
Id	Integer	ID do registro retornado da fila.
QueueName	String	Nome da fila operacional.
Message	String	Mensagem técnica ou aviso registrado pelo fornecedor.
Unit	String	Unidade de atendimento da agência.
Agency	String	Razão social ou nome da agência.
User	String	Usuário responsável pela transação.
Locator	String	Localizador PNR associado ao registro de fila.
Status	String	Status da mensagem na fila.
CreationDate	DateTime	Data/hora de entrada da mensagem na fila.
SupplierName	String	Fornecedor de origem (ex: "GOL GWS", "SABRE").
Exception	Objeto / null	Objeto de erro.

---

4. Inclusão de Fidelidade do Passageiro (/PassageiroIncluirFidelidade)

Permite associar o número do programa de passageiro frequente (Frequent Flyer Number / Milhas) a um passageiro em uma reserva já existente.

• Método: POST
• Rota: /api/V2/Voos/PassageiroIncluirFidelidade

4.1 Parâmetros da Requisição (PassageiroIncluirFidelidadeRQ)

Campo	Tipo	Obrigatório	Descrição
Localizador	String	Sim	Localizador da reserva aérea (ex: "SPRPMK").
PassageiroReferencia	String	Sim	Referência numérica do passageiro na reserva (ex: "1").
Companhia	String	Sim	Código IATA de 2 letras da companhia aérea do programa (ex: "G3" para Smiles, "LA" para Latam Pass).
NumeroFidelidade	String	Sim	Número do cartão de passageiro frequente.

Exemplo de Requisição

{
  "Localizador": "SPRPMK",
  "PassageiroReferencia": "1",
  "Companhia": "G3",
  "NumeroFidelidade": "123456789"
}

4.2 Resposta

{
  "Data": "2026-10-15T16:50:00",
  "Sucesso": true,
  "Exception": null
}

---

5. Notificações Operacionais

A API disponibiliza endpoints para recepção de avisos do sistema sobre mudanças de status em voos e emissões:

Rota	Método	Descrição
/api/V2/Voos/BuscarNotificacao	POST	Obtém o próximo aviso pendente da fila de notificações.
/api/V2/Voos/ListarNotificacoes	POST	Lista em lote as notificações ativas para o usuário/agência.
/api/V2/Voos/ExcluirNotificacao	POST	Confirma a leitura e remove a notificação da lista ativa.

Estrutura de NotificacaoItem

{
  "Id": 984512,
  "Referent": "SISTEMA",
  "Title": "Alteração de Horário de Voo (Schedule Change)",
  "Message": "O voo G3 1500 do localizador SPRPMK teve seu horário de saída alterado das 10:00 para as 10:45.",
  "Date": "2026-10-15T14:10:00"
}