Primeiros passos para integrar com nossa API de forma simples

Integre seu sistema com a nossa API para começar a emitir notas fiscais de forma automatizada. Em caso de dúvida em algum conceito utilizado aqui, visite nossa Página de Conceitos e saiba tudo que você precisa para emitir Nota Fiscal de Serviço Eletrônica (NFS-e).

Recomendados que você use nosso Ambiente de Testes para fazer a integração e só depois mudar para o Ambiente de Produção. Assim você pode tirar suas dúvidas e evitar equívocos quando mudar para produção.

Caso você não seja um desenvolvedor ou sua empresa não possua uma equipe de TI, nós disponibilizamos outras formas de automatizar suas emissões, clique aqui e veja as outras possibilidades disponíveis.

Integração a partir de um meio de pagamento

A emissão automatizada de NFS-e depende da integração com o meio de pagamento usado por você. O meio de pagamento deve ter uma API por onde serão disponibilizadas as informações sobre os pagamentos que foram realizados.

Alguns meios de pagamento disponibilizam Webhooks para monitaramento dos pagamentos. Uma das opções de integrar com a nossa API é através desses Webhooks, que informarão sempre que um pagamento for realizado.

Outra opção é, de tempos em tempos, consultar a API do seu meio de pagamento para coletar os dados dos pagamentos que foram realizados.

Tendo os dados do pagamento, é só adicionar as informações pertinentes ao serviço prestado e enviar para nossa API, que emitirá a nota calculando os impostos automaticamente.

Observação: Note que, a maioria dos meios de pagamento não disponibilizam todas as informações necessárias para que a nota seja emitida. Ou seja, sua solução terá que agregar as informações faltantes com as informações cedidas pelo seu meio de pagamento.

Utilizando o Ambiente de Testes

Uma das vantagens da nossa API é que você pode testa-la gratuitamente, assim você pode garantir que a nossa solução atenda às suas demandas.

Abaixo temos um passo a passo para utilização do nossa Ambiente de Testes:

Observação: Para testar nossa API você não precisa ter um Certificado Digital, Inscrição Municipal e nem mesmo uma Inscrição Estadual.

1. Fazer cadastro na plataforma: Cadastre-se e crie uma empresa, com isso, você terá a sua Apikey que será necessária na hora de emitir suas notas. Além disso, através da nossa plataforma, você pode acompanhar as emissões de suas notas, baixar o PDF ou o XML das notas que já foram emitidas e muito mais.

Observação: Caso você já possua cadastro na nossa plataforma, você pode criar uma empresa de testes utilizando um CNPJ gerado na internet. Ao criar uma nova empresa, ela estará automaticamente no ambiente de testes.

2. Saber o Código de Serviço: O Código de Serviço prestado no município é necessário para emitir notas de teste.

Caso você não saiba o Código de Serviço, você pode utilizar o código e descrição abaixo, referente à um serviço prestado na cidade de São Paulo - SP, para realizar seus testes:

• Código do Serviço prestado: 2919
• Descrição do Serviço: Suporte técnico em informática, inclusive instalação, configuração e manutenção de programas de computação e bancos de dados

3. Escolha da linguagem: Nós disponibilizamos pacotes para integração em três linguagens:

• Node.js
• PHP
• Ruby

Caso você escolha outra linguagem de sua preferência, você pode consultar a nossa Referência da API, onde você encontrará todas as informações necessárias para realizar a integração.

Mudando para o ambiente de produção

Após ter integrado seu sistema com a nossa API utilizando nosso ambiente de testes você já pode mudar para o ambiente de produção.

Nós desenvolvemos um passo a passo para te auxiliar nessa mudança:

1. Verifique se todos os dados foram preenchidos corretamente na hora de criar sua empresa na nossa plataforma.

2. Sua empresa deve estar cadastrada na prefeitura para emitir nota fiscal. Caso você ainda tenha dúvidas sobre o credenciamento, você pode acessar este link.

3. Faça upload do certificado digital. Após subir o certificado, se suas informações cadastrais estiverem corretas, o status da sua empresa constará como "Ativo para emissão" no menu "EMPRESAS". Além disso, ela agora estará na aba "ATIVO". conforme imagem abaixo.

4. Entre em contato com a nossa equipe comercial para gerar sua fatura. Assim que a fatura for paga, sua conta estará ativada.

Observação: Caso o pagamento seja realizado via boleto bancário o prazo de compensação é de dois dias úteis. Sua conta só será ativada após recebermos a notificação de pagamento do boleto. Em caso de dúvidas, entre em contato com a nossa equipe comercial através do email comercial@nfe.io

5. Após a ativação da sua conta, acesse nossa plataforma, vá até o menu "EMPRESAS" e clique no botão "ALTERAR EMPRESA" da empresa que você deseja mudar para o ambiente de produção.

6. Na seção "Ambiente" você terá informação de qual ambiente sua empresa está operando. Entrando na seção, você poderá alterar o ambiente no qual deseja operar.