Passo a Passo

Legal! Que bom que você deseja integrar sua solução com a gente! Nesta página nós iremos te auxiliar em como realizar este processo.

Contato Inicial

Primeiramente precisamos criar um usuário para você. Para isto, basta entrar em contato conosco através desta página!‌

Com a criação de um usuário, você terá acesso as nossas APIs!‌

Pré-Requisitos

Para iniciar os seus testes, você precisará ter em mãos os dados de uma empresa credenciada para o recebimento de NF-e e o certificado digital da mesma.‌

Após isso, basta seguir os seguintes passos:‌

• Fazer o login no Portal InvoiSys com usuário obtido;

• Cadastrar a empresa e incluir o certificado digital (Você pode conferir aqui como fazer o cadastro)​

Tudo em ordem? Então podemos começar os testes!‌

Conhecendo as APIs

Antes de iniciar seu desenvolvimento, separamos algumas APIs para que você possa testar pelo Swagger, a fim de que possa conhecer suas características e retornos.

Etapas	Descrição
​Autenticação​	Utilizado para obter o token de acesso.
Consulta XML Resumido	Utilizado para obter as NF-es consultadas automaticamente na SEFAZ, objetivando obter a chave de acesso das mesmas.
XML Resumido Obtido	Utilizado para flagar as chaves de acessos obtidas na API de consulta de XML resumido, com o intuito de que não retornem a aparecer na consulta.
​Realizar Entrada de NF-e por Chave de Acesso	Utilizado para realizar a entrada do documento no sistema pela chave de acesso.
​Realizar Envio da NF-e por XML	Usado para realizar a entrada do documento no sistema diretamente por seu XML completo.
Realizar o Manisfesto da NF-e	Utilizado para efetuar a operação de manifesto em uma NF-e.
Realizar o Download da NF-e por ID	Utilizado para realizar o download dos dados completos da nota diretamente da SEFAZ utilizando o seu ID.
Consulta XML Completo	Utilizado para obter as NF-es que já possuem o XML completo baixado, a fim de obter a chave de acesso das mesmas.
XML Completo Obtido	Utilizado para flagar as chaves de acessos obtidas na API de consulta de XML completo, com o intuito de que não retornem a aparecer na consulta.
Consulta DANFE da NF-e por ID	Utilizando o ID da nota, é possível consultar detalhadamente os dados da mesma.
Consulta XML da NF-e por ID	Utilizando o ID da nota, é possível consultar detalhadamente o XML deste documento.
Realizar o envio da NF-e por e-mail	Utilizando o ID da NF-e, realizar o envio da mesma por e-mail.

Testou e entendeu como tudo funciona? Então já podemos iniciar o desenvolvimento.‌

Desenvolvimento

Da mesma forma proposta na etapa de testes, nós deixaremos um passo a passo de desenvolvimento como guia. Nele, você verá todos os fluxos operacionais e as APIs que devem ser utilizadas.‌

Checklist

Etapa	Descrição
Autenticação	A autenticação será utilizada para obter o token de acesso que será passado em todas as chamadas de API.
Recebimento NF-e	Etapa principal, onde toda a operação de Recebimento irá ocorrer