Fluxo - Recebimento NF-e
O fluxo demonstrado a seguir trata o recebimento de NF-e dentro da integração com a InvoiSys.
APIs Essenciais 💡
Requisitar consulta por Chave de Acesso: /api/nfeentrada/entradadanfe
Enviar manifesto do documento: /api/nfeentrada/manifestar
APIs Opcionais 🥈
Consulta do documento por ID: /api/nfeentrada/{id}
Realizar download do documento: /api/nfeentrada/download
Realizar envio por e-mail do documento: /api/nfeentrada/enviaemail
Etapas e suas APIs
Para detalharmos melhor a operação, a separamos em tópicos, porém você consegue ver o fluxo completo aqui 📝.
1) Requisições e consultas periódicas
Antes de iniciamos a emissão da nota, é necessário estar com um token de acesso válido, pois este será utilizado no cabeçalho da chamada das APIs. Tendo ele em mãos, podemos partir para as devidas operações do fluxo.
A princípio, nossa solução irá fazer a consulta periódica por documentos que foram emitidos contra o seu estabelecimento direto na SEFAZ. Da mesma forma, você poderá pedir para que o sistema faça isto com um documento em específico, utilizando a API de Consulta por Chave de Acesso.
Aqui existem algumas informações que podem ser interessantes você guardar, como a própria chaveDeAcesso
e o id
do documento criado em nossa base. Estas informações são importante, já que elas são utilizados em outras APIs.

2) Realização do Manifesto
Com as informações do documento emitido contra a empresa em nossa base, você poderá realizar o envio de um manifesto. Um manifesto que pode ser composto por 4 tipos de eventos:
Ciência da Operação;
Confirmação da Operação;
Desconhecimento da Operação;
Operação não Realizada.

{
"data": "0001-01-01T00:00:00",
"tipo": {
"key": 19,
"value": "Confirmação da Operação"
},
"statusSEFAZ": "135",
"descricaoSEFAZ": "Evento registrado e vinculado a NF-e",
"xml": null
}
3) Download e envio por E-mail
Com o documento disponibilizado para você em nossa solução, possuímos duas funcionalidades que estão disponíveis para seu auxílio.
a) Download da NF-e; b) Envio por E-mail da NF-e.
a) Download da NF-e
Como o nome já diz, nós disponibilizaremos uma API onde será retornado para você o XML do documento para consulta. Como forma alternativa, também possuímos a API de consulta da DANFE caso deseja realizar a visualização e download da mesma.
b) Envio por E-mail da NF-e
Com esta API, será possível montar um simples modelo de E-mail, incluindo assunto, corpo, destinatários e qual a NF-e a ser disponibilizada. Abaixo temos um exemplo de como esta API é montada:
{
"idNFe": 999999,
"assunto": "NF-e de Entrada",
"corpoEmail": "Mensagem do E0mail",
"destinatarios": [
"email@email.com"
]
}
Last updated
Was this helpful?