Descrição do pacote
Emita documentos fiscais nos padrões vigentes com um conjunto de funções simples e intuitiva que irão simplificar o processo de emissão, assinatura e transmissão das NF-e, NFC-e, CF-e, CC-e, MDF-e e CT-e nas suas versões mais recentes. Compatível com certificados A1 (arquivo), A3 (cartão ou token) e com certificados instalados no Windows (MS CAPI). Além da função exclusiva de geração da DANFE em PDF (Retrato e Paisagem). Com um agente especial que permite a execução das funções na camada cliente, mesmo em navegadores sem suporte a Java (Windows).
Funções que integram o pacote
- Funcões de conexão com A1, A3 e Microsoft CryptoAPI (MS-CAPI);
- Funções de assinatura de XML;
- Funções de chamar aos Webservices:
- NF-e: NFeAutorizacao, NFeRetAutorizacao, NfeConsultaProtocolo, NfeStatusServico, NfeCancelamento2, NfeConsultaCadastro, NfeDistribuicaoDFe, NfeDownloadNF, NfeConsultaDest, NfeInutilizacao;
- RecepcaoEvento;
- CT-e: CteRecepcao, CteRetRecepcao, CteInutilizacao, CteConsultaProtocolo, CteStatusServico, CteCancelamento, CteRecepcaoEvento;
- MDF-e: MDFeRecepcao, MDFeRetRecepcao, MDFeRecepcaoEvento, MDFeConsulta, MDFeStatusServico e MDFeConsNaoEnc.
- Funções para processar XMLs de retorno;
- Funções para envio de NF-e, NFC-e, CC-e e CT-e;
- Funções para geração da DANFE (Retrato e Paisagem);
- Funções de montagem dos XMLs.
GNRE
Funções para envio de XML:
- SEFAZ – GNRE – Enviar Lote;
- SEFAZ – GNRE – Consultar Resultado do Lote;
- SEFAZ – GNRE – Configurar UF;
- SEFAZ – GNRE – Criar Lote.
NFCom
Funções da NFCom:
- SEFAZ NFCom – Consulta;
- SEFAZ NFCom – Recepção;
- SEFAZ NFCom – Recepção de Evento;
- SEFAZ NFCom – Status do Serviço;
Últimas versões
As últimas versões publicadas podem ser baixadas nos links abaixo:
- API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) versão 3.7.3 publicada em 10/01/2025
- API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) versão 3.7.1 publicada em 06/01/2025
- API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) versão 3.5.1 publicada em 13/09/2024
- API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) versão 3.5.0 publicada em 08/08/2024
- API da SEFAZ (CF-e, MDF-e, CT-e, NF-e, CC-e, NFC-e, GNRE) versão 3.4.2 publicada em 08/07/2024
Como instalar ou Atualizar
Para instalar basta baixar a versão mais recente se seguir os passos abaixo descritos, a atualização segue o mesmo roteiro, substituindo os arquivos e/ou funções existentes com os novos. As impressoras e tem procedimentos específicos para usar o recurso de impressão direta. Saiba mais no tópico sobre impressão de NFC-e e CF-e.
Maker
- Acesso o sistema onde deseja adicionar as funções da SEFAZ;
- Feche o editor de fluxos, e o cadastro de funções se estiverem abertos;
- Importe os arquivos ‘l2s-sefaz-*.frz’ (, atualize as funções caso já existam);
- Abra o edito de fluxos e procure pela nova categoria ‘L2S – SEFAZ’;
- Pronto! Basta instalar no Webrun e usar a nova função.
Webrun
- Instale a biblioteca básica em sua versão mais recente;
- Copie o conteúdo da pasta Maker.Commons para a pasta
[WEBRUN]\systems\Maker.Commons (crie-a se não existir); - Reinicie o Tomcat do Webrun;
- Acesse o sistema (1a vez);
- Reinicie novamente o Tomcat do Webrun (2a vez);
- Acesse o sistema novamente;
- Pronto! As bibliotecas estão instaladas.
- NOTA 1: Sempre que atualizar ou republicar o Webrun será necessário acessar, e em seguida reiniciar o Webrun uma vez para que as bibliotecas sejam carregadas.
- NOTA 2: Quando publicar seu sistem com JAR certifique-se de levar junto a pasta ‘Maker.Commons’.
Primeiros passos
Após a instalação da API utilize a tela de exemplos para verificar se você tem o básico para iniciar os testes: Testes básicos com a API da SEFAZ.
É importa entender como criar o conector, sugerimos começar com A1 (arquivo), aqui tem uma descrição da rotina de criação do conector: Criando um conector para comunicação através da API da SEFAZ
Depois siga os passos gerais e adapte as rotinas para seu sistema/banco de dados seguindo essas instruções aqui: Gerando uma NF-e/NFC-e com a API da SEFAZ.
Por fim, caso aconteça algum erro verifique as dicas deste tópico: Dicas e Solução de problemas.
Dicas e Instruções de uso
- Gerando uma MDF-e Síncrono com a API da SEFAZ
- CT-e 4.00 – Cancelamento por evento
- Testes básicos com a API da SEFAZ
- Gerando um certificado A1 com a cadeia de certificação completa
- Adicionando informações do responsável técnico na NF-e ou NFC-e (Nota Técnica 2018.005)
- Trabalhando com certificado Token/Cartão/A3/Camada cliente
- Emitindo NF-e 4.00 em contingência
- Horário de verão / Fuso horário (Timezone)
- Migrando para NF-e 4.00
- Erros de validações dos XMLs
- Criando um conector para comunicação através da API da SEFAZ
- Consulta de NF-e Destinadas e Distribuição (Baixar o XML das notas)
- Configurando a API da SEFAZ
- Dicas e Solução de problemas
- Realizando a consulta de destinatário [DESCONTINUADA PELA SEFAZ]
- Imprimindo um documento fiscal (CF-e, NFC-e, NF-e)
- CF-e: Emitindo cupom fiscal via SAT
- Consultando dados do contribuinte (buscar por CPF ou CNPJ)
- Personalizando os relatórios da DANFE / DACTE / DAMDFE / Cupom
- Baixando o XML da NF-e/NFC-e (Download) [DESCONTINUADA PELA SEFAZ]
- Gerando uma NF-e/NFC-e com a API da SEFAZ
- NF-e – Cancelando uma nota ou cupom emitido
- Validando o arquivo XML gerado pela API da SEFAZ
- Nota Fiscal ao Consumidor Eletrônica (NFC-e) com a API da SEFAZ
VERSÃO DE AVALIAÇÃO
- A versão de avaliação apresenta uma ou mais das seguintes limitações:
- Só emite documentos no ambiente de homologação;
- Tarjas e marcações nos documentos emitidos.