Configuração do integrador Vendas Externas no Solution

Pré requisitos:
  Realizar a configuração da API Cybersul:
    -https://remoto.cybersulinformatica.com.br:8082/books/api-cybersul

Configurando:
  1. Habilitar Integração com Vendas Externas no Menu: Outros -> Dados da Empresa (Aba: Integração)
image-1738693696005.png

2.Configurar a API Cybersul
    Certifique-se que a API esteja configurada.  Clique aqui para ver

3. No Menu: Outros -> Integrações (Aba: Permissões)
  - Registre a filial que será integrada e o Nome da API = VENDASEXTERNAS
image-1738693832832.png

4. No Menu: Outros -> Integrações (Aba: Vendas Externas), entre com os parâmetros:
     - Descrição da API - Campo opcional utilizado para melhor identificação da integração nos logs da API.
     - E-Mail de Acesso Mesmo e-mail utilizado para acessar o painel do Vendas Externas.
     - Senha de Acesso: Mesma senha utilizada para acessar o painel do Vendas Externas.
image-1738694170535.png

5. No Menu: Outros -> Integrações (Aba: Vendas Externas), configure as funções que serão integradas.
Aba -> Estoque / Preço:
     - Integrar Estoque: Habilita envio de estoque disponível.
     - Local Estoque: Local de estoque integrado.
     - Integrar Preços: Habilita envio de preços.
     - Faixa de Preço: Faixa de preço integrada.
     - Integrar Produtos: Cadastra produtos na Vendas Externas quando PRINTERNET='S'.
Aba -> Pedido de Venda:
     - Integrar Pedido: Habilita integração de pedidos de venda.
     - Data Inicial: Considera período de implantação da integração de pedidos.
     - Situação Inicial: Controle de situação utilizada para inserir novos pedidos da Vendas Externas.
     - Cód. Operação: Código da operação que será utilizada no pedido de vendas.
     - Tabela Vencimento: Tabela Vencimento que será utilizada no pedido de vendas.
     - Transportadora: Transportadora que será utilizada no pedido de vendas.
     - Vendedor Padrão: Vendedor que será utilizada no pedido de vendas.
     - Atualizar Clientes:
          Sim = Atualiza cadastro de clientes ao importar pedido.
          Não = Não atualiza cadastro de cliente ao importar pedido (Incluí novo endereço de entrega quando não existir).
          Notificar = Cria log de notificação quando cadastro do cliente estiver desatualizado e não importa o pedido.
     - Condição Trib.PF: Condição tributária para inclusão de novos clientes Pessoa Física.
     - Condição Trib.PJ: Condição tributária para inclusão de novos clientes Pessoa Jurídica.
     - Condição Trib.PJ c/IE: Condição tributária para inclusão de novos clientes Pessoa Jurídica Com Isncrição Estadual.

image-1738845518364.png

 

6. Ligar integrador ao iniciar o Windows:
Instalação utilizando GuardianAPP  
-Recomendado a utilização do GuardianAPP para instalação e monitoramento do integrador:
GuardianAPP (Biblioteca Cybersul)

Instalação Manual
  -No menu iniciar digitar "Executar" (ou "Run" - Windows EN) e abrir a pasta "%AppData%\Microsoft\Windows\Start Menu\Programs\Startup"
  -Dentro desta pasta criar atalho ao integrador com os parâmetros AUTO 5 para os ciclos de integração executarem a cada 5 minutos (conforme exemplo abaixo).
image-1738846340115.png

7. Caminho da API:
  - Na primeira abertura do aplicativo, será mostrada a tela de configuração de onde o aplicativo deverá buscar os parâmetros de funcionamento.
image-1738846463537.png

  - Caso necessário modificar estas configurações após a abertura do aplicativo, clique com o botão <direito> do mouse sobre o botão "Verificação Inicial".
image-1738847747376.png

8. Teste de comunicação:
  Ao clicar no botão "Verificação Inicial" verificar as respostas demonstradas abaixo:
    - Parametrizações Carregadas -> Significa que a comunicação com a API CyberSul foi estabelecida com sucesso e as parametrizações da integração foram carregadas.
    -Licença Não Encontrada -> Significa que ainda não foi realizada a primeira comunicação com a Vendas Externas, pois a licença será atualizada na primeira comunicação.
    -Licença atualizada com sucesso -> Significa que obteve a licença de uso da API Vendas Externas.
    -Integração Não Encontrada -> Significa que ainda não foi realizada a primeira comunicação com a Vendas Externas, pois a integração será registrada na primeira comunicação.
    -Integração atualiza com sucesso -> Significa que o integrador está apto a utilizar a API da Vendas Externas.
    -Token expirado -> Significa que a integração não possui um token (chave de comunicação) válido.
    -Token atualziado -> Significa que a integração obteve um novo token (chave de comunicação) valido.
image-1738848083448.png