Documentação de software

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.

====== Manual de Instalação do EasyCash ======

===== Requisitos Mínimos =====

<html>
<center>
<table>
<tr>
<td>
<center><b>Sistema Operacional</b></center>
</td>
<td>
Windows 7 SP1
</td>
</tr>

<tr>
<td>
<center><b>Processador</b></center>
</td>
<td>
Dual Core ou Intel i3
</td>
</tr>

<tr>
<td>
<center><b>Memória</b></center>
</td>
<td>
4 Gbytes
</td>
</tr>

<tr>
<td>
<center><b>Conexão</b></center>
</td>
<td>
2 Mbps por computador
</td>
</tr>

<tr>
<td>
<center><b>USB</b></center>
</td>
<td>
4 portas
</td>
</tr>

<tr>
<td>
<center><b>Disco Rígido</b></center>
</td>
<td>
40 Gbytes
</td>
</tr>

<tr>
<td>
<center><b>Vídeo</b></center>
</td>
<td>
Resolução de 1024x768 pixels
</td>
</tr>

</table>
</center>
</html>
===== Considerações iniciais =====

O EasyCash é um sistema de frente de caixa que deve ser instalado conforme as instruções deste manual. 

<note tip>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</note>

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.

<note warning>Para a versão 1.0.5000.012 é obrigatório que o IntelliCash seja atualizado para a versão 1.0.137.012</note>

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: 

<html><center><b>Intellicash</b> → <b>Gerenciamento</b> → <b>Configuração</b> → <b>Outras Configurações</b></center></html>

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

{{ :easycash:senha_firebird.png?nolink |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Configurações do Intellicash</i></b></center></html>



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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Tabela ECFS</i></b></center></html>


 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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Tabela PDVSYS</i></b></center></html>



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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Tela Principal</i></b></center></html>

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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Local da Instalação</i></b></center></html>

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

{{ :easycash:instalacao3.png?nolink |}}
<html><center><b><i style="color:#000000;font-size:12px;">Tipo de Instalação</i></b></center></html>

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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações do ECF</i></b></center></html>

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: 

<html><center><b>
Configurações</b> → <b>Equipamentos</b> → <b>SAT</b> → <b>Alterar</b></center></html> 

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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações do SAT</i></b></center></html>

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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configurações da impressora não fiscal e cupom fiscal eletrônico</i></b></center></html>

Configure o tamanho da fonte na tela de venda e o foco na segunda via.

{{ :easycash:instalacao7.png?nolink |}}
<html><center><b><i style="color:#000000;font-size:12px;">Configuração do tamanho da fonte na venda</i></b></center></html>



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 |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Configuração do Banco de Dados</i></b></center></html>





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.
<note important> Sempre verificar se a porta 3050 está livre, ou seja, em modo LISTENING.</note> 
  * **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 |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Configurando o caminho do Retaguarda</i></b></center></html>


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.

<note>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.</note>



===== 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 |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Arquivo aliases.conf </i></b></center></html>

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. 

<note>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.</note>

{{ :easycash:estrutura_da_instalacaoec.png?nolink |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Estrutura do Sistema </i></b></center></html>

===== Liberação do sistema =====

Agora precisamos liberar o sistema e a impressora. 

<note important>Antes da liberação é necessário realizar o cadastro do ECF no IntelliCash em Gerenciamento -> Cadastros -> ECFS.
</note>

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"//.

<note important>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.</note>

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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Liberação do ECF </i></b></center></html>

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 |}}
<html><center><b><i style="color:#000000;font-size:12px;">Instrução de Liberação</i></b></center></html>

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.

<note important>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.</note>

===== 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:

<html><center><b>Menu ECF</b> → <b>Programação</b> → <b>Programar Relatório Gerencial</b></center></html> 

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

{{ :easycash:relatorio_gerencial_atualizado.png?nolink |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Cadastrando Relatório Gerencial</i></b></center></html>

  * **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:

<html><center><b>Menu ECF</b> → <b>Programação</b> → <b>Programar Comprovante Não Fiscal</b></center></html> 

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

{{ :easycash:comprovante_nao_fiscal.png?nolink |}}
<html><center><b><i style="color:#000000;font-size:12px;"> Cadastrando Comprovante Não-Fiscal</i></b></center></html>

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
====== Manual de Instalação do EasyCash ======
===== Requisitos Mínimos =====
<html>
<center>
<table>
<tr>
<td>
<center><b>Sistema Operacional</b></center>
</td>
<td>
Windows 7 SP1
</td>
</tr>
<tr>
<td>
<center><b>Processador</b></center>
</td>
<td>
Dual Core ou Intel i3
X

Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página