05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Nota Fiscal Eletrônica

Comunicador de nota fiscal e nota fiscal do consumidor da fazenda.

 
Java CI passing coverage 79%
  maven-central v3.1.01   license apache 2.0

Atenção
Este é um projeto colaborativo, sinta-se à vontade em usar e colaborar com o mesmo.

Antes de submeter um pull request, verifique a estrutura seguida pelo projeto e procure
incluir no mesmo testes unitários que garantam que a funcionalidade funciona como o
esperado.

Antes de usar
Antes de começar a implementar, é altamente recomendável a leitura da documentação
oficial que o governo disponibiliza em http://www.nfe.fazenda.gov.br/portal

Caso não possua conhecimento técnico para criar notas fiscais, um profissional da área
(como um contador) pode lhe auxiliar.

Instalação

Diretamente pelo Maven

<dependency>

<groupId>com.github.wmixvideo</groupId>

<artifactId>nfe</artifactId>

<version>${latest.release}</version>

</dependency>

Para acessar a lista de versões disponíveis, acesse a página de release aqui no github.

Diretamente pelo código fonte (última versão em desenvolvimento)

git clone https://github.com/wmixvideo/nfe

mvn clean install

Como usar

https://github.com/wmixvideo/nfe 1/7
05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Basicamente você precisará de uma implementação de NFeConfig (exemplificado abaixo),

com informações de tipo de emissão, certificados digitais, e uma instância da WsFacade,
essa classe tem a responsabilidade de fazer a ponte entre o seu sistema e a comunicação
com os webservices da Sefaz.

// Exemplo de configuracao para acesso aos serviços da Sefaz.

public class NFeConfigTeste extends NFeConfig {

private KeyStore keyStoreCertificado = null;

private KeyStore keyStoreCadeia = null;

@Override

public NFUnidadeFederativa getCUF() {

return NFUnidadeFederativa.SC;

@Override

public String getCertificadoSenha() {

return "senha_certificado";

@Override

public String getCadeiaCertificadosSenha() {

return "senha_cadeia";

@Override

public KeyStore getCertificadoKeyStore() throws KeyStoreException {

if (this.keyStoreCertificado == null) {

this.keyStoreCertificado = KeyStore.getInstance("PKCS12");

try (InputStream certificadoStream = new FileInputStream("/tmp/certificad

this.keyStoreCertificado.load(certificadoStream, this.getCertificadoS
} catch (CertificateException | NoSuchAlgorithmException | IOException e)
this.keyStoreCadeia = null;

throw new KeyStoreException("Nao foi possibel montar o KeyStore com a

}

return this.keyStoreCertificado;

@Override

public KeyStore getCadeiaCertificadosKeyStore() throws KeyStoreException {

if (this.keyStoreCadeia == null) {
this.keyStoreCadeia = KeyStore.getInstance("JKS");

try (InputStream cadeia = new FileInputStream("/tmp/cadeia.jks")) {

this.keyStoreCadeia.load(cadeia, this.getCadeiaCertificadosSenha().to
} catch (CertificateException | NoSuchAlgorithmException | IOException e)
this.keyStoreCadeia = null;

throw new KeyStoreException("Nao foi possibel montar o KeyStore com o

}

return this.keyStoreCadeia;

https://github.com/wmixvideo/nfe 2/7
05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Configurar pelo repositório de certificados do Windows:

Carregando os alias disponíveis(certificados instalados) no Windows:

KeyStore keyStoreCert = KeyStore.getInstance("Windows-MY", "SunMSCAPI");

keyStoreCert.load(null, null);

Enumeration<String> aliasEnum = keyStoreCert.aliases();

Após isso é necessário algum método para o usuário escolher entre um destes alias, talvez
por meio de um JOptionPane(<java7) ou de um ChoiceDialog(>=Java8), e então fazer o load
com a respectivo alias escolhido e sua senha.

Alguns exemplos
Considere para os exemplos abaixo que config seja uma instância da implementação da
interface NFeConfig.

Status dos webservices

NFStatusServicoConsultaRetorno retorno = new WSFacade(config).consultaStatus(DFUnidad

System.out.println(retorno.getStatus());

System.out.println(retorno.getMotivo());

O Resultado será (caso o webservice responsável por SC esteja OK):

107

Servico em operacao

Envio do lote para o sefaz

Popule os dados do lote a ser enviado para o Sefaz:

NFLoteEnvio lote = new NFLoteEnvio();

// setando os dados do lote

Faça o envio do lote através do facade:

final NFLoteEnvioRetorno retorno = new WSFacade(config).enviaLote(lote);

https://github.com/wmixvideo/nfe 3/7
05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Corrige nota

Faça a correção da nota através do facade:

final NFEnviaEventoRetorno retorno = new WSFacade(config).corrigeNota(chaveDeAcessoDa

Cancela nota

Faça o cancelamento da nota através do facade:

final NFEnviaEventoRetorno retorno = new WSFacade(config).cancelaNota(chaveDeAcessoDa

Consulta nota por chave de acesso ou NSU

Faça a consulta da nota através do facade:

final NFDistribuicaoIntRetorno retorno = new WSFacade(config).consultarDistribuicaoDF

Convertendo objetos Java em XML

Qualquer objeto que seja uma representação XML do documento NFe, pode ser obtido seu
XML de forma fácil bastando chamar o método toString, por exemplo, para conseguir o
XML do lote, invoque o toString

NFLoteEnvio lote = new NFLoteEnvio();

// setando os dados do lote

...

// Obtendo o xml do objeto

String xmlGerado = lote.toString();

Convertendo nota XML em Java

Existe uma classe que pode receber um File/String e converter para um objeto NFNota, faça
da seguinte forma:

final NFNota nota = new DFPersister().read(NFNota.class, xmlNota);

final NFNotaProcessada notaProcessada = new DFPersister().read(NFNotaProcessada.class

https://github.com/wmixvideo/nfe 4/7
05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Ou desabilitando o modo estrito (habilitado por padrão):

final NFNota nota = new DFPersister(false).read(NFNota.class, xmlNota);

Armazenando notas autorizadas

Você precisará armazenar as notas autorizadas por questões legais e também para a
geração do DANFE, uma forma de fazer é armazenar o xml das notas ao enviar o lote:

final List<NFNota> notas = lote.getNotas();

// Armazena os xmls das notas

...

Ao fazer a consulta do lote, crie um objeto do tipo NFNotaProcessada e adicione o

protocolo da nota correspondente, além da nota assinada:

// Carregue o xml da nota do local que foi armazenado

final String xmlNotaRecuperada;

// Assine a nota

final String xmlNotaRecuperadaAssinada = new AssinaturaDigital(config).assinarDocument

// Converta para objeto java

final NFNota notaRecuperadaAssinada = new DFPersister().read(NFNota.class, xmlNotaRec

// Crie o objeto NFNotaProcessada

final NFNotaProcessada notaProcessada = new NFNotaProcessada();

notaProcessada.setVersao(new BigDecimal(NFeConfig.VERSAO_NFE));

notaProcessada.setProtocolo(protocolo);

notaProcessada.setNota(notaRecuperadaAssinada);

// Obtenha o xml da nota com protocolo

String xmlNotaProcessadaPeloSefaz = notaProcessada.toString();

Funcionalidades
Possui validação de campos a nível de código;
Valida o XML de envio de lote através dos xsd's disponibilizados pela Sefaz;
Gera o XML dos objetos de maneira simples, invocando o metodo toString() dá conta
do recado.
Suporta diferentes TimeZones, com a implementacao do devido metodo na classe de
configuração (DFConfig e suas subclasses).

Serviços disponíveis

Serviço Status

https://github.com/wmixvideo/nfe 5/7
05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Serviço Status

Envio lote Estável

Consulta lote Estável

Consulta status Estável

Consulta nota Estável

Download nota Estável

Corrige nota Estável

Cancela nota Estável

Inutiliza nota Estável

Consulta cadastro Estável

Manifestação de destinatário Estável

Requisitos
JDK >= 1.8
Maven >=
3.x

Criação do Java KeyStore (JKS)

Para usar os serviços da nota fiscal são necessários dois certificados:

1. O certificado do cliente que será utilizado para assinar as notas e comunicar com o
fisco (fornecido por uma entidade certificadora);
2. A cadeia de certificados da SEFAZ que queremos acesso;

Os certificados são um ponto crítico já que estes tem validade de apenas um ano
(certificado cliente). Além disso as SEFAZ vem trocando suas cadeias de certificado a cada
atualização. Dessa forma se surgirem erros de SSL vale a pena verificar se existem novas
atualizações de certificados. Para gerar a cadeia de certificados, disponibilizamos um
pequeno helper que baixa os certificados das SEFAZ e gera o arquivo automaticamente:

public static void main(String args[]){

try {

FileUtils.writeByteArrayToFile(new File("/tmp/producao.cacerts"), DFCadeiaCert

FileUtils.writeByteArrayToFile(new File("/tmp/homologacao.cacerts"), DFCadeia
} catch (Exception e) {

e.printStackTrace();

https://github.com/wmixvideo/nfe 6/7
05/02/2022 19:56 GitHub - wmixvideo/nfe: Nota Fiscal Eletrônica em Java.

Releases  46

Release v3.0.36 Latest

on 5 Feb 2021

+ 45 releases

Packages

No packages published

Contributors  64

+ 53 contributors

Languages

Java 100.0%

https://github.com/wmixvideo/nfe 7/7