Consultar NF-e sem certificado

POST /api/consultar-nfe-xml-sem-certificado

Retorna o XML de uma NF-e (modelo 55) a partir da chave de acesso de 44 dígitos, sem certificado digital. Uma chave por requisição.

O XML é uma cópia para leitura, sem a assinatura digital. Traz os dados da nota, mas não substitui o XML oficial na escrituração e não passa em validação de assinatura nem de schema. Para o XML oficial, use Consultar NF-e com certificado, com o certificado A1 de quem participou da nota.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Corpo da requisição

Envie um JSON (Content-Type: application/json) com um único campo.

Cobrança

• A consulta é cobrada quando a chave é válida, mesmo que a nota não seja encontrada (nao_encontrado).
• Chave inválida (dígito verificador, UF, data, modelo, CNPJ/CPF do emitente) é recusada com 400 e não é cobrada. Chave de API inválida também não.
• Depois de um nao_encontrado, a mesma chave volta como nao_encontrado sem cobrança por 1 hora, se a nota for do mês atual ou do anterior, ou por 24 horas, nos demais casos. Nota recém-emitida pode ainda não estar disponível: tente de novo depois desse prazo.
• Consultar de novo uma chave que já retornou XML cobra de novo. Para baixar outra vez sem custo, use o histórico do painel.
• Falha nossa (erro) não é cobrada.
• As consultas grátis do mês não valem para este produto.

Preço por nota: R$ 0,05 no Enterprise (2 consultas). Nos planos Lite, Starter e Pro, o mesmo da NF-e com certificado: 3 consultas por nota, ou R$ 2,01, R$ 0,30 e R$ 0,195. Veja a tabela em Planos e limites.

Exemplos de código

curl -X POST "https://api.fiscalapi.com.br/api/consultar-nfe-xml-sem-certificado" \
  -H "X-API-Key: fapi_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"chave":"35261012345678000195550010000001231123456784"}'

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-nfe-xml-sem-certificado",
  {
    method: "POST",
    headers: {
      "X-API-Key": "fapi_sua_chave_aqui",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      chave: "35261012345678000195550010000001231123456784",
    }),
  }
);
const data = await response.json();
console.log(data.resultados[0].status);

import requests

response = requests.post(
    "https://api.fiscalapi.com.br/api/consultar-nfe-xml-sem-certificado",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    json={"chave": "35261012345678000195550010000001231123456784"},
)
data = response.json()
print(data["resultados"][0]["status"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->post('https://api.fiscalapi.com.br/api/consultar-nfe-xml-sem-certificado', [
    'chave' => '35261012345678000195550010000001231123456784',
]);
$data = $response->json();

Resposta

Campos de nível superior

Campos de cada resultado (resultados[])

Valores de status

Exemplo de resposta

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "total": 1,
  "com_dado": 1,
  "creditos_cobrados": 3,
  "resultados": [
    {
      "chave": "35261012345678000195550010000001231123456784",
      "status": "ok",
      "mensagem": "Nota encontrada.",
      "xml": "<nfeProc versao=\"4.00\" ...>...</nfeProc>",
      "assinado": false,
      "tipo_xml": "leitura"
    }
  ]
}

A raiz do XML pode ser nfeProc ou NFe. Não conte com a ordem dos campos do schema nem com a assinatura.

Códigos de erro

Os erros seguem o formato RFC 7807: o código fica no campo title.

XML da NF-e pela chave de acesso · Planos e preços