Nota que volta recusada sem explicação
O sistema só diz "erro" e ninguém sabe qual campo está errado.
API de nota fiscal · sem trocar de sistema
Nota fiscal direto do seu sistema, numa chamada só.
O seu sistema manda a nota inteira — cliente, produtos, impostos e pagamento — e recebe a nota autorizada, com o seu certificado digital. Nota de produto e nota de serviço. Teste à vontade antes de valer.
2 tipos de notade produto e de serviço (emissor nacional)
Sem nota em dobrorepetir o envio devolve a mesma nota
Teste ilimitadonota de teste não entra na conta
O problema
Emitir nota pelo seu sistema não devia dar tanto trabalho.
Nota em dobro
A internet caiu no meio do envio, o sistema tentou de novo e saíram duas notas para a mesma venda.
Emissor que só funciona em um computador
A nota depende de um programa instalado na máquina do escritório.
Certificado espalhado
O arquivo do certificado digital circula por e-mail e pendrive para cada sistema que precisa emitir.
Como funciona
Manda a nota, recebe a nota.
Sem cadastro prévio, sem programa instalado, sem arquivo de certificado circulando.
A nota inteira vai de uma vez.
Cliente, produtos, impostos, pagamento e frete no mesmo envio. Não é preciso cadastrar cliente nem produto antes: o seu sistema já tem esses dados.
Tentar de novo é seguro.
Cada venda leva um código seu. Se o seu sistema repetir o envio — por queda de internet, por exemplo —, recebe a mesma nota de volta, nunca uma segunda.
O erro diz o campo e o motivo.
Antes de ir à Sefaz, a nota é conferida e o retorno aponta o campo errado. Se a Sefaz recusar, o motivo dela vem inteiro, sem tradução que esconde o problema.
O que dá para fazer hoje.
Só o que já está pronto. O que ainda não existe está escrito como não existe.
- Nota de produto (NF-e)
- Emitir, consultar, cancelar e corrigir (carta de correção)
- Nota de serviço (NFS-e)
- Pelo emissor nacional: emitir, consultar e cancelar, com ISS e impostos federais retidos
- Cupom da loja (NFC-e)
- Ainda não está na API
- Teste antes de valer
- Ambiente de homologação, sem custo
- Painel
- Notas emitidas, arquivos, chaves e o consumo do mês
Junto com a API
O que vem em toda conta.
Ambiente de teste
Emita quantas notas de teste quiser, sem valor fiscal e sem entrar na conta. Só passa a valer depois que você liberar.
Aviso automático
Se quiser, o seu sistema recebe um aviso quando a nota é autorizada, recusada, cancelada ou corrigida — com nova tentativa se ele estiver fora do ar.
Chave por sistema
Cada sistema que emite usa uma chave própria, que você cria e revoga no painel na hora.
Arquivo e segunda via
O arquivo oficial da nota (o XML) e o PDF ficam guardados para baixar pelo painel ou pelo seu sistema.
Seus dados separados
A conta ganha um banco de dados próprio, separado do de qualquer outro cliente. O certificado fica guardado cifrado, e cada uso fica registrado.
Reforma Tributária
A nota já sai com os campos novos de IBS e CBS da transição de 2026, e a gente atualiza conforme as regras mudam.
Para quem é
Serve para o meu caso?
Loja virtual e marketplace próprio
O pedido pago vira nota sem ninguém digitar nada.
Sistema de serviço
Ordem de serviço concluída, nota de serviço emitida pelo emissor nacional.
Quem desenvolve sistema
Coloque nota fiscal no seu produto sem manter um emissor dentro dele.
Empresa que já tem sistema
Não precisa trocar de ERP para emitir nota direito.
Para quem vai integrar
Para o programador, em um minuto.
O guia completo, com todos os campos e respostas, fica no portal do desenvolvedor.
Uma chamada HTTP, resposta em JSON.
A chave vai no cabeçalho X-Chave-Integracao e cada venda leva um Idempotency-Key — o código que garante que repetir o envio devolve a mesma nota. A resposta traz a chave de acesso, o protocolo e os links do XML e do PDF. Recusa volta com o código e o motivo da Sefaz inteiros.
POST /api/v1/nfe
X-Chave-Integracao: dfapp_•••
Idempotency-Key: pedido-1234
{ "ambiente": "homologacao",
"destinatario": { "cpfCnpj": "…", "nome": "…",
"endereco": { … } },
"itens": [{ "ncm": "39269090", "cfop": "5102",
"quantidade": 1, "valorUnitario": 100,
"icms": { "csosn": "102" } }],
"pagamentos": [{ "forma": "17", "valor": 100 }] }
→ 201 { "situacao": "autorizada",
"chave": "3126…", "links": { "xml": …, "pdf": … } }Como começar
Comece em três passos.
- 01Crie a conta e coloque os dados da empresaCNPJ, endereço e o certificado digital A1 que você já usa. O painel mostra o que falta.
- 02Crie a chave e testeLigue o seu sistema com a chave e emita notas de teste até tudo sair certo.
- 03Libere para valerQuando estiver tudo certo, libere a emissão de verdade na tela da empresa. Travou? Chame no WhatsApp.
Sem risco
Só vale quando você liberar.
Teste sem pressa
Nota de teste não conta na conta. Você só libera quando o seu sistema estiver pronto.
Sem cartão para começar
A conta nasce com 15 dias de teste, sem cartão de crédito.
As notas são suas
Todos os arquivos ficam disponíveis para baixar a qualquer momento.
Tutoriais
Aprenda fazendo, com exemplo pronto.
Dez tutoriais curtos, do cadastro à nota em produção.
Começar · 2 min
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.
Ler Nota de produto · 2 minEmita sua primeira NF-e pela API, passo a passo
Uma chamada POST com a nota inteira no corpo: os cabeçalhos, um exemplo de JSON que fecha a conta, a resposta da Sefaz e como baixar o XML e o PDF.
Ler Nota de serviço · 3 minNota de serviço pela API: a NFS-e do padrão nacional
Como emitir a nota de serviço pelo emissor nacional com a mesma API: o que a empresa precisa ter, o corpo da chamada, as retenções e os limites de hoje.
LerDúvidas
Perguntas de quem vai integrar.
Preciso usar o Frontier ERP?
Não. A API é vendida separada, para quem já tem o próprio sistema. Você entra num painel só da API: notas emitidas, chaves e consumo.
Quais notas dá para emitir?
Nota de produto (NF-e) e nota de serviço (NFS-e) pelo emissor nacional. O cupom da loja (NFC-e) ainda não está na API.
Preciso de certificado digital?
Sim, o A1 da sua empresa — o mesmo que qualquer emissor exige. Ele fica guardado cifrado e é usado só na hora de assinar cada nota.
E se a internet cair no meio do envio?
O seu sistema manda de novo com o mesmo código da venda e recebe a mesma nota. Se a Sefaz não respondeu, a nota fica "sem resposta" e uma consulta resolve — nunca sai uma segunda nota.
A API calcula os impostos?
Não: os impostos de cada item vêm do seu sistema (ou do seu contador). A API confere se os valores fecham e avisa o campo que não fecha, antes de enviar.
Dá para testar antes?
Dá. Toda conta tem o ambiente de teste, sem limite e sem custo. A emissão de verdade só começa quando você libera.
Quanto custa?
O preço sai em breve. Enquanto isso, fale com a gente pelo WhatsApp: a sua conta é criada com a API liberada para testar.
Tem documentação?
Tem: o guia com todos os campos, exemplos e respostas fica no portal do desenvolvedor, com o arquivo para importar no seu programa de testes de API.