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.

⚠ Antes de alterar o hosts: abra esta página para atualizar o certificado SSL

Antes de fazer o apontamento no hosts, acesse https://balanca.fersofterp.com.br neste computador para que o certificado SSL seja instalado/atualizado automaticamente. Em seguida, faça o apontamento e confirme que o SSL está habilitado nas configurações do Backend Balanca API, reiniciando o serviço após qualquer alteração.

⚠ 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 (Adicionar/Remover)

Automatizar o apontamento (recomendado)

Para facilitar, disponibilizamos um script que atualiza o hosts automaticamente: configurar-hosts-balanca.bat. Execute como Administrador, escolha a ação (ADICIONAR/ATUALIZAR ou REMOVER), e o script fará backup do hosts, removerá entradas antigas e aplicará (ou removerá) o apontamento do domínio.

✔ Download do script

Baixe aqui: Baixar configurar-hosts-balanca.bat (Adicionar/Remover)

# 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)

⛔ Não esqueça de habilitar o SSL nas configurações do Backend Balanca API

Para utilizar HTTPS/SSL, é obrigatório habilitar o uso de SSL nas configurações do Backend Balanca API. Após alterar essa configuração, reinicie o serviço (Windows Service) para que as mudanças entrem em vigor. Em modo SSL, utilize sempre https://balanca.fersofterp.com.br:3333 (inclusive no host local quando aplicável).

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`

O Back-End pode ser executado como Serviço do Windows usando o arquivo servico.bat (baseado em NSSM), garantindo inicialização automática e operação em segundo plano. Execute sempre como Administrador.

⚠ Requisitos na mesma pasta

Mantenha os arquivos na mesma pasta: backend-balanca-win64.exe, nssm.exe e servico.bat. A API roda por padrão na porta 3333 (ou na porta configurada via .env).

Uso sem parâmetros (menu interativo)

Basta executar servico.bat como Administrador. Um menu será exibido permitindo escolher as ações abaixo.

servico.bat
(Executar como administrador)
  [1] Instalar servico
  [2] Remover servico
  [3] Iniciar servico
  [4] Parar servico
  [5] Reiniciar servico
  [6] Status do servico
  [7] Definir porta personalizada (PORT)
  [8] Remover porta personalizada (PORT)

Uso por parâmetros (automação / suporte remoto)

Você também pode chamar o servico.bat diretamente com comandos:

servico.bat install
servico.bat uninstall
servico.bat start
servico.bat stop
servico.bat restart
servico.bat status
servico.bat set-port
servico.bat unset-port

✔ Porta personalizada via .env (PORT)

Para personalizar a porta do serviço, crie (ou edite) um arquivo .env na mesma pasta do executável contendo PORT=3333 (ou PORT=3331, etc.). Após alterar a porta, reinicie o serviço para aplicar.

⛔ Mudou SSL/porta/configurações? Reinicie o serviço

Sempre que habilitar Uso de SSL nas configurações do Backend Balanca API, ou alterar a porta (PORT), reinicie o serviço (opção Reiniciar no servico.bat) para que as mudanças entrem em vigor.

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.