- - - - - - - - - - - - - - - - - - - - - - - - - 
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.api.sia8.base-url={url da api do sia}
  </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:3055/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)
{url da api do sia}     - url do gateway da api do sia (se tiver diferença entre endereços de acesso, usar o endereço de acesso interno) exemplo http://127.0.0.1:8093/api
						  
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!
 -> Não salvar mobiliário
	É possível configurar para o integrador não salvar empresas de prestadores, ainda que sejam da cidade. O sistema já não salva no mobiliário empresas prestadoras de outros municípios,
	apenas salva no módulo contribuinte. Essa configuração modifica para fazer isso com todas as empresas que ainda não existam no banco.