- - - - - - - - - - - - - - - - - - - - - - - - - 
Fiorilli Software Ltda
- - - - - - - - - - - - - - - - - - - - - - - - - 

Integrador Nota Nacional - NFSE-NACIONAL

O nfse-nacional é um agente local que consome a api do ADN (Ambiente de Dados Nacional), consumindo as notas fiscais e eventos gerados pelos MEI do município,
convertendo em notas no nosso banco no município, incluindo cancelamentos e substituições.

# Requisitos

Para instalar o agente como um serviço no windows, são necessários:
 -- JRE versão 21 da Azul 
 -- arquivo instalador integrador.exe

# Instalação

É necessário criar um arquivo integrador.xml na mesma pasta do executável integrador.exe, com o seguinte conteúdo:

<service>
  <id>nfse-nacional</id>
  <name>Integrador Nota Nacional</name>
  <description>Integrador Nota Nacional</description>
  <env name="JAVA_HOME" value="{caminho para jre}"/>
  <executable>%JAVA_HOME%\java</executable>
  <arguments>
	-Xrs -Xmx512m -jar {caminho do jar}
	--server.port={porta}
	--spring.datasource.url={url jdbc do banco}
	--br.com.fiorilli.nfse.cron-processamento={cron de processamento}
	--br.com.fiorilli.servicosweb.url-api={api servicos}
  </arguments>
  <log mode="rotate"></log>
</service>

{caminho para jre} ------ caminho da jre azul 21 na máquina (o caminho para a pasta \bin da jre)
{caminho do jar} -------- caminho para o jar nfse-nacional
{porta} ----------------- porta a ser usada ex 8080, 8085
{url jdbc do banco} ----- url de acesso ao banco no formato: jdbc:firebirdsql://{ip}:{porta}/{caminhoFDB} exemplo jdbc:firebirdsql://127.0.0.1:3050/E:\SGB_DADOS\SIADADOS.FDB
{cron de processamento} - formato "cron" definindo o cronograma para processamento ex (de dois em dois minutos): 0 */2 * * * * 
						  a opção --br.com.fiorilli.nfse.cron-processamento pode ser omitida, sendo assim configurada para o padrão (processar de 5 em 5 minutos)
{api servicos} ---------- url da api do servicosweb, exemplo: http://localhost:8090/servicosweb-ws/rest (deve conter o final "/rest" !)
						  
Depois de criar o arquivo, basta executar o comando para instalar o serviço:
	
	integrador install

Para iniciar o serviço, basta executar:

	integrador start
	
Para parar:

	integrador stop
	
Para desinstalar:

	integrador uninstall

*** Observações:

- É necessário que a prefeitura tenha o certificado digital informado na GR_CAD_EMPRESA
- Os logs de instalação e do nfse-nacional vão aparecer na mesma pasta onde foram colocados o instalador e o xml de configuração
- Os erros de execução do próprio nfse-nacional (não do instalador) vão aparecer no arquivo nfse-nacional.log
- Se o sistema já possuir uma jdk 21 (como usada no chat do FlowDocs), é possível usá-la
- É possível (embora não recomendado) trocar o nome do xml, mas aí é necessário informar o nome após os comandos
- Também é possível (e ainda não recomendado) trocar o nome do integrador.exe, e se o xml tiver o mesmo nome, funcionará normalmente com o nome informado (ex: notafiscal.exe, notafiscal.xml)

** Configuração avançada

 -> Atualização de notas já cadastradas:
	É possível habilitar a atualização de notas que já foram importadas, de modo a corrigir erros anteriores na importação. Basta adicionar a propriedade: --br.com.fiorilli.nfse.atualizar-notas=true
	ao xml de configuração, dentro da tag <arguments>.
	É recomendado fazer a atualização apenas para correção de notas anteriores, e uma vez que se verificar que estão corrigidas, parar o serviço, remover a configuração, e reiniciar.
	* Atenção: o modo de atualização também faz a remoção de notas que foram duplicadas erroneamente na importação, removendo as que foram cadastradas mais recentemente.
 -> Modo de importação intensivo
	Juntamente ao modo de atualização de notas, é possível habilitar um modo intensivo de importação, que utiliza mais recursos computacionais para acelerar o processo.
	Basta adicionar a propriedade: --br.com.fiorilli.nfse.modo-intensivo=true ao xml.
	* Atenção: é recomendado fazer a importação intensiva de modo supervisionado, conferindo os logs em tempo real, e conferindo erros e os dados de importação
	* Aviso: o cron de processamento é ignorado ao configurar o modo intensivo
 -> Importação paralela
	Para permitir importação mais rápida, tanto no modo intensivo, quanto no normal, é possível habilitar até 25 threads para executar a importação em paralelo.
	Por padrão, é configurado o número 0 (zero), indicando ao sistema utilizar o número de processadores disponíveis na máquina.
	Adicione a propriedade: --br.com.fiorilli.nfse.threads-processamento=<insira aqui o número de threads>
	* Atenção: se for configurado um número superior a 25, o sistema vai apontar erro e não vai iniciar!