Manual de Instruções e Instalação do ECF Java
O sistema Java utilizará para a emissão de cupons fiscais o ECF do sistema Delphi. Dessa forma, a ATS Informática reduzirá custos com evolução, manutenção e homologação de um novo sistema de ECF. Estando o ECF do Delphi vinculado ao sistema Java, este terá apenas a função de emissor de cupons fiscais, cabendo ao sistema Java todo o controle financeiro e de estoque.
O ECF continuará a utilizar o banco de dados firebird, contudo, este banco deverá ser preparado para receber os cadastros do banco de dados do sistema Java. Para instalação em um novo cliente, um banco vazio poderá ser baixado na intranet na parte do fórum ou entre em contato com o departamento de sistemas do Java solicitando um banco de dados vazio para o ECF Java.
EM OUTRAS PALAVRAS:
- O banco de dados é totalmente vazio, não contendo registros de cartão de credito, prazos etc. NÃO PODE SER O BANCO PADRÃO DA IMPLANTAÇÃO.
Clique no link ao lado para baixar o banco adequado: banco ecf Firebird para JAVA
- Para o sistema funcionar, deverá estar na mesma pasta do ECF, o arquivo .war (equivale a um .exe) que foi homologado na Polimig. Em ago/2013 a única versão homologada era o JLite.war.
- É fundamental, no sistema JAVA, ter uma tabela de preços padrão. Ao cadastrar as tabelas em cadastros -> faturamento -> item -> tabela de preços há uma pergunta nesse sentido.
- Quanto ao caixa, lembre-se de definir o período de lançamento de lançamentos e abrir o saldo do caixa, para o sub-caixa configurado nos parametros do PDV. Veja então, que o caixa do ECF é gerado nas mesmas condições do caixa do PDV.
IMPORTANTE: O aplicativo ResulthECF deverá estar inserido na prevenção de execução de dados do Windows. Caso isso não seja feito, haverá problemas de conexão com os WebServices.
A emissão de cupons será realizada de duas formas: - Importação de um DAV do sistema Java para a geração de um cupom fiscal no ECF do Delphi; - Venda direta no ECF do Delphi após a sincronização dos cadastros necessários.
Para habilitar as configurações do ECF do Java é necessário que o cliente possua em sua senha pelo menos um dos sistemas do Java:
- JTelefonia (JTF);
- JStart (JST);
- JBusiness (JBU).
O sistema de retaguarda Java vem com duas operações pré configuradas: “venda direta no ECF” e “Importação ECF”. Pode ser necessário modificar alguns atributos da operação “Importação ECF”. Os atributos que podem ser modificados são “gerar financeiro” e “baixar estoque”. Isso ocorrerá, por exemplo, se a retaguarda estiver operando apenas como um DAV (Documento Auxiliar de Venda). Caso necessite alterar tais atributos, acesse "operações -> saída a operação de “venda direta no ECF” e “Importação ECF”" no sistema.
A operação do banco firebird (no caso abaixo operação 073) não afeta em nada o funcionamento da retaguarda JAVA. Ela existe apenas para manter uma compatibilidade com o ECF Delphi. Todo o controle financeiro e de estoque ficam nas operações do JAVA.
Para realizar a configuração do ECF com Java deverá ser utilizado o ConfigECF.exe realizando as mesmas configurações do Delphi com as configurações especiais do Java conforme imagem abaixo:
Passos para a configuração:
1. Certifique-se que a senha do cliente habilita pelo menos um sistema Java;
2. Atualize a base de dados;
3. Entre na tela de parâmetros do ECF => aba diversos => sub aba Importação / Exportação e marque a opção “Utiliza DAV Java”. A aba “WS JResulth” será habilitada onde serão informados os seguintes campos:
- Usuário Proxy WS: Onde será informado o nome do usuário da máquina onde está instalado o sistema;
- Senha Proxy WS: Onde será informado a senha do usuário onde está instalado o sistema;
- Web Service: Informar o caminho do WSDL do web service de sincronização do Java com o ECF. Para descobrir este caminho, digite na barra de endereços do navegador o endereço de login do sistema.
Exemplo: http://www.atscelular.com.br:3500/JTelefonia/login.ats?
Altere o final do endereço “login.ats?” para “cxf”
Exemplo: http://www.atscelular.com.br:3500/JTelefonia/cxf Será carregada a seguinte tela com os web services disponíveis, inclusive o “ImportaPedidoJavaWebserviceFacade” que é o web service de sincronização do sistema Java com o ECF.
Clique sobre o endereço do WSDL que está na coluna da direita do web service, conforme imagens abaixo:
Endereço do WSDL
Após clicar sobre o endereço exemplificado acima, será carregada uma nova tela, apresentando o endereço WSDL a ser informado no ConfigECF.EXE.
Atenção: o endereço exibido nas imagens acima não deve ser copiado para o CONFIG, e sim o que será exibido no navegador após clicar nesse endereço, ou seja, o que deve ser colado no CONFIG é o que termina com WSDL)
Tela com o endereço WSDL
ConfigECF.exe após a configuração do endereço WSDL
Após informar os campos de configuração do WS JResulth clique no botão salvar, nesse momento o ConfigECF.exe se comunicará com o sistema Java fazendo a sincronização de todas as filiais e usuários definidos como operadores de caixa no sistema Java para o banco de dados do ECF, para isso verifique as observações abaixo:
- As filiais devem ser previamente cadastradas no sistema Java, observando os campos obrigatórios do cadastro.
- Os usuários do sistema ECF serão definidos no cadastro de usuário do sistema Java (conforme imagem abaixo).
Ao definir um usuário no sistema Java como “Operador de Caixa”, este será criado no ECF, sendo cadastrado um usuário e um operador com os mesmos dados e com a senha definida no campo (senha operador), essa sincronização ocorrerá ao clicar no botão salvar do ConfigECF.exe ou na próxima vez que o ResulthECF.exe for executado (aberto).
Após concluir as configurações, será necessário sincronizar os cadastros do Java para o banco de dados do ECF. Esta sincronização é realizada automaticamente conforme o intervalo configurado anteriormente no ConfigECF.exe, ou pode ser realizada sempre que o usuário necessitar como na primeira vez que se inicia o sistema após a configuração. Para realizar a sincronização selecione o botão no canto inferior direito conforme ilustra a figura abaixo:
Será aberta uma tela com as seguintes opções:
1. Testar Conexão: Para verificação da conexão com o servidor;
2. Sincronizar Dados Cadastros: Para executar a qualquer momento a sincronização dos cadastros.
3. Cancelar: Para sair da tela.
A sincronização carrega os seguintes cadastros do banco de dados do sistema Java para o banco de dados do sistema ECF:
- Cadastro de produtos (mantendo o mesmo código do produto do Java);
- Cadastro de clientes (mantendo o mesmo código do cliente do Java);
- Cadastro de vendedores;
- Cadastro de cidades;
- Condições de pagamento;
- Convênios;
- Administradoras de cartões;
- Operadores.
Caso o sistema em algum momento não consiga estabelecer comunicação com o servidor, o mesmo trabalhará em modo off-line, mantendo os cupons na estação até que se estabeleça a conexão onde todos serão enviados para o servidor.
Após a emissão de um cupom, este é imediatamente enviado para o servidor.
Caso ocorra algum erro ou falha na sincronização, o sistema exibirá um ícone de notificação no canto inferior direito da tela alertando o usuário para que sejam tomadas providências. Veja imagem abaixo:
Ao clicar 2 vezes neste ícone, é exibida a tela a seguir com os cupons pendentes de sincronização e o motivo da não sincronização:
Após a emissão de uma redução Z, as informações da mesma também são enviadas para o servidor. Caso não haja comunicação no momento, esta ficará pendente até que se reestabeleça a conexão sendo a mesma enviada automaticamente.
Para a geração do sintegra, será utilizado os dados do ECF acessando o menu funções => botão Sintegra conforme imagem abaixo:
Após a geração do sintegra no ECF, as informações do mesmo serão enviadas para o servidor. Desta forma, o arquivo do sintegra deverá ser gerado no sistema Java que já possuirá as informações sincronizadas do ECF. Veja imagem da tela de geração do sintegra do Java abaixo:
Para controlar o financeiro e o estoque corretamente as observações abaixo devem ser verificadas antes de realizar qualquer emissão de cupom fiscal e venda direta.
- As operações de saída referentes a venda direta e importação de DAV devem estar marcadas para gerar financeiro e estoque. 'Cadastros > Operações > Operação de saída'.
- Deverá ser configurada uma operação para geração de documentos a receber no campo "operação padrão na entrada de documentos simples", em 'Utilitários> Configurações> Configuração do documento a receber/pagar'. Observação: esse campo não deve ficar em branco e essa operação não deve solicitar conta caixa e nem centro de custo, essas opções devem ser configuradas como "nunca".
- O campo "tipo de documento a receber", configurado em Utilitários > Configurações > Configuração do documento a receber/pagar, não pode estar em branco.
- Os CFOP´s de vendas no ECF com e sem substituição tributária devem ser configurados na aba parâmetros fiscais, em 'Utilitários > Configurações > Parâmetros fiscais'.
- Para geração de movimento bancário o período de lançamento deverá ser configurado em 'Utilitários > Tesouraria > Parâmetros de tesouraria'.
- Caso o cliente utilize cartão de credito as configurações abaixo devem ser observadas:
- O ponto de venda (PDV) deverá ter configurado o campo tipo de documento a receber para cartão.
- Caso o cliente não utilize TEF, o campo bandeira deverá ser configurado como “Nenhum”, caso contrário, esse campo deverá ser configurado de acordo com o TEF utilizado pelo cliente, devendo também ser configurado o ConfigECF.exe para utilização do TEF.
- Para geração de movimento de caixa as configurações abaixo devem ser realizadas:
- Cadastro do subcaixa a ser utilizado.
- O subcaixa deverá ter seu saldo inicial configurado em 'Utilitários > Tesouraria > Saldo inicial de caixa'.
- Deverá ser configurado um período de lançamento de caixa em 'Utilitários > Tesouraria > Período de lançamento do caixa'.
- Observação: a emissão de cupom fiscal através de venda direta ou importação de DAV obedecerá esse período, caso isso não ocorra, não será gerado movimento de caixa para o cupom, pois ele estará fora do período de lançamento do caixa.
- Na aba faturamento da rotina de ponto de venda (PDV) deverá ser informado o subcaixa cadastrado, configurando a geração de caixa conforme necessário.