Visão Geral

Este artigo explica como configurar a ação Cancelar Reserva no conector Azul Rest dentro da plataforma Ligaí. Essa ação permite cancelar uma reserva da Azul a partir do Código da Reserva.


Quando Utilizar esta Ação

Utilize a ação Cancelar Reserva quando houver a necessidade de:

  • Automatizar o cancelamento de bilhetes ou reservas quando uma viagem é cancelada no sistema de origem.
  • Garantir a agilidade no processamento de cancelamentos, evitando no-show ou multas por demora na execução manual.
  • Sincronizar o status de cancelamento entre plataformas de gestão de viagens e o inventário da Azul.

Pré-requisitos

Antes de configurar a etapa no robô, é necessário que a agência possua credenciais válidas da API Azul REST.

Caso ainda não tenha as credenciais, siga o passo a passo descrito neste artigo:
Como obter as credenciais da nova api azul rest

Após obter as credenciais junto à Azul, elas devem ser cadastradas no Ligaí conforme instruções disponíveis em:
Credenciais de acesso

Sem esse cadastro, a ação não conseguirá autenticar na API da Azul.


Passo a Passo de Configuração

1. Adicionar a etapa Azul Rest no robô

  1. Acesse o menu Meus Robôs
  2. Abra o robô desejado
  3. Selecione o conector Azul Rest
  4. Escolha a ação Cancelar Reserva

2. Autenticação

Para que o robô tenha permissão de cancelar reservas, preencha as credenciais de API da Azul:

  • Organization Code/Escritório (Ponto de Venda): Código identificador da agência ou ponto de venda.
  • Ambiente: Seleção entre ambiente de Homologação (Testes) ou Produção.
  • Usuario e Password: Credenciais específicas para acesso via API.
  • Subscription Key: Chave de subscrição fornecida pela Azul para controle de tráfego.



3. Dados Gerais

Nesta seção, você define qual reserva será impactada pelo cancelamento:

  • Código da Reserva: Insira o código da reserva (PNR) que deseja cancelar.


4. Salvar a Configuração

  • Após o preenchimento, clique no botão azul Confirmar na parte inferior da tela.
  • 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

Durante a execução da ação Cancelar Reservas, podem ocorrer erros como:

  • Reserva não encontrada: Verifique se o "Código da Reserva" informado está correto e se pertence ao mesmo "Organization Code" configurado na autenticação.
  • Status Inválido para Cancelamento: A reserva pode já estar cancelada ou em um status que não permite cancelamento via API (ex: check-in já realizado).
  • Not Authorized / PNR Restricted: A credencial não tem acesso a este localizador específico.

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.