← Tutoriais da API de nota fiscal

Começar · 05 de outubro de 2026 · 2 min de leitura

Do cadastro à primeira nota de teste: o roteiro da API de nota fiscal

Cinco passos antes da primeira chamada: conta, dados da empresa, certificado digital, chave de API e o ambiente de teste. O que cada um faz e onde fica.

A API de nota fiscal da Data Frontier faz uma coisa: o seu sistema manda a nota inteira numa chamada e recebe a nota autorizada de volta. Não é preciso cadastrar cliente nem produto antes. Mas a nota sai em nome da sua empresa e assinada pelo seu certificado, então há cinco passos antes da primeira chamada. Nenhum deles exige programador.

Os cinco passos

  1. Criar a conta da empresa, com e-mail e senha. Quem contrata só a API entra no mesmo endereço do Frontier ERP e vê apenas as telas da API.
  2. Preencher os dados do emitente na tela Empresa: CNPJ, inscrição estadual, regime de imposto (Simples ou regime normal), endereço com o código do município do IBGE e as séries da nota. Para nota de serviço, também a inscrição municipal.
  3. Enviar o certificado digital A1 (o arquivo .pfx e a senha). Ele fica guardado cifrado; cada nota o abre, assina e descarta. O arquivo não circula por e-mail nem fica no seu servidor.
  4. Criar a chave de API no painel: API de Nota Fiscal › Chaves e webhook › Nova chave. Marque o que ela pode emitir (nota de produto, de serviço ou as duas). A chave aparece uma única vez: copie e guarde no cofre de segredos do seu sistema.
  5. Emitir em homologação, o ambiente de teste da Sefaz. É o padrão: enquanto você não liberar produção, nenhuma nota tem valor fiscal nem entra na conta.
PassoOndePor quê
ContaCadastro da empresaCada conta tem um banco de dados próprio, separado dos outros clientes.
EmitenteTela EmpresaA nota sai sempre em nome da empresa dona da chave, nunca de outro CNPJ.
CertificadoCertificados e FilaÉ ele que assina a nota perante a Sefaz.
Chave de APIAPI de Nota Fiscal › Chaves e webhookIdentifica o seu sistema. Revogar corta o acesso na hora.
TesteHomologação (padrão)Errar aqui não custa nada.
O painel da API mostra uma lista "o que falta para começar" com cada item marcado conforme você completa.

O que a API emite hoje

  • Nota de produto (NF-e, modelo 55): emitir, consultar, baixar XML e PDF, cancelar e carta de correção.
  • Nota de serviço (NFS-e do padrão nacional): emitir, consultar, baixar e cancelar, inclusive com ISS e impostos federais retidos pelo cliente. A empresa precisa estar credenciada no emissor nacional.
  • Ainda não: cupom da loja (NFC-e), substituição tributária própria (ICMS-ST) e operação com o exterior.
Regra de ouro: tudo o que você testar em homologação funciona igual em produção. A diferença é só uma palavra no corpo da nota e uma liberação na tela Empresa.

Com os cinco passos prontos, o próximo tutorial mostra a primeira chamada, com o exemplo completo de uma nota de produto.

Conhecer a API de nota fiscal Documentação completa

Tutorial escrito pela equipe da API em 05 de outubro de 2026, conferido com a versão v1 no ar. Regra fiscal muda: o enquadramento de imposto da sua empresa é com o seu contador. Viu algo desatualizado? Fale com a gente pelo WhatsApp.