1. INTRODUÇÃO

Este manual tem como objetivo apresentar a definição das especificações e critérios técnicos necessários para utilização da API disponibilizada pelo Sistema Nacional da NFS-e para as empresas prestadoras e/ou tomadoras de serviços. Por meio do uso da API as empresas poderão integrar seus próprios sistemas de informações com o Sistema de Notas Fiscais Eletrônicas do modelo nacional.  Para executar os passos descritos neste guia, é necessario que se tenha certificado digital válido e a prefeitura estar parametrizada para uso do sistema nacional.

2. CHAVE DE REGISTRO

É necessário a configuração previa da chave de parametros no regedit. Deste modo, importe no regedit a chave key.reg disponível no pacote e configure corretamente conforme indicado abaixo:

• Ambiente ›› 1 – Produção | 2 – Testes;
• AtivaTrace ›› 0 – Desativado | 1 – Ativado;
• ImgPrefeitura ›› Path referente a imagem com logomarca da prefeitura;
• ImgPrestador ›› Path referente a imagem com a logomarca do prestador de serviço;
• Layout ›› 99 – para o ambiente nacional
• NoSerieCertificado ›› Valor que correspondente ao numero de serie do certificado;
• PathPrincipal ›› Path onde tem o repositório de pastas do projeto nfse, ex: c:MinhaAplicacaonfse;
• VerProc ›› Versão do schema;

3. APLICATIVO DE TESTES DE FUNCIONALIDADES

O pacote NFSeDLL dispõe de um executável (com fonte) com exemplos de todas as funcionalidades do projeto. Este executável é de extrema importância para testes preliminares do projeto e seu fonte serve de respaldo para implementação da solução em seu sistema de automação, deste modo, sugerimos que se familiarize com o aplicativo, acionando os métodos disponíveis. A sequencia para execução dos métodos varia de acordo com a exigência de cada ambiente.

EXECUÇÃO DE MÉTODOS PASSO-A-PASSO

Api Nacional – Layout 99

1) Gerar DPS ›› Preencher os arrays com os dados correspondentes, respeitando o numero sequencial do DPS.
## Método: nfse.GeraDps
RETORNO: C:\nfse-app\nfse\DPS\DPS355030825944964800019200001000000000000001.xml

Para os projetos VB6 e Delphi, utilizar GeraDpsStr, esta recebe uma string com a concatenação de todos os arrays separados por “|”, no código fonte dos aplicativos de teste de ambos os projeto Delphi e VB6 é possível encontrar uma função que faz esta concatenação, sendo necessário apenas copiar para o seu projeto.

2) Assinar DPS ›› Aqui deverá ser selecionado o arquivo DPS, cujo path é informado no passo 1, para que ele seja assinado digitalmente utilizando certificado digital válido.
## Método: nfse.AssinarArquivoXML
RETORNO: C:\nfse-app\nfse\DPS\assinado\DPS355030825944964800019200001000000000000001-assinado.xml

3) Validar XML›› Aqui deverá ser selecionado o arquivo DPS assinado, cujo path é informado no passo 2, para que ele tenha o xml validado.
## Método: nfse.ValidarArquivoXML
RETORNO: True {Arquivo validado com Sucesso}

4) Transmitir DPS›› Aqui deverá ser selecionado o arquivo DPS assinado, cujo path é informado no passo 2, para que ele seja transmitido para o sistema nacional, retornando a NFS-e caso seja aprovado.
## Método: nfse.EnviarDpsGerarNfse
RETORNO: NFS-e gerada com sucesso: 32050022205915656000158000000000000525120081580525
HTTP Status: 201
Ambiente: 2
ID DPS: NFS32050022205915656000158000000000000525120081580525
Data/Hora: 2025-12-30 17:08:31
Aplicativo: SefinNac_Pre_1.4.0

5) Imprimir›› Informando a chave numérica da NFS-e que é retornada no passo anterior ao método ImprimeDANFSe, será feito o Download do PDF gerado pelo próprio sistema da NFS-e Nacional retornando o caminho do PDF. No segundo parâmetro deste método pode-se informar um caminho para onde o PDF será gerado.
Método: nfse.ImprimeDANFSe
Retorno: C:\nfse-app\nfse\PDF\DANFSe_32050022205915656000158000000000000525120081580525.pdf

Mais informação entre em contato através de um de nossos canais de atendimento disponíveis em nosso site.

Equipe ASX COMPONENTES