{"id":601,"date":"2016-09-16T13:27:31","date_gmt":"2016-09-16T16:27:31","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=601"},"modified":"2026-03-03T10:14:04","modified_gmt":"2026-03-03T13:14:04","slug":"consulta-de-nf-e-destinadas","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2016\/09\/consulta-de-nf-e-destinadas\/","title":{"rendered":"Consulta de NF-e Destinadas e Distribui\u00e7\u00e3o (Baixar o XML das notas)"},"content":{"rendered":"<h1>Distribui\u00e7\u00e3o de NF-e<\/h1>\n<p>A SEFAZ passou a exigir o uso adequado desse WebService conforme INFORME publicado no site oficial:<\/p>\n<p><strong>04\/03\/2022 &#8211; Atualiza\u00e7\u00e3o das Regras de Uso Indevido do Web Service NFeDistribuicaoDFe &#8211; NT 2014.002<\/strong> ( <a href=\"https:\/\/www.nfe.fazenda.gov.br\/portal\/exibirArquivo.aspx?conteudo=C\/xkRclIh74=\" target=\"_blank\" rel=\"noopener\">https:\/\/www.nfe.fazenda.gov.br\/portal\/exibirArquivo.aspx?conteudo=C\/xkRclIh74=<\/a> ). \u00c9 importante seguir as exig\u00eancias para evitar bloqueios. Entre elas:<\/p>\n<ol>\n<li>N\u00e3o pode ter mais de um software consultando as notas;<\/li>\n<li>Deve ser consultado a partir do \u00faltimo NSU;<\/li>\n<li>Deve ser respeitado o intervalo m\u00ednimo 60 minutos.<\/li>\n<\/ol>\n<p>Ver notas da SEFAZ: <a href=\"https:\/\/www.nfe.fazenda.gov.br\/portal\/informe.aspx?ehCTG=false&amp;Informe=0cu\/yBLKrCs=\" target=\"_blank\" rel=\"noopener\">https:\/\/www.nfe.fazenda.gov.br\/portal\/informe.aspx?ehCTG=false&amp;Informe=0cu\/yBLKrCs=<\/a><\/p>\n<p>A distribui\u00e7\u00e3o seguem as determina\u00e7\u00f5es da SEFAZ conforme <strong>Nota T\u00e9cnica 2014.002 &#8211; v.1.12 &#8211; Publicada em 09\/03\/2022<\/strong> ( <a href=\"https:\/\/www.nfe.fazenda.gov.br\/portal\/exibirArquivo.aspx?conteudo=C\/xkRclIh74=\">https:\/\/www.nfe.fazenda.gov.br\/portal\/exibirArquivo.aspx?conteudo=C\/xkRclIh74=<\/a>\u00a0).<\/p>\n<p>Utilize a\u00a0fun\u00e7\u00e3o: &#8220;<strong>SEFAZ NF-e &#8211; Distribui\u00e7\u00e3o de NF-e<\/strong>&#8220;, para consultar os documentos fiscais de interesse, ela tem comportamentos distintos, de acordo com os par\u00e2metros informados:<\/p>\n<ol>\n<li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Conector (Variante)<\/a>;<\/li>\n<li>Este par\u00e2metro pode ser informado com um dos dois itens abaixo:\n<ul>\n<li>N\u00famero sequencia (\u00faltimo NSU com at\u00e9 15 dig\u00edtos), <strong>caso n\u00e3o saiba informe 0 (zero) para baixar as \u00faltimas notas<\/strong>;<\/li>\n<li>Chave de acesso da NF-e (44 caracteres) para \u00a0obter uma NF-e espec\u00edfica;<\/li>\n<li>XML completo a ser utilizado na consulta.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<p>O retorno dessa fun\u00e7\u00e3o ser\u00e1 uma lista de NF-e emitidas ou uma NF-e espec\u00edfica, de acordo com os dados passados no segundo par\u00e2metro. Ela corresponde ao WebService &#8220;NfeDistribuicaoDFe&#8221;.<\/p>\n<p><strong>IMPORTANTE 1:<\/strong> Atualmente este WebService s\u00f3 est\u00e1 dispon\u00edvel no &#8220;<strong>AN<\/strong>&#8220;. Defina o servidor no conector antes de executar a chamada atrav\u00e9s da fun\u00e7\u00e3o &#8220;<a href=\"\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\"><strong>SEFAZ \u2013 Definir Servidor<\/strong><\/a>&#8220;.<\/p>\n<p><strong>IMPORTANTE 2:<\/strong> Configure o tipo de servi\u00e7o para &#8220;<strong>NFE<\/strong>&#8221; usando a fun\u00e7\u00e3o &#8220;<strong>SEFAZ \u2013 Definir Tipo de Servi\u00e7o<\/strong>&#8220;.<\/p>\n<h2>Obtendo uma lista de documentos<\/h2>\n<p>Utilize a\u00a0fun\u00e7\u00e3o: &#8220;<strong>SEFAZ NF-e &#8211; Distribui\u00e7\u00e3o de DF-e<\/strong>&#8220;, que deve ser utilizada com os seguintes par\u00e2metros:<\/p>\n<ol>\n<li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Conector (Variante)<\/a>;<\/li>\n<li>N\u00famero sequencia (\u00faltimo NSU com at\u00e9 15 dig\u00edtos), <strong>caso n\u00e3o saiba informe 0 (zero) para baixar as \u00faltimas notas<\/strong>.<\/li>\n<\/ol>\n<p>O retorno dessa fun\u00e7\u00e3o ser\u00e1 uma lista de NF-e emitidas contra o CNPJ do certificado. Se for passado a chave de acesso ser\u00e1 o XML da NF-e em quest\u00e3o.<\/p>\n<p><span style=\"color: #ff6600;\"><strong>IMPORTANTE:<\/strong><\/span> O uso da fun\u00e7\u00e3o tem limites de chamadas por hora, especialmente quando passar ZERO. Esse limite \u00e9 por CNPJ\/CPF, ent\u00e3o mesmo que a consulta seja feita por outro sistema a limita\u00e7\u00e3o existir\u00e1.<\/p>\n<h3>Processando a resposta<\/h3>\n<p>Ap\u00f3s obter a lista de documentos emitidos utilize a fun\u00e7\u00e3o de processar XML para transformar o resultado em lista, percorra todas as chaves do mapa retornado (usando as fun\u00e7\u00f5es nativas do Maker);<\/p>\n<p>Obtenha os itens cujo retorno sejam prefixados por:<br \/>\n<span style=\"color: #ff0000;\">nfeDistDFeInteresseResponse\/nfeDistDFeInteresseResult\/retDistDFeInt\/loteDistDFeInt\/docZip[@nsu=&#8221;<\/span><\/p>\n<p>Observe, para cada nota existir\u00e3o 2 entradas, numa delas ter\u00e1 o sufixo &#8220;:ISO-8859-1&#8221;, o que permite a leitura dos XMLs em vers\u00f5es do webrun com charset diferente. Verifique qual das duas vers\u00f5es funciona no seu ambiente e use somente uma delas.<\/p>\n<p>Obtenha o XML da NF-e e processe para obter a chave de acesso de cada documento. Com a chave de acesso \u00e9 poss\u00edvel consultar o XML completo conforme NT2014.002.<\/p>\n<h2>Baixando o XML completo de uma NF-e<\/h2>\n<p>Utilize a mesma fun\u00e7\u00e3o do passo anterior: &#8220;<strong>SEFAZ NF-e &#8211; Distribui\u00e7\u00e3o de DF-e<\/strong>&#8220;, que desta vez ser\u00e1 utilizada com os seguintes par\u00e2metros:<\/p>\n<ol>\n<li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Conector (Variante)<\/a>;<\/li>\n<li>Chave de acesso da NF-e (44 caracteres) para \u00a0obter uma NF-e espec\u00edfica.<\/li>\n<\/ol>\n<p>O retorno dessa fun\u00e7\u00e3o ser\u00e1 o XML da NF-e que pode estar completo ou resumido se n\u00e3o tiver sido manifestado a ci\u00eancia.<\/p>\n<h1>Dando ci\u00eancia a opera\u00e7\u00e3o<\/h1>\n<p>A manifesta\u00e7\u00e3o pode ser feita por evento atrav\u00e9s das fun\u00e7\u00f5es a seguir:<\/p>\n<ol>\n<li>Criar o conector (Variante);<\/li>\n<li>Definir o Ambiente Nacional como destino: <strong>SEFAZ \u2013 Definir Servidor(Conector, &#8220;AN&#8221;)<\/strong>;<\/li>\n<li>Gerar o XML do manifesto j\u00e1 assinado usando a fun\u00e7\u00e3o: &#8220;<strong>SEFAZ &#8211; XML- Manifesta\u00e7\u00e3o do Destinat\u00e1rio &#8211; Evento<\/strong>&#8220;;<\/li>\n<li>Enviar a manifesta\u00e7\u00e3o com a fun\u00e7\u00e3o &#8220;<strong>SEFAZ NF-e &#8211; Enviar evento(conector, XML assinado)<\/strong>&#8220;;<\/li>\n<li>Obter o retorno para confirmar se o evento foi aceito ou rejeitado.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>Distribui\u00e7\u00e3o de NF-e A SEFAZ passou a exigir o uso adequado desse WebService conforme INFORME publicado no site oficial: 04\/03\/2022 &#8211; Atualiza\u00e7\u00e3o das Regras de Uso Indevido do Web Service NFeDistribuicaoDFe &#8211; NT 2014.002 ( https:\/\/www.nfe.fazenda.gov.br\/portal\/exibirArquivo.aspx?conteudo=C\/xkRclIh74= ). \u00c9 importante seguir as exig\u00eancias para evitar bloqueios. Entre elas: N\u00e3o pode ter mais de um software consultando [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[47],"tags":[],"class_list":["post-601","post","type-post","status-publish","format-standard","hentry","category-documentacao"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/601","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/comments?post=601"}],"version-history":[{"count":34,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/601\/revisions"}],"predecessor-version":[{"id":4215,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/601\/revisions\/4215"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=601"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=601"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=601"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}