====== Manual de Instalação ======
===== Requisitos Mínimos =====
Sistema Operacional
Windows 7 SP1
Processador
Dual Core ou Intel Core i3(4ª Geração)
Memória
4 Gbytes
Conexão
2 Mbps por computador
USB
4 portas
Disco Rígido
HD de 40 Gbytes
Vídeo
Resolução de 1024x768 pixels
Atualizado dia 05/07/2023.
===== Considerações iniciais =====
O EasyCash é um sistema de frente de caixa que deve ser instalado conforme as instruções deste manual.
Apartir da versão 1.0.5000.13 foi reformulada a representação de versão do EasyCash, sendo que neste caso, a próxima versão foi a 1.1.002.000
Quando for instalar pela primeira vez o sistema de frente de caixa, você irá receber dois instaladores da versão mais atual, sendo um referente a plataforma do Windows 32 bits e 64 bits. Portanto verifique qual é o tipo do sistema operacional que você utiliza. As diferentes versões são apenas por conta das dll's utilizadas, a estrutura criada será a mesma.
O frente de caixa EasyCash trabalha integrando com a retaguarda Intellicash que deverá estar atualizado para a versão mínima 3.0.137.000 (Firebird 2.5) por isso iremos também mostrar algumas configurações necessárias na retaguarda.
Para a versão 1.0.5000.012 é obrigatório que o IntelliCash seja atualizado para a versão 1.0.137.012
Primeiramente precisamos definir o local onde serão armazenados os arquivos de atualização. Por padrão determinamos como local o servidor e neste endereço criamos uma pasta denominada BIN no diretório C. É obrigatório compartilhar essa pasta na rede para que todos os caixas possam ter acesso. É preciso configurar no Intellicash o caminho desta pasta criada na configuração "Caminho EasyCash" e a senha do Firebird na configuração "Senha Firebird Frente Caixa", estas são utilizadas para importação e para atualização dos caixas. Estas configurações são encontradas no caminho:
Intellicash → Gerenciamento → Configuração → Outras Configurações
Sendo as configurações de número **9102** e **9202** que podem ser vistas na imagem abaixo.
{{ :easycash:senha_firebird.png?nolink |}}
Configurações do Intellicash
Quando o sistema de Frente de Caixa é executado pela primeira vez será buscada nesse local e inserida no caixa(diretório IwUtils) os arquivos necessários para funcionamento do sistema(DLL e EcUpdater). Caso esse caminho não seja corretamente informado ou compartilhado não será possível abrir o sistema de frente de caixa ou não conseguirá ser atualizado.
Esse caminho será informado na instalação do EasyCash no tópico abaixo.
Definido e compartilhado o local temos também que informar na tabela ECFS qual o endereço IP(campo IP) de cada caixa e o aliases do seu banco de frente de caixa(campo PASTA) correspondente aquele IP, conforme ilustramos na imagem abaixo:
{{ :easycash:easycash_instalacao:tabela_ecfs.jpg |}}
Tabela ECFS
Assim todos os dados da retaguarda serão exportados para o frente de caixa, mas para que isso ocorra é necessário alterar o campo Ativo igual a 1 do registro Intelliware da tabela PDVSYS. Como mostra a figura abaixo.
{{ :easycash:easycash_instalacao:figura_1..jpg |}}
Tabela PDVSYS
Mais detalhes sobre exportação e as configurações verificar o Manual de Instruções do EasyCash.
Instalador selecionado execute-o seguindo os passos que iremos descrever no próximo capítulo desse manual.
===== Instalação do EasyCash =====
O passo a passo da instalação está descrito abaixo de acordo com instalador da versão 1.3.004.000.
Assim que executado o instalador clique em //“Avançar”//, porém atenção, é recomendado que esteja fechado todos os aplicativos antes de continuar a instalação.
{{ :easycash:instalacao1_1.3.4.0.png?nolink |}}
Tela Principal
Ao avançar será mostrado o local padrão onde é instalado, caso queira que seja em outro lugar selecione o desejado.
{{ :easycash:instalacao2.png?nolink |}}
Local da Instalação
Escolha o tipo de instalação que será realizada para que sejam adicionadas as configurações no arquivo 'EasyCash1.ini'.
{{ :easycash:instalacao3.png?nolink |}}
Tipo de Instalação
Configure os dados do ECF, o sinal de gaveta do sistema e ainda informar se o ponto emitirá ou não DAV e Pré-Venda. Segue:
* **Porta:** Porta onde está conectada impressora fiscal. Essa porta pode ser visualizada no gerenciador de dispositivos do Windows;
*** Modelo:** Modelo da impressora que está conectada;
* **TimeOut = 30:** Indica o tempo que o ECF leva para responder a um comando em milesegundos;
* **Intervalo = 100:** Intervalo de tempo em millisegundos que o ECF leva para receber um comando;
* **Sinal de Gaveta:** Essa opção informa qual será o sinal da gaveta para abertura. Se marcada, você está informando que o sinal será True, se não, False. Como o sinal da gaveta varia de acordo com a impressora fiscal, sugerimos por padrão sempre marcar essa opção, logo se a gaveta não abrir após a instalação com o comando F12 é necessário inverter o sinal dela no arquivo 'Easycash1.ini' de **True** para **False**.
* **DAV:** Essa opção deverá estar sempre desmarcada, uma vez que o DAV deverá ser emitido pelo IntelliCash.
* **Pré-Venda:** Esta opção deverá estar marcada somente se o sistema for trabalhar com a emissão de Pré-venda.
Lembrando que se esta opção estiver marcada o sistema não habilitará a função PDV, respeitando o [[https://www.confaz.fazenda.gov.br/legislacao/atos/2017/ac010_17|item 5 do PAF]] na qual determina que é vedado qualquer tipo de impressão.
{{ :easycash:instalacao4.png?nolink |}}
Configurações do ECF
Configure os dados do SAT, como marca, modelo, assinatura da software house(SWH), código de ativação e outros.
* **Marca:** Marca do equipamento SAT.
* **AcessoDLL:** Forma de acesso as funções da DLL do SAT. Bematech e Sweda utiliza padrão 2, outras modelos deve ser verificado no manual do SAT.
* **CodigoAtivacao:** Código de ativação do SAT criado na etapa '4 - Ativação do equipamento' realizada com o software do próprio equipamento. Esse código de ativação deverá ser criptografado. Para criptografá-lo, utilize as configurações do EasyCash:
Configurações → Equipamentos → SAT → Alterar
No campo Código de ativação, informe o código que foi criado que o sistema irá criptografá-lo automaticamente.
* **Porta:** Porta do equipamento SAT.
* **VersaoDadosEnt:** Versão do XML . Padrão do sistema de acordo com a SEFAZ.
* **PaginaDeCodigo:** Sistema trabalha com o padrão UTF-8. Verificar no manual do SAT se trabalha com esse padrão.
* **SwHAssinatura:** Esse é o vinculo entre CNPJ do cliente e o CNPJ da Software House criptografado e informado pela IWS conforme item anterior Associar Assinatura.
* **NomeDLL:** Caminho da DLL do SAT que deve ficar dentro da pasta SAT (C:\IWS\EC\Client\SAT\BemaSAT32.dll).
* **Log:** Por padrão é setada para zero.
{{ :easycash:instalacao5.png?nolink |}}
Configurações do SAT
Próxima etapa é configurar a impressora não fiscal e a impressão do cupom fiscal eletrônico.
* **Porta:** Porta da impressora não fiscal.
* **Modelo:** Modelo da impressora não fiscal.
* **Marca:** Marca da impressora não fiscal.
* **TimeOut:** Tempo máximo de espera em segundos para o equipamento ficar em linha. O padrão do sistema é 30.
* **Identacao:** Recuo de impressão. O padrão do sistema é 3.
{{ :easycash:instalacao6.png?nolink |}}
Configurações da impressora não fiscal e cupom fiscal eletrônico
Configure o tamanho da fonte na tela de venda e o foco na segunda via.
{{ :easycash:instalacao7.png?nolink |}}
Configuração do tamanho da fonte na venda
A próxima tela será para configurar as informações do banco do seu frente de caixa. Cada parâmetro deve ser configurado com atenção para que o sistema funcione de maneira correta.
* **Remoto:** Essa opção deverá estar marcada somente se o banco que será utilizado não estiver local.
*** Path:** Caso seu banco esteja local informe o caminho ou o nome do aliases (esse arquivo será apresentado mais a frente). Já se seu banco estiver remoto colocar o endereço IP.
*** UserName:** Usuário do firebird de acesso ao banco de dados SYSDBA.
* **Providers:** É uma configuração interna do servidor que por padrão deverá ser informada como 20.
* **Debug:** Atualmente essa configuração não está sendo utilizado no cliente final, portanto deverá estar sempre desmarcada.
* **DebugSilentMode:** Mesmo caso do debug.
* **Verificação Online:** Indica o tempo em millisegundos que o sistema irá tentar comunicação com a Retaguarda que, por padrão, é 30 ms.
{{ :easycash:instalacao8.png?nolink |}}
Configuração do Banco de Dados
O próximo passo trata-se das configurações necessárias para que o sistema de frente de caixa possa se comunicar com o IntelliCash(Retaguarda).
* **IP:** Endereço do servidor da retaguarda para onde serão exportadas as vendas.
* **Intervalo:** Intervalo de tempo em segundos que o EcUpdater leva para executar. No caso do exemplo abaixo, os sistema irá buscar a cada 3 minutos dados a serem importados pelo sistema de frente de caixa. Vale lembrar que o EcUpdater.exe buscar os dados na retaguarda para inserir nas tabelas temporárias isso não quer dizer que o os dados já estão atualizados no frente. Depois que os dados estão na tabela temporária e for solicitada a importação os dados serão atualizados no frente.
* **Path:** Indica o caminho onde o sistema do frente deverá buscar a **EasyCashDll.dll** conforme explicado no início dessa etapa. No exemplo abaixo, a dll foi colocado na pasta bin do servidor.
*** Porta Firebird:** Por padrão deverá ser marcado como 3050.
Sempre verificar se a porta 3050 está livre, ou seja, em modo LISTENING.
* **PathBD:** Esse caminho indica o local para a exportação e importação dos dados para o servidor da retaguarda.
* **UserName:** Usuário do firebird de acesso ao banco de dados que por padrão é definido como //SYSDBA//.
{{ :easycash:instalacao9.png?nolink |}}
Configurando o caminho do Retaguarda
Após configurar o caminho do intellicash, basta clicar em instalar na tela seguinte para que o processo de instalação seja iniciado.
{{ :easycash:instalacao10.png?nolink |}}
Aguarde até que a instalação seja completada.
{{ :easycash:instalacao11.png?nolink |}}
Após o término, basta clicar em concluir.
Se a opção Executar EasyCash for marcada ao clicar em concluir o sistema será aberto.
{{ :easycash:instalacao12.png?nolink |}}
Para que o sistema funcione é necessário que seu computador tenha **o Firebird 2.5** instalado. No momento da instalação é verificado se o computador já possui a instalação do firebird e caso não haja será instalado. Vale lembrar que se o Firebird for uma versão inferior a 2.5 o instalador irá atualizar.
A partir da versão 1.0.5000.010 do EasyCash será instalado apenas o executável do IBExpert, na qual ficará na pasta Utils. Não sendo necessário a sua configuração.
===== Finalizando a Instalação =====
Após concluir a instalação, você deve adicionar o caminho do banco de dados do frente no arquivo 'aliases.conf' que fica na pasta de instalação do Firebird (Por exemplo, C:\Program Files (x86)\Firebird\2.5)
{{ :easycash:aliases.png?nolink |}}
Arquivo aliases.conf
Após a instalação o seu sistema irá conter quatro pastas:
* BD
* Client
* IwUtils
* Utils
Além do arquivo que é o desinstalador do EasyCash.
Pode-se compartilhar a pasta que foi criada durante a instalação para facilitar nas manutenções. Neste caso é importante observar sempre as boas práticas de segurança em rede, avisando o responsável pela administração dos recursos de software/hardware do cliente para que defina as diretrizes necessárias.
{{ :easycash:estrutura_da_instalacaoec.png?nolink |}}
Estrutura do Sistema
===== Liberação do sistema =====
Agora precisamos liberar o sistema e a impressora.
Antes da liberação é necessário realizar o cadastro do ECF no IntelliCash em Gerenciamento -> Cadastros -> ECFS.
Ao executar o sistema escolha qual o tipo que este caixa irá trabalhar (PAF-ECF/SAT/NFC-e).
Ao executar o sistema pela primeira vez irá aparecer uma mensagem para que seja feito a importação das configurações e da empresa, mas antes de importar, exporte da retaguarda as configurações, a empresa e os usuários e somente após a exportação clique no botão //"Ok"//.
Caso não ocorra a importação desses dados, não será exibida a tela para liberação da impressora pois a liberação exige o cadastro da empresa no banco de dados.
Após a importação da empresa e configurações, irá aparecer uma tela para que seja carregado os dados da impressora, figura abaixo. Clique no botão //"Carregar os dados da impressora"// para que os campos possam ser preenchidos com as informações da impressora e logo em seguida clique em //"Ok"//.
A opção DAV/PRÉ-VENDA deverá estar marcada somente se o seu comércio for vender estas opções no frente de caixa.
Caso não consiga carregar os dados certifique-se que a impressora está ligada ou se o arquivo 'EasyCash1.ini' está configurado corretamente com a porta e o modelo da impressora.
{{ :easycash:liberacao_ecf_e_sat.png?nolink |}}
Liberação do ECF
Quando clicar em Ok, a liberação online será realizada e caso haja algum problema na online então irá aparecer uma mensagem como mostra a Figura abaixo. Com a mensagem ainda na tela, busque na pasta Client o arquivo **CadEcf.cds**(arquivo com os dados da impressora para liberação) e envie a Intelliware para liberação.
{{ :easycash:easycash_instalacao:figura_23.jpg |}}
Instrução de Liberação
A Intelliware devolverá outro arquivo criptografado que será foi gerado exclusivamente para essa impressora, **Ecf.cad**, que deverá ser colocado no mesmo destino do executável, ou seja, dentro da pasta Client.
Após colocar o arquivo no local indicado, clique no botão //"Ok"// da mensagem aberta (Figura acima) inicialmente na liberação.
Pronto, a impressora e o sistema estão liberados.
Caso o seu sistema for trabalhar com a Emissão de DAV/Pré Venda conforme configurado no passo 2 deste manual, esta tela de liberação de ECF não irá aparecer, uma vez que ambas opções não podem trabalhar em conjunto.
===== Configurações iniciais =====
Antes de utilizar o sistema é necessário realizar algumas configurações no frente. Abaixo iremos descrever de forma sucinta as principais. Maiores informações encontram-se no Manual de Instruções do EasyCash.
* **Formas de Pagamento:** No cadastro da forma de pagamento você tem a opção de carregar as formas de pagamento que foram configuradas na retaguarda conforme 'Manual Cadastro Formas de Recebimento EasyCash'([[intellicash:atualizacoes:3.0.137.000|Clique aqui para ir para visualizar o Manual]]). Desta forma, clique em //"Carregar"//;
* **Tributações:** As tributações também devem ser carregadas diretamente da impressora, caso exista alguma tributação que a impressora não tenha você pode também cadastrar, mas esse procedimento só pode ser realizado após a redução z e antes da primeira venda do dia. Para saber melhor como cadastrar diretamente na impressora, consulte o Manual de instrução.
* **Relatório Gerencial:** É muito importante configurar os relatórios gerenciais para controle de relatórios impressos, pois assim é possível separar a quantidade emitida para cada relatório.
Através do botão //"Carregar"// a associação é feita automaticamente mas, só serão associados automaticamente se a descrição de Relatório Gerencial na Leitura X for idêntica ao do banco, caso não seja, ao clicar para carregar verá que os que não fizerem associação é por este motivo e terá que ser associado da seguinte maneira: basta clicar em //"RG do ECF"// que irá abrir uma nova tela com os relatórios que estão cadastrados na impressora e o seu índice. Verifique o número do índice do relatório gerencial, selecione o relatório que você deseja associar com o da impressora e clique em //"Alterar"// que irá aparecer uma tela para digitar o índice da impressora. Quando der Ok aparecerá uma nova tela com a associação que você está fazendo para confirmação. Ou seja, aparecerá o relatório que está pré-cadastrado no sistema com o que está cadastrado na impressora. Clique em //"Ok"// para confirmar a associação.
Caso não tenha algum relatório cadastrado na impressora que você utiliza é possível cadastrar para depois associar no sistema. Mas isso só é possível após a Redução Z e antes de realizar uma venda. O cadastro na impressora pode ser realizado em:
Menu ECF → Programação → Programar Relatório Gerencial
Para maiores informações consulte o Manual de Instrução.
{{ :easycash:relatorio_gerencial_atualizado.png?nolink |}}
Cadastrando Relatório Gerencial
* **Comprovantes não fiscais:** É muito importante associar os comprovantes não fiscais para Pagamentos e Recebimentos. Caso esses não estejam cadastrados não irá conseguir registrar um Pagamento ou um Recebimento no frente de caixa.
O processo é o mesmo do Relatório Gerencial. Com o botão //"Carregar"// a associação é feita automaticamente mas, só serão associados automaticamente se a descrição de Relatório Gerencial na Leitura X for idêntica ao do banco, caso não seja, ao clicar para carregar verá que os que não fizerem associação é por este motivo e terá que ser associado da seguinte maneira: Clique em **CNF do ECF** para verificar o índice do comprovante não fiscal que está cadastrado na impressora (índice do ECF). Selecione o CNF que deseja associar e clique em Alterar que irá aparecer uma tela para digitar o número do índice da impressora e depois uma nova tela para confirmação.
Caso não tenha o CNF Pagamentos e Recebimentos cadastrado na impressora é possível cadastrar para depois associar no sistema. Mas isso só é possível após a Redução Z e antes de realizar uma venda. O cadastro na impressora pode ser realizado em:
Menu ECF → Programação → Programar Comprovante Não Fiscal
Para maiores informações consulte o Manual de Instrução.
{{ :easycash:comprovante_nao_fiscal.png?nolink |}}
Cadastrando Comprovante Não-Fiscal
* **Importação de Produtos:** Certifique-se que já foi exportado todos os produtos da retaguarda. Após a exportação vá a Menu Integração -> Importação -> Produtos.
* **Importação de Clientes:** Faça a exportação dos clientes que estão na retaguarda e importe no EasyCash através do Menu Integração -> Importação -> Clientes.
* **Importação de Usuários:** Faça a exportação dos clientes que estão na retaguarda e importe no EasyCash através do Menu Integração -> Importação -> Usuários.
* **Importação de Estoque:** Faça a exportação dos clientes que estão na retaguarda e importe no EasyCash através do Menu Integração -> Importação -> Estoque.
* **Configurações:** As configurações são exportadas da retaguarda e importadas no frente conforme mencionado no item 4 – Liberação do sistema. No entanto algumas configurações são necessárias fazê-las diretamente no caixa devido as peculiaridades de cada caixa como:
* **Leitor Serial:** Se o caixa possui leitor do tipo Serial é necessário marcar essa opção na aba Geral e na aba Leitor configurar a porta.
*** Gaveta:** Se a gaveta não abrir com o comando F12 na tela de venda, é necessário inverter o sinal dela no arquivo 'EasyCash1.ini' como mencionado no item 2 deste manual.
* **Balança:** Se o caixa possui balança é preciso marcar essa opção nas configurações do frente. Caso todos os caixas tenham balança, configure a retaguarda e exporte para o frente.
Nesse momento resta então abrir o **Caixa(F3)** e o sistema está pronto para ser utilizado.
Boas Vendas! :-)