{"id":175,"date":"2015-11-27T11:17:09","date_gmt":"2015-11-27T14:17:09","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?p=175"},"modified":"2025-10-14T18:57:50","modified_gmt":"2025-10-14T21:57:50","slug":"gerando-uma-nfc-e-com-a-api-da-sefaz","status":"publish","type":"post","link":"https:\/\/www.l2maker.com.br\/documentacao\/2015\/11\/gerando-uma-nfc-e-com-a-api-da-sefaz\/","title":{"rendered":"Nota Fiscal ao Consumidor Eletr\u00f4nica (NFC-e) com a API da SEFAZ"},"content":{"rendered":"\n<p>Antes de chamar as fun\u00e7\u00f5es do conector defina o modo NFC-e chamando a fun\u00e7\u00e3o <strong>&#8220;SEFAZ &#8211; Definir Tipo de Servi\u00e7o&#8221;<\/strong>, passando como par\u00e2metro:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>O Conector (Variante) &#8211; <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Criado com a fun\u00e7\u00e3o correspondente<\/a>;<\/li>\n\n\n\n<li>A constante (Letras) &#8220;NFCE&#8221;.<\/li>\n<\/ol>\n\n\n\n<p>Al\u00e9m dos passos b\u00e1sicos de gera\u00e7\u00e3o de uma NF-e, ap\u00f3s assinar o XML \u00e9 necess\u00e1rio adicionar as informa\u00e7\u00f5es referentes ao QrCode V3 (atual) ou no padr\u00e3o antigo (&lt;=2025). <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">QRCode padr\u00e3o V3<\/h2>\n\n\n\n<p>Para adicionar o QRCode, execute a fun\u00e7\u00e3o &#8220;<strong>SEFAZ NFC-e &#8211; Adicionar QrCode V3<\/strong>&#8221; passando os seguintes par\u00e2metros:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Conector (Variante): <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Criado com a fun\u00e7\u00e3o correspondente<\/a>;<\/li>\n\n\n\n<li>XML Assinador (Letras): O XML da NFC-e j\u00e1 assinado.<\/li>\n<\/ol>\n\n\n\n<p>O retorno ser\u00e1 o XML completo, j\u00e1 com o QRCOde.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">QRCode padr\u00e3o antigo<\/h2>\n\n\n\n<p>Para adicionar o QRCode, execute a fun\u00e7\u00e3o &#8220;<strong>SEFAZ NFC-e &#8211; Adicionar QrCode<\/strong>&#8221; passando os seguintes par\u00e2metros:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>XML assinado<\/strong>: Caminho completo do arquivo, ou texto do <strong>XML j\u00e1 assinado<\/strong>.<\/li>\n\n\n\n<li><strong>cldToken<\/strong>\u00a0\u00e9 o n\u00famero sequencial de 06 digitos fornecido pela SEFAZ. Este dado \u00e9 p\u00fablico e ser\u00e1 exibido na URL do QRCode;<\/li>\n\n\n\n<li><strong>CSC<\/strong> \u00e9 a chave de seguran\u00e7a de 36 digitos.<\/li>\n<\/ul>\n\n\n\n<p>O retorno da fun\u00e7\u00e3o ser\u00e1 o XML com o QrCode adicionado. Na vers\u00e3o 4.00 ser\u00e1 adicionado tamb\u00e9m a tag &#8220;urlChave&#8221;.<\/p>\n\n\n\n<p>DICA: Para testar utilizem os dados disponibilizados pela SEFAZ do AM, a saber: Usu\u00e1rios do ambiente de desenvolvedores dever\u00e3o utilizar o valor fixo &#8220;<strong>0123456789<\/strong>&#8221; para o CSC e o identificador &#8220;<strong>000001<\/strong>&#8220;.: <a href=\"http:\/\/portalnfce.sefaz.am.gov.br\/desenvolvedor\/ambiente-de-homologacao-para-desenvolvedores\/\" target=\"_blank\" rel=\"noopener\">http:\/\/portalnfce.sefaz.am.gov.br\/desenvolvedor\/ambiente-de-homologacao-para-desenvolvedores\/<\/a><\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Cancelando um cupom fiscal<\/h1>\n\n\n\n<p>O cancelamento \u00e9 feito usando carta de corre\u00e7\u00e3o. <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/01\/nf-e-cancelando-uma-nota-ou-cupom-emitido\/\">Veja mais instru\u00e7\u00f5es no t\u00f3pico espec\u00edfico sobre cancelamento<\/a>.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Emiss\u00e3o OffLine<\/h1>\n\n\n\n<p>Para emiss\u00e3o de NFC-e em modo off-line, <strong>sem comunica\u00e7\u00e3o com a Internet ou SEFAZ<\/strong>, basta alterar\/definir as&nbsp;tags&nbsp;abaixo:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Na fun\u00e7\u00e3o &#8220;<strong>SEFAZ NF-e &#8211; Criar Nota Fiscal<\/strong>&#8221; mude o par\u00e2metro &#8220;<strong>tpEmis<\/strong>&#8221; (sexto) &#8211; Definir o tipo de emiss\u00e3o como 9 &#8211; OffLine;<\/li>\n\n\n\n<li><strong>infNFe\/ide\/dhCont<\/strong> &#8211;\u00a0Informar a data e hora de entrada em conting\u00eancia conting\u00eancia;<\/li>\n\n\n\n<li><strong>infNFe\/ide\/xJust<\/strong> &#8211;\u00a0Informar a Justificativa da entrada, m\u00ednimo de 15 caracteres.<\/li>\n<\/ol>\n\n\n\n<p>Assim que a Internet voltar voc\u00ea deve transmitir os XMLs previamente gerados para a SEFAZ. Observe o prazo m\u00e1ximo (normalmente 24 horas) para transmiss\u00e3o.<\/p>\n\n\n\n<p>Se a UF&nbsp;autorizadora n\u00e3o aceitar esse tipo de conting\u00eancia, ser\u00e1 retornado a rejei\u00e7\u00e3o &#8220;712 &#8211; NFC-e com conting\u00eancia off-line para a UF&#8221;.&nbsp;A Sefaz de S\u00e3o Paulo \u00e9 um exemplo, ela atualmente (2016)&nbsp;n\u00e3o aceita a conting\u00eancia off-line.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mensagem de informa\u00e7\u00e3o sobre emiss\u00e3o off-line<\/h2>\n\n\n\n<p>A emiss\u00e3o Off-Line requer uma mensagem indicativa que pode ser adicionada atrav\u00e9s do par\u00e2metro: <strong>RODAPE_TEXTO<\/strong>, que deve ser informado como um par\u00e2metro extra na impress\u00e3o, o conte\u00fado do texto e o prazo de envio pode variar em cada estado. Para obter o texto correto a ser impresso voc\u00ea deve consultar a SEFAZ do seu estado.<\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Outras mensagens de erro<\/h1>\n\n\n\n<p>Se obtiver um erro &#8220;464&#8221;, com a mensagem &#8220;Rejeicao: Codigo de Hash no QR-Code difere do calculado&#8221;, verifique se o &#8220;<strong>cldToken<\/strong>&#8221; e &#8220;<strong>CSC<\/strong>&#8221; est\u00e3o corretos.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Antes de chamar as fun\u00e7\u00f5es do conector defina o modo NFC-e chamando a fun\u00e7\u00e3o &#8220;SEFAZ &#8211; Definir Tipo de Servi\u00e7o&#8221;, passando como par\u00e2metro: Al\u00e9m dos passos b\u00e1sicos de gera\u00e7\u00e3o de uma NF-e, ap\u00f3s assinar o XML \u00e9 necess\u00e1rio adicionar as informa\u00e7\u00f5es referentes ao QrCode V3 (atual) ou no padr\u00e3o antigo (&lt;=2025). QRCode padr\u00e3o V3 Para [&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-175","post","type-post","status-publish","format-standard","hentry","category-documentacao"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/175","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=175"}],"version-history":[{"count":22,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/175\/revisions"}],"predecessor-version":[{"id":4102,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/posts\/175\/revisions\/4102"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=175"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/categories?post=175"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/tags?post=175"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}