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ô
- Acesse o menu Meus Robôs
- Abra o robô desejado
- Selecione o conector Azul Rest
- 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