ERP – Integração Balança – Como é possível efetuar a integração do ERP com balanças
Dúvida
Como é possível efetuar a integração do ERP com balanças e quais são as balanças homologadas?
Solução
O Gestão Empresarial | ERP permite integração com 3 DLLs diferentes de balança:
- DLL padrão Toledo - DLL PCLink 5;
- DLL padrão ExecSoft - DLL Genérica;
- DLL personalizada;
Além disso, é possível fazer a integração através da opção 'WebService / API REST', onde utiliza-se a integração do Gestão Empresarial | ERP com uma balança através do Aplicativo de Balança do sistema Gestão de Pátio| YMS da Senior.
É imprescindível que você verifique também as informações presentes na documentação do sistema Gestão Empresarial | ERP para esse tema. Para isso, acesse o Portal da Documentação da Senior (clique aqui para acessá-lo) e procure pelo termo 'FCFGBAL - Definições para a Leitura da Balança' e também pelo termo 'Saída via balança'.
Fluxo da integração / utilização das rotinas do sistema:
O fluxo do processo de integração do ERP com a Balança é bem simples (independentemente de qual DLL/forma de integração será utilizada). Segue abaixo:
- Nas rotinas que permitem integração com balança, o ERP acionará a DLL/aplicativo parametrizado em Recursos / Configurações / Leitura da balança;
- A DLL/aplicativo será responsável por fazer a comunicação com a balança e retornar ao ERP o valor lido da mesma;
- O ERP apresentará na tela os valores lidos pela balança.
Observação
- Note que o ERP apenas aciona a DLL. A DLL é responsável por retornar os valores lidos da balança;
- No caso do acionamento do Aplicativo da Balança do Gestão de Pátio | YMS, este acionamento é efetuado através de uma chamada a uma URL disponibilizada pelo Aplicativo e o ERP apenas interpretará o retorno dado pelo aplicativo nesta URL.
Informações adicionais sobre os tipos de integração disponíveis:
1- Integração com DLL Toledo - DLL PCLink 5:
Para balanças de fabricação Toledo, devem ser instaladas as bibliotecas (ou DLL PCLINK32.DLL) disponibilizadas pelo fabricante da balança no mesmo equipamento (estação) em que está instalada a balança. As DLL devem estar na pasta Sapiens onde o ERP foi instalado. O sistema Gestão Empresarial | ERP se comunica somente com a versão 5 (PCLink32.dll) das bibliotecas desse fabricante para integrar com a balança. Acima desta versão, o sistema ERP não mantêm mais compatibilidade e não irá funcionar.
Observação:
Caso a versão 5 das bibliotecas da fabricante Toledo seja atualizada para versões superiores, a versão não será mais compatível com a anterior, e a integração do sistema com a balança deixará de funcionar.
2- Integração com DLL padrão ExecSoft - DLL Genérica:
A Execsoft é uma empresa terceira que possui uma DLL que poderá ser utilizada para fazer a ponte entre o ERP e a balança.
No caso de ser escolhida a integração via DLL Execsoft, deverá ser tratado diretamente com a Execsoft a questão da compatibilidade com as balanças utilizadas e parametrização para comunicação com a balança.
A DLL genérica Execsoft é independente do fabricante da balança e a configuração não precisa mais ser feita pelo ERP, sendo necessário apenas informar na tela de configuração de balança que o tipo da DLL é EXECSOFT.
As demais configurações devem ser feitas no aplicativo próprio para a configuração desta DLL de integração (SCALECF.EXE). Após serem feitas todas as configurações através deste aplicativo o único detalhe que deve ser observado é que o aplicativo SCALELD.EXE deve ser sempre executado antes do ERP. Esta nova DLL é uma DLL de terceiros, ou seja, é preciso que seja adquirido um HARDKEY para liberar a utilização do mesmo.
Observação
Caso seja utilizada a integração via Execsoft, deve-se disponibilizar jogar todos os arquivos do diretório da Execsoft/Scale dentro do diretório Sapiens na estação que fará a comunicação com a balança.
No site site da Execsoft encontra-se os dados para contato: www.execsoft.com.br
Para maiores informações sobre a DLL, como adquiri-la, como configurá-la, compatibilidade com balanças, é necessário efetuar contato direto com a Execsoft.
3- Integração com DLL personalizada
No caso da escolha por uma DLL personalizada, é necessário que um especialista no desenvolvimento de DLLs trate a criação da mesma, de forma que o ERP receba da DLL as informações oriundas da balança.
Com relação a eventual necessidade de definição desta DLL, caso não haja um profissional com conhecimento para criação da mesma, poderá ser verificada com a área de Serviços da Senior a contratação deste serviço para configuração da integração com a balança e criação da DLL.
Em anexo segue arquivo DLL Personalizada.zip. Este arquivo contém:
- Arquivo de DLL personalizada para testes;
- Arquivos de configuração da DLL personalizada;
- Um exemplo simples de regra para utilização das funções de leitura da balança (funções que ativam a DLL personalizada).
Para utilizar esta DLL, deve-se colocar a mesma no diretório da aplicação onde será efetuado o teste (diretório Sapiens) junto com os arquivos arquivopesos_1.ini e arquivopesos_2.ini.
É importante salientar de que essa DLL personalizada serve apenas para testar as rotinas que fazem acionamento da balança, sem haver nenhuma comunicação com uma balança efetiva. Em resumo, é uma DLL que retorna aleatoriamente valores para o sistema emulando uma conexão com a balança, apenas para testes internos do ERP.
Lembrando que não há necessidade de criação de nenhuma regra para ativação do processo de comunicação com a balança em telas padrões do ERP.
A regra de exemplo disponibilizada é uma regra para teste de comunicação com a balança, utilizando funções do ERP que fazem acionamento da balança através da DLL já configurada no ERP. Essas funções são utilizadas em rotinas customizadas dos clientes onde deseja-se fazer leitura de valores da balança.
Para maiores informações sobre a construção da DLL personalizada, consultar a documentação citada no início desta solução.
4- Integração com Aplicativo de Balança do Gestão de Pátio | YMS
O Gestão Empresarial | ERP permite integração nativa com o aplicativo e leitura de balança do Gestão de Pátio | YMS.
Você encontrará maiores informações sobre a integração na documentação do sistema Gestão Empresarial | ERP para esse tema. Para isso, acesse o Portal da Documentação da Senior (clique aqui para acessá-lo) e procure pelo termo 'FCFGBAL - Definições para a Leitura da Balança'.
Importante
- Para utilizar o aplicativo, você deve efetuar a contratação do mesmo através de um Executivo de Vendas da Senior ou do seu Canal de Distribuição.
- Antes de adquirir o aplicativo, verifique na documentação do Gestão de Pátio | YMS as balanças homologadas para utilização.
- É obrigatório que das estações onde o Gestão Empresarial | ERP está sendo executado tenha-se acesso à URL do aplicativo de balança do Gestão de Pátio | YMS, garantindo a comunicação entre as soluções.
Verifique também os artigos abaixo sobre interação com YMS:
Limitações das rotinas:
- A integração com a balança não poderá ser efetuada quando o ERP está sendo executado via Windows Access ou Browser Access. É obrigatória a utilização do ERP no modelo Cliente-Servidor;
- É possível utilizar o ERP em ambiente Cloud com processos de Balança, desde que a DLL personalizada tenha sido desenvolvida permitindo esse tipo de comunicação. A Senior não disponibiliza nenhuma DLL padrão do produto que permita comunicação via ambiente Cloud. Para Clientes Cloud, a Senior disponibiliza a comunicação através do aplicativo de balança do Gestão de Pátio | YMS (que deve ser adquirido separadamente).
Informações adicionais sobre telas F909MIF e F909MOA:
Sendo utilizada uma DLL personalizada para integração do ERP com a balança a DLL utilizada deve possuir os métodos: BalancaPronta, LerPesoBruto, LerPesoLiquido e LerPesoTara, conforme consta na documentação sobre essa forma de integração. Contendo estes métodos o Botão Leitura deverá ser habilitado nas referidas telas. Caso a DLL não tenha essas definições, o botão Leitura não será habilitado.
Atenção
Homologação de Balanças
Hoje a Senior não efetua mais homologação de versões para balanças de fabricação Toledo (ou qualquer outra marca) para conectividade direta com o sistema Gestão Empresarial | ERP, porém, o suporte a versão homologada PCLink5 (para balanças Toledo), ainda ocorrerá.
A Senior não indica ou opina sobre qual melhor equipamento, pois não temos conhecimento técnico sobre os mesmos. Chamamos a atenção para o fato, que modelos de um mesmo fabricante podem ser compatíveis e outros não. Sugerimos antes da aquisição do equipamento, que seja solicitado junto ao fabricante uma balança para realização de testes em nossos Sistemas.
Apenas podemos dizer que o sistema Gestão Empresarial | ERP integra-se com balanças de pesagem que efetua a leitura de pesos para uso de diversas rotinas do sistema. Estas integrações são efetuadas através de bibliotecas disponibilizadas pelos fabricantes, bibliotecas genéricas configuráveis fornecidas por parceiros ou até mesmo podem ser construídas de forma proprietária. As integrações disponíveis atualmente são as indicadas no início desta solução.
Para informações de balanças homologadas para a integração com o Aplicativo de balança do sistema Gestão de Pátio | YMS, verifique a documentação deste sistema no Portal da Documentação da Senior.