Backend para utilização de balança integrado ao ERP da Fersoft

Aqui você encontra disponível o Backend de Balança para integração com o ERP da Fersoft. Após baixar o Backend Balanca API, siga as orientações abaixo para configurar o acesso via SSL (quando a balança/serviço estiver em um dispositivo na rede) ou via HTTP local (quando tudo estiver na mesma máquina).

Domínio: https://balanca.fersofterp.com.br

Arquivo: backend-balanca-win64.zip

Finalidade: SSL para autenticação em rede

Porta: 3333

✔ Cenários suportados

Mesma máquina (host do backend = estação que usa a balança): acesso local http://127.0.0.1:3333.
Outra estação na rede (cliente acessa o backend em outro IP): acesso via domínio https://balanca.fersofterp.com.br:3333 com SSL usando hosts do Windows.

Download do Backend (Windows x64)

Link direto: /backend-balanca-win64.zip

Hospedagem: balanca.fersofterp.com.br

Modo recomendado em rede: HTTPS (SSL)

Porta do serviço: 3333

Script hosts (Windows): /configurar-hosts-balanca.bat

Baixar backend-balanca-win64.zip Gerar apontamento no hosts (Windows)

Se o download não iniciar automaticamente, clique no botão novamente ou acesse o link direto acima.

1) Configuração do arquivo hosts (Windows) — Acesso via SSL

Para usar o SSL e garantir autenticação segura em rede, você deve configurar no Windows o arquivo hosts apontando o IP local do dispositivo onde o Backend está instalado para o domínio balanca.fersofterp.com.br.

✔ Antes de configurar o hosts: instale/atualize o certificado automaticamente

Antes de fazer o apontamento no arquivo hosts, acesse esta página pelo navegador (https://balanca.fersofterp.com.br) para que o certificado SSL seja instalado e atualizado automaticamente no Windows (cache/chain do navegador). Em seguida, faça o apontamento do hosts e teste o acesso em rede.

⚠ Importante

Esse apontamento faz com que o domínio balanca.fersofterp.com.br seja resolvido para o IP interno. Com isso, a estação cliente acessa o serviço via HTTPS usando o certificado SSL do domínio.

Passo a passo:

Abra o Bloco de Notas como Administrador.
Abra o arquivo: C:\Windows\System32\drivers\etc\hosts
Adicione a linha conforme o exemplo abaixo.
Salve o arquivo.
Opcional: execute ipconfig /flushdns no Prompt (Admin) para limpar cache DNS.

✔ Alternativa (recomendado): use o script automático para configurar o hosts

Para facilitar, baixe e execute como Administrador o arquivo configurar-hosts-balanca.bat. Ao executar, informe apenas o IP do host onde o Back-End está instalado (ex.: 192.168.0.10) e o script fará: backup do hosts, inclusão/substituição do apontamento e ipconfig /flushdns.

Baixar configurar-hosts-balanca.bat

# Exemplo (IP do dispositivo que está com o Backend instalado)
192.168.0.10   balanca.fersofterp.com.br

Após salvar o hosts, o acesso em rede deve ser feito usando o domínio com a porta 3333: https://balanca.fersofterp.com.br:3333

⛔ Efeito colateral esperado

Após configurar o hosts, o domínio balanca.fersofterp.com.br não apontará mais para a internet nesse dispositivo — ele apontará para o IP interno. Para voltar ao acesso público, remova a linha do hosts.

2) SSL (Rede) vs HTTP Local (Mesma Máquina)

A escolha do modo depende do cenário onde o Backend e o cliente (ERP/estação) estão rodando.

⚠ Observação importante quando for utilizar SSL/HTTPS

Se você for utilizar SSL, ajuste/ative essa opção nas configurações do Backend Balanca API (conforme a sua instalação) e reinicie o serviço para aplicar as alterações. A partir daí, inclusive no host onde o backend está instalado, o acesso deve ser feito via https://balanca.fersofterp.com.br:3333 (ou o domínio apontado no hosts), e não via HTTP.

Se o cenário for local e você optar por não usar SSL, continue utilizando http://127.0.0.1:3333.

✔ Cenário A — Mesma máquina (sem necessidade de SSL)

Se o Backend está instalado no mesmo host onde você utiliza a balança e o consumo é local, não há necessidade de SSL. A conexão pode ser feita diretamente via http://127.0.0.1:3333 (localhost), usando HTTP.

# Exemplo de acesso local (mesma máquina)
http://127.0.0.1:3333

⚠ Cenário B — Outra estação na rede (recomendado SSL)

Se outra estação irá consumir o Backend, configure o hosts conforme a seção anterior para acessar via https://balanca.fersofterp.com.br:3333. A finalidade é utilizar o domínio com o certificado SSL para autenticação em rede.

# Exemplo de acesso em rede (com hosts configurado)
https://balanca.fersofterp.com.br:3333

⛔ Atenção ao acesso público

Quando o hosts estiver configurado, o domínio ficará “preso” ao IP interno nessa máquina. Para acessar novamente o site público, remova o apontamento do hosts.

3) Instalação do serviço do Backend (Windows) — `servico.bat`

Para manter o Backend da Balança executando automaticamente no Windows (ex.: após reiniciar o PC), utilize o script servico.bat que acompanha o pacote. Ele instala o executável como um serviço do Windows utilizando o NSSM.

⚠ Execute como Administrador

Clique com o botão direito no servico.bat e escolha Executar como administrador. Sem privilégios de administrador, o Windows não permitirá instalar/remover o serviço.

Passo a passo recomendado:

Extraia o ZIP em uma pasta fixa (ex.: C:\BackendBalanca\).
Abra um Prompt de Comando como Administrador na pasta extraída.
Instale e inicie o serviço com: servico.bat install
Para consultar o status: servico.bat status
Para remover: servico.bat uninstall

REM (Prompt como Administrador)
servico.bat install
servico.bat status
servico.bat uninstall

✔ Reiniciar o serviço (após alterar configurações, ex.: SSL)

Sempre que você alterar as configurações do Backend Balanca API (por exemplo, ativar/ajustar SSL), reinicie o serviço para aplicar. Como o servico.bat não possui um comando “restart” dedicado, utilize os comandos do Windows:

REM (Prompt como Administrador)
net stop API_Leitura_Serial_Fersoft
net start API_Leitura_Serial_Fersoft

⚠ Porta padrão do Backend

O Backend roda na porta 3333. Exemplos:
• Local (sem SSL): http://127.0.0.1:3333
• Rede/SSL (com hosts): https://balanca.fersofterp.com.br:3333

4) Checklist rápido de validação

Download: confirmar que backend-balanca-win64.zip está acessível em /backend-balanca-win64.zip.
Rede/SSL: se for outra estação, confirmar entrada no hosts apontando para o IP do dispositivo do backend.
DNS cache: se necessário, executar ipconfig /flushdns.
Acesso: testar abertura do domínio https://balanca.fersofterp.com.br:3333 no navegador da estação cliente.
Local: se for mesma máquina, testar via http://127.0.0.1:3333.

✔ Dica prática

Para evitar dúvida operacional, mantenha documentado internamente qual é o IP fixo (ou reserva DHCP) do dispositivo onde o Backend está instalado — isso reduz falhas de apontamento.