Instalação
PostgreSQL, ERP, Servidor e PDVs: do zero até a primeira venda.
Visão geral
O OverDesk tem três programas:
| Programa | Onde fica | Para quê |
|---|---|---|
| OverDeskERP.exe | Computadores do escritório | Cadastros, estoque, compras, fiscal, financeiro e relatórios |
| Server.exe | Um computador que fica sempre ligado (o servidor) | Liga os PDVs ao banco do ERP, faz backup e rotinas automáticas |
| PDV.exe | Cada caixa | Vendas, 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)
- Instale o PostgreSQL 16 no servidor (instalador oficial). Anote a senha do usuário
postgres. - No pgAdmin, crie o banco
overdesk(codificação UTF8). - Para outros computadores acessarem, libere a rede em
pg_hba.conf(só a faixa da loja, por exemplo192.168.0.0/24) e a porta 5432 no firewall do Windows.
Nunca deixe a porta 5432 aberta para a internet.
2. ERP
- Baixe o OverDeskERP.exe em Downloads e coloque numa pasta, por exemplo
C:\OverDesk. - 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
- Abra o ERP. Na primeira vez, rode Procedimentos > Atualizar Estrutura: ele cria todas as tabelas. Repita sempre que trocar de versão.
- 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
- Coloque o Server.exe no servidor, em
C:\OverDesk\Servidor. - Crie o
Server.iniao 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
- 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.
- 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)
- Copie o PDV.exe para
C:\OverDesk\PDVem cada caixa. - 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
- No ERP, cadastre o PDV em Configurações > PDV's com o mesmo número.
- 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
- Baixe os executáveis novos em Downloads.
- Feche o ERP em todos os computadores, pare o Servidor e feche os PDVs.
- Troque os
.exe(guarde os antigos numa pastaanterior, para voltar se precisar). - Abra o ERP e rode Procedimentos > Atualizar Estrutura.
- Inicie o Servidor e depois os PDVs.
Precisa voltar uma versão? Os executáveis anteriores ficam em Downloads, em "Versões anteriores".
