Manual de Instalação do SisCom

1. Visão geral

O SisCom é uma aplicação Windows (32 bits) que acessa um banco de dados Firebird. Existem duas instalações distintas:

Convenções usadas neste manual — substitua pelos valores reais do cliente:

2. Instalação no servidor

2.1 Pré-requisitos

1. Sistema operacional Windows. O SisCom.exe é uma aplicação Windows de 32 bits (roda normalmente em Windows 64 bits).
2. Firebird instalado — atualmente versão 5.0. O instalador está em \\192.168.0.215\Util\Firebird\FB_5\. Em situações normais basta avançar com Next em todas as telas e, quando solicitado, informar a senha padrão do sistema SisCom para o usuário SYSDBA.
3. Porta do Firebird liberada no Firewall do Windows. Logo após instalar o Firebird, libere a porta TCP 3050 no firewall do servidor, para permitir o acesso das estações pela rede (ver quadro abaixo).
4. Internet disponível. Na primeira execução o SisCom baixa arquivos complementares (schemas fiscais, utilitários, atualizador).
5. IBExpert instalado. É o gerenciador de banco de dados (SGBD) utilizado para administrar o banco do cliente — necessário para consultar a versão do banco e rodar os scripts na atualização (seção 5).

netsh advfirewall firewall add rule name="Firebird 3050" dir=in action=allow protocol=TCP localport=3050

Se o cliente usa outra porta (caso raro de duas versões do Firebird no mesmo servidor), libere a porta informada em PORTAFB no lugar da 3050. Sem essa liberação o SisCom funciona no servidor, mas nenhuma estação consegue conectar.

2.2 Arquivos necessários

Apenas os itens abaixo são copiados para a pasta Programas\. Todas as demais pastas e arquivos são criados ou baixados pelo próprio SisCom.exe quando necessário.

2.3 Passo a passo

1. Instalar o Firebird 5.0 e liberar a porta no firewall Conforme os pré-requisitos 2 e 3 da seção 2.1. Porta padrão: 3050.
2. Criar a estrutura de pastas

   C:\Memoria\SisComInd\
   ├── Dados\          ← arquivo do banco de dados (.FDB)
   └── Programas\      ← executáveis, DLLs, CONFIG.INI e logotipo

3. Copiar o banco de dados Coloque o arquivo NOMECLIENTE.FDB na pasta Dados\.
4. Copiar os arquivos do sistema Copie para Programas\ os itens da seção 2.2.
5. Compartilhar a pasta Programas como SISCOM Compartilhe C:\Memoria\SisComInd\Programas com o nome SISCOM, com permissão de leitura e gravação para os usuários das estações. O resultado deve ser acessível como \\SERVIDOR\SISCOM. A pasta Dados\ não deve ser compartilhada.
6. Ajustar o CONFIG.INI Conforme a seção 2.4.
7. Executar o SisCom.exe e criar o atalho Conforme a seção 2.5. No servidor, o atalho da área de trabalho aponta para o SisCom.exe.

2.4 CONFIG.INI do servidor

O arquivo deve ficar na mesma pasta do SisCom.exe. Modelo:

[CONFIGURACAO]
SENHABANCO=
PORTAFB=3050
CaminhoBase=LOCALHOST:C:\Memoria\SisComInd\Dados\NOMECLIENTE.FDB
SrvLinux=
Logotipo=\\SERVIDOR\SISCOM\logo.bmp
Exe=SISCOM.EXE
App=\\SERVIDOR\SISCOM\siscom.exe
Cliente=NOMECLIENTE
Caixa=1
EmpCaixa=1
[AUTOLOGIN]
USUARIO=
PASSWORD=

• CaminhoBase no servidor começa sempre com LOCALHOST:, seguido do caminho completo do .FDB.
• SENHABANCO fica vazio — não digitar senha neste campo.
• Logotipo e App usam o caminho de rede (UNC) do compartilhamento SISCOM, inclusive no servidor.
• Cliente é o nome do banco sem .FDB, em maiúsculas.

A explicação completa de cada campo está na seção 6.

2.5 Primeira execução

Execute o SisCom.exe. Com internet disponível, o sistema cria a estrutura abaixo e faz o download dos arquivos complementares — nada disso precisa ser copiado manualmente:

2.6 Checklist do servidor

• Firebird 5.0 instalado, com a senha padrão do SisCom, e serviço em execução.
• Pastas Dados\ e Programas\ criadas; NOMECLIENTE.FDB em Dados\.
• SisCom.exe, Atualizador.exe, todas as DLLs, CONFIG.INI e logo.bmp em Programas\.
• Pasta Programas compartilhada como SISCOM (leitura e gravação) — testar abrindo \\SERVIDOR\SISCOM.
• Porta 3050 liberada no firewall.
• CONFIG.INI revisado: CaminhoBase com LOCALHOST, Logotipo, App e Cliente.
• SisCom abriu com internet, criou as subpastas e permitiu login.
• Atalho da área de trabalho criado para o SisCom.exe.
• IBExpert instalado no servidor.

3. Instalação na estação

Faça a instalação das estações depois que o servidor estiver funcionando.

3.1 Pré-requisitos

1. Sistema operacional Windows (aplicação 32 bits; roda em Windows 64 bits).
2. Acesso de rede ao servidor: abrir \\SERVIDOR\SISCOM no Explorador de Arquivos sem erro, com permissão de leitura e gravação, e porta 3050 do servidor alcançável.
3. Internet disponível — a estação também baixa arquivos complementares na primeira execução.

3.2 Passo a passo

1. Criar a pasta local do sistema Crie uma pasta local para o SisCom (ex.: C:\Memoria\SisComInd\Programas). A estação não tem pasta Dados\.
2. Copiar os arquivos Copie os mesmos itens da seção 2.2: SisCom.exe, Atualizador.exe, todas as DLLs, CONFIG.INI e logo.bmp. Eles podem ser copiados diretamente de \\SERVIDOR\SISCOM.
3. Ajustar o CONFIG.INI Conforme a seção 3.3.
4. Criar o atalho para o Atualizador.exe e abrir o sistema Crie o atalho na área de trabalho apontando para o Atualizador.exe local — e não para o SisCom.exe. Abra o sistema por esse atalho e confirme o login.

3.3 CONFIG.INI da estação

É igual ao do servidor, trocando apenas LOCALHOST pelo nome ou IP do servidor em CaminhoBase:

[CONFIGURACAO]
SENHABANCO=
PORTAFB=3050
CaminhoBase=SERVIDOR:C:\Memoria\SisComInd\Dados\NOMECLIENTE.FDB
SrvLinux=
Logotipo=\\SERVIDOR\SISCOM\logo.bmp
Exe=SISCOM.EXE
App=\\SERVIDOR\SISCOM\siscom.exe
Cliente=NOMECLIENTE
Caixa=1
EmpCaixa=1
[AUTOLOGIN]
USUARIO=
PASSWORD=

3.4 O que é automático na estação

• A cada abertura, o SisCom compara fbclient.dll e gds32.dll com as do servidor (pasta do campo App) e copia a versão do servidor se forem diferentes.
• O Atualizador.exe da estação — aberto pelo atalho da área de trabalho — é quem atualiza o SisCom.exe local a partir do servidor antes de abrir o sistema.
• As subpastas (LOG\, GRID\, PDF\, NFe\...) são criadas localmente na primeira execução.
• Atualizações de versão não são executadas na estação: ao detectar versão nova, o SisCom avisa que a atualização deve ser feita apenas no servidor.

3.5 Checklist da estação

• \\SERVIDOR\SISCOM abre normalmente a partir da estação.
• Pasta local criada com SisCom.exe, Atualizador.exe, DLLs, CONFIG.INI e logo.bmp.
• CaminhoBase com nome/IP do servidor + caminho local do .FDB no servidor.
• Logotipo e App apontando para \\SERVIDOR\SISCOM\.
• Atalho da área de trabalho criado para o Atualizador.exe (não para o SisCom.exe).
• SisCom abriu pelo atalho e permitiu login.

4. Configurações iniciais

Resumo do que será configurado:

4.1 Dados da empresa

1. Abrir a tela de empresas Menu Configurações → Empresa (tela SisCom - Configurações).
2. Entrar em edição Selecione a empresa na lista e clique em Alterar (F3). Para cadastrar uma empresa adicional, use Novo (F2).
3. Preencher a aba "Dados da Empresa" Razão Social, Nome Fantasia, CPF/CNPJ, Insc. Estadual, Insc. Municipal, CNAE Fiscal, Telefone, e-Mail, Endereço, Nr., Bairro, Cep, Cidade e UF. Os dados devem ser idênticos aos do cadastro na SEFAZ, pois são enviados nos documentos fiscais.
4. Informar o logotipo para relatórios No campo Caminho do logo para relatórios (.bmp .jpg .png) use o caminho da pasta compartilhada: \\SERVIDOR\SISCOM\logo.bmp.
5. Gravar Clique em Gravar (F4). O código da empresa aparece no canto do quadro (001 para a primeira) — é esse código que define o nome do arquivo do certificado na seção 4.2.

4.2 Dados fiscais e certificado digital (por empresa)

Na mesma tela (Configurações → Empresa), com a empresa em Alterar (F3). Repita para cada empresa que emite documento fiscal. As configurações de nota de serviço (grupo Nota Fiscal de Serviços e aba NFS-e) não fazem parte deste manual.

a) Aba "Dados Fiscais" — grupo "Nota Fiscal de Produtos"

b) Aba "NF-e / CT-e" — grupo "NF-e"

• Marque Emite NFe e confira Cód. IBGE Cidade e Cód. IBGE Estado.
• Para NFC-e (modelo 65): preencha TOKEN NFC-e e ID TOKEN com o CSC (Código de Segurança do Contribuinte) e o seu identificador. O CSC deve ser obtido pelo cliente/contador no portal e-CAC ou equivalente da SEFAZ do estado. Sem o CSC não é possível emitir NFC-e.

c) Aba "Certificado Digital"

O SisCom pode consumir o certificado de duas formas:

Forma 1 — arquivo na pasta compartilhada (padrão das instalações):

1. Copiar o certificado para a pasta compartilhada Copie o arquivo do certificado A1 (.pfx) para \\SERVIDOR\SISCOM\CERTIFICADOS\, renomeando-o conforme o código da empresa:

   \\SERVIDOR\SISCOM\CERTIFICADOS\
   ├── empresa1.pfx    ← empresa de código 1
   ├── empresa2.pfx    ← empresa de código 2
   └── ...

2. Informar o arquivo No campo Localização do Arquivo (somente A1), informe o caminho pela pasta compartilhada: \\SERVIDOR\SISCOM\CERTIFICADOS\empresa1.pfx (o botão ao lado abre a seleção de arquivo).
3. Informar a senha e a validade Digite a Senha do certificado (obrigatória nesta forma) e a data de Validade.
4. Gravar e testar Clique em Gravar (F4) e depois em Verificar situação web server. O retorno 107 - Serviço em Operação indica que o certificado foi configurado com êxito no sistema. O teste só funciona depois de gravar — antes disso o sistema avisa "Salvar dados antes de continuar!".

Forma 2 — certificado instalado no Windows:

1. Instalar o certificado no Windows Instale o certificado em cada máquina que for emitir documento fiscal — o servidor e cada estação.
2. Selecionar o certificado Na aba Certificado Digital, clique no botão ao lado de Número de Série. O sistema lista os certificados válidos instalados no Windows (Núm. Série, Razão Social, CNPJ, Validade, Certificadora); selecione o da empresa.
3. Gravar e testar Gravar (F4) e Verificar situação web server — retorno esperado 107 - Serviço em Operação. Repita o teste em cada estação que for emitir.

4.3 Parâmetros da NF-e / NFC-e

Abra Configurações → Parâmetros NFe / CTe (tela SisCom - Parâmetros da NFe). A mesma tela também abre pelo botão Parâmetros de configuração da NF-e / CT-e, na aba Certificado Digital da empresa. Selecione a EMPRESA no topo da tela — os parâmetros são por empresa.

Na aba principal NF-E, configure as sub-abas abaixo:

Ao terminar, clique em OK para gravar. Os demais campos (mensagens, opções de impressão, logotipo do DANFE, ICMS desonerado etc.) são ajustados conforme a necessidade de cada cliente.

4.4 Checklist das configurações

• Dados da empresa preenchidos e conferidos com o cadastro da SEFAZ.
• Logo para relatórios apontando para \\SERVIDOR\SISCOM\logo.bmp.
• Nr. da 1ª Nota, Série NF-e (55) e Série NFC-e (65) confirmados com o cliente/contador.
• Certificado em \\SERVIDOR\SISCOM\CERTIFICADOS\empresaN.pfx, com caminho, senha e validade informados (ou, na forma 2, instalado no Windows de cada máquina emissora e selecionado pelo Número de Série).
• Verificar situação web server retornou 107 - Serviço em Operação.
• Repositório NFe = \\SERVIDOR\SISCOM\NFe\.
• Versão XML = 4.00.
• Licença NFe (ACBR) preenchida com o token fornecido pelo administrador MemoriaInfo.
• TimeOut = 30000 e SSLType = TLS1_2.
• Se emite NFC-e: série própria definida e CSC (TOKEN NFC-e / ID TOKEN) informado.

5. Atualização

Uma atualização tem duas partes: o banco de dados (scripts) e o executável (SisCom.exe). Os scripts são sempre rodados antes de trocar o executável. Nem toda atualização tem script para rodar — nesse caso, apenas o SisCom.exe é substituído.

5.1 Pré-requisito

IBExpert instalado no servidor. É o SGBD utilizado para gerenciar o banco de dados do cliente — com ele se consulta a versão do banco e se executam os scripts.

5.2 Recomendações antes de atualizar

1. Avisar o cliente Informe que será feita a atualização e que o sistema ficará indisponível durante o procedimento. Peça para todos os usuários fecharem o SisCom.
2. Reiniciar o serviço do Firebird Garante que nenhum cliente esteja acessando o banco de dados. Em services.msc, reinicie o serviço Firebird Server - DefaultInstance, ou pelo Prompt de Comando como administrador:

   net stop FirebirdServerDefaultInstance
   net start FirebirdServerDefaultInstance

3. Criar cópia do banco de dados Com o banco sem conexões, copie o arquivo .FDB da pasta Dados\ com outro nome (ex.: NOMECLIENTE_AAAAMMDD.FDB). Confira se há espaço em disco suficiente antes de copiar.
4. Criar cópia do SisCom.exe atual Na pasta Programas\, copie o SisCom.exe em uso (ex.: SisCom_AAAAMMDD.exe), para poder voltar à versão anterior se necessário.

5.3 Passo a passo

1. Verificar a versão do banco do cliente No IBExpert (no servidor), conecte no banco do cliente e consulte a tabela TAB_BANCO_DADOS, coluna BD_VERSAO. Ela contém o número do último script que foi rodado neste banco.

   SELECT BD_VERSAO, BD_ATUALIZACAO FROM TAB_BANCO_DADOS;

2. Verificar o último script disponível Abra \\192.168.0.215\docs - scripts\ e veja qual é o script de maior número. Os scripts são arquivos .txt cujo nome é o número da versão.
3. Rodar os scripts faltantes, em ordem Rode no IBExpert (Tools → Script Executive) todos os scripts com número maior que o BD_VERSAO do cliente, um a um, em ordem crescente, sem pular nenhum. Exemplo: banco em 1605 e último script 1608 → rodar 1606, 1607 e 1608. Confirme (commit) cada script. Se um script der erro, pare e não siga para o próximo — acione o desenvolvimento.
4. Conferir a versão do banco Repita a consulta do passo 1: o BD_VERSAO deve ser o número do último script rodado. Cada script atualiza esse campo sozinho, na última linha — não é preciso alterá-lo à mão.
5. Atualizar o SisCom.exe Copie o SisCom.exe de \\192.168.0.215\MemoriaPROD\SisComInd\ para a pasta Programas\ do servidor, substituindo o antigo. O SisCom precisa estar fechado no servidor.
6. Testar Abra o SisCom no servidor, faça login e confira as rotinas principais do cliente. Depois abra uma estação pelo atalho do Atualizador.exe e confirme que ela recebeu a versão nova.

5.4 Checklist da atualização

• Cliente avisado e usuários fora do sistema.
• Serviço do Firebird reiniciado.
• Cópia do .FDB criada.
• Cópia do SisCom.exe atual criada.
• BD_VERSAO consultado e comparado com o último script de \\192.168.0.215\docs - scripts\.
• Scripts faltantes rodados em ordem, sem erro (ou confirmado que não havia script).
• BD_VERSAO conferido após os scripts.
• SisCom.exe substituído na pasta Programas\ do servidor.
• SisCom testado no servidor e em uma estação.
• Cliente avisado de que o sistema está liberado.

6. Referência do CONFIG.INI

Seção [CONFIGURACAO]

Seção [AUTOLOGIN]

7. Problemas comuns