O endpoint /api/NFeCompleta permite consultar uma Nota Fiscal Eletrônica por meio da chave de acesso, retornando o conteúdo integral do XML autorizado, incluindo emitente, destinatário, itens, tributos, totais, pagamentos, transporte e eventos vinculados.
NFe - Nota Fiscal Eletrônica - Completa
API de consulta completa de Nota Fiscal Eletrônica (NF-e) por chave de acesso, com retorno integral dos dados do XML autorizado. Inclui emitente, destinatário, produtos/serviços, NCM, tributos detalhados, totais, pagamentos, protocolos, eventos vinculados (cancelamento e carta de correção) e status da nota. Indicada para auditoria, compliance, conciliação financeira e validação fiscal automatizada em sistemas corporativos.
Casos de Uso
- Auditoria fiscal automatizada a partir do XML autorizado da NF-e.
- Conciliação financeira entre notas fiscais, pagamentos e pedidos.
- Onboarding e validação de fornecedores e clientes.
- Processos de compliance, ESG e validações tributárias.
- Validação automática de tributos, NCM, CFOP e composição fiscal de produtos.
- Monitoramento de cancelamentos e cartas de correção vinculadas à NF-e.
Aplicações
- Onboarding de Clientes e Fornecedores
- Compliance/ESG
Benefícios
- Acesso completo e estruturado a todos os dados da NF-e autorizada na SEFAZ.
- Reduz erros manuais em auditorias fiscais e conferências tributárias.
- Permite validação automatizada de impostos, produtos e pagamentos.
- Integração simples com ERPs, sistemas financeiros e fiscais.
- Possibilidade de geração de comprovante em PDF da NF-e consultada.
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/NotaFiscalEletronicaCompletaEndpoint
GET https://apiv3.directd.com.br/api/NotaFiscalEletronicaCompleta?Chave={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas NFe - Nota Fiscal Eletrônica - Completa.
Nota: Esta consulta gera comprovantes em PDF.
Esta API suporta geração de comprovantes em PDF
Campos Retornados
- Alíquota: Informa a alíquota do registro.
- Alíquota do ICMS: Informa a alíquota do ICMS do registro.
- Bairro: Bairro do endereço
- Base do Cálculo: Informa a base do cálculo do registro.
- Base do CBS: Informa a base do CBS (Contribuição sobre Bens e Serviços) do registro.
- Base do IBS: Informa a base do IBS (Imposto sobre Bens e Serviços) do registro.
- Base ICMS: Informa o valor base do ICMS do imposto.
- CEP: Número CEP do endereço
- CEST: Informa o CEST (Código Especificador da Substituição Tributária) do item.
- CFOP: Informa o código CFOP (Código Fiscal de Operações e Prestações) do item.
- Chave NFe: Informa a chave da nota fiscal.
- CNPJ: CNPJ da empresa
- Código do Produto: Informa o código do produto.
- CST: Informa o CST (Código de Situação Tributária) do registro.
- Data de Emissão: Data da emissão do certificado
- Data de Pagamento: Informa a data de pagamento.
- Descrição: Descrição do registro
- Descrição do Produto: Informa a descrição do produto.
- Destinatário: Detalhes sobre o destinatário da nota fiscal.
- Documento: Documento referente ao CPF/CNPJ
- E-mail: Endereço de e-mail da entidade
- Emitente: Detalhes sobre o emitente da nota fiscal.
- Endereço: Informa o endereço do indivíduo
- Espécie: Informa a espécie do veículo.
- Forma de Pagamento: Informa sobre a forma de pagamento do registro.
- Formas de Pagamento: Detalhes sobre a forma de pagamento do registro.
- Identificação: Identificação do indivíduo consultado
- Impostos: Detalhes a respeito dos impostos do item.
- Indicador: Descreve o título do indicador
- Indicador da IE: Indica o tipo de inscrição estadual da entidade.
- Informações Complementares: Detalha informações complementares sobre a consulta.
- Inscrição Estadual: Inscrição estadual da entidade consultada
- Lista de Itens: Lista os itens disponíveis.
- Logradouro: Nome da rua, avenida, travessa, alameda ou outros onde está localizado o endereço.
- Modalidade do Frete: Informa a modalidade do frete do registro.
- Modelo: Informa o modelo do veículo.
- Município: Município/cidade referente ao registro
- Natureza da Operação: Informa a natureza da operação da nota fiscal.
- NCM: Informa o código NCM (Nomenclatura Comum do Mercosul) do item.
- Nome Entidade: Nome da entidade ou Razão Social consultada
- Nome Fantasia: Nome fantasia da empresa
- Número: Número do registro em questão
- Número da NFe: Informa o número da nota fiscal.
- Número do Item: Informa o número do item.
- Peso Bruto: Informa o peso bruto do volume.
- Peso Líquido: Informa o peso líquido do volume.
- PIS: Número PIS (Programa de Integração Social) do indivíduo
- Quantidade: Quantidade de registros
- Razão Social: Razão social da empresa
- Série: Informa a série da nota fiscal.
- Telefone: Número de telefone do indivíduo ou entidade
- Tipo da NFe: Informa o tipo da nota fiscal.
- Totais: Detalha os totais dos valores da nota fiscal.
- Transporte: Detalhes sobre os registros de transporte.
- UF: Unidade Federativa (estado) referente ao registro
- Unidade Comercial: Informa a unidade comercial.
- Valor: Valor da parcela
- Valor de Outros: Informa outros valores do registro.
- Valor do CBS: Informa o valor do CBS (Contribuição sobre Bens e Serviços) do registro.
- Valor do COFINS: Informa o valor do COFINS do registro.
- Valor do Desconto: Informa o valor do desconto do registro.
- Valor do Frete: Informa o valor do frete do registro.
- Valor do IBS: Informa o valor do IBS (Imposto sobre Bens e Serviços) do registro.
- Valor do ICMS: Informa o valor do ICMS do registro.
- Valor do IPI: Informa o valor do IPI do registro.
- Valor do PIS: Informa o valor do PIS do registro.
- Valor do Seguro: Informa o valor do seguro do registro.
- Valor dos Produtos: Informa o valor dos produtos no registro.
- Valor Total: Valor total do registro
- Valor Total da NFe: Informa o valor total da nota fiscal.
- Valor Total dos Tributos: Informa o valor total dos tributos do registro.
- Valor Unitário: Informa o valor unitário do item.
- Volume: Informa o volume.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CHAVE | string | Sim | O parâmetro CHAVE pode ser enviado com qualquer outro. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"chaveNFe": "string",
"identificacao": {
"numeroNFe": 0,
"serie": 0,
"dataEmissao": "string",
"naturezaOperacao": "string",
"tipoNFe": "string",
"modelo": 0
},
"emitente": {
"cnpj": "string",
"razaoSocial": "string",
"nomeFantasia": "string",
"inscricaoEstadual": "string",
"endereco": {
"logradouro": "string",
"numero": "string",
"bairro": "string",
"municipio": "string",
"uf": "string",
"cep": "string",
"telefone": "string"
}
},
"destinatario": {
"documento": "string",
"nomeEntidade": "string",
"inscricaoEstadual": "string",
"indicadorIE": "string",
"email": "string",
"endereco": {
"logradouro": "string",
"numero": "string",
"bairro": "string",
"municipio": "string",
"uf": "string",
"cep": "string",
"telefone": "string"
}
},
"itens": [
{
"numeroItem": 0,
"codigoProduto": "string",
"descricaoProduto": "string",
"ncm": "string",
"cest": "string",
"cfop": "string",
"quantidade": "string",
"unidadeComercial": "string",
"valorUnitario": "string",
"valorTotal": "string",
"impostos": {
"baseICMS": "string",
"aliquotaICMS": "string",
"valorICMS": "string",
"pis": {
"cst": "string",
"baseCalculo": "string",
"aliquota": "string",
"valor": "string"
},
"cofins": {
"cst": "string",
"baseCalculo": "string",
"aliquota": "string",
"valor": "string"
}
}
}
],
"totais": {
"baseICMS": "string",
"valorICMS": "string",
"baseIBS": "string",
"valorIBS": "string",
"baseCBS": "string",
"valorCBS": "string",
"valorProdutos": "string",
"valorFrete": "string",
"valorSeguro": "string",
"valorDesconto": "string",
"valorOutros": "string",
"valorIPI": "string",
"valorPIS": "string",
"valorCOFINS": "string",
"valorTotalNFe": "string",
"valorTotalTributos": "string"
},
"formasPagamento": [
{
"indicador": "string",
"formaPagamento": "string",
"descricao": "string",
"dataPagamento": "string",
"valor": "string"
}
],
"transporte": {
"modalidadeFrete": "string",
"cnpj": "string",
"razaoSocial": "string",
"volume": {
"quantidade": 0,
"especie": "string",
"pesoBruto": "string",
"pesoLiquido": "string"
}
},
"informacoesComplementares": "string"
}
}Erros Comuns
| Código | Descrição |
|---|---|
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. |
Notas Importantes
- Para obter o comprovante desta consulta, utiliza-se: '&GerarComprovante=habilitar' na URL
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228