Invent Apps NF-e | Fluxo de Processos - Processamento

Entenda o fluxo de processamento de Notas Fiscais via Invent Apps

O processamento de Notas Fiscais via Invent Apps é o fluxo em que o sistema recebe, por integração, os dados necessários para geração, assinatura, transmissão e acompanhamento de uma NF-e ou NFC-e junto à SEFAZ.

Nesse processo, o ERP ou sistema de origem envia para o Invent Apps um JSON contendo as informações da Nota Fiscal. Após o recebimento, o Invent Apps valida os campos obrigatórios, monta o XML, assina o documento com o certificado digital do cliente, transmite a Nota Fiscal para a SEFAZ, recebe o retorno, persiste as informações no banco de dados e disponibiliza os XMLs e os dados principais para consulta.

Atenção: para utilizar o processamento via Invent Apps, é necessário que a comunicação entre o ERP ou sistema de origem e o Invent Apps esteja previamente configurada. Além disso, o certificado digital da entidade emissora deve estar cadastrado no aplicativo Dados Mestres, pois ele será utilizado para assinar digitalmente o XML da Nota Fiscal.

Diferença entre sincronismo e processamento

Processo	Descrição
Sincronismo	O Invent Apps recebe uma cópia de um XML já autorizado fora do sistema, interpreta seus dados e cataloga a Nota Fiscal.
Processamento	O Invent Apps recebe os dados da Nota Fiscal por API, gera o XML, assina digitalmente, transmite para a SEFAZ, recebe o retorno e registra o resultado do processamento.

Visão geral do fluxo

O processamento via Invent Apps é assíncrono. Isso significa que, ao receber o JSON da Nota Fiscal, o sistema retorna um número de protocolo para acompanhamento, enquanto o processamento do documento ocorre em segundo plano.

ERP → Envio do JSON → Protocolo → Geração do XML → Assinatura digital → SEFAZ → Consulta do resultado

Com o protocolo retornado pelo Invent Apps, o sistema de origem pode consultar posteriormente o resultado do processamento no endpoint de consulta, que retorna os principais XMLs relacionados ao documento, como XML de envio, XML de retorno e XML processado.

Pré-requisitos para o processamento

Pré-requisito	Descrição
Comunicação configurada	O ERP ou sistema de origem deve estar configurado para consumir o endpoint de processamento do Invent Apps.
Certificado digital cadastrado	O certificado digital da entidade emissora deve estar previamente cadastrado no aplicativo Dados Mestres.
Campos obrigatórios preenchidos	O JSON enviado deve conter os campos obrigatórios necessários para que o Invent Apps consiga gerar a Nota Fiscal.
Controle pelo ERP	O controle de numeração, série, itens, impostos e cadastro do destinatário é de responsabilidade do ERP ou sistema de origem.

Atenção: a validação dos campos obrigatórios permite que o Invent Apps gere a Nota Fiscal, mas não garante a autorização do documento pela SEFAZ. A autorização depende também da consistência fiscal das informações enviadas no JSON, conforme validações aplicadas pelo órgão autorizador.

Etapas do processamento

Etapa	Descrição	Resultado esperado
Envio dos dados	O ERP envia ao Invent Apps um JSON contendo os dados da NF-e ou NFC-e.	Dados recebidos pelo endpoint de processamento.
Retorno do protocolo	O Invent Apps retorna um protocolo para que o sistema de origem acompanhe o processamento.	Protocolo disponível para consulta posterior.
Validação de campos obrigatórios	O sistema verifica se as informações mínimas necessárias para geração da Nota Fiscal foram enviadas.	Continuidade do fluxo quando os campos obrigatórios estiverem preenchidos.
Geração do XML	O Invent Apps monta o XML da Nota Fiscal com base nos dados recebidos no JSON.	XML gerado conforme os dados enviados pelo sistema de origem.
Assinatura digital	O XML é assinado utilizando o certificado digital da entidade emissora cadastrado no aplicativo Dados Mestres.	XML assinado e pronto para transmissão.
Transmissão para SEFAZ	O Invent Apps transmite o XML assinado para autorização junto à SEFAZ.	Documento enviado ao órgão autorizador.
Recebimento do retorno	O sistema recebe o retorno da SEFAZ, refletindo a situação fiscal retornada para a Nota Fiscal.	Resultado do processamento recebido pelo Invent Apps.
Persistência dos dados	O Invent Apps grava no banco de dados os dados da Nota Fiscal, os retornos recebidos e os XMLs relacionados.	Documento registrado e disponível para consulta.
Consulta do processamento	Com o protocolo, o sistema de origem consulta o resultado do processamento no endpoint de consulta.	Retorno dos dados principais e dos XMLs de envio, retorno e processado.

Eventos fiscais

Os eventos fiscais seguem a mesma lógica do processamento via Invent Apps. O sistema recebe os dados do evento por integração, realiza o processamento necessário, registra as informações e disponibiliza o resultado para consulta conforme o fluxo configurado.

A principal diferença em relação ao processamento da Nota Fiscal é que, para o correto referenciamento do evento, a Nota Fiscal base precisa estar previamente registrada no Invent Apps. Isso permite que o sistema localize o documento fiscal relacionado e vincule o evento à nota correspondente.

Eventos como cancelamento, carta de correção ou outros eventos aplicáveis podem atualizar informações ou alterar a situação da Nota Fiscal, dependendo do tipo de evento processado e do retorno obtido.

Atenção: para que um evento fiscal seja vinculado corretamente, a Nota Fiscal base deve existir no Invent Apps. Caso a nota referenciada ainda não esteja registrada no sistema, o evento pode não ser associado corretamente ao documento fiscal.

Documentação API

A documentação da API reúne as informações técnicas necessárias para integrar o ERP ou sistema de origem ao Invent Apps.

Nela estão descritos os endpoints disponíveis para processamento, consulta de protocolos e geração ou extração de eventos fiscais, além dos payloads esperados, retornos da integração, campos obrigatórios e exemplos de utilização.

Essa documentação é indicada para equipes técnicas responsáveis pela integração, pois orienta como enviar os dados da NF-e ou NFC-e, acompanhar o processamento assíncrono e consultar os XMLs gerados durante o fluxo, como XML de envio, retorno e processado.

Acessar documentação API

Acessar documentação API - Modelo Swagger

FAQ

O Invent Apps processa NF-e e NFC-e?

Sim. O fluxo de processamento pode ser utilizado para NF-e e NFC-e, conforme integração e regras aplicáveis ao ambiente.

O retorno do endpoint de processamento já indica que a nota foi autorizada?

Não. O processamento é assíncrono. O endpoint retorna um protocolo para acompanhamento, e o resultado final deve ser consultado posteriormente no endpoint de consulta.

O preenchimento dos campos obrigatórios garante a autorização da Nota Fiscal?

Não. Os campos obrigatórios permitem que o Invent Apps gere a Nota Fiscal, mas a autorização depende das validações fiscais realizadas pela SEFAZ.

Quem controla a numeração, série, itens, impostos e destinatário?

Essas informações são de responsabilidade do ERP ou sistema de origem, que deve enviá-las corretamente no JSON de processamento.

Onde o cliente consulta o resultado do processamento?

O resultado pode ser consultado por meio do endpoint de consulta, utilizando o protocolo retornado no envio inicial. Essa consulta retorna os principais dados e XMLs relacionados ao processamento.

Os eventos fiscais seguem a mesma lógica de processamento?

Sim. Os eventos fiscais também são processados pelo Invent Apps. A principal diferença é que a Nota Fiscal base precisa estar registrada no sistema para que o evento seja corretamente referenciado e vinculado ao documento.

O que você precisa resolver hoje?