Visão Geral
Este artigo detalha como configurar a ação Buscar Voos no conector Latam NDC dentro da plataforma Ligaí. Esta funcionalidade permite realizar consultas de voos e tarifas disponíveis diretamente no inventário da companhia aérea, utilizando como base os aeroportos selecionados, datas de viagem e o perfil dos passageiros.
Quando Utilizar esta Ação
Utilize a ação Buscar Voos quando houver a necessidade de:
Iniciar um fluxo de cotação, reserva ou venda de passagens aéreas com a LATAM.
Consultar horários, conexões e valores de tarifas vigentes em tempo real para trechos de ida ou ida e volta.
Capturar o ID da Oferta, dado essencial para alimentar as etapas seguintes do fluxo do robô, como a consulta de mapas de assentos ou a criação de reservas.
Pré-requisitos
Antes de configurar esta ação, é obrigatório que a agência possua credenciais válidas do LATAM NDC e que elas estejam corretamente cadastradas no Ligaí.
Para saber como solicitar e configurar as credenciais, consulte:
Passo a Passo de Configuração
1. Adicionar a etapa Latam NDC no robô
- Acesse o menu Meus Robôs.
- Abra o robô desejado.
- Selecione o conector Latam NDC.
- Escolha a ação Buscar Voos.
2. Autenticação
Para que o robô tenha permissão de buscar voos, é necessário preencher as credenciais de API da Latam NDC:
Ambiente (obrigatório): Defina o ecossistema de processamento entre Desenvolvimento (homologação) ou Produção.
Chave de Api (ApiKey): Token chave de identificação do integrador.
Senha de API (ApiSecret): Código secreto associado à chave de API.
Nome da Agência: Razão social ou nome de identificação da agência de viagens.
ID da Agência: Identificador exclusivo da sua agência no ecossistema Latam NDC.
ID de Contato Agência (obrigatório): Identificador do contato responsável registrado.
Código IATA: Código de credenciamento IATA oficial da agência.
ID do agente (obrigatório): Identificador do agente de viagens emissor da transação.
Email da Agência (obrigatório): Endereço eletrônico oficial de comunicação corporativa.
DDD (Código de Área) da Agência (obrigatório): Código de área telefônica da sede comercial.
Telefone da Agência (obrigatório): Número de telefone comercial ativo da agência.
Endereço da Agência (obrigatório): Logradouro completo com número e bairro.
CEP da Agência (obrigatório): Código de Endereçamento Postal do endereço indicado.
3. Dados Gerais
Configure os parâmetros específicos da pesquisa de malha aérea e passageiros:
Origem (obrigatório): Código IATA de 3 letras maiúsculas do aeroporto de origem (Ex: GRU, SDU).
Data Ida (obrigatório): Data de partida programada do voo no formato
DD/MM/YYYY.Destino (obrigatório): Código IATA de 3 letras maiúsculas do aeroporto de chegada (Ex: MIA, Santiago - SCL).
Data Volta: Data de retorno do voo no formato
DD/MM/YYYY.Numero de conexões: Preencha para filtrar a quantidade máxima permitida de escalas ou conexões.
Quantidade de Passageiros Adultos (ADT) (obrigatório): Insira o volume de adultos (valores permitidos entre 1 e 9).
Quantidade de Passageiros Bebês de 0 a 2 anos (INF): Insira a quantidade de bebês de colo (valores permitidos entre 1 e 9).
Quantidade de Passageiros Crianças de 2 a 10 anos (CHD): Insira a quantidade de crianças (valores permitidos entre 1 e 9).
Cabine: Defina a classe do voo desejada. Digite EXEC para Classe Executiva ou PRIM para Primeira Classe. Se o campo for deixado em branco, o robô trará por padrão as tarifas de Classe Econômica.
Código Promocional: Insira cupons de desconto ou chaves de campanhas vigentes na LATAM, se aplicável.
Código da Conta: Insira o código da conta corporativa (Corporate Account Code) para acessar tarifas negociadas ou privadas exclusivas da empresa.
4. Remarcação
Este bloco opcional permite focar a busca no contexto de alterações de bilhetes:
ID da Ordem (Ex: LA1234567789): Insira o número identificador do pedido/ordem original da LATAM caso a busca de voos tenha como finalidade uma reacomodação ou remarcação de passagem existente.
5. Salvar a Configuração
- Após o preenchimento, clique no botão azul Confirmar na parte inferior da tarefa.
- Lembre-se de clicar em Salvar na barra superior do robô para registrar as alterações no fluxo de automação.
Erros Comuns e Como Proceder
Erros de Autenticação (401/403): Valide se as chaves (ApiKey e ApiSecret) ou o ID da Agência correspondem exatamente ao ambiente selecionado (Produção ou Desenvolvimento). Dados de produção inseridos em ambiente de desenvolvimento travarão o fluxo.
Códigos IATA de Aeroportos em Letras Minúsculas: A API Latam NDC exige que códigos de aeroporto (Origem/Destino) sejam passados estritamente em strings de 3 letras maiúsculas. O uso de termos em minúsculo gerará falhas de busca.
Exceder o Limite de Passageiros: Tentar pesquisar mais de 9 passageiros em uma das categorias em uma única chamada quebrará as regras de negócio da API. Se precisar processar grupos maiores, fracione a requisição em execuções paralelas no robô.