# API de nota fiscal

> 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.

- Produto: Flow Fiscal — API de emissão (disponível no flow fiscal)
- Página: https://fideflow.com.br/api-nota-fiscal
- Atualizado em: 2026-10-21
- Publicado por: FideFlow
- Oferta: adicional de R$ 29,90/mês além do plano Flow Fiscal, com 300 autorizações em produção por contratante/ciclo mensal compartilhadas entre CNPJs; excedente automático R$ 0,50. Cancelamento posterior não estorna consumo.

## Preço e contratação
Adicional de R$ 29,90/mês ao plano Flow Fiscal; 300 autorizações em produção por contratante no ciclo mensal, compartilhadas entre seus CNPJs. Excedente automático de R$ 0,50 por autorização. Cancelamento posterior não estorna consumo.
- 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.
[Configurar integração](https://erp.fideflow.com.br/flow-fiscal/emissao-api) · [Criar conta](https://erp.fideflow.com.br/flowfiscal/cadastro) · [Guia de integração](https://fideflow.com.br/api-nota-fiscal/guias/integracao)

## Documentos
- [API de NF-e](https://fideflow.com.br/api-nota-fiscal/nfe.md): Nota fiscal de mercadorias. Emissão, cancelamento, carta de correção e inutilização.
- [API de NFC-e](https://fideflow.com.br/api-nota-fiscal/nfce.md): Nota do consumidor no PDV, com QR Code, CSC e contingência off-line somente em SP.
- [API de NFS-e](https://fideflow.com.br/api-nota-fiscal/nfse.md): Nota de serviço no padrão nacional, enviada à Sefin Nacional como DPS assinada.
- [API de CT-e](https://fideflow.com.br/api-nota-fiscal/cte.md): Transporte rodoviário de cargas, com XML, DACTE e eventos.
- [API de CT-e OS](https://fideflow.com.br/api-nota-fiscal/cte-os.md): Outros serviços de transporte rodoviário, com contrato próprio para o modelo 67.
- [API de MDF-e](https://fideflow.com.br/api-nota-fiscal/mdfe.md): Manifesto rodoviário, com XML, DAMDFE, consulta, cancelamento e encerramento.

## Como funciona
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.
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.
3. **Assinatura.** O XML é assinado com o certificado A1 do emitente, no padrão XMLDSig exigido pelo Fisco.
4. **Autorização.** A transmissão vai ao autorizador do documento: SEFAZ da UF, Sefaz Virtual ou Sefin Nacional, no caso da NFS-e.
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.

## Cada nota, suas regras
| 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 |

## Para quem
- **Software houses e ERPs:** Ofereça emissão fiscal aos seus clientes sem manter um emissor próprio para cada documento e cada UF.
- **Lojas virtuais e marketplaces:** Emita a NF-e de cada pedido no faturamento, com o XML pronto para enviar ao comprador.
- **PDV e aplicativos de venda:** NFC-e no caixa, com QR Code e DANFE para imprimir ou mandar ao consumidor.
- **Transportadoras e TMS:** CT-e, CT-e OS e MDF-e no modal rodoviário, com documentos auxiliares e encerramento do manifesto.
- **Plataformas de serviços:** NFS-e no padrão nacional para cada atendimento, assinatura ou contrato.

## Guias
- [Integração da API de emissão](https://fideflow.com.br/api-nota-fiscal/guias/integracao.md)
- [Como emitir nota fiscal por API](https://fideflow.com.br/api-nota-fiscal/guias/como-emitir-nota-fiscal-por-api.md)
- [Como escolher uma API de nota fiscal](https://fideflow.com.br/api-nota-fiscal/guias/como-escolher-api-de-nota-fiscal.md)
- [Homologação e produção na emissão de notas](https://fideflow.com.br/api-nota-fiscal/guias/homologacao-e-producao.md)
- [Contingência na emissão de notas fiscais](https://fideflow.com.br/api-nota-fiscal/guias/contingencia.md)
- [Certificado digital A1 para emitir nota por API](https://fideflow.com.br/api-nota-fiscal/guias/certificado-digital-a1.md)

## Perguntas frequentes
### 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](https://fideflow.com.br/api-nota-fiscal/guias/integracao) 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.

---
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.
