Visão Geral
Este artigo descreve como configurar a ação Emitir Reserva do conector LATAM NDC no Ligaí. Essa funcionalidade permite consolidar a emissão de uma reserva existente e realizar o respectivo pagamento dos bilhetes diretamente na API da companhia aérea.
Quando Utilizar esta Ação
A ação Emitir Reserva deve ser utilizada quando houver necessidade de:
Finalizar o processo de compra de um voo previamente reservado ou cotado.
Efetivar o pagamento de bilhetes utilizando cartão de crédito ou faturamento direto (GR).
Gerar os números finais dos e-tickets para os passageiros do fluxo automatizado.
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 Emitir 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 do Pagador
Nome do Pagador: Nome do titular responsável pelo pagamento.
Sobrenome do Pagador: Sobrenome do responsável.
Aniversário Pagador (obrigatório): Data de nascimento do pagador.
CPF do Titular do Cartão (obrigatório): Documento de identificação fiscal do titular.
4. Dados da Reserva
orderID (obrigatório): Código identificador técnico da reserva gerado previamente que será emitido.
5. Formas de Pagamento e Tickets
Configure a modalidade financeira pretendida e os dados de conciliação:
Forma de Pagamento: Cartão de Crédito:
Bandeira do Cartão (obrigatório): Emissora do cartão (ex: Visa, Mastercard).
Nome Impresso no Cartão (obrigatório): Nome do titular exatamente como consta no plástico.
Número do Cartão (obrigatório): Numeração completa do cartão de crédito.
Código de Segurança (obrigatório): Código CVV/CVC.
Data de Validade do Cartão (obrigatório): Preencha estritamente no formato MMYY contendo apenas números.
Número de Parcelas: Quantidade de parcelas.
Forma de Pagamento: GR:
Pagamento GR: Informe SIM caso a emissão utilize faturamento direto por Garantia de Recebíveis. Qualquer outro valor digitado será interpretado como NAO.
Tickets:
Pedido Pago (orderID): ID do pedido correspondente à liquidação.
IDs dos Documentos (orderItemRefIDs): Códigos de referência dos itens do pedido. Caso possua mais de um, separe os valores por vírgula.
6. 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
Formato Inválido na Data do Cartão: O uso de barras ou hifens no campo de validade (como 05/29 ou 05-29) fará a API recusar a requisição instantaneamente. Insira estritamente quatro dígitos numéricos: 0529.
Time-out ou Expiração de Tarifa: Se a reserva demorar muito tempo para ser emitida após sua criação, a LATAM poderá cancelar o bloqueio do inventário de assentos por decurso de prazo. Garanta que a criação e a emissão estejam próximas no fluxo.
Falhas de Processamento de Cartão: Erros de saldo, cartões bloqueados ou dados incorretos de segurança retornarão diretamente como falha de transação da adquirente na API.
Para entender erros de acesso, consulte: Erro Not Authorized ou PNR Restricted