Visão Geral
Este artigo descreve como configurar a ação Consultar Regras de Tarifa do conector LATAM NDC no Ligaí. Essa funcionalidade permite extrair de forma automatizada as condições contratuais, penalidades, regras de reembolso e multas por alteração associadas a uma determinada oferta ou voo selecionado diretamente da API da companhia aérea.
Quando Utilizar esta Ação
A ação Consultar Regras de Tarifa deve ser utilizada quando houver necessidade de:
Validar as restrições financeiras e operacionais de uma tarifa antes de prosseguir com a criação da reserva ou emissão.
Exibir de forma transparente para o cliente final os custos de multa por No-Show, cancelamento ou alteração de voo.
Guardar o histórico das regras tarifárias vigentes no momento da cotação.
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í.
Credenciais Latam NDC
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 Consultar Regras de Tarifa.
2. Autenticação
Para que o robô tenha permissão de consultar as regras de tarifa, é 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 das Ofertas
- ID da Viagem: É o identificador alfanumérico exclusivo e temporário gerado pela API da LATAM no momento em que o robô realizou a busca de voos anterior. Ele é único para cada voo e está localizado diretamente na raiz de cada array de voo retornado na busca. Mapeie este campo dinamicamente utilizando as variáveis de saída da etapa anterior.
- Lista de Ofertas: É um array que pode ser opcionalmente montado na plataforma para iterar e percorrer sobre vários voos em paralelo dentro do robô (substitui a variável $$).
- ID da Tarifa: Identificador específico da precificação selecionada. Ele está presente e deve ser extraído de dentro de um objeto fare, localizado na lista de fares (fares) do retorno da companhia aérea.
4. Dados dos Passageiros
Lista de Passageiros: Array utilizado para iteração ou mapeamento em lote de passageiros (substitui a variável $$).
ID do Passageiro (obrigatório): Identificador único do passageiro associado no fluxo.
Tipo de Passageiro (obrigatório): Defina a classificação (ex: ADT para Adulto, CHD para Criança, INF para Bebê).
5. Salvar a Configuração
Após o preenchimento dos blocos necessários, clique no botão azul Confirmar na parte inferior da tarefa.
Lembre-se de clicar em Salvar na barra superior do robô para gravar as alterações no fluxo de automação.
Erros Comuns e Como Proceder
Oferta Expirada (Offer Expired): As tarifas e disponibilidades do Latam NDC atualizam muito rápido. Se o robô demorar para executar esta ação após a etapa de busca de voos, a API retornará um erro informando que a oferta não é mais válida. Mantenha as duas etapas próximas no fluxo.
Mapeamento Incorreto do Tipo de Passageiro: Certifique-se de enviar códigos compatíveis com o padrão NDC (ex:
ADT). Passar strings customizadas fará com que a API rejeite os parâmetros de entrada.Incompatibilidade de Ambiente: Gerar uma oferta utilizando credenciais de Desenvolvimento e tentar consultar suas regras de tarifa usando parâmetros de Autenticação configurados para Produção gerará erros de processamento.
Para entender erros de acesso, consulte: Erro Not Authorized ou PNR Restricted