Como configurar a ação Integrar Venda :

Visão Geral

Este artigo explica como configurar o conector Benner, na ação Integrar Vendas, dentro de um robô no LIGAí. Esta ação é utilizada para enviar e registrar os dados de vendas diretamente no ERP Benner. Devido à complexidade e extensão dos campos, este guia focará nas seções de Autenticação, Dados Gerais, Dados Aéreo e Dados do Pagamento.

Quando Utilizar esta Ação

Utilize a ação Integrar Vendas quando houver a necessidade de:

Automatizar o backoffice enviando vendas emitidas para o sistema financeiro Benner.
Registrar bilhetes aéreos e suas respectivas formas de pagamento.
Garantir que os dados de faturamento estejam sincronizados entre a emissão e o ERP.

Pré-requisitos

Antes de configurar a etapa no robô, é necessário possuir as credenciais de acesso ao serviço de integração (Webservice) da Benner. Sem estas informações de endpoint e autenticação, o robô não conseguirá realizar a integração.

Seções Cobertas neste Guia

Autenticação (Conexão com o servidor)
Dados Gerais (Cabeçalho da venda e cliente)
Dados Aéreo (Detalhes do bilhete e voo)
Dados do Pagamento (Valores e formas de liquidação)

Passo a Passo de Configuração

1. Adicionar a etapa no robô

Acesse o menu Meus Robôs.
Abra o robô desejado.
Selecione o conector Benner.
Escolha a ação Integrar Venda.

2. Autenticação

Nesta etapa, devem ser inseridos os dados de acesso ao Web Service do Benner.

Credencial: Selecione a credencial previamente cadastrada na plataforma (se houver).
Usuário: Nome de usuário para autenticação no serviço.
Senha: Senha de acesso do usuário.
URL do Serviço: Endereço completo (endpoint) do Web Service que possui os métodos principais.

3. Dados Gerais

Esta seção engloba as informações macro da venda, identificação da empresa e do cliente.

Localizadora: Código localizador da reserva (Id do pedido)
Data de Criação: Data em que o pedido foi criado.
- Formato: 2011-01-01T01:00:00-03:00
Observação: Campo de texto livre para observações gerais ou motivo de pendência do pedido.
Empresa: ID da Empresa - valor numérico inteiro.
Filial: ID da Filial - valor numérico inteiro.
Data de Emissão: Data da emissão do pedido.
- Formato: 2011-01-01T01:00:00-03:00
PCC: ID do Ponto de Venda - valor numérico inteiro.
PCC de Emissão: Identificador do PCC responsável pela emissão.
Agente: ID do Agente de viagens - valor numérico inteiro.
Agente de Emissão: Nome ou identificador do agente emissor.
Usuário: Nome do usuário responsável.
Tipo de Reserva: Nome do sistema de reserva.
Tipo de Aéreo: Identificador numérico do tipo de aéreo.
- Valores: 1 - Aéreo, 2 - PTA, 3 - Bilhete Open, 4 - E-Ticket.
ID do Cliente: ID do Cliente. Obrigatório caso as tags de cliente específicas não sejam enviadas.
Tipo de Contrato: Número identificador do tipo de contrato (Geralmente 1).
Histórico: Histórico da reserva.
Sistema de Reserva: ID do sistema de reserva - valor inteiro.
Localizadora da Companhia: ID do pedido ou localizador específico da cia aérea.
Destino da Reserva: Define o destino do pedido (campo informativo).
Passageiros Não Cadastrado: Informações de passageiros eventuais.
Tipo de Passageiro: ID da faixa etária do passageiro.
- Valores: 1 - ADT (Adulto), 2 - INF (Bebê), 3 - CHD (Criança).
Código do Fornecedor: Código identificador do fornecedor no sistema.
Tipo de Comissão Retida: Informação sobre a retenção de comissão.
Valor Total (cheio): Valor total da venda.

4. Dados do Aéreo

Esta seção detalha os valores financeiros, taxas e informações específicas dos bilhetes e trechos de voo.

Valores e Bilhete

Tarifa: Valor total das tarifas. Se não houver, enviar zero (0).
Taxa: Valor total das taxas. Se não houver, enviar zero (0).
Taxa DU: Valor da taxa de serviço (DU).
Valor do Markup: Valor adicionado como margem de lucro.
Número do Bilhete: Número do bilhete emitido.
- Nota: Quando for Gol ou Azul, enviar o Localizador.
Tipo da Rota: Classificação da rota.
- Valores: 1 - Nacional, 3 - Internacional.
Cotação: Cotação da moeda estrangeira, se aplicável.
Tarifa Estrangeira: Valor da tarifa na moeda original.
Tarifa Mínima / Máxima: Faixas de tarifa aplicáveis.
Dados do Trecho: Este campo substituirá a variável $$.
Trecho de Origem: Aeroporto ou cidade de origem.
Destino do Trecho: Aeroporto ou cidade de destino.
Saída do Trecho: Aeroporto ou cidade de origem
Hora da Saída / Hora de Chegada: Horários previstos do voo.
Classe: Classe tarifária ou de serviço (ex: Y, J, F).
Operadora do Trecho: Cia aérea que opera o voo.
Número do Voo: Numeração do voo.
Status: Status do segmento (ex: HK, SS).
Conexão / Escala: Indicadores se o trecho é uma conexão ou escala.
Nome da Aeronave: Modelo do equipamento/avião.

5. Dados do Pagamento

Informações financeiras sobre como a venda foi liquidada.

ID Forma de Pagamento: Identificador numérico da forma de pagamento.
- Valores: 1-Cash, 2-Invoice, 3-Pagamento Direto, 4-Cartão, 5-Governo, 6-Faturado.
ID Forma de Recebimento: Identificador numérico da forma de recebimento.
- Valores: 1-Cash, 2-Cheque, 3-Faturado, 4-Cartão, 6-Cartão Convênio, 10-Pagamento Direto, 11-Cartão EBTA, 13-TKT, 14-Governo.
Número do Pagamento: Obrigatório quando a forma de recebimento for igual a 1 (Cash).
Tipo de Cartão: Código de 2 letras indicando a bandeira/operadora.
- Exemplos: MC (Mastercard), VI (Visa), DC (Diners), etc.
Número do Cartão: Numeração do cartão de crédito utilizado.
Titular Cartão: Nome impresso no cartão.
Data de Vencimento do Cartão: Data de expiração do cartão.

6. Salvar a Configuração

Após configurar os campos:

Clique em Confirmar (botão azul na parte inferior da tarefa).
Em seguida, clique em Salvar no robô.

Dúvidas Frequentes

Importante: Campos marcados com ícones de lâmpada amarela na interface possuem regras de validação estritas (como IDs numéricos e formatos de data). Certifique-se de tratar os dados antes do envio para evitar erros de integração.