API de NF-e, NFC-e e NFS-e Padrão Nacional

A NF-e, a NFC-e e a NFS-e do seu ERP,
resolvidas em um POST.

Integre emissão de notas fiscais eletrônicas sem escrever XML, sem assinatura no seu deploy e sem fila para operar. A NFS-e é a Padrão Nacional, nos municípios conveniados ao Emissor Nacional. Multiemitente, com o certificado dos seus clientes num cofre que a nossa API não consegue abrir — e homologação liberada na hora, sem conversa com vendas.

Sem cartão de crédito. Ambiente de homologação gratuito e ilimitado.

flexdfe-api — bash
POST /v1/emitentes/6b2f0c9e-1a2b-4c3d-8e4f-5a6b7c8d9e0f/nfe?wait=8000 HTTP/1.1
Host: SEU-HOST
Authorization: Basic base64(client_id:secret)
Idempotency-Key: 3fa85f64-5717-4562-b3fc-2c963f66afa6

{
  "modelo": 55,
  "serie": 1,
  "documento": {
    "ide": { "natOp": "VENDA", "tpNF": 1, "indFinal": 1 },
    "dest": { "CNPJ": "11444777000161", "xNome": "Cliente Exemplo" },
    "itens": [{
      "prod": { "xProd": "Teclado mecanico", "NCM": "84716053",
                "CFOP": "5102", "qCom": 2, "vUnCom": 149.90 },
      "imposto": { "ICMS": { "orig": "0", "csosn": "102" } }
    }]
  }
}
// o emitente vem da credencial; os totais o servidor calcula
// corpo abreviado — o Quickstart traz o exemplo completo

← 200 OK
{
  "tipo": "nfe.emit",
  "situacao": "autorizada",
  "resultado": {
    "chave": "35260811222333000181550010000001231234567890",
    "protocolo": "135260123456789"
  }
}
1 POST
Para emitir uma nota
3 notas
NF-e, NFC-e e NFS-e na mesma API
0
Bibliotecas fiscais no seu deploy
Ilimitado
Notas em homologação, sem prazo
O que a plataforma entrega

Uma API. Todo o ciclo de vida da nota fiscal eletrônica.

Você não gerencia fila, não assina XML e não guarda contador de numeração. A gente cuida da burocracia. Você cuida do seu produto.

Emissão em uma chamada

Monte o payload JSON com os itens da nota. A plataforma gera o XML no leiaute vigente, assina, numera, transmite à SEFAZ, insiste quando ela oscila e devolve o desfecho. Sem bibliotecas de assinatura no seu deploy.

Síncrono ou assíncrono, você escolhe

Use ?wait=8000 — a janela em milissegundos — para receber a nota autorizada na mesma resposta. Ou deixe assíncrono e receba o desfecho por webhook no instante da resposta da SEFAZ.

Certificado blindado

O A1 do seu cliente é cifrado com chave pública assim que chega. O processo exposto à internet nunca detém a chave privada — ele guarda um envelope que não consegue reabrir. Um vazamento do banco não revela certificado algum.

Contingência quando a SEFAZ cai

Ligue o regime de contingência do modelo e toda nota nasce lacrada, com a justificativa carimbada — o seu cliente leva o documento e você transmite depois, uma a uma ou em lote. EPEC e FS-DA na NF-e, offline na NFC-e.

DANFE e XML prontos

Uma chamada para o PDF do DANFE, outra para o XML autorizado e arquivado. Layout fiscal sempre atualizado. Você nunca mais desenha um DANFE na mão.

Multiemitente, isolado por cliente

Cada cliente seu é um emitente independente, com certificado, séries e ambiente próprios. Credenciais de integrador enxergam a carteira toda. Credenciais de emitente, só a si mesmas.

Cancelamento, CC-e e mais

Cancelamento, Carta de Correção, comprovante de entrega, registro de insucesso, inutilização de numeração. O ciclo de vida completo do documento fiscal, tudo pela mesma API.

Reconciliação por cursor

Seu sistema ficou offline? Não importa. Leia o feed sequencial de desfechos a partir do último cursor conhecido. Nada se perde, mesmo que o webhook falhe.

Distribuição DF-e e manifestação

Receba as notas emitidas contra os seus emitentes, manifeste ciência, confirmação ou desconhecimento. E consulte o cadastro de qualquer contribuinte direto na SEFAZ antes de faturar.

NFS-e Padrão Nacional

A NFS-e entra na mesma API, no mesmo plano

A NFS-e Padrão Nacional segue o ciclo da NF-e: um POST com os dados do serviço, o desfecho pelo feed, pelo webhook ou na própria resposta. A plataforma monta a DPS, assina com o A1 do emitente e transmite ao Sistema Nacional NFS-e.

Emissão em uma chamada

Um POST /v1/emitentes/{id}/nfse com o serviço prestado e o tomador. Você não monta a DPS nem assina, e a numeração fica com a plataforma, ou com o seu ERP, se você preferir numerar.

Consulta

Detalhe, lista e feed de desfechos. A consulta ao Sistema Nacional procura a nota de uma DPS que ficou sem desfecho e traz os cancelamentos feitos fora da plataforma.

Cancelamento e substituição

Cancele a NFS-e autorizada ou substitua-a por outra. Na substituição, a original fica marcada como substituída, e o detalhe das duas mostra o vínculo.

DANFSe em PDF

O PDF do DANFSe e o XML da NFS-e autorizada, uma chamada para cada um. Você não desenha o documento.

Pacote do contador por competência

No painel, peça o pacote de um mês de produção: um ZIP com os XMLs das NFS-e da competência e os dos cancelamentos delas, pronto para o seu contador.

Consulta de convênio

Consulte o que qualquer município publicou de convênio no Sistema Nacional da NFS-e, e não só o do seu emitente. A consulta informa, e não bloqueia a emissão.

Onde a NFS-e Padrão Nacional vale

Atendemos os municípios conveniados ao Emissor Nacional. A consulta de convênio, acima, devolve a parametrização que o município publicou no Sistema Nacional da NFS-e; sozinha, ela não diz se o município aderiu.

Seu município usa um sistema próprio?

Integramos outros provedores sob consulta. Escreva para suporte@flexdfe.com.br, com o município e o provedor.

Segurança

O certificado entra num envelope que a nossa API não consegue abrir

O A1 é cifrado com chave pública no instante em que chega. O processo que atende a internet guarda o envelope e não tem a chave privada — nem para o certificado que ele mesmo acabou de gravar. Quem abre é um worker sem porta para fora, e só no momento exato de assinar a nota. Sessões de suporte são somente-leitura impostas pelo próprio banco de dados — não por promessa de código —, ficam registradas e aparecem na tela de segurança do seu cliente.

→
→
API cifra, e não reabre Banco guarda o envelope Worker assina a nota
Do zero à primeira nota

Seis passos. Quinze minutos de setup.

A conta nasce em homologação, sem custo e sem prazo. Cadastre o emitente, suba o certificado e emita. Produção é liberada quando você estiver pronto.

1
Crie sua conta CNPJ, e-mail e senha. Ative pelo link que chega na caixa de entrada. Leva menos de um minuto.
2
Cadastre o emitente Insira os dados fiscais de quem vai emitir. Um emitente por cliente seu, todos isolados.
3
Envie o certificado A1 O arquivo .pfx e a senha. Os dois entram cifrados no cofre assim que chegam — e o processo que os recebeu não tem como reabri-los.
4
Configure a série Escolha o número da série e o ambiente. A numeração das notas é gerenciada pela plataforma — ou pelo seu ERP, se você preferir numerar.
5
Gere as credenciais Cunhe um par client_id e secret para seu ERP. O secret aparece uma vez, e você pode rotacionar ou revogar a qualquer momento.
6
Emita a primeira nota Um POST com os dados da operação. A plataforma devolve a nota autorizada, a chave de acesso e o protocolo.

Importante: o certificado deve ser do próprio emitente

A SEFAZ valida a correspondência entre CNPJ do emitente e CNPJ do certificado. Não emite com certificado de terceiros, nem em homologação, nem com procuração eletrônica. Se seu cliente já possui A1, são dois minutos. Se ainda não, a emissão do certificado ocorre fora da plataforma e pode levar alguns dias. Os outros cinco passos podem ser feitos antes, sem bloqueio.

Preço

Preço publicado. Emitentes ilimitados em todos os planos.

Homologação não custa nada — nem por nota, nem por chamada, nem por consulta. Em produção, o plano define quantas transmissões o mês inclui, e nenhum deles limita quantos emitentes ficam em produção. NF-e, NFC-e e NFS-e consomem a mesma franquia, sem adicional para a NFS-e.

Nível 1

R$ 119,00por mês

Transmissões incluídas por mês
1.200
Transmissão excedente
R$ 0,13

Nível 2

R$ 269,00por mês

Transmissões incluídas por mês
3.000
Transmissão excedente
R$ 0,12

Nível 3

R$ 379,00por mês

Transmissões incluídas por mês
5.000
Transmissão excedente
R$ 0,10

Nível 4

R$ 589,00por mês

Transmissões incluídas por mês
10.000
Transmissão excedente
R$ 0,08

O que conta como transmissão

O pedido de emissão que recebeu veredito da administração tributária, a SEFAZ na NF-e e na NFC-e e o Sistema Nacional NFS-e na NFS-e: a nota autorizada ou a rejeitada. O cancelamento, de NF-e, NFC-e ou NFS-e, a inutilização, a carta de correção, o EPEC, a manifestação do destinatário e o recebimento pela Distribuição DF-e não contam. A substituição de NFS-e conta uma transmissão, a da nota substituta. A regra inteira está na cláusula 12 dos Termos de Uso.

Passou do volume incluído, a emissão continua

Nada é suspenso, enfileirado ou degradado por volume. Cada transmissão além do que o plano inclui é cobrada pelo preço de excedente dele.

Contrato sob medida

Quem precisa de condições fora da tabela pode negociar um contrato sob medida, com preço sob consulta.

Homologação gratuita e ilimitada

Crie a conta, integre, teste à vontade. O ambiente de homologação não tem limite de notas nem prazo de expiração, e nada do que você faz nele consome o plano. A produção é liberada por proposta comercial, com um plano da tabela ou sob consulta. A cobrança acontece fora da plataforma — o Flex DFe não processa pagamento.

Pedir proposta

Pronto para integrar?

Abra sua conta em homologação agora. Emita notas sem valor fiscal, teste todos os endpoints, valide o fluxo do seu ERP. Quando tudo estiver redondo, a gente libera a produção em uma conversa de cinco minutos.