Passar para o conteúdo principal

API Consulta de Nota Fiscal: Chave do XML e QR Code de NFC-e

[JT] Equipe Webmania® avatar
Escrito por [JT] Equipe Webmania®
Atualizado essa semana

A consulta de Nota Fiscal é a maneira de validar as informações garantindo a sua veracidade e obter controle contábil de suas operações.

A Webmania® permite realizar a consulta por dois modelos, sendo por Chave XML e QR Code para Notas Fiscais de Consumidor (NFC-e) para visualização das informações de compra. Abaixo maiores informações e características técnicas de cada consulta:

Informação importante: Para realizar a consulta de nota fiscal é necessário a contratação do plano, caso não tenha contratado (Clique aqui) e entre em contato com nossa equipe de vendas.

1) CARACTERÍSTICAS DE CONSULTA DE CHAVE POR XML PARA NF-e e NFC-e

  • Principais estados para consulta de NF-e e NFC-e por chave XML: Válido para todo território Brasileiro.

  • Estados permitidos para consulta de QR CODE NFC-e [Informações de produto na nota]: Acre, Alagoas, Amazonas, Bahia, Espírito Santo, Goiás, Mato Grosso, Mato Grosso do Sul, Paraná, Pernambuco, Piauí, Rio de Janeiro, Rio Grande do Sul, Roraima, São Paulo, Tocantins.

  • Estados NÃO atendidos para consulta de QR CODE NFC-e [Informações de produto na nota]: Amapá, Ceará, Distrito Federal, Maranhão, Pará, Paraíba, Rio Grande do Norte, Rondônia, Sergipe, São Paulo (CF-e SAT).

      • Observação: Limitação técnica de restrição de consulta do próprio estado. Necessário conferência manual.

Ao consultar a chave do XML de uma nota fiscal de produto (NF-e) e Nota fiscal de consumidor (NFC-e), para consulta conforme instruções da documentação:

"chave":"00000000000000000000000000000000000000000000"

Irá ser visualizado os principais retornos prévios da consulta:

  • Status: Aprovado, Cancelado, Processamento e Inválido

  • Motivo: Retorno SEFAZ

  • Emitente: CNPJ do emitente

  • UF: Estado

  • Ano: Ano de emissão

  • Mês: Mês de emissão

  • Modelo: Modelo da Nota fiscal consulta (NF-e ou NFC-e)

  • Série: Série da Nota Fiscal

  • NF-e: Número da Nota Fiscal

  • Emissão: Tipo de emissão (Normal e tipos de contigência)

  • Log: Log de retorno do SEFAZ

2) CARACTERÍSTICAS DE CONSULTA POR QR CODE PARA NFC-e [CONSULTA COMPLETA]

Para confirmação da visualização dos produtos da Nota Fiscal de Consumidor (NFC-e), para consulta por QR CODE é necessário a leitura visual para extração e conferência de todas informações fiscais, recomendamos as seguintes tecnologias vinculadas para esta operação:

mceclip0.png

Ao realizar a consulta do QRCODE para consulta conforme instruções da documentação:

"url_qrcode":"http://www.sefaz.to.gov.br/nfce/qrcode?p=00000000000000000000000000000000000000000000"  "estado":"TO"

Irá ser visualizado os principais retornos da consulta completa por QRCODE:

  • Chave: Chave de identificação da Nota Fiscal do SEFAZ

  • Série: Série da NFC-e

  • Número: Número da NFC-e

  • Protocolo: Protocolo de aprovação da Nota Fiscal

  • Data de emissão: Mês de emissão

  • Total: Valor total da nota fiscal

  • Produtos: Informações sobre os produtos da nota fiscal

  • Log: Log de retorno do SEFAZ

3) CARACTERÍSTICAS PARA DOWNLOAD DO XML NO SEFAZ: EMISSÃO POR TERCEIROS

Segue abaixo as principais delimitações técnicas para download do XML por emissão de softwares contábeis terceiros.

  • Download XML de NF-e em softwares terceiros: Somente Nota Fiscal de Produto (NF-e)

  • Download XML de NFC-e em softwares terceiros: Acesso Restrito por limitação do SEFAZ, porém possível validação por consulta de QRCODE.

Maiores informações para download do XML, neste link: https://webmaniabr.com/docs/rest-api-consulta-nota-fiscal/#download-xml-outros

4) CARACTERÍSTICAS PARA DOWNLOAD DO XML NO SEFAZ: EMISSOR WEBMANIA®

Para todos os clientes que emitem NF-e e NFC-e no ecossistema Webmania®, ao realizar a consulta da chave do XML é retornado o XML completo na consulta.

Respondeu à sua pergunta?