Pular para o conteúdo principal

WCF Travellink - Serviço Aéreo (Legado)

:::danger ⚠️ ATENÇÃO: SERVIÇO LEGADO E DESCONTINUADO Os serviços WCF AereoNoSession.svc e Aereo.svc são considerados LEGADOS.

  • NOVAS IMPLEMENTAÇÕES NÃO DEVEM SER FEITAS NESTE SERVIÇO.
  • Qualquer nova integração, novo cliente ou novo projeto deve utilizar exclusivamente a Web API Aéreo (V2).
  • Esta documentação é mantida estritamente para fins de suporte e manutenção de sistemas já existentes que ainda não concluíram o processo de migração.
  • Consulte o Guia de Migração WCF ➔ Web API para o plano de transição. :::

O WCF Travellink foi a primeira interface de integração externa da Wooba para conteúdo aéreo, construída sobre o Windows Communication Foundation (WCF). Ele é publicado em três serviços:

ServiçoFinalidadeSessão
AereoNoSession.svcOperações aéreas (pesquisa, tarifação, reserva, emissão, pós-venda). É o serviço utilizado nas integrações de parceiros e nos exemplos desta documentação.Não
Aereo.svcMesmo contrato de 51 operações do AereoNoSession.svc, porém com sessão HTTP mantida entre chamadas. Restrito a credenciais de aplicativos móveis.Sim
Usuario.svcOperações de usuário (autenticação com usuário da agência, token de segurança, recuperação de senha, atendimento 24h).Sim

Cada serviço expõe duas interfaces de comunicação:

  1. REST/JSON: no endereço raiz do serviço, com o comportamento webHttp (corpo sem envelope, defaultBodyStyle="Bare"). Todas as operações são chamadas com POST /{NomeDaOperacao}.
  2. SOAP/XML: no endereço /soap do serviço.

Consulte a Relação das 51 Operações para a lista completa.

2. Por que o WCF está sendo descontinuado?​

  1. Padrão de Data Obsoleto: Utiliza o formato proprietário Microsoft JSON /Date(ticks-offset)/, que não é nativo em linguagens modernas (Python, Node, Go, Rust, Java). Veja Formato de Datas.
  2. Sem Recursos Recentes: Operações como divisão de reserva (DividirReserva), inclusão de fidelidade do passageiro, consulta de famílias de tarifa, a disponibilidade V3 e a API em inglês existem apenas na Web API.

3. Endereços de Referência​

AmbienteEndereço
Sandbox (REST/JSON)https://wooba-sandbox.travellink.com.br/wcfTravellink/AereoNoSession.svc
Sandbox (SOAP)https://wooba-sandbox.travellink.com.br/wcfTravellink/AereoNoSession.svc/soap
Página de ajuda do serviço RESThttps://wooba-sandbox.travellink.com.br/wcfTravellink/AereoNoSession.svc/help
ProduçãoInformado pela Wooba junto com as credenciais da integração.
observação

Os endereços do ambiente de produção e de homologação dependem da credencial concedida a cada parceiro e são informados pela Wooba.

4. Como Chamar uma Operação (REST/JSON)​

curl --location 'https://wooba-sandbox.travellink.com.br/wcfTravellink/AereoNoSession.svc/Consultar' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'developer-token: SEU_DEVELOPER_TOKEN' \
--header 'developer-access-code: SEU_DEVELOPER_ACCESS_CODE' \
--data '{
    "Login": "SEU_LOGIN",
    "Senha": "SUA_SENHA",
    "Localizador": "ABC123"
}'

Pontos de atenção:

  • Envie Content-Type: application/json e Accept: application/json.
  • Os headers developer-token e developer-access-code são obrigatórios. Veja Autenticação no WCF.
  • No AereoNoSession.svc, Login e Senha da credencial seguem no corpo de cada requisição.
  • Datas trafegam no formato /Date(...)/.
  • Erros de negócio retornam no objeto Exception da resposta (veja Arquitetura).