Visão Geral
Este artigo descreve como configurar a ação Cancelar Reserva do conector LATAM NDC no Ligaí. Essa funcionalidade permite realizar o cancelamento definitivo de uma reserva de voo diretamente no sistema da companhia aérea.
Quando Utilizar esta Ação
A ação Cancelar Reserva deve ser utilizada quando houver necessidade de:
Desistir de uma reserva ativa ou não combinada dentro do prazo regulamentar.
Automatizar fluxos de reembolso ou desistência solicitados pelo cliente final.
Desfazer bloqueios de assentos e pedidos pendentes para liberar o inventário.
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 Cancelar Reserva.
2. Autenticação
Para que o robô tenha permissão de cancelar reservas, é 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
Nesta seção são informados os dados utilizados para processar o cancelamento do pedido:
Número do Pedido (obrigatório): Insira o identificador técnico e exclusivo do pedido ou reserva gerado originalmente no fluxo da LATAM.
Valor de Reembolso: Informe o valor calculado ou esperado para a restituição/estorno do bilhete, caso a regra tarifária da companhia preveja reembolso.
4. Salvar a Configuração
Após o preenchimento, clique no botão azul Confirmar na parte inferior da tarefa.
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
Pedido Não Encontrado ou Já Cancelado: Se o robô retornar uma falha informando que o ID do pedido é inválido, certifique-se de que a variável mapeada no campo Número do Pedido está extraindo o identificador correto em tempo real. Pedidos cancelados manualmente direto no portal da companhia também gerarão erro de processo duplicado.
Incompatibilidade com Regras Tarifárias da LATAM: Algumas tarifas restritas não permitem cancelamento ou reembolso via API após a emissão do bilhete. Caso a API retorne um erro de negócio da companhia, verifique as regras da classe tarifária associada à reserva.
Incompatibilidade de Ambiente: Tentar cancelar um pedido gerado no ambiente de Produção utilizando chaves de Autenticação configuradas para o ambiente de Desenvolvimento (e vice-versa) fará com que a operação falhe.
Para entender erros de acesso, consulte: Erro Not Authorized ou PNR Restricted