{"id":7,"date":"2015-10-04T22:23:44","date_gmt":"2015-10-04T22:23:44","guid":{"rendered":"http:\/\/www.l2maker.com.br\/documentacao\/?page_id=7"},"modified":"2025-01-10T11:15:15","modified_gmt":"2025-01-10T14:15:15","slug":"api-sefaz","status":"publish","type":"page","link":"https:\/\/www.l2maker.com.br\/documentacao\/api-sefaz\/","title":{"rendered":"SEFAZ (NF-e \/ NFC-e, CF-e, CC-e, MDF-e e CT-e)"},"content":{"rendered":"<h1>Descri\u00e7\u00e3o do pacote<\/h1>\n<p>Emita documentos fiscais nos padr\u00f5es\u00a0vigentes\u00a0com um conjunto de fun\u00e7\u00f5es simples e intuitiva que ir\u00e3o simplificar o processo de emiss\u00e3o, assinatura e transmiss\u00e3o das NF-e, NFC-e, CF-e, CC-e, MDF-e e CT-e nas suas vers\u00f5es mais recentes. Compat\u00edvel com certificados A1 (arquivo), A3 (cart\u00e3o ou token) e com certificados instalados no Windows (MS CAPI). Al\u00e9m da fun\u00e7\u00e3o exclusiva de gera\u00e7\u00e3o da DANFE em PDF (Retrato e Paisagem). Com um <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/agente-de-comunicacao\/\">agente especial<\/a>\u00a0que permite a execu\u00e7\u00e3o das fun\u00e7\u00f5es na camada cliente, mesmo em navegadores sem suporte a Java (Windows).<\/p>\n<h1>Fun\u00e7\u00f5es que integram o pacote<\/h1>\n<ul>\n<li>Func\u00f5es de conex\u00e3o com A1, A3 e Microsoft CryptoAPI (MS-CAPI);<\/li>\n<li>Fun\u00e7\u00f5es de assinatura de XML;<\/li>\n<li>Fun\u00e7\u00f5es de chamar aos Webservices:\n<ul>\n<li>NF-e: NFeAutorizacao,\u00a0NFeRetAutorizacao,\u00a0NfeConsultaProtocolo,\u00a0NfeStatusServico,\u00a0NfeCancelamento2,\u00a0NfeConsultaCadastro, NfeDistribuicaoDFe,\u00a0NfeDownloadNF,\u00a0NfeConsultaDest,\u00a0NfeInutilizacao;<\/li>\n<li>RecepcaoEvento;<\/li>\n<li>CT-e: CteRecepcao, CteRetRecepcao, CteInutilizacao, CteConsultaProtocolo, CteStatusServico, CteCancelamento, CteRecepcaoEvento;<\/li>\n<li>MDF-e: MDFeRecepcao,\u00a0MDFeRetRecepcao,\u00a0MDFeRecepcaoEvento,\u00a0MDFeConsulta, MDFeStatusServico e MDFeConsNaoEnc.<\/li>\n<\/ul>\n<\/li>\n<li>Fun\u00e7\u00f5es para processar XMLs de retorno;<\/li>\n<li>Fun\u00e7\u00f5es para envio de NF-e, NFC-e, CC-e e CT-e;<\/li>\n<li>Fun\u00e7\u00f5es para gera\u00e7\u00e3o da DANFE (Retrato e Paisagem);<\/li>\n<li><span style=\"line-height: 1.5;\">Fun\u00e7\u00f5es de montagem dos XMLs.<\/span><\/li>\n<\/ul>\n<h3>GNRE<\/h3>\n<p>Fun\u00e7\u00f5es para envio de XML:<\/p>\n<ul>\n<li>SEFAZ &#8211; GNRE &#8211; Enviar Lote;<\/li>\n<li>SEFAZ &#8211; GNRE &#8211; Consultar Resultado do Lote;<\/li>\n<li>SEFAZ &#8211; GNRE &#8211; Configurar UF;<\/li>\n<li>SEFAZ &#8211; GNRE &#8211; Criar Lote.<\/li>\n<\/ul>\n<h3>NFCom<\/h3>\n<p>Fun\u00e7\u00f5es da NFCom:<\/p>\n<ul>\n<li>SEFAZ NFCom &#8211; Consulta;<\/li>\n<li>SEFAZ NFCom &#8211; Recep\u00e7\u00e3o;<\/li>\n<li>SEFAZ NFCom &#8211; Recep\u00e7\u00e3o de Evento;<\/li>\n<li>SEFAZ NFCom &#8211; Status do Servi\u00e7o;<\/li>\n<\/ul>\n<h1>\u00daltimas vers\u00f5es<\/h1>\n<p>As \u00faltimas vers\u00f5es publicadas\u00a0podem ser baixadas nos links abaixo:<\/p>\n<ul class=\"lcp_catlist\" id=\"lcp_instance_0\"><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2026\/04\/api-da-sefaz-cf-e-mdf-e-ct-e-nf-e-cc-e-nfc-e-gnre-versao-3-12-6-publicada-em-14-04-2026\/\">API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) vers\u00e3o 3.12.6 publicada em 14\/04\/2026<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2026\/04\/api-da-sefaz-cf-e-mdf-e-ct-e-nf-e-cc-e-nfc-e-gnre-versao-3-12-5-publicada-em-09-04-2026\/\">API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) vers\u00e3o 3.12.5 publicada em 09\/04\/2026<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2025\/10\/api-da-sefaz-cf-e-mdf-e-ct-e-nf-e-cc-e-nfc-e-gnre-versao-3-12-2-publicada-em-30-10-2025\/\">API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) vers\u00e3o 3.12.2 publicada em 30\/10\/2025<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2025\/10\/api-da-sefaz-cf-e-mdf-e-ct-e-nf-e-cc-e-nfc-e-gnre-versao-3-12-0-publicada-em-15-10-2025\/\">API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) vers\u00e3o 3.12.0 publicada em 15\/10\/2025<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2025\/09\/api-da-sefaz-cf-e-mdf-e-ct-e-nf-e-cc-e-nfc-e-gnre-versao-3-10-1-publicada-em-04-09-2025\/\">API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) vers\u00e3o 3.10.1 publicada em 04\/09\/2025<\/a><\/li><\/ul><ul class='lcp_paginator'><li class='lcp_currentpage'>1<\/li><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=2#lcp_instance_0' title='2'>2<\/a><\/li><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=3#lcp_instance_0' title='3'>3<\/a><\/li><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=4#lcp_instance_0' title='4'>4<\/a><\/li><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=5#lcp_instance_0' title='5'>5<\/a><\/li><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=6#lcp_instance_0' title='6'>6<\/a><\/li><span class='lcp_elipsis'>...<\/span><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=20#lcp_instance_0' title='20'>20<\/a><\/li><li><a href='https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7?lcp_page0=2#lcp_instance_0' title='2' class='lcp_nextlink'>&gt;&gt;<\/a><\/li><\/ul>\n<h1>Como instalar ou Atualizar<\/h1>\n<p>Para instalar basta baixar a vers\u00e3o mais recente se seguir os passos abaixo descritos, <strong>a atualiza\u00e7\u00e3o segue o mesmo roteiro, substituindo os arquivos e\/ou fun\u00e7\u00f5es existentes com os novos<\/strong>. As impressoras e tem procedimentos espec\u00edficos para usar o recurso de impress\u00e3o direta. Saiba mais no <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/07\/imprimindo-um-documento-fiscal-cf-e-nfc-e\/\">t\u00f3pico sobre impress\u00e3o\u00a0de NFC-e e CF-e<\/a>.<\/p>\n<h2>Maker<\/h2>\n<ol>\n<li>Acesso o sistema onde deseja adicionar as fun\u00e7\u00f5es da SEFAZ;<\/li>\n<li>Feche o editor de fluxos, e o cadastro de fun\u00e7\u00f5es se estiverem abertos;<\/li>\n<li>Importe os arquivos \u2018<strong>l2s-sefaz-<span style=\"color: #ff0000;\">*<\/span>.frz<\/strong>\u2019 (, atualize as fun\u00e7\u00f5es caso j\u00e1 existam);<\/li>\n<li>Abra o edito de fluxos e procure pela nova categoria \u2018L2S \u2013 SEFAZ\u2019;<\/li>\n<li>Pronto! Basta instalar no Webrun e usar a nova fun\u00e7\u00e3o.<\/li>\n<\/ol>\n<h2>Webrun<\/h2>\n<ol>\n<li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/biblioteca-basica-da-l2-l2s-core-jar\/\" target=\"_blank\" rel=\"noopener noreferrer\">Instale a biblioteca b\u00e1sica em sua vers\u00e3o mais recente<\/a>;<\/li>\n<li>Copie o conte\u00fado da pasta Maker.Commons para a pasta<br \/>\n[<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/?p=1\">WEBRUN<\/a>]\\systems\\<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/?p=1\">Maker.Commons<\/a> (crie-a se n\u00e3o existir);<\/li>\n<li>Reinicie o Tomcat do Webrun;<\/li>\n<li>Acesse o sistema (1a vez);<\/li>\n<li>Reinicie novamente o Tomcat do Webrun (2a vez);<\/li>\n<li>Acesse o sistema novamente;<\/li>\n<li>Pronto! As bibliotecas est\u00e3o instaladas.<\/li>\n<\/ol>\n<ul>\n<li>NOTA 1: Sempre que atualizar ou republicar o Webrun ser\u00e1 necess\u00e1rio acessar, e em seguida reiniciar o Webrun uma vez para que as bibliotecas sejam carregadas.<\/li>\n<li>NOTA 2: Quando publicar seu sistem com JAR certifique-se de levar junto a pasta \u2018Maker.Commons\u2019.<\/li>\n<\/ul>\n<h2>Primeiros passos<\/h2>\n<p>Ap\u00f3s a instala\u00e7\u00e3o da API utilize a tela de exemplos para verificar se voc\u00ea tem o b\u00e1sico para iniciar os testes:\u00a0<a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2023\/05\/testes-basicos-com-a-api-da-sefaz\/\">Testes b\u00e1sicos com a API da SEFAZ<\/a>.<\/p>\n<p>\u00c9 importa entender como criar o conector, sugerimos come\u00e7ar com A1 (arquivo), aqui tem uma descri\u00e7\u00e3o da rotina de cria\u00e7\u00e3o do conector: <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Criando um conector para comunica\u00e7\u00e3o atrav\u00e9s da API da SEFAZ<\/a><\/p>\n<p>Depois siga os passos gerais e adapte as rotinas para seu sistema\/banco de dados seguindo essas instru\u00e7\u00f5es aqui: <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/01\/gerando-um-nf-e-com-a-api-da-sefaz\/\">Gerando uma NF-e\/NFC-e com a API da SEFAZ<\/a>.<\/p>\n<p>Por fim, caso aconte\u00e7a algum erro verifique as dicas deste t\u00f3pico: <a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/08\/dicas-e-solucao-de-problemas\/\">Dicas e Solu\u00e7\u00e3o de problemas<\/a>.<\/p>\n<h2>Dicas e Instru\u00e7\u00f5es de uso<\/h2>\n<ul class=\"lcp_catlist\" id=\"lcp_instance_0\"><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2024\/07\/gerando-uma-mdf-e-sincrono-com-a-api-da-sefaz\/\">Gerando uma MDF-e S\u00edncrono com a API da SEFAZ<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2024\/02\/ct-e-4-00-cancelamento-por-evento\/\">CT-e 4.00 &#8211; Cancelamento por evento<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2023\/05\/testes-basicos-com-a-api-da-sefaz\/\">Testes b\u00e1sicos com a API da SEFAZ<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2021\/02\/gerando-um-certificado-a1-com-a-cadeia-de-certificacao-completa\/\">Gerando um certificado A1 com a cadeia de certifica\u00e7\u00e3o completa<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2019\/03\/adicionando-informacoes-do-responsavel-tecnico-na-nf-e-ou-nfc-e-nota-tecnica-2018-005\/\">Adicionando informa\u00e7\u00f5es do respons\u00e1vel t\u00e9cnico na NF-e ou NFC-e (Nota T\u00e9cnica 2018.005)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2019\/01\/nfe-nfce-trabalhando-com-certificado-a3-camada-cliente\/\">Trabalhando com certificado Token\/Cart\u00e3o\/A3\/Camada cliente<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2018\/11\/emitindo-nf-e-4-00-em-contingencia\/\">Emitindo NF-e 4.00 em conting\u00eancia<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2018\/10\/horario-de-verao-fuso-horario-timezone\/\">Hor\u00e1rio de ver\u00e3o \/ Fuso hor\u00e1rio (Timezone)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2017\/09\/migracao-nfe-4\/\">Migrando para NF-e 4.00<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2017\/05\/sefaz-erros-de-validacoes-dos-xmls\/\">Erros de valida\u00e7\u00f5es dos XMLs<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/11\/criando-um-conector-para-comunicacao-atraves-da-api-da-sefaz\/\">Criando um conector para comunica\u00e7\u00e3o atrav\u00e9s da API da SEFAZ<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/09\/consulta-de-nf-e-destinadas\/\">Consulta de NF-e Destinadas e Distribui\u00e7\u00e3o (Baixar o XML das notas)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/09\/configurando-a-api-da-sefaz\/\">Configurando a API da SEFAZ<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/08\/dicas-e-solucao-de-problemas\/\">Dicas e Solu\u00e7\u00e3o de problemas<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/08\/realizando-a-consulta-de-destinatario\/\">Realizando a consulta de destinat\u00e1rio [DESCONTINUADA PELA SEFAZ]<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/07\/imprimindo-um-documento-fiscal-cf-e-nfc-e\/\">Imprimindo um documento fiscal (CF-e, NFC-e, NF-e)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/07\/cf-e-emitindo-cupom-fiscal-vai-sat\/\">CF-e: Emitindo cupom fiscal via SAT<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/06\/consultando-dados-do-contribuinte\/\">Consultando dados do contribuinte (buscar por CPF ou CNPJ)<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/04\/personalizando-os-relatorios-da-danfe\/\">Personalizando os relat\u00f3rios da DANFE \/ DACTE \/ DAMDFE \/ Cupom<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/03\/baixando-o-xml-da-nf-enfc-e-download\/\">Baixando o XML da NF-e\/NFC-e (Download) [DESCONTINUADA PELA SEFAZ]<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/01\/gerando-um-nf-e-com-a-api-da-sefaz\/\">Gerando uma NF-e\/NFC-e com a API da SEFAZ<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2016\/01\/nf-e-cancelando-uma-nota-ou-cupom-emitido\/\">NF-e &#8211; Cancelando uma nota ou cupom emitido<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2015\/11\/validando-o-arquivo-xml-gerado-pela-api-da-sefaz\/\">Validando o arquivo XML gerado pela API da SEFAZ<\/a><\/li><li><a href=\"https:\/\/www.l2maker.com.br\/documentacao\/2015\/11\/gerando-uma-nfc-e-com-a-api-da-sefaz\/\">Nota Fiscal ao Consumidor Eletr\u00f4nica (NFC-e) com a API da SEFAZ<\/a><\/li><\/ul>\n<h2>VERS\u00c3O DE AVALIA\u00c7\u00c3O<\/h2>\n<ul>\n<li>A vers\u00e3o de avalia\u00e7\u00e3o apresenta uma ou mais das seguintes limita\u00e7\u00f5es:\n<ul>\n<li>S\u00f3 emite documentos no ambiente de homologa\u00e7\u00e3o;<\/li>\n<li>Tarjas e marca\u00e7\u00f5es nos documentos emitidos.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Descri\u00e7\u00e3o do pacote Emita documentos fiscais nos padr\u00f5es\u00a0vigentes\u00a0com um conjunto de fun\u00e7\u00f5es simples e intuitiva que ir\u00e3o simplificar o processo de emiss\u00e3o, assinatura e transmiss\u00e3o das NF-e, NFC-e, CF-e, CC-e, MDF-e e CT-e nas suas vers\u00f5es mais recentes. Compat\u00edvel com certificados A1 (arquivo), A3 (cart\u00e3o ou token) e com certificados instalados no Windows (MS CAPI). [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-7","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/types\/page"}],"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=7"}],"version-history":[{"count":39,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7\/revisions"}],"predecessor-version":[{"id":3792,"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/pages\/7\/revisions\/3792"}],"wp:attachment":[{"href":"https:\/\/www.l2maker.com.br\/documentacao\/wp-json\/wp\/v2\/media?parent=7"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}