Nota Fiscal Eletrônica - Completa

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/nfe-completa

R$ 1,86 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Permite consultar uma Nota Fiscal Eletrônica autorizada na SEFAZ através de sua chave de acesso, retornando a estrutura integral do documento autorizado. Inclui dados do emitente, destinatário, itens comercializados, classificações fiscais (NCM, CFOP, CST), impostos detalhados, totais, formas de pagamento, informações de transporte e eventos vinculados (cancelamentos e cartas de correção).

Casos de uso:

Auditoria fiscal e validação de conformidade tributária
Conciliação de dados entre notas fiscais, pagamentos e pedidos em sistemas internos
Onboarding e validação de dados de fornecedores e clientes
Validação automatizada de tributos, classificações e composição fiscal
Monitoramento de eventos relacionados à nota fiscal
Processos de governança (ESG) e compliance regulatório

Benefícios:

Acesso estruturado e completo aos dados da NF-e autorizada
Redução de erros em conferências tributárias e auditorias manuais
Validação automática de impostos, produtos e condições de pagamento
Integração facilitada com sistemas ERP, financeiro e fiscal
Geração de comprovante em PDF da consulta realizada

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/nfe-completa?chave=31260299888777000100550010004567891123456786"

Parâmetros

Nome	Tipo	Descrição	Exemplo
chave obrigatório	texto	Chave de acesso da Nota Fiscal Eletrônica autorizada na SEFAZ (44 dígitos), que identifica o documento de forma única.	31260299888777000100550010004567891123456786

Resposta

A resposta inclui os seguintes grupos de informações:

Identificação da NF-e:

Número, série, data de emissão e tipo da nota
Natureza da operação
Modelo

Emitente:

CNPJ, razão social, nome fantasia
Inscrição estadual
Endereço completo (logradouro, número, bairro, município, UF, CEP)
Contatos (telefone, e-mail)

Destinatário:

Documento (CPF/CNPJ)
Razão social/nome
Inscrição estadual e indicador de IE
Endereço completo e contatos

Itens comercializados:

Código e descrição do produto
Quantidade e unidade comercial
Valores unitário e total
NCM, CEST e CFOP
Impostos por item: bases de cálculo, alíquotas e valores de ICMS, PIS e COFINS

Totais:

Valores consolidados de produtos, frete, seguro e descontos
Base e valor de cada tributo (ICMS, IPI, PIS, COFINS)
Valor total de tributos e valor total da NF-e

Formas de pagamento:

Indicador e descrição da forma
Data de pagamento e valor de cada parcela

Transporte:

Modalidade de frete
Dados do transportador (CNPJ, razão social)
Volume (quantidade, espécie, peso bruto e líquido)

Informações complementares:

Campo livre para dados adicionais da operação

Exemplo — 200 OK

{
  "itens": [
    {
      "ncm": "string",
      "cest": null,
      "cfop": "string",
      "impostos": {
        "pis": {
          "cst": "string",
          "valor": "string",
          "aliquota": "string",
          "baseCalculo": "string"
        },
        "cofins": {
          "cst": "string",
          "valor": "string",
          "aliquota": "string",
          "baseCalculo": "string"
        },
        "baseICMS": "string",
        "valorICMS": "string",
        "aliquotaICMS": "string"
      },
      "numeroItem": "number",
      "quantidade": "string",
      "valorTotal": "string",
      "codigoProduto": "string",
      "valorUnitario": "string",
      "descricaoProduto": "string",
      "unidadeComercial": "string"
    }
  ],
  "totais": {
    "baseCBS": "string",
    "baseIBS": "string",
    "baseICMS": "string",
    "valorCBS": "string",
    "valorIBS": "string",
    "valorIPI": "string",
    "valorPIS": "string",
    "valorICMS": "string",
    "valorFrete": "string",
    "valorCOFINS": "string",
    "valorOutros": "string",
    "valorSeguro": "string",
    "valorDesconto": "string",
    "valorProdutos": "string",
    "valorTotalNFe": "string",
    "valorTotalTributos": null
  },
  "chaveNFe": "string",
  "emitente": {
    "cnpj": "string",
    "endereco": {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "numero": "string",
      "telefone": "string",
      "municipio": "string",
      "logradouro": "string"
    },
    "razaoSocial": "string",
    "nomeFantasia": "string",
    "inscricaoEstadual": "string"
  },
  "transporte": {
    "cnpj": "string",
    "volume": {
      "especie": "string",
      "pesoBruto": "string",
      "quantidade": "number",
      "pesoLiquido": "string"
    },
    "razaoSocial": "string",
    "modalidadeFrete": "string"
  },
  "destinatario": {
    "email": "string",
    "endereco": {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "numero": "string",
      "telefone": "string",
      "municipio": "string",
      "logradouro": "string"
    },
    "documento": "string",
    "indicadorIE": "string",
    "nomeEntidade": "string",
    "inscricaoEstadual": null
  },
  "identificacao": {
    "serie": "number",
    "modelo": "number",
    "tipoNFe": "string",
    "numeroNFe": "number",
    "dataEmissao": "string",
    "naturezaOperacao": "string"
  },
  "formasPagamento": [
    {
      "valor": "string",
      "descricao": null,
      "indicador": null,
      "dataPagamento": null,
      "formaPagamento": "string"
    }
  ],
  "informacoesComplementares": "string"
}

O JSON Schema desta consulta é longo demais para caber aqui. A íntegra está na versão em Markdown desta página e na especificação OpenAPI.

Códigos de erro

Código	Mensagem	Quando acontece
400	Requisição Inválida	a requisição está incorreta ou os parâmetros são inválidos.
401	Não Autenticado	o usuário não forneceu as credenciais corretas para acessar o recurso.
403	Não Autorizado	o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404	Não Encontrado	o servidor não encontrou uma representação atual do recurso solicitado.
408	Tempo Esgotado	o servidor não conseguiu retornar a requisição no prazo estabelecido.
500	Falha ao Realizar Consulta	o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503	Consulta em Manutenção	a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Observações

Esta consulta suporta geração de comprovante em PDF
Recomendado para fluxos que exigem rastreabilidade completa e auditoria de operações fiscais
A estrutura de retorno mapeia fielmente o conteúdo autorizado do documento
Integração ideal com workflows de conformidade e validação de dados cadastrais

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.