# API fiscal

> API fiscal é uma interface de programação que permite a sistemas como ERPs, lojas virtuais e marketplaces emitir, consultar e cancelar documentos fiscais eletrônicos, como NF-e, NFS-e, NFC-e, CT-e e MDF-e, de forma automática, sem que o usuário precise acessar portais da Sefaz ou das prefeituras manualmente.

**Também conhecido como:** API de emissão fiscal, API de nota fiscal, API de notas fiscais eletrônicas, API para emissão de NF-e, Tax invoicing API

**Glossário:** [Glossário de A a Z](https://conota.dev/glossario/) · **Letra:** A

## O que é uma API fiscal, em palavras simples?

Uma API fiscal funciona como uma ponte entre o sistema de uma empresa e os órgãos que autorizam documentos fiscais, como as Secretarias da Fazenda estaduais e as prefeituras. Em vez de alguém digitar os dados de cada nota em um site oficial, o próprio sistema envia essas informações para a API, que cuida do restante.

API é a sigla em inglês para interface de programação de aplicações. Na prática, é um conjunto de endereços e regras que permitem que um software converse com outro de maneira padronizada, trocando dados de forma automática.

## Para que serve uma API fiscal?

Ela serve para automatizar a emissão e a gestão de documentos fiscais. Quando uma venda é concluída em uma loja virtual ou um serviço é faturado em um ERP, o sistema chama a API, que gera o documento, assina digitalmente o XML, transmite ao órgão autorizador e devolve o resultado.

Além da emissão, uma API fiscal costuma oferecer consulta de status, cancelamento, carta de correção, download de XML e PDF e tratamento de rejeições. Isso reduz erros de digitação, acelera o faturamento e libera a equipe de tarefas repetitivas.

## Como funciona uma API fiscal no dia a dia?

O fluxo básico é: o sistema da empresa monta os dados da nota (emitente, destinatário, itens, impostos) e envia uma requisição à API, normalmente identificada por uma API Key ou Bearer token. A API valida os dados, monta o XML no layout exigido, assina com o certificado digital A1 da empresa e transmite ao órgão responsável.

Em seguida, a API acompanha o processamento até a autorização ou rejeição e devolve o status, a chave de acesso, o XML autorizado e o documento auxiliar em PDF, como DANFE ou DANFCE. Muitas APIs avisam o sistema automaticamente por notificações, sem que ele precise ficar consultando.

## Quais documentos uma API fiscal pode emitir?

Depende do fornecedor, mas os mais comuns são a NF-e (venda de produtos), a NFC-e (varejo ao consumidor final), a NFS-e (serviços, emitida conforme regras de cada município ou do padrão nacional), o CT-e (transporte de cargas) e o MDF-e (manifesto que acompanha o transporte).

A disponibilidade pode variar conforme o documento, o município e o ambiente suportado, especialmente no caso da NFS-e, em que cada prefeitura pode ter regras e sistemas próprios.

## Qual a diferença entre usar uma API fiscal e integrar direto com a Sefaz?

Integrar direto exige que a própria empresa desenvolva e mantenha a geração do XML, a assinatura digital, a comunicação com cada webservice, o tratamento de rejeições e as atualizações de layout. É trabalhoso, sobretudo quando envolve vários estados e centenas de prefeituras com padrões diferentes.

Com uma API fiscal, o sistema faz uma única integração e o fornecedor absorve essa complexidade técnica. A responsabilidade pelas informações fiscais, como CFOP, CST e alíquotas corretas, continua sendo da empresa emissora.

## Como uma API fiscal se relaciona com agentes de inteligência artificial?

Algumas APIs fiscais oferecem acesso via MCP, um protocolo que permite a agentes de IA consultar documentos e executar ações autorizadas. Assim, um assistente pode verificar o status de uma nota ou listar rejeições, sempre dentro de permissões controladas e com registro para auditoria.

## Exemplos de API fiscal

- Um marketplace integra uma API fiscal para emitir automaticamente a NF-e de cada pedido aprovado, recebendo de volta o XML e o DANFE para enviar ao comprador.
- Um software de gestão para clínicas usa a API fiscal para emitir NFS-e em diferentes municípios, sem precisar desenvolver uma integração para cada prefeitura.
- Uma transportadora conecta seu sistema a uma API fiscal para emitir CT-e e MDF-e antes de cada viagem e acompanhar a autorização em tempo real.
- Um ERP que atende vários clientes gerencia certificados e rejeições de dezenas de CNPJs em um único painel, com todas as emissões feitas pela mesma API.

## Perguntas frequentes

### Preciso de certificado digital para usar uma API fiscal?

Sim, na maioria dos casos. Documentos como NF-e, NFC-e, CT-e e MDF-e exigem assinatura com certificado digital, geralmente do tipo A1, que é enviado à API para que ela assine o XML em nome da empresa.

### Posso testar a API fiscal sem emitir notas válidas?

Sim. As APIs fiscais costumam oferecer um ambiente de homologação, onde os documentos são processados sem valor fiscal. Depois dos testes, a integração passa a usar o ambiente de produção.

### A API fiscal calcula os impostos sozinha?

Depende do fornecedor. Em geral, a API valida e transmite os dados, mas a definição de regras tributárias, como CST, CSOSN, CFOP e alíquotas, continua sendo responsabilidade da empresa ou do seu contador.

### API fiscal serve para empresas pequenas?

Serve para qualquer empresa que tenha um sistema próprio ou plataforma de vendas e queira automatizar a emissão. É especialmente útil para quem desenvolve software e precisa emitir notas para vários clientes.

## Termos relacionados

- [API REST para emissão fiscal](https://conota.dev/glossario/api-rest-para-emissao-fiscal.md)
- [Arquivo XML fiscal](https://conota.dev/glossario/arquivo-xml-fiscal.md)
- [Assinatura digital do XML](https://conota.dev/glossario/assinatura-digital-do-xml.md)
- [Certificado digital A1](https://conota.dev/glossario/certificado-digital-a1.md)
- [Ambiente de homologação](https://conota.dev/glossario/ambiente-de-homologacao.md)
- [Conota MCP](https://conota.dev/glossario/conota-mcp.md)

---

Fonte: [API fiscal](https://conota.dev/glossario/api-fiscal/) · Atualizado em 2026-10-22
