Ferramenta CROSS responsável pelo visual WEB a ser utilizado na geração da obrigação fiscal EFD-Reinf.
Abrangência
Esta integração destina-se a todos os clientes do segmento DMS dos produtos Apollo/Bravos, Spress e Sisdia.
Aplicação
Consiste em gerar as informações relacionadas às retenções ocorridas mensalmente, a partir das notas fiscais de tomadores e prestadores, disponibilizando-as à SEFAZ através de serviços WebService.
Restrição
Não será possível utilizar a ferramenta Cross do LinxEFDReinf para mais de um contribuinte do mesmo produto que esteja em bases diferentes (Bancos de dados em servidores distintos). Se isto ocorrer, será necessário a instalação da ferramenta Cross em cada um dos servidores. Agora, se o cliente da Linx possuir mais de um contribuinte em produtos diferentes, poderá utilizar a mesma instalação da ferramenta Cross, ou seja, por exemplo, se o cliente da Linx possuir o produto Spress e Sisdia, poderá utilizar somente uma instalação.
Apesar da nova obrigação fiscal permitir aos clientes utilizarem certificados da série A e tipo A1 e A3, a solução implementada somente permitirá aos clientes utilizarem o certificado do tipo A1.
Instalando o LinxEFDReinf WEB
A instalação completa do LinxEFDReinf ocorrerá em duas etapas como descrito abaixo:
- A 1ª Etapa contempla a instalação da ferramenta Cross, a parte visual do produto desenvolvido em formato (Web). O executável chama-se "Instalar LinxEFDReinf v01.00.exe".
- A 2ª Etapa contempla o acesso aos bancos de dados, desenvolvido no formato de serviços (WebApis). Estes Webapis devem ser liberados com o seguinte nome "LinxEFDReinfWS????.war", variando somente o seu nome em função do produto, que pode ser SPRESS, SISDIA ou APOLLO. A responsabilidade pelo desenvolvimento destes Webapis ficou a cargo das fábricas de cada produto, por se tratar de acesso a banco de dados. E dependerá de regras de negócio específicas e inerentes a cada produto. Para que o Webapi seja instalado no mesmo momento da instalação da ferramenta Cross (1ª Etapa), é necessário que ele esteja na mesma pasta do instalador.
A versão do instalador constará no próprio nome do executável "Instalar LinxEFDReinf v01.00.exe" e será sempre atualizada a cada alteração/liberação.
Instalando o LinxEFDReinf WEB em máquina com o Tomcat já instalado
Requisitos
- Ter instalado o Tomcat. Se não possuir, utilizar o manual de instalação do Tomcat para a sua instalação.
- Estar atualizado na versão mais recente dos produtos que contemplam a criação das tabelas necessárias ao LinxEFDReinf.
- Linx DMS/ BRAVOS - 3.04U02 ou superior
- Sisdia - v08.20.01 ou superior
- Spress - pacote 106 da release DS2009 patch 003 - 25/05 ou superior
Passo a passo
Exclusivamente para o produto Sisdia, a configuração da ferramenta Cross pode ser realizada no ambiente Linux. Acesse o manual EFD-Reinf Configuração em Ambiente Linux para consultar o passo a passo.
Na primeira tela do instalador, será solicitado o caminho do TOMCAT. Será sugerido um local mas devemos ficar atentos, caso não seja, deverá ser realizada a alteração para o local correto.
Se a sua máquina for 64 bits, alterar o caminho sugerido na tela abaixo para "C:\Program Files (x86)\Apache Software Foundation\Tomcat 6.0\webapps", pois o tomcat será instalado em 32 bits.
Figura: 1.0 – Clicar no botão Avançar
Caso a pasta Webapps do TOMCAT já exista, será apresentada a seguinte tela. Se isto ocorrer, basta confirmar a instalação.
Figura: 2.0 – Clicar no botão Sim
Em seguida será exibido a seguinte tela:
Figura: 3.0 – Clicar no botão Avançar
Será permitido a instalação do (Webapi) (2ª Etapa) a partir do instalador, bastando para isto copiar o (Webapi) para a pasta "C:\Program Files (x86\Apache Software Foundation\Tomcat 6.0\webapps\LinxEFDReinfWS????war", como demonstrado na figura abaixo:
Figura: 4.0 – Neste exemplo estamos instalando Web e Webapi do produto Spress.
Ao clicar em Avançar da figura 3.0, será exibido a seguinte tela:
Figura: 5.0 – Clicar no botão Instalar.
Se foi feito a opção pela instalação do (Webapi) a partir do instalador e não foi feito a cópia como descrito acima, será exibido a tela abaixo. Nesta tela será possível cancelar a execução do instalador clicando no botão <Anular>, ignorar o erro e prosseguir com a instalação (Web) (1ª Etapa), clicando no botão <Ignorar> ou prosseguir com a instalação clicando no botão <Repetir>, desde que o arquivo tenha o seu nome renomeado, como descrito no passo anterior.
Figura: 6.0 – Clicar em Anular, Repetir ou Ignorar.
Quando solicitado a instalação do (Webapi) (2ª Etapa) a partir do instalador, será exibido a tela a seguir solicitando os dados de configuração do ambiente. Através desta tela será possível a configuração de mais de um produto da Linx, bastando preencher todos os parâmetros e clicar no botão Confirma. Feito isto, será possível configurar um novo produto.
Figura: 7.0 – Preencher os dados solicitados
A tela é aberta sendo solicitado ao usuário em primeiro lugar o 'PRODUTO'. Após essa seleção os campos desabilitados ficam habilitados para ser realizada a configuração.
Figura: 7.0 – Preencher os dados solicitados
Uma vez preenchidos os parâmetros, é possível validar os locais de armazenamento de arquivos. Se clicar no botão Verificar Pasta WEB API (CONTEXT) e for apresentado a tela a seguir, significa que o serviço Webapi não foi instalado.
Figura: 8.0 – Verificando pasta WebApi
Se for apresentado a tela a seguir, significa que o serviço Webapi foi bem sucedido a sua instalação.
Figura: 9.0 – Verificando pasta WebApi
Se clicar no botão Verificar Pasta servidor Tomcat (Nome da Aplicação) e for apresentado a tela a seguir, significa que o serviço Tomcat não foi iniciado.
Figura: 10.0 – Verificando pasta servidor Tomcat
Se for apresentado a tela a seguir, significa que o serviço Tomcat foi iniciado.
Figura: 11.0 – Verificando pasta servidor Tomcat
Se clicar no botão Confirma da figura 7.0 e for apresentado a seguinte tela, significa que o serviço Tomcat não foi iniciado. Para isto, basta clicar no botão Iniciar desta mesma tela.
Figura: 12.0 – Validando serviço Tomcat
Se for apresentado a seguinte tela, significa que as configurações de bases de dados foi bem sucedida.
Figura: 13.0 – Configuração bem sucedida
Se clicar no botão Iniciar do serviço do Windows Tomcat, em seguida poderá utilizar o botão Testar URL. Ao fazer isto será apresentado a tela a seguir demonstrando que o serviço e a instalação foram bem sucedidos.
Figura: 14.0 – Testando a instalação
Se clicar no botão 'Testar URL' e apresentar a seguinte tela, significa que o (Webapi) (2ª Etapa) ainda não foi instalado. Não há o que se preocupar.
Figura: 15.0 – Testando a instalação
Após o preenchimento das telas de configuração, ao clicar no botão Fechar, será apresentado a seguinte tela informando a conclusão da instalação.
Figura: 16.0 – Finalizando processo de instalação
Quando não for optado pela instalação do (Webapi) (2ª Etapa) a partir do instalador do (Web), será apresentado a seguinte tela.
Figura: 17.0 – Finalizando processo de instalação
Ao final do processo de instalação, se foi optado pela instalação do (Webapi) (2ª Etapa), a pasta de instalação do 'LinxEFDReinf' deverá estar como a imagem abaixo.
Figura: 18.0 – Finalizando processo de instalação
Quando não for instalado o (Webapi) (2ª Etapa) a partir do instalador, deve-se copiar o (Webapi) para a pasta "C:\Program Files (x86\Apache Software Foundation\Tomcat 6.0\webapps\LinxEFDReinfWS????war" e em seguida executar o programa 'C:\Program Files (x86)\Apache Software Foundation\Tomcat 6.0\webapps\LinxEFDReinfconfigura.exe' como administrador. Preencher parâmetros necessários e iniciar o Tomcat através do botão Iniciar.
Figura: 7.0 – Preencher os dados solicitados
O processo de configuração vai gerar um log na pasta "C:\Program Files (x86\Apache Software Foundation\Tomcat 6.0\webapps\LinxEFDReinf\CONFIG.log".
A ferramenta Cross ao fazer comunicação com a SEFAZ, também vai gerar um log destas operações na pasta "C:\Program Files (x86\Apache Software Foundation\Tomcat 6.0\webapps\LinxEFDReinfComWS\LinxEFDReinfComWS.log".
Também será criado log da execução dos Webapis que ficará na pasta "C:\Program Files (x86\Apache Software Foundation\Tomcat 6.0\webapps\LinxEFDReinfWS_SPRESS".
Para verificar a instalação da Web (1º Etapa), executar o seguinte comando "http://localhost:8080/LinxEFDReinf" no browser (Recomendamos o Google Chrome ou Mozilla Firefox), onde deve ser retornado a seguinte tela:
Figura: 19.0 – Tela principal de acesso ao sistema
Atualizações
Toda vez que a ferramenta Cross sofrer atualizações, é necessário limpar o cache da máquina em execução e executar um refresh da tela, como exemplificado na tela abaixo. Também será necessário parar o serviço Tomcat (Container Servlets) ao atualizar os Webapis.
Figura: 20.0 – Tela principal de acesso ao sistema
Conteúdo do pacote
# | Nome do arquivo | Comentário |
---|---|---|
1 | Instalar LinxEFDReinf v01.00.exe | Instalador do produto Web (1º Etapa) |
4 | LinxEFDReinfWS_SPRESS.war | WebApi do produto Spress (Webapi) (2ª Etapa) |
5 | LinxEFDReinfWS_SISDIA.war | WebApi do produto Sisdia (Webapi) (2ª Etapa) |
6 | LinxEFDReinfWS_APOLLO.war | WebApi do produto Apollo (Webapi) (2ª Etapa) |
9 | \IntegradorEFDReinf\ Linx DMS EFDReinf - Manual Instalacao Tomcat.docx | Manual instalação do Tomcat |