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.

Retorno da Operação de Manifesto

{
  "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": [
    "[e-mail]"
  ]
}