MV DOCS

Guia de instalação do SPED-Reinf

Índice

Estrutura...................................................................................................................... 3
Introdução................................................................................................................... 4
Instalação .................................................................................................................... 5
Pré-requisitos ..................................................................................................................................... 5
Passo a passo para instalar o TOMCAT ............................................................................................. 6
Configuração do Certificado do tipo A1.......................................................................................... 13
Finalizando a instalação do Tomcat ............................................................................................... 14
Configuração do FCCT no SoulMV............................................................................ 15
ATENÇÃO: Atualização de Banco.............................................................................. 16
ATENÇÃO: Passo a passo para atualização do serviço do SPED-Reinf................... 17
Conclusão .................................................................................................................. 19

–
Estrutura
• Estrutura
• Introdução
• Instalação
• Pré-requisitos
• Passo a passo para instalar o TOMCAT
• Configuração do Certificado do tipo A1
• Finalizando a instalação do Tomcat
• Configuração do FCCT no SoulMV
• ATENÇÃO: Atualização de Banco
• ATENÇÃO: Passo a passo para atualização do serviço do SPED-Reinf
• Conclusão

Copyright ©2023MV. Todos os direitos reservados. 3

Introdução
O Serviço de Integração SPED-Reinf é um serviço Representational State Transfer (ReST) - Transferência
de Estado Representacional, que recebe requisições do produto e transforma em XML, além de assiná-los
digitalmente com certificado A1 e depois enviar para a Receita Federal. Lembrando que o certificado
deve ser acreditado por uma das entidades certificadoras autorizadas conforme estrutura
de Autoridades Certificadoras – ACs de 1º e 2º nível e Autoridades de Registro – ARs da ICP-Brasil (https://
www.iti.gov.br/icp-brasil/estrutura).

Copyright ©2023MV. Todos os direitos reservados. 4

Instalação

Pré-requisitos
• Requisitos de hardware
Para utilizar a integração SPED-Reinf, o cliente deverá dispor de uma máquina com as
configurações mínimas para utilização do ambiente de integração Java 8:
Sistema Operacional Windows 2008/2012 R2 SP1 com todas as atualizações disponíveis (64 bits);
8GB de memória RAM;
20GB de espaço livre em disco.
• Requisito de Software
• Deverá ser disponibilizado um serviço Tomcat 9 com as devidas liberações de portas necessárias
para comunicação com o serviço SPED-Reinf da Receita Federal. O serviço de integração se
conectará ao produto MV, utilizando credenciais DBAMV e deverá ter permissão para abrir no mínimo
20 conexões simultâneas com o banco de dados do cliente. O Tomcat deverá estar configurados com
a seguinte parametrização:
Memória permanente de 1GB alocada
Memória de 4 GB elástica.
• Pacotes Java a serem instalados no seu banco de dados ORACLE
• O pacote XQUERY é pré-requisito para utilizar essa integração. Portanto, é necessário solicitar
ao DBA, a instalação desse pacote Oracle no banco de dados.
• Liberação de ACL, Proxy e Firewall
• O setor de infraestrutura deverá liberar acessos às URLs da Receita Federal. Os endereços publicados
em diário oficial são:
• https://reinf.receita.fazenda.gov.br/WsREINF/RecepcaoLoteReinf.svc
• https://preprodefdreinf.receita.fazenda.gov.br/WsREINF/RecepcaoLoteReinf.svc
• https://reinf.receita.economia.gov.br/recepcao/lotes
• https://pre-reinf.receita.economia.gov.br/recepcao/lotes
• https://reinf.receita.fazenda.gov.br/WsReinfConsultas/ConsultasReinf.svc
• https://preprodefdreinf.receita.fazenda.gov.br/WsReinfConsultas/ConsultasReinf.svc
• https://reinf.receita.economia.gov.br/consulta/lotes/
• https://reinf.receita.economia.gov.br/consulta/reciboevento/
• https://pre-reinf.receita.economia.gov.br/consulta/lotes/
• https://pre-reinf.receita.economia.gov.br/consulta/reciboevento/
• Possuir um certificado e-CNPJ do tipo A1.

 Access Control List (ACL)

Para algumas versões de banco Oracle, é necessário cadastrar o IP e a porta do Tomcat do SPED
como endereço confiável do banco de dados. Esse é o chamado ACL. A configuração do ACL foi
implementada na versão 11g do Oracle. Sem liberar ACL, alguns bancos não conseguem disparar
requisições HTTP a outros serviços.

O serviço do SPED exige conexão com a internet, liberação de requisição externa para as URLs
da Receita Federal, conforme descrito acima.

Copyright ©2023MV. Todos os direitos reservados. 5

  Importante!
Adicionalmente, é vital para o sucesso da configuração da integração que não haja impedimento
entre o seu banco de dados e o serviço de integração. Portanto, não deve haver bloqueio de
conexão em decorrência de proxy, VPN, ou Firewall com o IP do servidor de integração e a porta
(De acordo com este guia de instalação: 8930).

 Atenção!!!
Caso ocorra o erro "ORA-29273: falha na solicitação HTTP", deve ser verificado se ainda há
bloqueio de conexão, conforme descrito acima.

Passo a passo para instalar o TOMCAT

O passo a passo a seguir contém as instruções necessárias para instalação de uma instância de Tomcat.

 Atenção!!!
O Tomcat disponibilizado já está configurado para a porta "8935". Caso a mesma já esteja em
uso, será necessária a abertura de um ticket de INFRA, solicitando alteração para próxima porta
livre.

Fazer download do Java e Tomcat, disponibilizado pela MV. Descompactar os pacotes no desktop ou local
desejado.
• JDK: https://cloud.mv.com.br/index.php/s/wrFJMlgOqDMraVH
• TOMCAT: https://cloud.mv.com.br/index.php/s/Rwr3URcYoatk910
• mv-api-sped-reinf.war: https://cloud.mv.com.br/index.php/s/RCYcJOSaU6uZ7RB
• mvintegra.imv_reinf.sql: https://cloud.mv.com.br/index.php/s/mdKdMuM7YbPj8Yz
• mvintegra.imvw_reinf_cons_job.sql: https://cloud.mv.com.br/index.php/s/aGDDkvtHW1ddy6F
Iniciar o processo pela instalação do JDK.

 Atenção!!!
Caso já esteja instalado, não deve ser instalado novamente.

Na sequência, é necessário criar o diretório padrão de instalação dos servidores Tomcat

[C\MV\servers\soulmv_prd\] e copiar o Tomcat descompactado para este diretório. Se o diretório informado
já existir no servidor, deve-se apenas copiar o Tomcat.
No diretório "bin" do Tomcat [C:\MV\servers\soulmv_prd\tomcat-9.0-x64_8935\bin] deverá abrir os
executáveis na ordem com privilégio de Administrador;
1. service_8935.bat
2. set_descricao_8935.bat
3. set_mem_8935.bat

Copyright ©2023MV. Todos os direitos reservados. 6

 Abrir as propriedades do Tomcat [C:\MV\servers\soulmv_prd\tomcat-9.0-x64_8935\bin\8935w.exe] para
excluir os parâmetros default de memória, conforme exemplo abaixo:
• Pressionar com botão direito do mouse, o executável "8935w.exe", e selecionar "Executar como
Administrador" para visualizar as propriedades.
• Apagar os valores default dos campos "Initial memory pool" e "Maximum memory pool", em seguida
selecione o botão Aplicar;

• Iniciar o serviço do Tomcat e fazer um teste de acesso ao Tomcat: http://ip-servidor:89351;

Extrair o arquivo mv-api-sped-reinf.zip em uma pasta. Obter o arquivo mv-api-sped-reinf-war e colocar
na pasta /webapps do Tomcat instalado. Reiniciar o Tomcat;

1 http://seu-servidor:8083/

Copyright ©2023MV. Todos os direitos reservados. 7

  OBS.: Se o firewall do servidor estiver ligado, solicitar a equipe de infraestrutura do hospital para
fazer a liberação as portas do Tomcat e banco.

Configurando a conexão com o banco de dados

Dentro da pasta do Tomcat 7 deve conter um arquivo em tomcat/conf/context.xml adicionando os

dados de acesso ao banco de dados conforme XML abaixo:

context.xml

<?xml version="1.0" encoding="UTF-8"?>

<Context>
<WatchedResource>WEB-INF/web.xml</WatchedResource>
<WatchedResource>${catalina.base}/conf/web.xml</WatchedResource>
<Parameter name="jintegra.db.driver" value="oracle.jdbc.driver.OracleDriver
" />
<Parameter name="jintegra.db.url" value="jdbc:oracle:thin:@IP:PORTA:CONTEXT
O"/>
<Parameter name="jintegra.db.user" value="DBAMV"/>
<Parameter name="jintegra.db.password" value="SENHA_DBAMV"/>
<Parameter name="jintegra.rmi.host" value="127.0.0.1" />
<Parameter name="jintegra.rmi.port" value="2239" />
<Parameter name="jintegra.db.minPoolSize" value="2" />
<Parameter name="jintegra.db.maxPoolSize" value="20" />
<Parameter name="jintegra.db.maxIdleTime" value="1800" />
<Parameter name="jintegra.db.maxConnectionAge" value="1800" />
</Context>

Devem ser alteradas as seguintes linhas, no arquivo context.xml descrito no exemplo acima:
• <Parameter name="jintegra.db.url"
value="jdbc:oracle:thin:@IP:PORTA:CONTEXTO"/>
• IP = Deve conter o endereço IP do banco de dados. Exemplo: 192.168.1.1
• PORTA = Deve conter a porta do serviço do banco de dados. Exemplo: 1521

Copyright ©2023MV. Todos os direitos reservados. 8

 • CONTEXTO = Deve conter o contexto do banco de dados que será consultado.
Exemplo: sml.
• <Parameter name="jintegra.db.password" value="SENHA_DBAMV"/>
• SENHA_DBAMV = Deve conter a senha de acesso do usuário DBAMV ao banco de
dados. Exemplo: 123456.
Exemplo preenchido:

Exemplo de trecho preenchido:

<Parameter name="jintegra.db.url" value="jdbc:oracle:thin:@192.168.1.1:1521:sml

"/>
<Parameter name="jintegra.db.password" value="123456"/>

Para bancos que utilizam rack, a jintegra.db.url pode ser utilizada referenciando um alias Oracle:

Exemplo de trecho preenchido:

<Parameter name="jintegra.db.url" value="jdbc:oracle:thin:@(DESCRIPTION=(ADDRES

S_LIST=(ADDRESS=(PROTOCOL=TCP)(Host=192.168.1.1)(Port=1521)))
(CONNECT_DATA=(SID=sml)))"/>

Configurando Tabela e Procedure que pertencerão ao schema MVINTEGRA do banco de dados

Deve ser importado, usando o cliente do banco de dados, os objetos SQL responsáveis pela consulta
assíncrona do lote.

Tabela: MVINTEGRA.IMV_REINF Procedure: MVINTEGRA.

PRC_IMVW_REINF_CONS_JOB

Copyright ©2023MV. Todos os direitos reservados. 9

Copyright ©2023MV. Todos os direitos reservados. 10
 Ativando a execução automática do objeto JOB no banco de dados

O objeto procedure, responsável pela consulta de lote assíncrona, necessita ser executado constantemente
para que haja o correto funcionamento do fluxo.

Procedimento deverá ser realizado via client de banco.

Execução do job:
por dia: sysdate + 1
por hora: sysdate + 1/24
por 1 minuto: sysdate+ 1/(24*60)
por 5 minutos: sysdate + 5/1440

Ativando a execução automática do objeto JOB no banco de dados

DECLARE

Copyright ©2023MV. Todos os direitos reservados. 11

 jobno INTEGER;
BEGIN
DBMS_JOB.SUBMIT(jobno, 'Begin MVINTEGRA.PRC_IMVW_REINF_CONS_JOB; end;',
Sysdate, 'sysdate+5/1440');
COMMIT;
END;

Consultar inclusão do objeto na execução automática do banco.

Consultar inclusão do objeto na execução automática do banco

SELECT *
FROM sys.dba_jobs
WHERE Upper(what) LIKE Upper('%MVINTEGRA.PRC_IMVW_REINF_CONS_JOB%');

Copyright ©2023MV. Todos os direitos reservados. 12

Configuração do Certificado do tipo A1
Colocar a chave pública na pasta de certificados do serviço mv-api-sped-reinf.

É necessário utilizar um certificado A1 do tipo e-CNPJ com o CNPJ da instituição que transmitirá dados para
o serviço da Receita Federal e colocar a chave pública do certificado (.pfx) na pasta de certificados do
serviço mv-api-sped-reinf (conforme imagem abaixo). A chave pública servirá para assinar digitalmente o
conteúdo para certificados A1 e abrir conexão SSL com o serviço da Receita Federal.

Configurar arquivo de propriedades do serviço mv-api-sped-reinf

É necessário adicionar o alias (CNPJ), e a senha do certificado A1 ao arquivo de propriedades do serviço.

Além disso, é necessário informar o nome do certificado, como no exemplo acima
seria SeuCertificado.pfx. Adicionalmente, ao lado de cada variável há um número, como exemplo
senhaCertificado1. Este número significa a empresa que será considerada para envio. Portanto, todas as
configurações do arquivo abaixo seriam para a empresa 1, tornando necessário que para outras empresas,
seja adicionado ao arquivo de propriedades, as configurações para a empresa 2, 3, e assim sucessivamente.
Exemplo:
• O aliasCertificado1 = CNPJ do certificado da empresa 1.
• A senhaCertificado1 = senha do certificado de segurança. (Verificar a senha com o provedor de
certificados).

Copyright ©2023MV. Todos os direitos reservados. 13

Finalizando a instalação do Tomcat
Depois de configurar o arquivo de propriedades e inserir a chave pública na pasta do serviço, com as
URLs devidamente configuradas, reiniciar o tomcat para que as configurações sejam efetivadas.

Copyright ©2023MV. Todos os direitos reservados. 14

Configuração do FCCT no SoulMV
Configuração de parâmetro
Na tela "Cadastro Geral de Parâmetros" (Serviços de Apoio / Global / Configurações / Cadastro Geral de
Parâmetro (CONFIG_SERVICE)), o usuário deverá configurar no Parâmetro "DS_LINK_REINF", o IP e a
Porta do Servidor que foi instalado o TOMCAT com o Serviço de comunicação com a Receita Federal.

Copyright ©2023MV. Todos os direitos reservados. 15

ATENÇÃO: Atualização de Banco
• A cada atualização de banco, é necessário compilar os objetos de banco, limpar os logs do serviço do
Tomcat e reiniciá-lo.

Copyright ©2023MV. Todos os direitos reservados. 16

ATENÇÃO: Passo a passo para atualização do serviço do SPED-
Reinf
Parar o serviço de integração.

Ir até a pasta do Tomcat de integração e fazer um backup da pasta /certificados/ e do arquivo

application.properties

Substituir o mv-api-sped-reinf.war pelo novo https://cloud.mv.com.br/index.php/s/RCYcJOSaU6uZ7RB

Excluir a pasta /mv-api-sped-reinf/ contida na pasta webapps do Tomcat de integração.

Copyright ©2023MV. Todos os direitos reservados. 17

 Iniciar o serviço de integração novamente e aguardar alguns segundos;
Parar o serviço de integração;
Ir até a pasta de backup onde foi guardada a pasta de certificados /certificados/ e application.properties,
e copiar os arquivos para a nova pasta /mv-api-sped-reinf/ dentro do Tomcat de integração;
Iniciar o serviço;
Pronto! Já é possível emitir novamente os lotes de Reinf.

Copyright ©2023MV. Todos os direitos reservados. 18

Conclusão
Neste documento foi apresentado o passo a passo para instalação e configuração do serviço mv-
api-sped-reinf, Seguindo minunciosamente os passos supracitados, é possível configurar o serviço
para envio do SPED-Reinf que enviará as mensagens de transmissão para o SPED-Reinf, assinados
digitalmente.

Copyright ©2023MV. Todos os direitos reservados. 19