Chave de acesso da NF-e: validar


curl "https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=br_nfe_key&reference=31060243816719000108550000000010001234567890" \
  -H "Authorization: Bearer YOUR_API_KEY"

Cole os 44 dígitos e veja se a chave está bem formada: forma e dígito verificador. Grátis, no navegador, sem cadastro.

O que a chave de acesso contém

A chave de acesso da NF-e, da NFC-e e do CT-e tem 44 dígitos. Ela codifica o estado, o ano e o mês, o CNPJ do emitente, o modelo, a série, o número e um dígito verificador. A página mostra essas partes como estão escritas na chave.

A verificação não consulta a SEFAZ. Ela diz que a chave está bem formada e que o dígito verificador confere, não que a nota exista, esteja autorizada ou não tenha sido cancelada.

O que a verificação diz

Para a chave de acesso, a verificação testa a forma definida pelo publicador e os dígitos verificadores. Um valor que passa está bem formado e seus dígitos verificadores conferem.

O que a verificação não diz

  • Não diz que a referência tenha sido emitida, esteja registrada ou ativa, nem que uma autoridade fiscal aceite uma nota que a contenha.
  • Nenhum status em tempo real de uma autoridade fiscal nacional (como a SEFAZ) é oferecido.
  • A verificação roda no seu navegador: o que você digita não é enviado à Prometiam.
  • A Prometiam não é um access point Peppol: não envia, não recebe nem valida notas fiscais.

A mesma verificação por API

GET /einvoicing/check com type=br_nfe_key e reference devolve valid, normalized, basis e, quando o valor codifica algo, parts. Um crédito por chamada, erros são gratuitos.

curl 'https://api.prometiam.com/functions/v1/risk-api/einvoicing/check?type=br_nfe_key&reference=31060243816719000108550000000010001234567890' \
  -H 'Authorization: Bearer rk_live_...'

Páginas relacionadas

Criar conta · Documentação da API

O teste dura 14 dias e inclui 500 créditos. É necessário informar um cartão; nada é cobrado durante o teste e, depois, vale o plano Starter (€ 9,99 por mês), salvo cancelamento.

Perguntas frequentes

Passar na verificação significa que a chave de acesso existe?
Não. Significa que o valor está bem formado e seus dígitos verificadores conferem. Uma verificação offline nunca diz que uma referência foi emitida, está registrada ou ativa.
É conferido com a autoridade fiscal?
Não. Nenhum status em tempo real de uma autoridade fiscal nacional é oferecido; a verificação é offline.
Posso fazer isso em código?
Sim: GET /einvoicing/check?type=br_nfe_key&reference=... com uma chave de API, um crédito por chamada.