Pular para o conteúdo

API do FazNota — v3 (Recomendada)

API REST para emissão e gestão de NF-e, NFC-e, NFS-e, CIOT, RENAVE, notas de fornecedor, clientes e produtos.

Comece por aqui

O que a API do FazNota faz

A API de emissão de notas do FazNota permite automatizar a emissão de:

  • NF-e — Nota Fiscal Eletrônica (modelo 55)
  • NFC-e — Nota Fiscal de Consumidor Eletrônica (modelo 65)
  • NFS-e — Nota Fiscal de Serviço Eletrônica (Padrão Nacional e municipais)
  • CT-e e CT-e OS — Conhecimento de Transporte Eletrônico (modelos 57 e 67)
  • MDF-e — Manifesto Eletrônico de Documentos Fiscais (modelo 58)
  • BP-e — Bilhete de Passagem Eletrônico (modelo 63)
  • CIOT — Código Identificador da Operação de Transporte (ANTT)

E também:

  • RENAVE — registro de entrada e saída de veículos no estoque da revenda (não emite documento fiscal)
  • Notas de fornecedor — manifestação do destinatário (MD-e)
  • Classificação fiscal de produtos e serviços (sugestão de NCM, CFOP, CST, alíquotas e IBS/CBS, a conferir com o contador)
  • Rotinas que emitem NFS-e sozinhas na data da agenda (serviço recorrente, aluguel, condomínio)
  • Certificado digital A1: instalação e consulta da situação e da validade
  • Relatórios — resumo diário de emissões e XMLs em lote por período
  • Clientes e produtos — cadastro com configurações fiscais completas
  • Status — health check da plataforma (GET /health)

A API foi projetada para integrar-se a sistemas existentes (ERPs, e-commerces, PDVs) e transferir para a plataforma toda a responsabilidade de emissão e comunicação com a SEFAZ.

Como a documentação está organizada

Conceitos

Glossário fiscal, fluxo assíncrono de emissão e estrutura padrão de resposta.

Padrões

Códigos de status internos, tratamento de erros, paginação e idempotência.

Guias práticos

Receitas passo a passo: emitir NF-e, NFC-e, NFS-e e CIOT; cancelar, carta de correção, inutilizar numeração; RENAVE; nota de fornecedor; classificação fiscal; rotinas; certificado digital; resumo diário; XMLs por período; sincronizar clientes e produtos.

Código de Exemplo

Implementações em 9 linguagens: cURL, PHP, JavaScript, TypeScript, Python, Java, C#, Go e Ruby.

Convenções desta documentação

  • Sempre HTTP 200. A API retorna 200 OK mesmo em erros; o status real está em body.status (códigos 001–999).
  • Toda emissão é assíncrona. Você recebe um recibo e consulta depois. Veja Fluxo assíncrono.
  • Cada resposta inclui um X-Request-Id (também em meta.request_id). Cite esse valor ao acionar o suporte.

Suporte