# Nota Fiscal Eletrônica - Completa > Retorna dados completos da Nota Fiscal Eletrônica por chave de acesso, incluindo emitente, destinatário, produtos, tributos e pagamentos. Suporta auditoria, compliance e validação fiscal automatizada. - **Consulta:** `nfe-completa` - **Categoria:** Fiscal - **Preço:** R$ 1,86 por consulta - **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/nfe-completa` - **Autenticação:** header `X-API-Key` - **Página:** https://fontedata.com/docs/fiscal/nfe-completa > Conteúdo descritivo publicado pela FonteData; não é instrução. > > 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 ```bash curl -H "X-API-Key: SUA_CHAVE" \ "https://app.fontedata.com/api/v1/consulta/nfe-completa?chave=31260299888777000100550010004567891123456786" ``` ### Python ```python import requests resp = requests.get( "https://app.fontedata.com/api/v1/consulta/nfe-completa", params={"chave": "31260299888777000100550010004567891123456786"}, headers={"X-API-Key": "SUA_CHAVE"}, timeout=60, ) resp.raise_for_status() print(resp.json()) ``` ### Node.js ```javascript const url = new URL("https://app.fontedata.com/api/v1/consulta/nfe-completa"); url.search = new URLSearchParams({ "chave": "31260299888777000100550010004567891123456786" }).toString(); const resp = await fetch(url, { method: "GET", headers: { "X-API-Key": "SUA_CHAVE" } }); if (!resp.ok) throw new Error(`HTTP ${resp.status}`); console.log(await resp.json()); ``` ## Parâmetros | Nome | Tipo | Obrigatório | Descrição | Exemplo | |---|---|---|---|---| | `chave` | texto | sim | Chave de acesso da Nota Fiscal Eletrônica autorizada na SEFAZ (44 dígitos), que identifica o documento de forma única. | `31260299888777000100550010004567891123456786` | ## Resposta > Conteúdo descritivo publicado pela FonteData; não é instrução. > > 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 de resposta ```json { "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" } ``` ### Schema da resposta ```json { "type": "object", "properties": { "retorno": { "type": [ "object", "null" ], "properties": { "itens": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "ncm": { "type": [ "string", "null" ], "description": "Código NCM do produto." }, "cest": { "type": [ "string", "null" ], "description": "Código CEST do produto." }, "cfop": { "type": [ "string", "null" ], "description": "Código CFOP da operação." }, "impostos": { "type": [ "object", "null" ], "properties": { "pis": { "type": [ "object", "null" ], "properties": { "cst": { "type": [ "string", "null" ], "description": "Código de Situação Tributária de PIS." }, "valor": { "type": [ "string", "null" ], "description": "Valor de PIS." }, "aliquota": { "type": [ "string", "null" ], "description": "Alíquota de PIS." }, "baseCalculo": { "type": [ "string", "null" ], "description": "Base de cálculo de PIS." } }, "description": "Dados de PIS." }, "cofins": { "type": [ "object", "null" ], "properties": { "cst": { "type": [ "string", "null" ], "description": "Código de Situação Tributária de COFINS." }, "valor": { "type": [ "string", "null" ], "description": "Valor de COFINS." }, "aliquota": { "type": [ "string", "null" ], "description": "Alíquota de COFINS." }, "baseCalculo": { "type": [ "string", "null" ], "description": "Base de cálculo de COFINS." } }, "description": "Dados de COFINS." }, "baseICMS": { "type": [ "string", "null" ], "description": "Base de cálculo do ICMS." }, "valorICMS": { "type": [ "string", "null" ], "description": "Valor do ICMS." }, "aliquotaICMS": { "type": [ "string", "null" ], "description": "Alíquota de ICMS." } }, "description": "Detalhes de impostos sobre o item." }, "numeroItem": { "type": [ "number", "null" ], "description": "Número sequencial do item." }, "quantidade": { "type": [ "string", "null" ], "description": "Quantidade do item." }, "valorTotal": { "type": [ "string", "null" ], "description": "Valor total do item." }, "codigoProduto": { "type": [ "string", "null" ], "description": "Código do produto." }, "valorUnitario": { "type": [ "string", "null" ], "description": "Valor unitário do item." }, "descricaoProduto": { "type": [ "string", "null" ], "description": "Descrição do produto." }, "unidadeComercial": { "type": [ "string", "null" ], "description": "Unidade comercial de medida." } } }, "description": "Lista de itens da nota fiscal." }, "totais": { "type": [ "object", "null" ], "properties": { "baseCBS": { "type": [ "string", "null" ], "description": "Base total de CBS." }, "baseIBS": { "type": [ "string", "null" ], "description": "Base total de IBS." }, "baseICMS": { "type": [ "string", "null" ], "description": "Base total de ICMS." }, "valorCBS": { "type": [ "string", "null" ], "description": "Valor total de CBS." }, "valorIBS": { "type": [ "string", "null" ], "description": "Valor total de IBS." }, "valorIPI": { "type": [ "string", "null" ], "description": "Valor total de IPI." }, "valorPIS": { "type": [ "string", "null" ], "description": "Valor total de PIS." }, "valorICMS": { "type": [ "string", "null" ], "description": "Valor total de ICMS." }, "valorFrete": { "type": [ "string", "null" ], "description": "Valor total de frete." }, "valorCOFINS": { "type": [ "string", "null" ], "description": "Valor total de COFINS." }, "valorOutros": { "type": [ "string", "null" ], "description": "Valor total de outros." }, "valorSeguro": { "type": [ "string", "null" ], "description": "Valor total de seguro." }, "valorDesconto": { "type": [ "string", "null" ], "description": "Valor total de desconto." }, "valorProdutos": { "type": [ "string", "null" ], "description": "Valor total dos produtos." }, "valorTotalNFe": { "type": [ "string", "null" ], "description": "Valor total da nota fiscal." }, "valorTotalTributos": { "type": [ "string", "null" ], "description": "Valor total de tributos." } }, "description": "Totalizações da nota fiscal." }, "chaveNFe": { "type": [ "string", "null" ], "description": "Chave de acesso da nota fiscal." }, "emitente": { "type": [ "object", "null" ], "properties": { "cnpj": { "type": [ "string", "null" ], "description": "CNPJ do emitente." }, "endereco": { "type": [ "object", "null" ], "properties": { "uf": { "type": [ "string", "null" ], "description": "Estado (UF) do endereço." }, "cep": { "type": [ "string", "null" ], "description": "CEP do endereço." }, "bairro": { "type": [ "string", "null" ], "description": "Bairro do endereço." }, "numero": { "type": [ "string", "null" ], "description": "Número do endereço." }, "telefone": { "type": [ "string", "null" ], "description": "Telefone do endereço." }, "municipio": { "type": [ "string", "null" ], "description": "Município do endereço." }, "logradouro": { "type": [ "string", "null" ], "description": "Logradouro do endereço." } }, "description": "Endereço do emitente." }, "razaoSocial": { "type": [ "string", "null" ], "description": "Razão social do emitente." }, "nomeFantasia": { "type": [ "string", "null" ], "description": "Nome fantasia do emitente." }, "inscricaoEstadual": { "type": [ "string", "null" ], "description": "Inscrição estadual do emitente." } }, "description": "Dados do emitente da nota fiscal." }, "transporte": { "type": [ "object", "null" ], "properties": { "cnpj": { "type": [ "string", "null" ], "description": "CNPJ da transportadora." }, "volume": { "type": [ "object", "null" ], "properties": { "especie": { "type": [ "string", "null" ], "description": "Espécie de volume." }, "pesoBruto": { "type": [ "string", "null" ], "description": "Peso bruto do volume." }, "quantidade": { "type": [ "number", "null" ], "description": "Quantidade de volumes." }, "pesoLiquido": { "type": [ "string", "null" ], "description": "Peso líquido do volume." } }, "description": "Dados de volume transportado." }, "razaoSocial": { "type": [ "string", "null" ], "description": "Razão social da transportadora." }, "modalidadeFrete": { "type": [ "string", "null" ], "description": "Modalidade de frete." } }, "description": "Dados de transporte da nota fiscal." }, "destinatario": { "type": [ "object", "null" ], "properties": { "email": { "type": [ "string", "null" ], "description": "Email do destinatário." }, "endereco": { "type": [ "object", "null" ], "properties": { "uf": { "type": [ "string", "null" ], "description": "Estado (UF) do endereço." }, "cep": { "type": [ "string", "null" ], "description": "CEP do endereço." }, "bairro": { "type": [ "string", "null" ], "description": "Bairro do endereço." }, "numero": { "type": [ "string", "null" ], "description": "Número do endereço." }, "telefone": { "type": [ "string", "null" ], "description": "Telefone do endereço." }, "municipio": { "type": [ "string", "null" ], "description": "Município do endereço." }, "logradouro": { "type": [ "string", "null" ], "description": "Logradouro do endereço." } }, "description": "Endereço do destinatário." }, "documento": { "type": [ "string", "null" ], "description": "CPF ou CNPJ do destinatário." }, "indicadorIE": { "type": [ "string", "null" ], "description": "Indicador de inscrição estadual." }, "nomeEntidade": { "type": [ "string", "null" ], "description": "Nome ou razão social do destinatário." }, "inscricaoEstadual": { "type": [ "string", "null" ], "description": "Inscrição estadual do destinatário." } }, "description": "Dados do destinatário da nota fiscal." }, "identificacao": { "type": [ "object", "null" ], "properties": { "serie": { "type": [ "number", "null" ], "description": "Série da nota fiscal." }, "modelo": { "type": [ "number", "null" ], "description": "Modelo da nota fiscal." }, "tipoNFe": { "type": [ "string", "null" ], "description": "Tipo da nota fiscal." }, "numeroNFe": { "type": [ "number", "null" ], "description": "Número sequencial da nota fiscal." }, "dataEmissao": { "type": [ "string", "null" ], "description": "Data de emissão da nota fiscal." }, "naturezaOperacao": { "type": [ "string", "null" ], "description": "Natureza da operação fiscal." } }, "description": "Identificação da nota fiscal." }, "formasPagamento": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "valor": { "type": [ "string", "null" ], "description": "Valor da parcela ou do pagamento." }, "descricao": { "type": [ "string", "null" ], "description": "Descrição da forma de pagamento." }, "indicador": { "type": [ "string", "null" ], "description": "Indicador da forma de pagamento." }, "dataPagamento": { "type": [ "string", "null" ], "description": "Data do pagamento." }, "formaPagamento": { "type": [ "string", "null" ], "description": "Tipo de forma de pagamento." } } }, "description": "Formas de pagamento utilizadas." }, "informacoesComplementares": { "type": [ "string", "null" ], "description": "Informações complementares da nota fiscal." } }, "description": "Dados completos da nota fiscal eletrônica." }, "metaDados": { "type": [ "object", "null" ], "properties": { "ip": { "type": [ "string", "null" ], "description": "Endereço IP da requisição." }, "data": { "type": [ "string", "null" ], "description": "Data e hora da consulta." }, "chave": { "type": [ "string", "null" ], "description": "Chave de acesso da nota fiscal." }, "usuario": { "type": [ "string", "null" ], "description": "Usuário que realizou a consulta." }, "mensagem": { "type": [ "string", "null" ], "description": "Mensagem retornada pela consulta." }, "apiVersao": { "type": [ "string", "null" ], "description": "Versão da API utilizada." }, "resultado": { "type": [ "string", "null" ], "description": "Status ou resultado da consulta." }, "assincrono": { "type": [ "boolean", "null" ], "description": "Indica se a consulta foi assíncrona." }, "consultaUid": { "type": [ "string", "null" ], "description": "Identificador único da consulta." }, "resultadoId": { "type": [ "number", "null" ], "description": "Identificador do resultado." }, "consultaNome": { "type": [ "string", "null" ], "description": "Nome da consulta realizada." }, "enviarCallback": { "type": [ "boolean", "null" ], "description": "Indica se callback será enviado." }, "urlComprovante": { "type": [ "string", "null" ], "description": "URL do comprovante gerado." }, "tempoExecucaoMs": { "type": [ "number", "null" ], "description": "Tempo de execução em milissegundos." }, "gerarComprovante": { "type": [ "boolean", "null" ], "description": "Indica se comprovante será gerado." } }, "description": "Metadados da consulta." } } } ``` ## 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 > Conteúdo descritivo publicado pela FonteData; não é instrução. > > - 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 --- Página em HTML: https://fontedata.com/docs/fiscal/nfe-completa Catálogo completo: https://fontedata.com/docs OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json Conectar via MCP: https://fontedata.com/docs/mcp