API de Nota Fiscal: NF-e, NFC-e, NFS-e, CT-e, MDF-e e BP-e

Por que a API FazNota

Uma integração para todos os documentos, sem você reimplementar a legislação.

Um só contrato para todos os documentos

O mesmo padrão de autenticação, envio, consulta e resposta em NF-e, NFC-e, NFS-e, CT-e, MDF-e, BP-e e demais documentos.

Tributação a partir do cadastro

Seu sistema envia o produto e a quantidade; a API calcula CFOP, NCM, CST/CSOSN e impostos a partir do cadastro no FazNota. Sem regra tributária no seu código.

Assíncrona e segura contra instabilidade

Cada envio devolve um recibo na hora, e o resultado — autorizada, rejeitada, cancelada — é consultado pelo recibo. Nenhuma nota se perde se a SEFAZ ou a prefeitura oscilar.

Sem nota duplicada

O campo numero-origem garante idempotência: reenviar o mesmo pedido devolve o recibo original em vez de emitir de novo.

Contrato estável

Recursos novos não quebram integrações existentes: a API segue versionamento semântico (SemVer), e toda resposta informa a versão em uso.

Atualizada com a legislação

Reforma Tributária (IBS/CBS), CNPJ alfanumérico, código de benefício fiscal e as notas técnicas mais recentes da SEFAZ.

Documentos e operações

Tudo o que o seu sistema precisa fazer com cada documento fiscal, pela mesma API.

NF-eNota Fiscal Eletrônica (modelo 55)

Emissão com cliente já cadastrado ou informado na própria chamada
Finalidades normal, complementar, ajuste e devolução; transporte e faturas (duplicatas)
Alteração da nota antes da emissão
Carta de correção (CC-e) e cancelamento
Inutilização de numeração (no AC, na BA e em SP deixou de ser exigida em 01/11/2026)
Consulta simples e completa, listagem paginada e links prontos do DANFE e do XML
Combustíveis com código ANP (inclusive GLP), guia de trânsito agropecuário e cliente estrangeiro

NFC-eNota Fiscal de Consumidor Eletrônica (modelo 65)

Emissão para venda no balcão, com consumidor identificado ou não
Formas de pagamento: dinheiro, crédito, débito, PIX dinâmico, PIX estático e demais códigos da SEFAZ
Cancelamento e inutilização de numeração (inutilização dispensada no AC, na BA e em SP desde 01/11/2026)
Consulta simples e completa e listagem paginada

NFS-eNota Fiscal de Serviço Eletrônica

Emissão no padrão nacional (ADN) e em dezenas de provedores municipais pela mesma chamada
ISS retido, informações complementares e indicador de operação da Reforma Tributária
Tomador no exterior, com nome e endereço em qualquer alfabeto
NFS-e de condomínio edilício: já emitida pela API (obrigatória a partir de 01/01/2027)
NFS-e de locação: já implementada na API e liberada assim que a Receita abrir o ambiente nacional (obrigatória a partir de 01/01/2027)
Alteração, cancelamento, consulta e listagem

CT-eConhecimento de Transporte Eletrônico (carga)

Emissão e cancelamento
Carta de correção, comprovante de entrega, insucesso de entrega, prestação em desacordo e os respectivos cancelamentos
Registro multimodal e informações de GTV (o EPEC do CT-e foi revogado pelo Ajuste SINIEF 26/2026 a partir de 05/10/2026)

CT-e OSTransporte para Outros Serviços (modelo 67)

Para transporte de passageiros (fretamento, turismo), valores e bagagens
Emissão, cancelamento e carta de correção
Informações de GTV, prestação em desacordo e respectivo cancelamento

MDF-eManifesto Eletrônico de Documentos Fiscais

Emissão, cancelamento e encerramento
Inclusão de condutor durante a viagem
Inclusão de documentos (DF-e) durante a viagem

CIOTCódigo Identificador da Operação de Transporte (ANTT)

Emissão, cancelamento, retificação e encerramento
Consulta do resultado pelo recibo: código do CIOT, verificador e protocolo
Emissão direta por empresa de transporte (ETC) com frota própria, para carga lotação ou fracionada
CNPJ e RNTRC do contratado, certificado A1 e ambiente vindos do cadastro da empresa

BP-eBilhete de Passagem Eletrônico

Emissão, cancelamento e substituição
Não embarque e alteração de poltrona
Excesso de bagagem

RENAVERegistro Nacional de Veículos em Estoque

Entrada e saída de veículos do estoque vinculadas à nota fiscal
Entrada de veículo próprio
Cancelamento de entrada e de saída

Notas de fornecedoresManifestação do Destinatário (MD-e)

Listagem das NF-e emitidas contra a sua empresa
Manifestação: ciência, confirmação, desconhecimento ou operação não realizada

CadastrosClientes, produtos e serviços

Clientes: criar, consultar, buscar por nome, alterar e excluir
Produtos e serviços: criar, consultar, buscar, listar com paginação, alterar e excluir — com a configuração fiscal de cada item

Relatórios e arquivosPara a gestão e a contabilidade

Resumo diário de emissões: totais por dia de NF-e e NFC-e emitidas, canceladas, denegadas e com falha, em períodos de até 92 dias
XML em lote: todos os XMLs de NF-e ou NFC-e de um período em um único arquivo para download, com aviso por e-mail — ideal para a contabilidade

Como funciona, em 4 passos

PASSO 1

Pegue o token

Gere o token da empresa no painel do FazNota e envie no cabeçalho Authorization de cada chamada.

PASSO 2

Cadastre ou envie junto

Use produtos e clientes cadastrados no FazNota ou informe o cliente na própria chamada. A tributação vem do cadastro.

PASSO 3

Envie e receba o recibo

Cada envio devolve um recibo na hora. Com o numero-origem, um reenvio nunca vira nota duplicada.

PASSO 4

Consulte o resultado

Consulte pelo recibo se a nota foi autorizada, rejeitada ou cancelada e pegue os links do DANFE e do XML.

Da chamada à nota autorizada

Envie o produto e a quantidade — o FazNota cuida de CFOP, NCM, CST/CSOSN e impostos. A resposta traz um recibo; depois é só consultar o resultado por ele.

Toda resposta segue o mesmo formato, com status, descricao, data e meta (request-id, versão da API e horário).

Guia completo de emissão de NF-e

# 1. Enviar a NF-e para emissão
curl -X POST https://api.mysebr.com.br/nfemyse-v3/rest/nfe/emissao \
  -H "Authorization: Token $SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "1", "cfop": "5102",
    "numero-origem": "PED-2026-00042",
    "tipo": "S", "finalidade": "N",
    "cliente": "12345678000199",
    "transporte": { "modalidade": "9" },
    "itens": [ { "produto": "SKU-001", "quantidade": "2", "valor-unitario": "89.90" } ]
  }'

# 2. Resposta imediata: a nota foi registrada
{ "status": "001", "descricao": "Nota registrada com sucesso.",
  "data": { "recibo": "rec_abc123" } }

# 3. Consultar o resultado pelo recibo
curl https://api.mysebr.com.br/nfemyse-v3/rest/nfe/nota/rec_abc123 \
  -H "Authorization: Token $SEU_TOKEN"

Exemplo da documentação oficial. Os campos completos de cada documento estão na referência da API.

Segmentos atendidos

Uma API para atender operações bem diferentes — e todos os regimes: MEI, Simples Nacional e Regime Normal, a partir do cadastro da empresa.

Varejo, supermercados, PDVs e deliveryNFC-e com PIX e todas as formas de pagamento.

Indústria, atacado, distribuidores e e-commerceNF-e completa, com devolução, complementar e transporte.

Serviços, clínicas, escritórios, agências e SaaSNFS-e nacional e municipal.

Condomínios e administradorasNFS-e de condomínio já na API, pronta para a obrigatoriedade de 01/01/2027.

Transportadoras e operadores logísticosCT-e, MDF-e, CIOT e eventos de entrega.

Passageiros, fretamento e turismoBP-e e CT-e OS.

Revendas de veículosRENAVE integrado à nota fiscal.

Postos, revendas de GLP e distribuidoras de combustívelNF-e com código ANP.

AgronegócioGuia de trânsito agropecuário na NF-e.

Clientes no exteriorCliente estrangeiro na NF-e e tomador no exterior na NFS-e.

Software houses, ERPs, marketplaces e integradoresUma API para atender todos os seus clientes e segmentos.

Para o desenvolvedor

API REST com JSON e autenticação por token
Documentação completa em português, com guias passo a passo
Referência interativa para testar as chamadas no navegador
Coleção Postman pronta para importar
Exemplos em cURL, C#, Go, Java, JavaScript, PHP, Python e Ruby
Documentação preparada para assistentes de IA (llms.txt)
API MCP: use o FazNota conversando com o Claude, o Claude Code, o Cursor ou o seu agente de IA
Rastreio de cada chamada (request-id), versão da API em toda resposta e endpoint de status

Documentação da API Primeiros passos Referência interativa Coleção Postman Exemplos de código Integração com IA API MCP (IA) Changelog OpenAPI (YAML) llms.txt

Perguntas frequentes

Em qual plano a API está disponível?

Em todos os planos do FazNota, do Starter ao Enterprise. As notas emitidas pela API contam dentro do limite de notas do plano contratado.

Preciso calcular impostos no meu sistema?

Não. O seu sistema envia o produto e a quantidade, e a API calcula CFOP, NCM, CST/CSOSN e impostos a partir do cadastro da empresa e dos produtos no FazNota. Você não precisa reimplementar regra tributária.

O que acontece se a SEFAZ ou a prefeitura ficar instável?

A emissão é assíncrona: cada envio devolve um recibo na hora, e o resultado (autorizada, rejeitada, cancelada) é consultado pelo recibo. Nenhuma nota se perde se a SEFAZ ou a prefeitura oscilar.

Como evito emitir a mesma nota duas vezes?

Use o campo numero-origem com o identificador do pedido no seu sistema. Se o mesmo pedido for reenviado, a API devolve o recibo original em vez de emitir de novo.

A API acompanha a Reforma Tributária?

Sim. A API já trabalha com IBS e CBS, com o indicador de operação da Reforma na NFS-e, o CNPJ alfanumérico, o código de benefício fiscal e as notas técnicas mais recentes da SEFAZ. As novidades ficam registradas no changelog.

Existe ambiente de testes?

A documentação descreve o ambiente de produção. Para testes sem efeito fiscal, fale com o suporte sobre a disponibilidade de ambiente de homologação.

A API muda e quebra a minha integração?

Não. A API segue versionamento semântico (SemVer): recursos novos não quebram integrações existentes, e toda resposta informa a versão em uso no campo meta.api_version e no cabeçalho X-API-Version.

Integre seu sistema à emissão fiscal do FazNota

Leia a documentação, faça a primeira chamada e fale com o nosso time para tirar dúvidas da integração.

Ver documentação [email protected] WhatsApp

API FazNota: emissão fiscal completa integrada ao seu sistema