Roteiro de implantação

Encontre informações sobre como implementar a NFBLibrary

Abaixo estão os passos gerais para implantação da NFBLibrary em seu sistema.

Antes de começar

Antes de começar a usar a NFBLibrary em seu sistema, recomendamos que:

Leia o manual de integração fornecido pelo governo para conhecer o funcionamento do projeto e principalmente o layout nacional da NFS-e;
Providencie um certificado digital válido;
Faça a configuração da NFBLibrary em sua Workspace conforme especificado no tópico Configuração.

Passo-a-passo

1 – Gerar a DPS

Para geração do arquivo XML da DPS, a NFBLibrary fornece a função NFBGerarXMLDPS. Esta função recebe um único parâmetro do tipo tNFBGeraXMLDPSParam, uma estrutura (Struct) que contém todos os campos necessários para gerar o XML da DPS.

A estrutura tNFBGeraXMLDPSParam está definida no pacote da função. Porém, existe internamente a estrutura vtInfDPS que está definida no pacote NFBStructs.pkg.

O Code Complete do Visual DataFlex Studio 12.0 ou superior facilita o preenchimento da estrutura, pois exibe os campos existentes conforme demonstrado na imagem que segue:

Code Complete

A NFBLibrary é fornecida com uma Workspace de Exemplo, que demonstra o preenchimento da estrutura e a chamada da função NFBGerarXMLDPS. Para mais detalhes, consulte o pacote NFBPreparaDPSExemplo.pkg.

Observação

É importante salientar que é de total responsabilidade do desenvolvedor o preenchimento correto das informações, não sendo responsabilidade da NFBLibrary garantir a correta carga das informações diante de cada contexto fiscal.

2 – Envio da DPS

Uma vez gerado o arquivo XML da DPS, a próxima etapa é enviar o XML gerado para o ADN. Para realizar o envio, a NFBLibrary fornece a função NFBRecepcionarDPS, que realiza o envio síncrono e salva o XML da NFS-e gerado pela ADN, quando validado e aceito pelo ambiente nacional. Caso o contrário, será retornado eventual mensagem de erro. Para mais detalhes, consulte a documentação completa da função.

3 – O lote foi processado com sucesso. E agora?

A rigor, se a DPS foi processada com sucesso, ou seja, a NFS-e foi gerada, não é necessário fazer mais nada.
Não existe exigência legal para a impressão da NFS-e. No entanto, caso queira, a NFBLibrary disponibiliza a função NFBGerarDANFSe, que realiza a geração e download do DANFSe no formato PDF.