Integrador Nota Nacional - NFSe Nacional

O NFSe-Nacional é um agente local que consome a API do ADN (Ambiente de Dados Nacional), capturando notas fiscais e eventos gerados pelos MEI do município e convertendo-os em notas fiscais no banco de dados municipal.

Download dos arquivos

Para iniciar a instalação você precisará de alguns arquivos, para baixar basta clicar aqui.

Feito o download do arquivo (NfseNacional.rar) descompacte ele dentro do servidor em C:/Fiorilli.

Certifique-se de que dentro da pasta terá um arquivo chamado integrador.exe e outro integrador.xml 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}
  </arguments>
  <log mode="rotate"></log>
</service>

Configurações obrigatórias:

  • {caminho para jre}: caminho da JRE Azul 21 na máquina (diretório da pasta \bin)

  • {caminho do jar}: caminho para o jar nfse-nacional

  • {porta}: porta a ser usada (por exemplo, 8080 ou 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" para definição do cronograma de processamento. Exemplo (de dois em dois minutos):

0 */2 * * * *

Se omitido, o processamento padrão será de 5 em 5 minutos. Recomenda-se não configurar abaixo de 2 minutos.

  • Execute o comando para instalar o serviço:

integrador install

Operação do Serviço

  • Para iniciar o serviço:

integrador start

  • Para parar:

integrador stop

  • Para desinstalar:

integrador uninstall

Observações Importantes

  • É necessário que a prefeitura tenha o certificado digital informado na tabela GR_CAD_EMPRESA.

  • Os logs de instalação e do nfse-nacional serão gerados na mesma pasta onde foram colocados o instalador e o arquivo XML de configuração.

  • Erros de execução do nfse-nacional (não relacionados ao instalador) serão registrados no arquivo nfse-nacional.log.

  • Se o sistema já possuir uma JDK 21 (como usada no chat do FlowDocs), é possível utilizá-la.

  • Embora não recomendado, é possível trocar o nome do XML, informando o nome nos comandos.

  • Também é possível (ainda não recomendado) renomear o integrador.exe. Se o XML tiver o mesmo nome, funcionará normalmente (exemplo: notafiscal.exe, notafiscal.xml).

  • É necessário ter o servicosweb rodando, e o url dele configurado na tabela GR_CONFSERVICOSWEB nos campos URL_PORTALWEB_CSW - para o portal de serviços (/servicosweb) e URL_WEBSERVICE_CSW - para o webservice do portal de serviços (/servicosweb-ws)

"C:\Fiorilli\Downloads\Instalacao\NfseNacional\integrador.exe"