Guia prático de utilização – NFSe DLL
21/09/2026
Este guia tem como objetivo explicar rapidamente o funcionamento das funções que podem ser encontradas na nossa DLL NFSe. O uso na prática destas funções pode ser observado através do código fonte do aplicativo de testes que acompanha o pacote – pasta “source”.
1. GeraDPS / GeraDpsStr: Esta função vai receber um conjunto de vetores que devem ser preenchidos conforme o exemplo no fonte do aplicativo de testes. No mesmo estão comentados cada posição de cada vetor, e qual tag é gerada, assim como instruções para tags específicas, caso seja necessário.
Exemplo em C#:
Nos casos dos pacotes VB6 e Delphi, a função que deve ser utilizada é a GeraDpsStr. Ela funciona de maneira semelhante, no entanto ela recebe uma string concatenada com os valores de todas as posições de todos os vetores. No próprio código fonte do aplicativo de testes é possível encontrar uma função que faz este processo e que pode ser simplesmente copiada e utilizada no seu próprio código.
2. AssinarArquivoXML: Esta função é utilizada para assinar o xml da DPS que foi gerada no passo anterior para que possa ser transmitida e validada pela SEFAZ. A função simplesmente recebe o caminho do arquivo que precisa ser assinado e em seguida vai solicitar um certificado digital válido para concluir a assinatura. Após isto o arquivo assinado será gerado na pasta “…\nfse\DPS\assinado”.
3. ValidarArquivoXML: Esta função funciona de forma semelhante à anterior. Ela recebe o caminho de um arquivo assinado, e vai fazer uma validação estrutural do arquivo. Isto evita que erros muito óbvios passem para a fase de transmissão do arquivo, mas ela não valida erros relacionados às informações que são passadas, apenas valida a estrutura e sintaxe do arquivo xml assinado.
4. EnviarDpsGerarNfse: Esta é a função que faz a transmissão do DPS assinado e retorna o resultado da transmissão. Basta informar o caminho do DPS assinado, em seguida o componente vai solicitar novamente um certificado digital válido, e logo após a transmissão será feita. Caso haja algum erro, uma mensagem será retornada explicando o que causou o erro. Caso a DPS seja aprovada, o XML da NFSe será finalmente gerado no caminho “…\nfse\NF”.
5. ImprimeDANFSe: A função para impressão do DANFSe não está funcional no momento pois a SEFAZ desativou a API que fazia a geração do PDF, e estamos trabalhando para implementar uma impressão própria. No entanto, é possível baixar o PDF da NFSe através do portal da própria NFSe e para isto basta simplesmente informar a chave de acesso da nota que foi emitida.
Acessando o portal: https://www.nfse.gov.br/consultapublica/, é possível baixar notas que foram emitidas em produção.
Já através do portal: https://www.producaorestrita.nfse.gov.br/consultapublica/, é possível baixar notas emitidas em homologação.
Este processo também pode ser feito através do Portal do contribuinte que também existem ambos em ambiente de produção e homologação.
Portal do Contribuinte (Produção): https://www.nfse.gov.br/EmissorNacional/Login
Portal do Contribuinte (Homologação): https://www.producaorestrita.nfse.gov.br/EmissorNacional/Login