Java-CTe

API Java para consumo do WebService de CTe

Dúvidas, Sugestões ou Consultoria

Gostou do Projeto? Dê sua colaboração pelo Pix: 01713390108

Para Iniciar :

• External Jar: Baixe e adicione às bibliotecas de seu Projeto.

  • https://github.com/Samuel-Oliveira/Java_CTe/releases

• Baixe o Schemas.zip e extraia na sua Máquina.

• Maven :

<dependency>
    <groupId>br.com.swconsultoria</groupId>
    <artifactId>java-cte</artifactId>
    <version>4.00.14</version>
</dependency>

• Gradle :

dependencies {
    implementation "br.com.swconsultoria:java-cte:4.00.14"
}

Veja a Wiki, para ter um Tutorial Completo.

⚠️ Breaking Change — Reorganização dos packages de schemas JAXB

Os packages de schemas gerados via JAXB foram completamente reorganizados. Se você usa esta biblioteca como dependência, é necessário atualizar os imports nos seus projetos.

Packages anteriores (removidos)

br.com.swconsultoria.cte.schema_100.*          (e todos os sub-packages)
br.com.swconsultoria.cte.schema_400.cte.*
br.com.swconsultoria.cte.schema_400.cteOS.*
br.com.swconsultoria.cte.schema_400.evento.*
br.com.swconsultoria.cte.schema_400.retCte.*
br.com.swconsultoria.cte.schema_400.*.<demais sub-packages>

Novos packages (flat, sem sub-pastas)

Package novo	Conteúdo
br.com.swconsultoria.cte.schema_400	Classes do CT-e, CT-eOS e tipos básicos (83 classes)
br.com.swconsultoria.cte.schema_400_eventos	Classes dos eventos de CT-e (59 classes)

Como migrar

Substitua todos os imports antigos pelos novos packages. Exemplos:

// ANTES
import br.com.swconsultoria.cte.schema_400.cte.TCTe;
import br.com.swconsultoria.cte.schema_400.cteOS.TCTeOS;
import br.com.swconsultoria.cte.schema_400.evento.evCancCTe.TEvento;
import br.com.swconsultoria.cte.schema_100.cte.TCTe;

// DEPOIS
import br.com.swconsultoria.cte.schema_400.TCTe;
import br.com.swconsultoria.cte.schema_400.TCTeOS;
import br.com.swconsultoria.cte.schema_400_eventos.TEvento;

Regra geral: qualquer classe relacionada a eventos vai para schema_400_eventos; todo o restante vai para schema_400.

---

Historico de Versões

v4.00.14 - 21/03/2026 - Schemas PL. RTC 2026.001 (02/03/2026)

• Atualização dos schemas XSD para versão 4.00 (novos schemas SEFAZ)
• Suporte à Reforma Tributária — IBS/CBS: novo utilitário IbsCbsUtil para cálculo e preenchimento automático do grupo IBSCBS no CT-e e CT-eOS
• Novos DTOs: CstDTO, ClassificacaoTributariaDTO, DocumentoCteEnum
• Atualizado Cacert e certificados Java

v4.00.13 - 13/09/2025 - Schemas PL. RTC 1.07

• Atualizado Schema Reforma Tributaria
• Remoçao de classes duplicadas
• Reforacao JAXB

v4.00.12 - 06/07/2025

• Atualizado Cacert

v4.00.11 - 22/04/2025

• Atualizado URL QRCode MG
• Atualizado Cacert

v4.00.10 - 11/12/2024

• Atualizado Cacert
• Adicionado CTe Simplificado

v4.00.9 - 08/06/2024

• Atualizado Cacert
• Corrigido erro conversao TRetConsSitCTe

v4.00.8 - 19/04/2024

• Atualizado nova versao Java Certificado

v4.00.7 - 04/04/2024

• Correcao Eventos MS - Uso de prefixo de namespace nao permitido - status 404
• Atualizado nova versao Java Certificado

v4.00.6 - 01/03/2024

• Adicionado Evento Insucesso Entrega
• Adicionado Evento Cancelamento Insucesso Entrega
• Atualizado nova versao Java Certificado

v4.00.5 - 29/01/2024

• Corrigido Conversao TProtCTeOS

v4.00.4 - 27/01/2024

• Corrigido Conversao TRetConsSitCTe

v4.00.3 - 03/01/2024

• Corrigido Criacao de id da CCE
• Atualizado Java Certificado

v4.00.2 - 05/09/2023

• Adicionado todos os Eventos

v4.00.1 - 29/08/2023

• Atualizado Layout para versao 4.00
  • Envio CTe
  • Cancelamento Cte
  • Consulta Cte
  • Distribuicao CTe
  • Status Servico

v3.00.11 - 16/08/2023

• Correcao de Uso de ContingenciaSVC
• Atualizado Cacert (Sefaz Minas)

v3.00.10 - 09/05/2023

• Atualizado Java Certificado (Ver https://github.com/Samuel-Oliveira/Java_Certificado)
• Atualizado Cacert (Sefaz Minas)

v3.00.9 - 21/02/2023

• Atualizado Dependencia Java-Certificado
• Melhorias JAxB
• Adicionado compatibilidade Java 14+
• Modificado Logs

v3.00.8 - 15/01/2022

• Atualizado Dependencia Java-Certificado
• Corrigido erro NS1 para MT
• Corrigido erro NS1 para MS
• Corrigido erro de assinatura para Certificados com Repositorio

v3.00.7 - 01-04-2021

• Removido Cacert do Projeto, agora o projeto Java Certificados irá gerenciar os Cacerts.
• Adicionado Retorno de Cte OS
• Melhoria nos Logs
• Atualizado Dependencia Java-Certificado

v3.00.6 - 27-04-2020

• Refatoração de Classes
• Adicionado QRCode
• Atualizado para versão 3.00a
• Correção de Inutilização
• Corrigido Erros WSDL MS

v3.00.5 - 17-07-2019

• Removido Endereços versão 2.00
• Limpeza de Classes
• Adicionado WSDL CTe-OS
• Corrigido Chamadas para CTe-OS
• Adiciona Url WebServices Cte-OS

v3.00.4 - 22-01-2019

• Adicionado Mais conversões Object->String
• Atualizado Cacert
• Atualizado biblioteca de certificados
• Melhoria no Nome de Classes.
• Corrigido erros Nas COnfigurações Web
• Adicionado Todos os Schemas e WSDL
• Adicionado ao Maven Central

v3.00.3 - 27-08-2018

• Implementado Padrão Web

v3.00.2 - 07-12-2017

• Atualizado Cacert
• Corrigido Erro Namespace PR

v3.00.1 - 07-11-2017

• Atualizado Cacert
• Corrigido conflito com Nfe
• Atualizado para rodar somente com Versão 3.00
• Removido CTe Para Outro Projeto
• Atualizado Layout e Melhorias de velocidade.

v2.00.1 - 25-09-2017

• Adicionado Cacert Atual
• Adicionado Validação Para Modal Rodoviario
• Adicionado DistDfe
• Atualizado Metodo De verificação do Certificado
• Adicionado JavaDocs
• Removido a Parte de Certificado Digitais para outro Projeto.
• Adicionado MDfe ao Projeto
• Alterações:
• 'ConfiguracoesIniciaisCte' para 'ConfiguracoesIniciais'
• 'ConstantesUtil' para 'ConstantesCte'
• 'CteException' para 'EmissorException'
• 'VersaoCte' para 'Versao'
• 'ObjectToXml' para 'ObjectCteToXml'
• Atenção: Alterado o caminho do Objeto Certificado, refaça os Imports.

v2.00.0 - 17-02-2017

• Versão Inicial Do Sistema