Baixar XML da NF-e pela chave de acesso

A API da FiscalAPI baixa o XML completo e assinado (nfeProc) pela chave de acesso: um POST em /api/consultar-nfe-xml com a chave de 44 dígitos, o certificado A1 (.pfx em base64) e a senha. O XML vem na resposta, em JSON. É uma chave por requisição; para um lote, percorra a lista ou use o lote por planilha no painel. O certificado precisa ser de um participante da nota (emitente, destinatário, transportador ou autorizado no XML) e, na API, é usado só na consulta e não fica guardado. A API começa no plano Lite.

Na FiscalAPI, sim, até 10 XML por mês. A cota renova todo mês e vale para quem ainda não assinou nenhum plano: crie a conta, confirme o e-mail e envie o certificado A1 no painel, sem cartão de crédito. Chave que não retorna XML não gasta a cota. As 10 consultas grátis de Inscrição Estadual e CNPJ continuam à parte.

Só a chave de acesso, sem certificado, retorna apenas o resumo da NF-e (sem itens, NCM, CFOP ou impostos) — é o limite definido pelo Ajuste SINIEF 16/2018. O XML completo e assinado sai com o certificado digital de um participante da nota (emitente, destinatário, transportador ou autorizado): com ele, a FiscalAPI baixa o XML pela chave. Sem certificado, o caminho é pedir o XML a quem emitiu a nota.

Não, valem no painel. Pela API, a NF-e por chave começa no plano Lite e conta como 3 consultas do plano por nota (no Enterprise, R$ 0,025 por nota). Dá para testar no painel e ver os campos da resposta na documentação antes de integrar.

Não. A consulta usa o certificado A1: o arquivo .pfx com a senha. O A3 fica preso no token ou no cartão e não pode ser enviado. Se a empresa só tem o A3, peça o XML a quem emitiu a nota ou providencie um A1 com a sua certificadora.

Na consulta avulsa, não: o certificado e a senha são usados apenas durante a consulta e descartados em seguida — zero custódia. No lote por planilha, com a sua autorização, eles ficam cifrados só enquanto o lote é processado e são apagados ao final.

Pode, com o certificado A1 da empresa cliente que participou da nota (emitente, destinatário ou transportador). Em qualquer caso, o certificado é usado só durante a consulta.

O XML (nfeProc) é o documento fiscal com validade jurídica, assinado pela SEFAZ. O DANFE em PDF é apenas a representação gráfica. Para escrituração, crédito de ICMS/PIS/COFINS e guarda dos 5 anos, é o XML que vale — e é ele que a FiscalAPI entrega.

Sim. No painel você cola até 50 chaves por vez, ou envia uma planilha com até 200 mil chaves na aba Lotes: processamos no servidor e você baixa todos os XML num único .zip. Pela API, é uma chave por requisição: para um lote, percorra a lista.

Quando o titular do certificado não é participante da nota (emitente, destinatário, transportador ou autorizado), ou quando a nota é tão antiga que a SEFAZ não a entrega mais. Nesses casos a FiscalAPI explica o motivo e não cobra a consulta.

Em muitos casos, sim. As notas recentes saem direto pela consulta por chave da SEFAZ. Quando a SEFAZ não disponibiliza mais o XML por esse serviço (rejeição 632, típico de notas mais antigas), a FiscalAPI continua buscando o XML automaticamente com o mesmo certificado. Se não conseguir, a consulta não é cobrada. Em qualquer caso, o titular do certificado precisa ser participante da nota.

A SEFAZ só libera o resumo até que o destinatário se manifeste. A FiscalAPI registra a Ciência da Operação com o seu certificado e entrega o XML na mesma consulta; fora do prazo da Ciência, tenta obter o XML sem registrar evento e, se preciso, registra a Confirmação da Operação. O comportamento está descrito nos Termos de Uso e pode ser desligado por consulta.

Sim. Como a FiscalAPI obtém o XML pelo certificado de um participante da nota, a consulta funciona inclusive quando o destinatário possui Inscrição Estadual — cenário comum no agronegócio e no produtor rural.