Skip to content

Instantly share code, notes, and snippets.

@Samuel-Oliveira
Last active June 19, 2019 17:00
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save Samuel-Oliveira/c547decad469f21ff99de1c766bdc75d to your computer and use it in GitHub Desktop.
Save Samuel-Oliveira/c547decad469f21ff99de1c766bdc75d to your computer and use it in GitHub Desktop.
Guia de Migração da BIblioteca Java NFe versão 4.00.10

Depois de longos anos da biblioteca chegou a hora de uma longa refatoração. Muito foi apreendido ao longo desse anos e toda minha experiencia na area foi utilizada para melhorar ainda mais essa ferramenta. Para Ajudar a Todos nessa migração segue abaixo um peuqeno guia com todas as modificações e mudanças:

PACKAGES

Para melhor padronização foi adotado uma padronização no raiz dos Packages. Use um Replace All dos dados abaixo.

  • Mudar todos os iniciados em br.com.samuelweb para br.com.swconsultoria
  • Mudar todos os iniciados em br.inf.portalfiscal para br.com.swconsultoria

Configurações Normal e WEB

Foi removido a diferenciação entre projetos Desktop e WEB facilitando a manutenção do código e evitando classes repetidas. Agora toda chamada do sistema deve ser passado o Objeto de configuracao, caso você use projetos desktop salve esse objeto em um constante statica e chame ele toda vez que precisar.

Alterações de nome de Classes

  • XmlUtil mudou para XmlNfeUtil
  • ConfiguracoesIniciaisNfe mudou para ConfiguracoesNfe

    Metodo iniciaConfiguracoes alterado para criarConfiguracoes

  • Estados mudou para EstadosEnum
  • TipoManifestacao mudou para ManifestacaoEnum

Remoção Constantes e parametros String

Todas as constantes dos sistema foram mudados para Enums, assim se evita a passagem de parametros errados para os metodos.

  • ConstantesUtil.NFE use DocumentoEnum
  • ConstantesUtil.AMBIENTE use AmbienteEnum
  • ConstantesUtil.TIPOS use PessoaEnum e ConsultaDFeEnum
  • ConstantesUtil.SERVICOS use ServicosEnum

Chave Nfe

Foi modificado o Metodo de Criação de Chave NFe, facilitando o uso e evitando erros de preenchimento.

Cancelamento, Carta de Correção, Manifestacao, Epec e Inutilização

Para a crição de cada um destes eventos foi criado uma classe Util, onde é passado os parametros e já se recebe o Objeto montado. Evitando assim erros de preenchimento. Então use essas Classes para facilitar o desenvolvimento.

  • CancelamentoUtil
  • CancelamentoSubstituicaoUtil
  • InutilizacaoUtil
  • CartaCorrecaoUtil
  • ManifestacaoUtil
  • EpecUtil

Validações e Retornos

Como alguns usuários tem bastante dificuldade com os retornos de códigos, foi implmentado uma classe Util chamada RetornoUtil onde algumas validações já são preconfiguradas. Veja os exemplos da Wiki.

LOG

Os logs que a Biblioteca printa no console foram melhorados e trazem informações mais precisas para que se possam descobrir falhas. Agora também é possivel desabilita-los usando java.util.logging

Exemplos da WIKI

Foram refeitos todos os Exemplos da Wiki, recomendo fortemente que de uma olhada neles.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment