OverDesk
← Manuais

Instalação

PostgreSQL, ERP, Servidor e PDVs: do zero até a primeira venda.

Visão geral

O OverDesk tem três programas:

ProgramaOnde ficaPara quê
OverDeskERP.exeComputadores do escritórioCadastros, estoque, compras, fiscal, financeiro e relatórios
Server.exeUm computador que fica sempre ligado (o servidor)Liga os PDVs ao banco do ERP, faz backup e rotinas automáticas
PDV.exeCada caixaVendas, NFC-e, TEF e PIX, funcionando mesmo sem rede

O banco de dados do ERP é PostgreSQL e fica no servidor. Os PDVs têm banco local e conversam só com o OverDesk Servidor.

Requisitos

  • Windows 10/11 ou Windows Server 2016 ou mais novo (32 ou 64 bits).
  • Servidor: 4 GB de memória e SSD; os caixas funcionam bem com 4 GB.
  • Rede local entre os caixas e o servidor (cabo de preferência).
  • Para NF-e/NFC-e: certificado digital A1 instalado no computador que emite.

1. Banco de dados (PostgreSQL)

  1. Instale o PostgreSQL 16 no servidor (instalador oficial). Anote a senha do usuário postgres.
  2. No pgAdmin, crie o banco overdesk (codificação UTF8).
  3. Para outros computadores acessarem, libere a rede em pg_hba.conf (só a faixa da loja, por exemplo 192.168.0.0/24) e a porta 5432 no firewall do Windows.
Nunca deixe a porta 5432 aberta para a internet.

2. ERP

  1. Baixe o OverDeskERP.exe em Downloads e coloque numa pasta, por exemplo C:\OverDesk.
  2. Crie, na mesma pasta, o arquivo OverDesk - ERP.ini. O nome da seção começa pelo usuário do Windows que usa o computador (no exemplo, caixa1):
[caixa1\Config]
DB_Type=POSTGRESQL
DB_Host=192.168.0.10
DB_Port=5432
DB_Name=overdesk
DB_User=postgres
DB_Pass=SENHA_DO_BANCO
  1. Abra o ERP. Na primeira vez, rode Procedimentos > Atualizar Estrutura: ele cria todas as tabelas. Repita sempre que trocar de versão.
  2. Cadastre em Configurações: Unidades, Dados Fiscais (emitente), Formas de pagamento e Geral.
Se o ERP não encontrar a configuração, a mensagem de erro mostra o arquivo e a seção exatos que ele procurou. A senha do banco fica só no INI do computador: proteja a pasta e não envie o INI por e-mail.

3. OverDesk Servidor

  1. Coloque o Server.exe no servidor, em C:\OverDesk\Servidor.
  2. Crie o Server.ini ao lado do executável (aqui as seções não levam o usuário do Windows):
[Config]
DB_Host=127.0.0.1
DB_Port=5432
DB_Name=overdesk
DB_User=postgres
DB_Pass=SENHA_DO_BANCO

[Servidor]
Usuario=pdv
Senha=UMA_SENHA_FORTE
Porta=8082

[Backup]
Hora=23:30
Dias=15
  1. Rode o Server.exe e confira na tela se o banco e o serviço ficaram verdes. Ele também pode rodar como serviço do Windows, para iniciar sozinho com o computador.
  2. Libere a porta 8082 no firewall, só para a rede da loja.

O backup diário grava em Backup\ ao lado do executável e guarda os últimos dias configurados. Confira em Procedimentos > Backups do servidor no ERP.

4. PDVs (caixas)

  1. Copie o PDV.exe para C:\OverDesk\PDV em cada caixa.
  2. Crie o OverDesk - PDV.ini, também com o usuário do Windows no nome das seções:
[caixa1\Servidor]
Host=192.168.0.10
Porta=8082
Usuario=pdv
Senha=UMA_SENHA_FORTE
PDV=1
  1. No ERP, cadastre o PDV em Configurações > PDV's com o mesmo número.
  2. Abra o PDV: ele baixa produtos, preços e formas de pagamento do servidor. O rodapé mostra a situação da comunicação.

NFC-e

No OverDesk - PDV.ini do caixa:

[caixa1\NFCe]
Ativo=1
Impressao=ESCPOS
Modelo=0
Porta=COM1
Colunas=48

Os dados fiscais (CSC, série e ambiente) vêm do cadastro do emitente no ERP. Sem internet, a NFC-e sai em contingência offline e é transmitida sozinha quando a conexão volta; o rodapé mostra quantas estão pendentes. A SEFAZ exige a transmissão em até 24 horas.

PIX e TEF

[caixa1\PIX]
Chave=sua-chave-pix
Nome=NOME DA LOJA
Cidade=CIDADE

[caixa1\TEF]
GP=PAYGO

GP pode ser PAYGO, CLISITEF, ELGIN ou vazio (TEF Dial).

5. Atualizar para uma nova versão

  1. Baixe os executáveis novos em Downloads.
  2. Feche o ERP em todos os computadores, pare o Servidor e feche os PDVs.
  3. Troque os .exe (guarde os antigos numa pasta anterior, para voltar se precisar).
  4. Abra o ERP e rode Procedimentos > Atualizar Estrutura.
  5. Inicie o Servidor e depois os PDVs.
Precisa voltar uma versão? Os executáveis anteriores ficam em Downloads, em "Versões anteriores".