Visão Geral
Este artigo descreve como configurar a ação Buscar Voos do conector Amadeus no Ligaí. Essa funcionalidade permite realizar consultas de voos e tarifas disponíveis diretamente no sistema do Amadeus, utilizando como base os aeroportos selecionados, datas de viagem e a composição de passageiros.
Quando Utilizar esta Ação
A ação Buscar Voos deve ser utilizada quando houver necessidade de:
Iniciar um fluxo de cotação ou reserva de passagens aéreas utilizando o inventário consolidado do Amadeus.
Consultar horários, trechos, disponibilidades e valores de tarifas vigentes em tempo real.
Capturar dados cruciais de precificação e disponibilidade para alimentar as etapas posteriores da automação do robô.
Pré-requisitos
Antes de utilizar este conector, é obrigatório solicitar uma credencial ao Amadeus. Sem esse vínculo prévio configurado junto ao provedor, as chamadas de API não serão processadas com sucesso.
Credenciais de acesso – Como cadastrar no Ligaí
Passo a Passo de Configuração
1. Adicionar a etapa Amadeus no robô
Acesse o menu Meus Robôs.
Abra o robô desejado.
Selecione o conector Amadeus.
Escolha a ação Buscar Voos.
2. Autenticação
Para que o robô consiga conectar ao webservice do GDS, preencha os parâmetros de acesso na aba correspondente:
Ambiente: Defina o ecossistema de processamento entre Desenvolvimento (homologação/sandbox) ou Produção.
WSAP (obrigatório): Informe o código do Web Services Access Point correspondente à sua integração.
Office ID (obrigatório): Código identificador único da agência no Amadeus (ex: SAOBR11AA).
Duty Code (obrigatório): Código de função do agente para permissões internas no sistema.
User ID (Originator) (obrigatório): Identificador do usuário solicitante ou originador da transação.
Senha (obrigatório): Senha associada ao acesso do usuário configurado.
3. Dados Gerais
Nesta seção, defina os critérios específicos de busca de voos e as regras de retorno dos dados:
Quantidade de Passageiros Adultos (ADT) (obrigatório): Insira o volume de adultos para a pesquisa (valores válidos entre 1 e 9).
Quantidade de Passageiros Crianças de 2 a 10 anos (CHD): Insira o volume de crianças (valores válidos entre 1 e 9).
Quantidade de Passageiros Bebês de 0 a 2 anos (INF): Insira o volume de bebês de colo (valores válidos entre 1 e 9).
Origem (obrigatório): Código IATA de 3 letras maiúsculas do aeroporto de partida (Ex: GRU, BSB).
Data Ida (obrigatório): Data de partida do voo programada.
Destino (obrigatório): Código IATA de 3 letras maiúsculas do aeroporto de chegada (Ex: LHR, CDG).
Data Volta: Data de retorno do voo (deixe em branco se a cotação for apenas de ida).
Código Promocional (Promocode): Insira cupons ou códigos promocionais de companhias aéreas específicas, quando aplicável.
Deve buscar voos combinados? (Sim ou Não): Defina se o sistema deve forçar a busca de voos com múltiplas conexões ou combinações complexas de trechos.
- Cabine: Defina a classe de serviço desejada. Digite EXEC para Classe Executiva ou PRIM para Primeira Classe. Caso o campo permaneça vazio, o robô retornará por padrão os voos configurados para a Classe Econômica.
4. Salvar a Configuração
Após preencher os campos necessários, clique no botão azul Confirmar no canto inferior direito da janela.
Clique em Salvar na barra de ferramentas superior do editor de robôs para consolidar e publicar as atualizações do fluxo.
Erros Comuns e Como Proceder
WSAP Incorreto ou Sem Vínculo: Caso retorne um erro indicando falha estrutural logo no início da tarefa, certifique-se de que o valor inserido no campo WSAP confere com o pré-requisito.
Formato de Códigos Aeroportuários: O Amadeus rejeita códigos de cidades ou aeroportos que não estejam no padrão IATA de 3 letras e totalmente em maiúsculas (ex: use CGH e não cgh ou Congonhas).
Incompatibilidade de Ambiente: Certifique-se de que o Office ID e as credenciais inseridas na aba de Autenticação batem com o ambiente selecionado (Produção ou Desenvolvimento).