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 às nossas APIs!

Pré-Requisitos

Para iniciar os seus testes, você precisará ter em mãos os dados de uma empresa credenciada para emitir NFC-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, afim de que possa conhecer suas características e retornos.

Etapas	Descrição
Autenticação	Utilizado para obter o token de acesso.
Cadastro Empresa	Você poderá cadastrar uma empresa credenciada. Caso não possua, disponibilizamos a "INVOISYS SISTEMAS" (id: 9015) para testes.
Cadastro Produto por ID	Será atribuído a uma empresa para testes. No ambiente de homologação, deverá ser utilizado como nome o literalNOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL
Cadastro Produto por CNPJ	Será atribuído a uma empresa para testes. No ambiente de homologação, deverá ser utilizado como nome o literalNOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL
Envio Normal da NFC-e [Completo]	Utilizado para realizar a emissão da nota
Envio Normal da NFC-e [Híbrido]	Usado para realizar a emissão da nota
Envio Contingência da NFC-e [Completo]	Usado para realizar a emissão da nota em contingência.
Envio Contingência da NFC-e [Híbrido]	Usado para realizar a emissão da nota em contingência.
Consulta da NFC-e por ID	Utilizando o ID da nota, é possível consultar detalhadamente os dados da mesma
Consulta da NFC-e por Número e Série	Utilizando o Número e Série, em conjunto do CNPJ da empresa, é possível consultar detalhadamente os dados da mesma
Consulta da NFC-e por Chave de Acesso	Usando a Chave de Acesso do documento, é possível consultar detalhadamente os dados da mesma
Consulta Paginada de NFC-es	Retorna uma lista de documentos fiscais. Pode ser parametrizada de diversas formas
Cancelamento/Inutilização da NFC-e por ID Estabelecimento	Ambas as operações são realizadas através de uma mesma chamada
Cancelamento/Inutilização da NFC-e por CNPJ	Ambas as operações são realizadas através de uma mesma cham​ada
Consultar Última Numeração por ID	Permite checar, por ID do Estabelecimento, a última numeração utilizada
Consultar Última Numeração por CNPJ	Permite checar, por CNPJ, a última numeração utilizada

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 - Modelo Completo

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.
Envio Normal	Tudo o que envolve o envio normal da NFC-e
Envio Contingência SEFAZ	Todas as chamadas necessárias para validar o envio em contingência SEFAZ
Envio Contingência Off-Line	Todas as chamadas necessárias para validar o envio em contingência Off-Line
Cancelamento/Inutilização	Desde o seu envio, até a consulta de seu status na SEFAZ.

Checklist - Modelo Híbrido

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.
Envio Normal	Tudo o que envolve o envio normal da NFC-e
Envio Contingência Off-Line	Todas as chamadas necessárias para validar o envio em contingência Off-Line
Cancelamento/Inutilização	Desde o seu envio, até a consulta de seu status na SEFAZ.