1. Obtenção Material de Instalação

Linx Share

O Linx Share é um portal desenvolvido pela Linx com o objetivo de documentar seus sistemas e fornecer suporte tanto a colaboradores quanto a clientes no processo de aprendizagem das soluções de diversas verticais. No portal, também é possível encontrar informações sobre pré-requisitos de hardware e uma lista de equipamentos homologados e compatíveis com nossos sistemas.
Link de Acesso: https://share.linx.com.br.

Priv

O Priv foi criado para centralizar os Softwares necessários para a Implantação do sistema Emsys3.
Link de Acesso: http://priv.rezendesistemas.com.br
Link de Acesso: Linx Postos - EMSys

Download Identificador: 

2. Requisitos de Configurações

• Computadores PDV

Memória Ram: 8GB;
HD: 500GB;
Processador: Core i5 3.5GHz
2 Portas Seriais (COM)
6 Portas USB
Sistema Operacional: Windows 7 ou superior

• Computadores para Retaguarda 

Memória Ram: 8GB;
HD: 500GB;
Processador: Core i5 3.5GHz
2 Portas Seriais (COM)
6 Portas USB
Sistema Operacional: Windows 7 ou superior

• Servidor de Aplicação e Banco de dados 

Até 2 PDVs e 4 Retaguardas
Processador Core i5
8 GB Memória RAM
1 HD 500GB

• Até 3 PDVs e 5 Retaguardas

Processador Core i7
16 GB Memória RAM
1 HD 1TB

• Até 8 PDVs e 6 Retaguardas 

Processador Xeon E3
16 GB memória RAM
1 HD 1TB

• Sistema Operacional para o Servidor de Aplicação e Banco de Dados 

EMsys3 
Windows 2003 R2 ou superior
Windows 7 Professional 64bits ou superior
Windows Server 2012

3. Sistemas de Gerenciamento de Banco de Dados e Organograma

• Firebird versão: 3.0
• PostgresSQL versão: 9.2 à 9.6.8-1
• ODBC versão: 9.3.400.0

4. Liberação de Módulos do Sistema

Para liberação de módulos do EMSys3 você precisa do identificador.exe com ele você consegue coletar o ID da máquina e solicitar à Linx que libere com os seguinte dados do projeto:

OP:
CNPJ:
ESCOPO: (pista, loja, pista e loja)
MÓDULOS: (o que deseja que seja liberado?)
Exemplo: Liberar Emsys3 + Módulos: GasStation, EMsysFiscal e TacGas3.
Se a base for hospedada na Linx informar o nome da Base.
IDs: Enviar ID’s de todas as máquinas.
E-mail de liberação de Módulos: [email protected]

Links para Coletar CHAVE de Licença por ID:  

Link download Identificador: http://priv.rezendesistemas.com.br/ferramentas/diversos/
Link para Coletar CHAVE de Licença por ID: http://www.rezendesistemas.com.br/public_html/aplicativos/licencaonline/

5. Instalação do PostgreSQL e Banco de Dados Local

Neste capítulo, abordaremos como instalar o PostgreSQL e como criar o Banco de Dados Local do EMSys3, tanto de forma automática quanto manual. Será necessário instalar o banco de dados somente na máquina Servidor Local, para isso, utilize o instalador: "LinxPostos-PostgreSQL_Server-9.6.8-1.exe". Este instalador inclui o PostgreSQL, o banco de dados do EMSys3, além de criar automaticamente o usuário e a senha do banco. Para mais detalhes, consulte o manual disponível nos links abaixo.

Links Instaladores: 

Link Instalador: http://priv.rezendesistemas.com.br/servicos/Instaladores/PostgreSQL/
Ou utilizar a versão 9.6 do Postgres (Versão homologada). Link: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads#windows

Após a instalação do Postgres abra o Windows Explorer e navegue até o diretório C:\PostgreSQL9.6\data. Localize e exclua o arquivo pg_hba.conf, pois o instalador automático pode ter criado uma configuração inadequada. Renomeie pg_hba_original.conf para pg_hba.conf.

Edite o arquivo da seguinte forma:

Encontre as 2 linhas abaixo
# IPv6 local connections:
host       all           all    ::1/128      md5
host       all           all   0/0            md5    (Adicionar essa linha, pois ela não existe no arquivo).
# Essa ultima linha (permitirá conexões externas).
“#” - Este significa linha comentário, sem efeito para configuração.

Reiniciar o serviço do PostgresSQL para as alterações sejam aplicadas.

5.1. Criação e Restauração de Banco de Dados Manual

Para instalar o PostgreSQL, utilize o instalador automático e selecione a opção “Somente Servidor PostgreSQL - sem database”, garantindo que apenas o PostgreSQL seja instalado, sem base de dados inicial. A base de dados será criada manualmente a partir de um arquivo.dump.
As bases de dados pré-configuradas do EMSys3 estão disponíveis no link  http://priv.rezendesistemas.com.br/servicos/Bases%20Implantacao/EMSys3/
Na pastas, você encontrará três tipos de bases: Lucro Real, Lucro Presumido e Simples Nacional. Selecione a base de dados de acordo com o regime fiscal da empresa do cliente. Salve o arquivo do banco de dados na pasta: C:\PostgreSQL\9.6\bin. Renomeie o arquivo baixado para um nome simples de digitar no CMD.

5.1.1 Criação de Banco de Dados

           No CMD do Windows acesse o diretório C:\PostgreSQL\9.6\bin e execute o comando:

• CREATEDB -U postgres -E LATIN1 -T template0 nome_do_banco
• Senha do Banco: pgsq1@Rez

Exemplo: Abaixo está sendo criado o emsys_teste. 

Após digitar a senha o banco será criado e será exibido novamente o diretório C:\PostgreSQL\9.6\bin. Para conferir se o banco realmente foi criado executar os comandos:

• 1. psql –U postgres –h localhost
• 2. \list ou \l

Na lista dos bancos de dados observe que o “emsys_teste” foi criado é o segundo da lista.
O Banco foi criado, mas ele ainda está vazio esperando a base ser restaurada. Digite o comando: \q para sair do programa psql. Será exibido novamente o diretório C:\PostgreSQL\9.6\bin.

5.1.2 Restauração do Banco de Dados

Método 1 de Restauração de Backup

Para facilitar a restauração do banco de dados, renomeie o arquivo “emsys3_selcon_lucroreal_11-01-2018.dump” para “emsys_teste.dump”. Isso evitará que você precise digitar o nome completo no CMD, como mostrado na imagem abaixo.

           No CMD do Windows, acesse o diretório onde o arquivo do banco foi salvo: C:\PostgreSQL\9.6\bin e execute o seguinte comando para restaurar o backup:

• Senha do banco: pgsq1@Rez

Método 2 de Restauração de Backup

Este método é utilizado quando o backup foi realizado em formatos de customização, como custom, tar ou plain text. Ele é ideal para restaurar bases de dados que estavam hospedadas na Linx e que serão migradas para um ambiente local.
No CMD diretório: C:\PostgreSQL\9.6\bin> comando:

• pg_restore -v -U postgres -d nome_do_banco < C:\caminho\nome_do_buckup.dump

Método 3 de Restauração de Backup

No CMD diretório: C:\PostgreSQL\9.6\bin> comando:

• psql -f dump.sql nome_banco usuario_do_banco

5.2. Criação de Backup Manual do Banco de Dados

No CMD diretório: C:\PostgreSQL\9.6\bin> comando:

• pg_dump -v -U postgres nomedobanco > c:\local_do_backup\nome_do_banco.dump

5.3. Permissão de Usuário

grant usage on schema public to user;
grant select, insert, update, delete on all tables in schema public to user;
grant usage, select, update on all sequences in schema public to user;
grant execute on all functions in schema public to user;

grant usage on schema session_variables to user;
grant select, insert, update, delete on all tables in schema session_variables to user;
grant usage, select, update on all sequences in schema session_variables to user;
grant execute on all functions in schema session_variables to user;

Obs: Substitua "user" pelo nome do usuario do banco Banco do EMSys que deseja liberar as permissões e aplique o Script no “pgAdmin4.exe” na pasta:

C:\PostgreSQL\9.6\pgAdmin 4\bin

Exemplo da primeira linha: grant usage on schema public to emsys3;

6. Instalação do EMSys3 e Integração com Firebird

6.1. Instalação EMSys

Para instalar o EMSys3, basta executar o arquivo “Instalar_EMSys3.05.21.760_Full.exe” como Administrador, este instalador oferece duas opções: 

      1. Instalação Completa: Inclui o Firebird 3.0, BDE e ODBC.
      2. Instalação Somente EMSys3: Instala apenas o EMSys3, sem Firebird, BDE ou ODBC (geralmente usada para reinstalações).
      3. Link Instalador Emsys: http://priv.rezendesistemas.com.br/servicos/Instaladores/EMSys3/

• Usuário: tarcisio.souza
• Senha: l1n32019

 Ou, utilize o pacote disponibilizado pela Linx.

6.2. Instalação Firebird 3.0

           Execute como Administrador a instalação do Firebird 3.0. A Linx disponibilizará um pacote contendo o instalador e pastas que deverão ser substituídas nos próximos passos.

       1. Siga "NEXT, NEXT, NEXT" até chegar à tela indicada a seguir. 
       2. Marque a penúltima opção e clique em "NEXT", conforme mostrado na imagem.
       3. Na próxima tela, informe a senha do banco de dados: masterkey.
       4. Conclua a instalação e prossiga com os próximos passos.  

 5. Após a instalação, verificar se a pasta Firebird possui acesso do Windows para edição, caso não tenha faça a liberação. Pois irá precisar para alterar o arquivo firebird.conf;

6. No pacote disponibilizado pela Linx citado anteriormente terá uma pasta do Firebird 3.0 e dentro dela uma pasta “UDF” que após a instalação do Firebird 3.0 deverá ser substituída pela original da instalação.

 7. Na pasta do pacote disponibilizado pela Linx copie o arquivo Firebird e substitua pelo arquivo original da instalação do Firebird.
 8. Nos serviços do Windows reinicie o serviço do Firebird (Conforme o print abaixo).

7. Liberação de portas no Firewall

     Realize a liberação da porta 3050 do Firebird no Firewall do Windows para não precisar desabilitar o Firewall do Windows

1. Etapa "Configurações Avançadas":     

    Abra o painel de controle: Firewall do Windows Configurações Avançadas.

2. Etapa "Tipo de Regra":     

1. Clique em Regras de Entrada.
2. Clique em Nova Regra
3. Marque a opção Porta.
4. Clique em Avançar.

 3. Etapa "Protocolo e Portas":

 1. No campo Portas locais específicos digite: 3050.
 2. Clique em Avançar.

4. Etapa "Ação":

    Nessa tela selecione Permitir Conexão e clique em Avançar.

 5. Etapa "Perfil":         

    Nessa tela clique em Avançar.

   6. Etapa "Nome":

   1. No Campo nome digite: Firebird.
   2. Clique em Concluir. 

8. Acesso e Configuração do Banco de Dados Local 

    A configuração do banco é feita no primeiro acesso ao Emsys após ter feito todos os passos anteriores desse manual.

1. Na área de trabalho clique no ícone do Emsys3:

2. No campo do banco de dados, que está em branco, e clique no ícone de engrenagem ao lado, para configurar o Banco Local

    Na tela que da imagem abaixo, insira o caminho do banco de dados, nome, usuário e senha e clique em "Conectar" para finalizar a configuração.

    3. Incluir os dados no Configurador de Alias, siga os passos da imagem abaixo:

    1. Alias: “apelido” do banco de dados, caso tenha mais de um, por exemplo, você pode renomear um banco de dados para "Emsys - Produção" e outro para "Emsys - Homologação" para diferenciá-los facilmente.
    2. Banco: Digite o nome do banco de dados.
    3. Usuário: Digite o usuário do banco de dados
    4. Servidor: Digite o IP do servidor
    5. Porta: Digite a porta do postgres.
    6. Senha: Digite a senha do banco de dados.
    7. Testar conexão: Como o próprio nome diz testar conexão com o banco.
    8. Botão ok: Clique em Ok para gravar a configuração do banco.

4. Alterações caso seja necessário:

• Editar: Permite modificar os dados da conexão do banco de dados se houver alterações.
• Excluir: Remove uma conexão de banco de dados existente.
• Utiliza Conexão da Licença: Por padrão, está configurado como SIM. Para um banco de dados local, altere para NÃO.

9. Acesso do Banco de Dados Hospedado 

O banco de dados é hospedado pela Linx, não necessita de configuração manual. Após a instalação do Firebird, conforme descrito neste manual, estará pronto para acessar diretamente o banco de dados do cliente.
O PMO responsável providenciará a licença de software vinculada ao CNPJ do cliente. Após instalar o EMSys e o Firebird, simplesmente, abra o EMSys para acessar o banco de dados do cliente, desde que as configurações tenham sido seguidas conforme os passos indicados anteriormente.

Na área de trabalho clique no ícone do Emsys3:

 O banco de dados já vem configurado com o nome da Rede ou do posto, como por exemplo, "Rede SELECT".

10. Apresentação dos Ícones das telas do Emsys

Abaixo seguem ícones das (telas) específicos para cada operação, ou seja, para incluir registros, salvar registros já inclusos, pesquisar registros já inclusos, dentre outros.

11. Atualização de Módulos GasStation e Fiscal

1. Para atualizar os módulos GasStation e Fiscal. Acesse o Menu: Módulos Adicionais e Selecione o Módulo.
2. Clique no Módulo que deseja Atualizar e clique em “Yes”.
3. Aparecerá a tela de Atualização, clique em cima do número da versão e depois em Obter Atualização.

12. Cadastros de Empresas 

Ao realizar a implantação do posto e/ou loja, o analista implantador irá receber um documento “EM015 - Pré-Requisitos para Implantação.docx” preenchido pelo cliente, neste irá constar as informações da empresa a ser implantada.

12.1. Menu: Sistema Empresa(s)

Aba Principal

• Código: O Código é preenchido automaticamente.
• Número: Se a implantação for de alguma CNPJ franqueado a uma Distribuidora, este campo serve para informar o código de registro de loja junto a mesma (IBM, ZBMR ou PV)
• Demais campos a serem preenchidos são: CNPJ, IE, Endereço, Bairro, CEP, Cidade Clicar no Disquete azul para salvar as informações preenchidas.

Aba Tributação

Campos com preenchimento necessário:

• Regimes débito e crédito: Conforme check list preenchido pelo cliente.
• Cod. ANP de Atividade Econômica: 4731800
• Contador: Cadastrar no Cadastro de PESSOA.

Sub Aba - Sped PIS / COFINS:

• Preencher de acordo com o Check List dúvidas consultar o cliente e ou seu contador. (Exemplo Imagem abaixo).

Aba Faturamento

Sub Aba - Outros:

• Campos: Almoxarifado de Venda e os 2 modelos de documento Fiscais já vem preenchidos por default.
• Representante Padrão: Cadastrar o Posto ou Loja no cadastro de Pessoas e marcar Rep. Com. (representante comercial e Funcionário). Necessário para ratear as sobras de Caixas.

Cadastro Contador e Representante Comercial

• Contador: Pedir para o cliente preencher as informações obrigatórias da aba Principal e em Classificação marcar Contador.
• Na Aba Contador do Cadastro de Pessoa: adicionar o CRC e o CNPJ.
• Cadastro da Empresa aba: Tributação → Outros.

• Representante Comercial: No cadastro de Pessoas preencha a aba principal com os dados do Posto ou Loja.
• Em classificação: Marcar as opções Rep. Com. e Funcionário.
• Esse cadastro também servirá para que as diferenças de caixa positivas sejam rateadas para o Posto no fechamento de caixa.
• Após cadastrar adicionar no cadastro da empresa na aba: Faturamento →  Outros →  Representante Padrão e salvar no Disquete azul.

13. Cadastro de Mapa de Pista

O Mapa de pista é informado pelo cliente no documento “EM015 - Pré-Requisitos para Implantação.docx”, no final do documento. Caso não esteja preenchido solicitar ao cliente que preencha ou que passe a informação de alguma outra maneira.

13.1. Cadastro de PDV: Menu → PDV → PDV.

Aba Geral

• Descrição: Não há um padrão obrigatório para a descrição. A imagem abaixo ilustra um exemplo de descrição, que pode incluir informações como o número do PDV, o tipo de ponto de venda (Pista ou Loja) e, neste caso, especificar se o sistema é um SAT.
• Almox. Venda: Escolher o Almoxarifado. Alguns clientes criam almoxarifados 1 para Pista e 1 para Loja para controle por almoxarifado.
• Nome Host: Nome da máquina ou se o PDV for AutoSystem digitar a conta caixa.
• Alias: Alias criado no ConfigAlias para o PDV ex: Tacgas3.
• Nº Fabricação: Existem 3 tipos de preenchimento. Que será de acordo com o emissor de cupom do estado.
• ECF: Em estados que ainda utilizam ECF (emissor de cupom fiscal) informe o número de série sem espaços. 
  • O número de série é encontrado na Leitura X na parte inferior. O número é único por ECF (exemplo Nº de série do ECF Bematech: BE09131010001132452).

• SAT / CFe: Caso o estado utilize SAT / CFe.
  PDV1 - “MATRIC1” (sem aspas) nome genérico definido pelo time de implantação.
  PDV2 – “MATRIC2” (sem aspas).
  PDV3 - “MATRIC3” (sem aspas)... e assim sucessivamente.

• NFCe: Se o estado utiliza NFCe utilizar o nome genérico:
  PDV1 - “NFCE1” (sem aspas).
  PDV2 - “NFCE2” (sem aspas) e assim sucessivamente.

• Nº Caixa: Para PDV1 001, PDV2 002, seguir sequencia para demais PDV’s.
• Franquia: Preencher de acordo com a Franquia ou Outros para Bandeira Branca.
• Tipo de PDV: Marque o PDV que será utilizado.
• PDV SAT: Marcar check box apenas se o estado utilizar SA

Aba Formas de pagamento

Nesta aba é possível determinar quais formas de pagamento podem ser liberadas por ponto de venda. Esta função facilita quem trabalha com dois PDV's, podendo delimitar por exemplo todos os pagamentos a vista no PDV1 e os pagamentos a prazo no PDV2.

As formas de pagamento recém cadastradas ficam na parte superior “Formas de pagamento Disponíveis” para liberar utilize as setas no centro da tela:

1. Clique na seta para liberar todas as formas de pagamentos para o PDV.
2. Clique na seta para liberar todas a forma de pagamento selecionada para o PDV.
3. Clique na seta para remover todas a forma de pagamento selecionada para o PDV.
4. Clique na seta para remover todas as formas de pagamentos para o PDV.

Aba Grupo Item

Como na Aba Geral se delimita apenas um Grupo de Itens a vender no PDV, nesta aba é possível adicionar mais grupos de itens. Com esta delimitação, todos os itens que não compõe o Grupo, não estarão disponíveis para venda no PDV.

Exemplo: O cliente pode utilizar o Tacgas3 na pista e na Loja de conveniência, mas ele não quer que os combustíveis apareçam no PDV da LOJA. Então para o PDV da Loja delimita apenas os grupos de itens que são correspondentes a LOJA.

13.2. Cadastro de Produtos Menu: Estoque → Item → Item

O Cadastro dos combustíveis é necessário para cadastrar os Tanques de combustíveis por esse motivo vamos ver nesse momento do treinamento. É nessa tela também que se cadastrar os demais produtos.

Cadastros Sub-Categoria, Categoria e Grupo

• As bases comuns não vem com sub-categorias cadastradas, mas é essencial para cadastrar um produto. Para realizar o cadastro realizar a cadeia abaixo:
• Cadastrar Grupo no Menu: Estoque → Item → Grupo
• Cadastrar Categoria no Menu: Estoque → Item → Categoria
• Cadastrar Sub-categoria no Menu: Estoque → Item → Sub-Categoria
• Para Sub-categorias os campos obrigatórios a serem preenchidos são: Descrição, Categoria, Grupo e para finalizar o cadastro clicar no “+” verde.

Cadastro de Produto Aba Principal

Nesta tela é realizado o registro inicial do item como descrição, unidade, descrição auxiliar (opcional), subcategoria (obrigatoriamente) e a definição do "Tipo do Item" como: produto, serviço, entre outros.

Aba Complemento

Campos obrigatórios para CFe e NFCe, caso esses campos não sejam preenchidos apresentará erros no PDV.

• Tipo de Combustível: Vai de acordo com o combustível, mas para Gasolina comum é o 10 – Gasolina C.
• Item ANP: Também vai de acordo com o combustível que está sendo cadastrado.
• Solicita Vendedor: Essa Flag é necessária para itens Comissionados seja para combustíveis ou produtos de loja comissionados

Aba Características e aba ECF

• Características: Decimais. Preencher com 3 para combustíveis devido as casas decimais.
• ECF: Preencher todos os campos, a parte de tributação deve ser preenchida pelo contador da empresa do cliente.

Aba Preços

• Preço A: Digitar o valor do produto.
• Início da Validade: Digitar a data do cadastro e em seguida clicar no + verde para incluir o preço ao produto. Não esquecer de salvar o cadastro no Disquete caso seja uma alteração.

Aba Faturamento

• Faturamento:
  Responsável pelos movimentos fiscais das notas de entrada e saída, impactando o cálculo de impostos (crédito e débito) por Estado. Essas informações alimentam os livros fiscais.
  A classe de comissão dos produtos também é definida aqui e pode ser ajustada para todos os itens no Otimizador de Cadastro.
• Para cadastrar a classe de comissão:
  Menu: Vendas → Comercial → Comissionamento → Classe de Comissão.

A tributação é tão importante quanto o faturamento na apuração fiscal, mas é fundamental distinguir entre os diferentes tipos de impostos e suas aplicações. Essa diferenciação é crucial para garantir a conformidade e a otimização fiscal.

Aba Fiscal NCM

O NCM é utilizado pelo cadastro do item para atender as transações da NF-e, NFC-e, RPS e SAT (CFe). Para todos os Estados que utilizem alguma das modalidades de venda descritas, devem ter o NCM relacionado ao item obrigatoriamente. 

Cadastro de NCM

Os NCM’s de combustíveis não vem cadastrados para cadastrar acessar o Menu: Fiscal → NCM.

13.3. Cadastro de Almoxarifado

O cadastro de almoxarifado consiste em informar ao sistema o local onde os produtos receberão os lançamentos de movimentação de estoque.

Acesse: Estoque →  Almoxarifado → Almoxarifado.

• Código: Gerado automaticamente pelo sistema no momento do cadastro.
• Descrição: Informe a descrição do Almoxarifado, como por exemplo: Almoxarifado Central, Almoxarifado Pista, Almoxarifado Loja.
• Código de Posse: Define a utilização do Almoxarifado para controle de estoque dos itens.
• Pessoa: Ao utilizar o código de posse 2, informe a pessoa que está em posse da mercadoria. Este código identifica o proprietário dos itens no estoque.
• Tanques de Combustível: Define se o Almoxarifado é um tanque de combustível. As próximas etapas são exclusivas para Almoxarifados em Postos de Combustíveis e/ou Distribuidoras.
• Nº Tanque LMC: Número referente ao tanque no Livro de Movimentação de Combustíveis (LMC).
• Nº Lógico: Usado na integração do EMSys com medidores de tanque, este campo registra o número lógico fornecido pelo equipamento medidor.
• Item de Combustível: Adicione o item combustível correspondente.
• Tipo de Combustível: Selecione o tipo de combustível.
• Capacidade: Determine a capacidade do tanque.
• Lastro: Defina o lastro do tanque, de acordo com sua capacidade.
• Ativação: Defina a data de ativação do tanque, podendo ser a mesma data de cadastro.
• Desativação: Ao desativar um tanque de combustível, informe a data de desativação. Observação: A desativação do almoxarifado só é permitida se não houver saldo de estoque. Certifique-se de que todo o estoque foi baixado antes de realizar a desativação.

13.4. Cadastro de Bombas de combustível

O cadastro de bombas é realizado no módulo GasStation do EMSys3.

Caminho no Sistema:

• Menu: Módulos → Adicionais →  Selecionar Módulos →  GasStation.
• No GasStation, acessar: PDV →  Bomba de Combustível.
• Aba Principal (preenchimento obrigatório): Série, Fabricante, Modelo e Tipo de Medição
• Aba Lacre: Digite o lacre informado pelo cliente no check-list.

13.5. Cadastro de Bicos de combustível

O Cadastro de Bico é feito no Módulo GasStation.

Acesse: PDV → Bomba de Combustível.