API fiscal: emissão de seis documentos fiscais | FideFlow Ir para o conteúdo

API de
nota fiscal. Seis emissores.
Uma integração.

Emita, consulte e cancele documentos fiscais eletrônicos direto do seu sistema. A API monta o XML, assina com o seu certificado A1 e transmite à SEFAZ ou à NFS-e nacional.

Testar grátis por 10 dias API completa no teste · até 300 notas em produção · sem cartão Já tenho conta: abrir a API de emissão
Flow Fiscal API de emissão. Sua nota flui. Role para explorar

O que é a Flow Fiscal — API de emissão

A API de emissão do Flow Fiscal integra NF-e, NFC-e, NFS-e Nacional, CT-e, CT-e OS e MDF-e ao seu sistema. Cada emissor tem seu contrato JSON: a operação é aceita com HTTP 202, processada e acompanhada por consulta ou webhook. O XML autorizado, os eventos e o PDF ficam no acervo privado; a emissão registra o fiscal sem movimentar financeiro ou estoque automaticamente.

246.797 XMLs fiscais já foram processados pelo Flow Fiscal, somando R$ 613,4 milhões em documentos. Contador público da operação.

Disponível no Flow Fiscal Atualizado em Versão em Markdown

Seis emissores.
Cada um com seu contrato.

Cada nota tem leiaute, autorizador e eventos próprios. A operação segue o mesmo desenho: dados em JSON, aceite HTTP 202 e acompanhamento até o resultado; protocolo e arquivos ficam disponíveis após a autorização.

Do JSON à nota
autorizada.

Cinco etapas, as mesmas para os seis documentos. Mudam o leiaute e quem autoriza.

  1. Dados em JSON

    Sua aplicação envia a operação: emitente, destinatário ou tomador, itens ou serviço, valores e pagamento, com uma referência sua.

    referencia_externa

  2. XML no leiaute

    A API valida os campos e monta o XML no leiaute oficial. NF-e, NFC-e, CT-e, CT-e OS e MDF-e já levam a chave de acesso; na NFS-e vai a DPS, e a chave vem da Sefin Nacional.

    XML

  3. Assinatura

    O XML é assinado com o certificado A1 do emitente, no padrão XMLDSig exigido pelo Fisco.

    Signature

  4. Autorização

    A transmissão vai ao autorizador do documento: SEFAZ da UF, Sefaz Virtual ou Sefin Nacional, no caso da NFS-e.

    SEFAZ

  5. Protocolo e arquivos

    Após a autorização, consulte a operação ou receba o webhook para obter situação, protocolo e arquivos: XML e DANFE, DACTE, DANFSe ou DAMDFE em PDF.

    protocolo

Cada nota,
suas regras.

O resumo que a equipe fiscal pede antes de qualquer integração: modelo, quem autoriza, como corrigir e como testar.

Item NF-e NFC-e NFS-e CT-e CT-e OS MDF-e
Modelo 55 65 Nacional (DPS) 57 67 58
Uso Mercadorias Venda ao consumidor Serviços Transporte de cargas Outros serviços de transporte Manifesto da viagem
Cobertura do produto Credenciamento e UF do emitente Credenciamento e UF do emitente Emissor nacional e operação municipal habilitada Rodoviário Rodoviário Rodoviário
Documento auxiliar DANFE DANFE NFC-e DANFSe DACTE DACTE OS DAMDFE
Eventos da API Cancelamento e CC-e Cancelamento Cancelamento Cancelamento e CC-e Cancelamento e CC-e Cancelamento e encerramento
Inutilização na API Sim Sim Não Não Não Não
Ambiente de teste Homologação Homologação Produção restrita (ambiente homologacao da API) Homologação Homologação Homologação
Contingência da API Não habilitada Off-line em SP, com requisitos próprios Não habilitada Não habilitada Não habilitada Não habilitada

Envie uma vez.
Acompanhe o resultado.

Você envia a operação com uma referência sua. O aceite HTTP 202 confirma o registro para processamento. Consulte a operação ou receba o webhook até o resultado fiscal; após a autorização, baixe XML e PDF privados.

Exemplo de NF-e em homologação extraído do OpenAPI v1. IDs são fictícios e devem corresponder aos cadastros do emitente. HTTP 202 ainda não é autorização fiscal.

Ver a emissão de NF-e passo a passo
RequisiçãoHTTP
POST https://erp.fideflow.com.br/api/flow-fiscal/v1/homologacao/emitentes/{emitente}/documentos/nfe
Authorization: Bearer {credencial_de_homologacao}
Content-Type: application/json
Idempotency-Key: exemplo-nfe-001

{
    "referencia_externa": "exemplo-nfe-001",
    "dados": {
        "cabecalho": {
            "natureza_id": 1,
            "cliente_id": 1,
            "total": "10.00",
            "tipo_pagamento": "01"
        },
        "itens": [
            {
                "produto_id": 1,
                "quantidade": "1.00",
                "valor_unitario": "10.00",
                "sub_total": "10.00",
                "cfop": "5102"
            }
        ],
        "pagamentos": [
            {
                "tipo_pagamento": "01",
                "valor": "10.00",
                "data_vencimento": "2026-10-21"
            }
        ]
    }
}
RespostaJSON
HTTP/1.1 202 Accepted
Location: https://erp.fideflow.com.br/api/flow-fiscal/v1/homologacao/emitentes/{emitente}/operacoes/{operacao_id}
Retry-After: 5
Content-Type: application/json

{"dados":{"id":"{operacao_id}","estado":"enfileirada","url":"https://erp.fideflow.com.br/api/flow-fiscal/v1/homologacao/emitentes/{emitente}/operacoes/{operacao_id}"}}

Para quem emite
pelo próprio sistema.

Antes de integrar,
leia isto.

Respostas curtas para as dúvidas que aparecem em toda integração fiscal.

Uma contratação.
Seus CNPJs conectados.

Opcional de emissão independente da API de documentos recebidos. Requer um plano Flow Fiscal ativo; cada emitente mantém seus vínculos e permissões.

Adicional de emissão

R$ 29,90/mês

Além do plano Flow Fiscal. 300 autorizações em produção por contratante no ciclo mensal, compartilhadas entre seus CNPJs.

Total a partir de R$ 69,80/mês, com o plano Flow Fiscal a partir de R$ 39,90/mês.

Teste grátis de 10 dias com a API completa. Os seis emissores sem contratar: homologação sem limite e até 300 autorizações em produção, sem cartão.

Testar grátis por 10 dias

Já tem conta? Abrir a API de emissão, no menu Fiscal.

Como o consumo funciona

  • Excedente de R$ 0,50 por autorização, cobrado automaticamente.
  • Rejeições, homologação, consultas, downloads, eventos e reentregas não geram unidades: não consomem franquia nem geram excedente.
  • Cancelamento posterior não devolve a unidade autorizada.
  • XML, PDF, consulta e eventos das próprias emissões incluídos, conforme cada modelo; API de documentos recebidos é um opcional independente.
  • Registro fiscal sem movimentação automática de financeiro e estoque nem envio de comunicações comerciais; integrações adicionais exigem ação explícita.
  • Repetir a mesma operação idempotente não cria outra emissão nem nova unidade de consumo.
Ver configuração e contrato

Perguntas
diretas.

Quais documentos posso emitir?

NF-e (55), NFC-e (65), NFS-e Nacional, CT-e (57), CT-e OS (67) e MDF-e (58). Cada documento tem contrato próprio. CT-e, CT-e OS e MDF-e atendem o modal rodoviário; a NFS-e depende da habilitação no padrão nacional.

Quanto custa a API de emissão?

O adicional custa R$ 29,90 por mês além do plano Flow Fiscal. Inclui 300 documentos autorizados em produção por contratante no ciclo mensal, compartilhados entre os seus CNPJs. Cada autorização excedente custa R$ 0,50 e entra automaticamente na cobrança. No teste grátis do Flow Fiscal, a API vem completa sem custo, até 300 autorizações em produção.

O que consome a franquia de 300 documentos?

Somente documentos autorizados em produção pela nova API. Rejeições, homologação, consultas, downloads, eventos e repetição idempotente não geram unidades adicionais. Cancelar depois da autorização não devolve a unidade nem estorna o consumo.

Uma conta pode vincular vários CNPJs?

Sim. Um contratante Flow Fiscal vincula múltiplos CNPJs e compartilha a franquia mensal. Cada emitente exige autorização de seu titular, configuração fiscal e certificado compatível; cada credencial acessa somente os vínculos concedidos. Os emitentes técnicos não precisam contratar um plano ERP individual.

A emissão movimenta financeiro e estoque?

A API registra o documento fiscal e preserva seus arquivos. Financeiro, estoque e demais integrações do ERP exigem uma ação adicional explícita. A emissão não envia e-mail nem mensagem automaticamente ao destinatário ou tomador.

Preciso contratar também a API de documentos recebidos?

Não para consultar, cancelar, corrigir quando aplicável ou baixar XML/PDF das suas próprias emissões. A API de documentos recebidos permanece no opcional atual, independente do novo opcional de emissão.

Como começo e testo a integração?

Crie sua conta Flow Fiscal: no teste grátis, a API de emissão vem completa, com os seis emissores, homologação sem limite e até 300 autorizações em produção, sem cartão. Abra API de emissão no menu Fiscal e configure os CNPJs, certificados, vínculos e credenciais por ambiente; para continuar depois do teste, contrate o adicional. O guia de integração reúne OpenAPI, Postman, autenticação, idempotência, operações e webhooks. Homologação não consome a franquia.

HTTP 202 significa que a nota foi autorizada?

Não. HTTP 202 significa aceite durável para processamento. Consulte a operação ou acompanhe o webhook até o resultado fiscal. Timeout e ausência de resposta exigem conciliação; não reenvie cegamente nem troque a referência para tentar de novo.

Quais certificados e contingências são suportados?

O produto usa certificado ICP-Brasil A1. A contingência off-line de NFC-e está habilitada somente em SP e exige configuração e regularização posterior. Modalidades previstas nos manuais fiscais não ficam automaticamente disponíveis na API; consulte as capacidades do emitente.

Sua nota
flui daqui.

No teste grátis do Flow Fiscal, a API de emissão vem completa, sem contratar; depois do teste, requer plano Flow Fiscal ativo e o opcional de emissão contratado. Exige certificado A1 válido e vínculo autorizado de cada CNPJ. CT-e, CT-e OS e MDF-e atendem o modal rodoviário; NFS-e segue o padrão nacional e os requisitos do município. Consulte as capacidades do emitente antes de transmitir.

Adicional de R$ 29,90/mês, além do plano Flow Fiscal. 300 autorizações em produção por contratante e ciclo mensal, compartilhadas entre CNPJs; excedente automático de R$ 0,50 por autorização. Cancelamento posterior não estorna consumo. Ver condições.