Visão Geral
Este artigo descreve como configurar a ação Emitir Reserva do conector Amadeus no Ligaí. Essa funcionalidade permite que o robô envie os dados de uma reserva ativa para efetuar a criação, preenchimento das formas de pagamento contratadas e a consolidação final do PNR diretamente no sistema de distribuição global (GDS) Amadeus.
Quando Utilizar esta Ação
A ação Emitir Reserva deve ser integrada ao fluxo quando houver necessidade de:
Concluir e bilhetar de forma automatizada uma reserva de voo que já possui itinerários e passageiros definidos.
Processar pagamentos via cartão de crédito, faturamento governamental ou remissão por bilhetes de forma síncrona.
Automatizar a emissão imediata de passagens aéreas reduzindo erros manuais de digitação de dados de cobrança.
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 Emitir Reserva.
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
PNR (obrigatório): Código alfanumérico do localizador da reserva que será emitida (ex:
ABC123).ID da Oferta (obrigatório): Identificador exclusivo gerado no momento da busca/cotação de tarifas daquele voo.
4. Pagamento com Cartão
Número do Cartão (obrigatório): Digite o número completo do cartão sem espaços ou hifens.
Validade (obrigatório): Mês e ano de expiração do cartão de crédito (ex:
1230).Parcelas: Quantidade de parcelas selecionadas para o financiamento da passagem.
Bandeira do Cartão (obrigatório): Código identificador da bandeira do emissor (ex: Visa, Mastercard, Elo).
CVV (obrigatório): Código de Valor de Verificação de segurança (geralmente de 3 ou 4 dígitos).
5. Pagamento por Bilhete
- Números do e-tickets: Campo em formato de lista (array) para mapear os números dos bilhetes eletrônicos originais que financiarão esta transação. Informe um ou mais e-tickets separados por vírgula, espaço ou quebra de linha.
6. Pagamento Governamental
- Pagamento por GR: Marque SIM para indicar que o pagamento é governamental (GR). Obrigatório: deixar cartão vazio e informar o número do warrant.
Numero Warrant GWTD: Código ou identificador numérico da ordem/garantia governamental de pagamento.
7. 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
Formatos de Cartão Inválidos: Certifique-se de que os campos de validade ou número do cartão não carreguem máscaras textuais (como barras ou hifens), pois a API da Amadeus rejeitará caracteres que não estejam estritamente padronizados no protocolo financeiro.
PNR ou ID da Oferta Expirados: Caso o tempo decorrido entre a geração do PNR/ID da Oferta e a chamada de emissão ultrapasse o Time Limit imposto pela companhia aérea ou o tempo de vida do cache da tarifa, a API retornará um erro informando que os registros já não estão disponíveis.
Falta de Associação de Forma de Pagamento: Tentar enviar dados incompletos ou ignorar campos obrigatórios dentro do bloco de pagamento selecionado fará com que o GDS retorne uma falha de validação impedindo a bilhetagem.