Ferramentas do usuário

Ferramentas do site


easycash:manual_de_instalacao

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:

IntellicashGerenciamentoConfiguraçãoOutras Configurações

Sendo as configurações de número 9102 e 9202 que podem ser vistas na imagem abaixo.

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:

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.

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.

Tela Principal

Ao avançar será mostrado o local padrão onde é instalado, caso queira que seja em outro lugar selecione o desejado.

Local da Instalação

Escolha o tipo de instalação que será realizada para que sejam adicionadas as configurações no arquivo 'EasyCash1.ini'.

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 item 5 do PAF na qual determina que é vedado qualquer tipo de impressão.

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çõesEquipamentosSATAlterar

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.

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.

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.

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.

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.

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.

Aguarde até que a instalação seja completada.

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.

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)

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.

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.

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.

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'(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 ECFProgramaçãoProgramar Relatório Gerencial

Para maiores informações consulte o Manual de Instrução.

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 ECFProgramaçãoProgramar Comprovante Não Fiscal

Para maiores informações consulte o Manual de Instrução.

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! :-)

easycash/manual_de_instalacao.txt · Última modificação: 2023/07/05 14:22 por amonteiro