Java NFe
Biblioteca Java para consumo do WebService de NFe/NFCe
v4.3.0 Schemas PL 010g v1.03 Java 8+Dúvidas, Sugestões ou Consultoria
Gostou do Projeto? Dê sua colaboração pelo Pix: 01713390108

Para Iniciar
- Baixe o schemas.zip e extraia na sua máquina. O caminho da pasta é informado nas Configurações.
Atenção
Os Schemas mudam a cada Nota Técnica. Sempre que atualizar a versão da biblioteca, baixe o schemas.zip novamente, principalmente se você usa a validação do XML.
External Jar: baixe e adicione às bibliotecas do seu projeto em Releases.
Maven :
<dependency>
<groupId>br.com.swconsultoria</groupId>
<artifactId>java-nfe</artifactId>
<version>4.3.0</version>
</dependency>
- Gradle :
repositories {
mavenCentral()
}
dependencies {
implementation "br.com.swconsultoria:java-nfe:4.3.0"
}
Impressão (DANFE)
As bibliotecas de impressão (JasperReports, Thymeleaf, openhtmltopdf, barbecue e zxing) são provided: não vêm por transitividade. Declare-as no seu projeto somente se for usar a Impressão.
Atualizando de v4.00.x para v4.1.* ou superior?
A partir da v4.1.* os ~48 sub-packages JAXB foram consolidados em apenas 2 (schemas e schemas_eventos) e várias classes de evento foram renomeadas. Imports antigos como schema_4.enviNFe.*, schema.envEventoCancNFe.* ou schema.evento112110.DetEvento não compilam mais.
Veja o guia completo em Migração v4.00 → v4.1.
Novidades recentes
v4.3.0 - Schemas PL 010g
- DANFE v2 da NF-e (modelo 55) no leiaute da NT 2026.010 (Reforma Tributária: IBS/CBS/IS), gerado com Thymeleaf + openhtmltopdf. Veja DANFE v2.
- Schemas atualizados para o PL 010g v1.03:
- NT 2026.006 (Vinculação de Pagamento): grupo
gPgtoVince evento 110300 (DetEvento110300). - NT 2026.008 (Valor Líquido): campos
vUnComLiq,vProdLiq,vProdLiqTote grupoICMSPrevistoPagtoAntecip.
- NT 2026.006 (Vinculação de Pagamento): grupo
- Quebra de compilação:
TTribNFCeperdeugetGIBSCBSMono()/setGIBSCBSMono()(removido pelo PL 010g). - Correção do marshalling de eventos sem
@XmlRootElement(evento genérico).
v4.2.0 - Schemas PL 010f
- Novo modelo de monofásicos (NT 2025.002 v1.50) e melhorias no
IbsCbsUtil.
v4.1.x - Schemas PL 010d/010e
- Consolidação dos packages JAXB (
schemas+schemas_eventos). - Eventos da Reforma Tributária gerados como classes
DetEvento<código>. - BREAKING:
TProtNFe.InfProt.getDhRecbto()passou a retornarString.
O histórico completo está no README do projeto.
Funcionalidades
| Serviço | Página |
|---|---|
| Status do serviço | Status Serviço Sefaz |
| Consulta situação / protocolo | Consulta Situação |
| Envio NF-e / NFC-e (síncrono e assíncrono) | Envio |
| Cancelamento e Cancelamento por Substituição | Cancelamento |
| Carta de Correção | CC-e |
| Inutilização | Inutilização |
| Manifestação do Destinatário | Manifestação |
| Distribuição DF-e | Baixar Documento |
| Consulta Cadastro | Consulta Cadastro |
| EPEC | Envio EPEC |
| Conciliação Financeira (ECONF) | ECONF |
| IBS / CBS (Reforma Tributária) | Reforma Tributária |
| Eventos da Reforma Tributária | Evento Genérico |
| Impressão DANFE / DANFCE / CC-e | Impressão |
