Visão Geral
Este artigo descreve como configurar a ação Criar Reserva do conector Latam NDC no Ligaí. Essa funcionalidade permite que o robô efetue a criação de uma nova reserva de voo (PNR) dentro do ecossistema NDC da LATAM, contemplando os dados da viagem selecionada, as informações dos passageiros e do contato responsável pela reserva.
Quando Utilizar esta Ação
A ação Criar Reserva deve ser integrada ao fluxo quando houver necessidade de:
- Efetivar a reserva de uma oferta de voo previamente consultada/selecionada no ecossistema NDC da LATAM.
- Cadastrar automaticamente os dados dos passageiros (identificação, contato, documento e demais informações pessoais) no momento da criação do pedido.
- Vincular à reserva itens complementares já ofertados, como assento, bagagem ou serviços adicionais.
- Padronizar e agilizar o processo de emissão, reduzindo a necessidade de preenchimento manual pelas agências.
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 Criar Reserva.
2. Autenticação
Para que o robô tenha permissão de criar reserva, é 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 da Viagem
- Lista de ofertas (obrigatório): Conjunto de ofertas retornadas na consulta/shopping realizada previamente no fluxo.
- ID Oferta (obrigatório): Identificador exclusivo da oferta selecionada para a reserva.
- ID Oferta Item (obrigatório): Identificador do item específico dentro da oferta selecionada (trecho/tarifa).
4. Passageiros
- Lista de Passageiros (obrigatório): Conjunto de passageiros que farão parte da reserva.
- Nome do Passageiro (obrigatório): Primeiro nome do passageiro, conforme documento de identificação.
- Sobrenome do Passageiro (obrigatório): Sobrenome do passageiro, conforme documento de identificação.
- Email do Passageiro (obrigatório): Endereço eletrônico de contato do passageiro.
- DDD (Código de Área) do Passageiro (obrigatório): Código de área telefônica do passageiro.
- Telefone do Passageiro (obrigatório): Número de telefone de contato do passageiro.
- Número de Identidade do Passageiro (obrigatório): Número do documento de identificação utilizado na viagem.
- Aniversário do Passageiro (obrigatório): Data de nascimento do passageiro.
- Gênero do Passageiro (obrigatório): Gênero do passageiro conforme documento.
- ID de Seleção de Assento: Identificador do assento previamente escolhido para o passageiro, quando aplicável.
- ID Oferta de Bagagem: Identificador de oferta de bagagem adicional vinculada ao passageiro, quando aplicável.
- ID Serviço: Identificador de serviço complementar vinculado ao passageiro, quando aplicável.
- Nome do Contato: Primeiro nome da pessoa de contato responsável pela reserva.
- Sobrenome do Contato: Sobrenome da pessoa de contato responsável pela reserva.
- Telefone do Contato: Número de telefone da pessoa de contato.
- Email do Contato: Endereço eletrônico da pessoa de contato.
- ID do Programa Fidelidade: Identificador do programa de fidelidade do passageiro, quando houver.
- Número do Programa de Fidelidade: Número de cadastro do passageiro no programa de fidelidade informado.
5. Dados Gerais
- Resposta Simplificada: Ative esta opção para que o retorno da API seja consolidado em um formato reduzido, contendo apenas as informações essenciais da reserva criada.
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
- Oferta Expirada ou Inválida: Caso o ID Oferta ou ID Oferta Item não correspondam mais a uma oferta ativa (por exemplo, tempo de expiração da tarifa excedido), a API retornará falha. Trate o fluxo para realizar uma nova consulta de ofertas antes de tentar a criação da reserva novamente.
- Dados de Passageiro Incompletos: A ausência de campos obrigatórios como Nome, Sobrenome ou Número de Identidade do Passageiro impedirá a criação da reserva. Certifique-se de mapear corretamente todos os campos obrigatórios da lista de passageiros.
- Incompatibilidade entre Passageiro e Oferta: Se a quantidade ou o tipo de passageiro informado não corresponder ao que foi solicitado na oferta original, a API retornará erro de inconsistência. Revise se os dados enviados na etapa de consulta são os mesmos utilizados na criação da reserva.
- Falha de Autenticação: Verifique se as credenciais informadas no bloco Autenticação estão corretas e ativas, especialmente Chave de Api, Senha de API e ID do agente.
Para entender erros de acesso, consulte: Erro Not Authorized ou PNR Restricted