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. Desta 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.
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.
IMPORTANTE: O aplicativo ResulthECF deverá estar inserido na prevenção de execução de dados do Windows. Caso isto 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 pedido 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 imagem abaixo:
Será carregada a tela com a estrutura do WSDL e o endereço do WSDL na barra do navegador. Este endereço é que deve ser informado na tela de configuração.
Após informar os campos de configuração do WS JResulth salve as configurações da tela de parâmetros do ConfigECF.exe.
Será necessário cadastrar as filiais do Java no cadastro de filiais do ConfigECF.exe vinculando o código da filial do Java ao cadastro do Delphi conforme imagem abaixo:
Os usuários do sistema ECF serão definidos no cadastro de usuário do sistema Java (Veja conforme imagem abaixo). Ao definir um usuário no Java como “Operador de Caixa”, este será sincronizado para o ECF na próxima vez que o mesmo for executado e será criado um usuário do sistema ECF com a mesma senha definida para o operador de caixa no cadastro de usuários do sistema java.
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:
