Importação de NFS-e Através do WS de Distribuição do Modelo Nacional
O processo de importação de NFS-e via Web Service de Distribuição do Modelo Nacional utiliza o ADN como um repositório centralizado de documentos.
Diferente da consulta tradicional realizada em cada prefeitura, este método permite que o InvoiCy monitore e capture automaticamente as notas emitidas contra o CNPJ da empresa em todo o território nacional, utilizando o NSU para garantir a sincronia e a integridade de todas as notas recebidas.
É importante ressaltar que, para garantir a segurança e a conformidade no ambiente nacional, cada filial deve utilizar seu próprio certificado digital para a comunicação. Como o CNPJ utilizado nas consultas é extraído diretamente do certificado, o uso do documento da matriz não é aceito para representar as filiais; portanto, cada unidade deve possuir um certificado específico para realizar suas consultas de notas.
Configurações de Importação
Para configurar a importação de NFS-es através do Web Service de distribuição do Modelo Nacional, ative a extensão Importação de Documentos para a empresa e configure o parâmetro "Tipo de arquivos para importar no módulo NFS-e", conforme evidenciado abaixo:
Para realizar as consultas através do WS de distribuição do Modelo Nacional, é necessário definir o parâmetro "Consultar NFS-e recebidas no Ambiente Nacional" como "Sim".
Além disso, é possível configurar o número de consultas realizadas na prefeitura através do parâmetro "Número de Consultas diárias na PREFEITURA (NFS-e)".
No entanto, caso configure os parâmetros conforme recomendado anteriormente, estas consultas passam a ser realizadas no ADN, e este por sua vez, permite realizar até 12 consultas diárias.
Nas configurações da extensão de importação, pode ser registrado o último NSU da NFS-e. Este NSU também pode ser informado na tela de Configurações para Emissão dentro do grupo "Parâmetros" ou enviado junto ao cadastro da empresa via Web Service, conforme descrito aqui.
Após registrar as configurações definidas pelo usuário, um processo irá automaticamente consultar no ambiente de dados nacional as notas recebidas e importar para o InvoiCy. A consulta sempre será realizada nas primeiras horas do dia seguinte, buscando as notas do dia anterior.
Consulta e Exportação de Notas Importadas
Caso desejar, após a importação dos documentos, é possível realizar a consulta e download dessas notas.
Estas operações podem ser realizadas por integração via SOAP ou API REST, ou diretamente pela interface do sistema, utilizando as opções disponíveis na coluna "Ações" do documento correspondente.
Se o documento possuir algum evento, será retornado o grupo correspondente ao evento, apenas se o parâmetro "XML InvoiCy no retorno da requisição" na tela de "Configuração para Emissão” estiver configurado como "NFSe InvoiCy". Consulte mais informações aqui.
Notificação via Webhook
Sempre que um documento for importado com sucesso via Web Service de Distribuição do Modelo Nacional, o InvoiCy disparará automaticamente uma notificação para o Webhook cadastrado.
Para habilitar esse recurso, realize o cadastro de um novo Webhook e certifique-se de que a URL de destino esteja devidamente parametrizada na tela de configurações do Webhook. Através desse fluxo, o ERP recebe os dados da nota de forma imediata, garantindo maior agilidade no processamento das NFS-e recebidas.