Visão Geral

Este artigo descreve como configurar a ação Reembolso do conector LATAM NDC no Ligaí. Essa funcionalidade permite que o robô envie de forma automatizada uma solicitação de reembolso de um bilhete emitido diretamente para o sistema da companhia aérea.


Quando Utilizar esta Ação

A ação Reembolso deve ser integrada ao fluxo quando houver necessidade de:

  • Processar o cancelamento definitivo e a devolução de valores de uma reserva elegível.

  • Automatizar fluxos de atendimento pós-venda relacionados a desistências de viagens ou pedidos formais de estorno por parte dos clientes.


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 Reembolso.


2. Autenticação 

Para que o robô tenha permissão de reembolso, é 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 

  • ID da Reserva (obrigatório): Insira o identificador exclusivo gerado originalmente na emissão do bilhete (geralmente mapeado dinamicamente a partir do orderID de etapas anteriores do fluxo).




4. 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

  • Bilhete não Elegível ou Tarifa Restrita: Determinadas classes tarifárias promocionais da LATAM não permitem cancelamento com direito a estorno financeiro. Caso o robô execute a ação em um bilhete com essa restrição, a API retornará um erro de negação. Certifique-se de validar a regra da tarifa antes de direcionar a tarefa.

  • ID da Reserva Inválido ou Inexistente: Se o localizador ou o ID da Reserva contiver caracteres incorretos, espaços em branco ou se referir a um ambiente diferente (por exemplo, usar um ID de homologação rodando em produção), a API retornará que a ordem não foi encontrada.

  • Bilhete já Processado (Duplicidade): Tentar submeter um reembolso para uma reserva que já consta com o status CANCELADO, ESTORNADO ou REEMBOLSADO resultará em falha por duplicidade de solicitação no sistema da LATAM NDC.

  • Incompatibilidade de Ambiente: Certifique-se de que as chaves inseridas (ApiKey e ApiSecret) na aba de Autenticação pertencem exatamente ao ecossistema selecionado (Desenvolvimento ou Produção) para evitar erros de credencial inválida (Not Authorized).


Para entender erros de acesso, consulte: Erro Not Authorized ou PNR Restricted


Aqui chegamos ao fim de mais um artigo, caso surja mais dúvidas busque por outros artigos em nosso portal de suporte. Caso haja necessidade, envie um e-mail para suporte@ligai.com.br.