From 9f74826e04da5197180baabec33784804d3d0ea5 Mon Sep 17 00:00:00 2001 From: Diego Fincatto Date: Tue, 8 May 2018 08:29:01 -0300 Subject: [PATCH] Ajustando readme para nova versao e iniciando os trabalhos para a 3.0.1 --- README.md | 29 ++++++++--------------------- pom.xml | 5 ++--- 2 files changed, 10 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index f0230acb2..993725922 100755 --- a/README.md +++ b/README.md @@ -3,13 +3,13 @@ Nota Fiscal Eletrônica Comunicador de nota fiscal e nota fiscal do consumidor da [fazenda](http://www.nfe.fazenda.gov.br/portal/principal.aspx).
[![Build Status](https://travis-ci.org/wmixvideo/nfe.svg?branch=master)](http://travis-ci.org/#!/wmixvideo/nfe) [![Coverage Status](https://coveralls.io/repos/wmixvideo/nfe/badge.svg?branch=master&service=github)](https://coveralls.io/github/wmixvideo/nfe?branch=master) -[![Maven Central](https://img.shields.io/badge/maven%20central-2.0.4-blue.svg)](http://search.maven.org/#artifactdetails|com.github.wmixvideo|nfe|2.0.4|) +[![Maven Central](https://img.shields.io/badge/maven%20central-3.0.0-blue.svg)](http://search.maven.org/#artifactdetails|com.github.wmixvideo|nfe|3.0.0|) [![Apache 2.0 License](https://img.shields.io/badge/license-apache%202.0-green.svg) ](https://github.com/wmixvideo/nfe/blob/master/LICENSE) ## Atenção Este é um projeto colaborativo, sinta-se à vontade em usar e colaborar com o mesmo.
-Antes de submeter um patch, 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 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 @@ -24,10 +24,10 @@ Caso não possua conhecimento técnico para criar notas fiscais, um profissional com.github.wmixvideo nfe - 2.0.4 + 3.0.0 ``` -### Fazendo o clone do projeto(última versão em desenvolvimento) +### Fazendo o clone do projeto (última versão em desenvolvimento) 1. Faça o clone do projeto com o comando: ```console git clone https://github.com/wmixvideo/nfe @@ -46,13 +46,10 @@ Caso não possua conhecimento técnico para criar notas fiscais, um profissional com.github.wmixvideo nfe - 3.0.0-SNAPSHOT + 3.0.1-SNAPSHOT ``` - - Onde ```3.0.0-SNAPSHOT``` - é a versão atual do projeto definido no arquivo [pom.xml](https://github.com/wmixvideo/nfe/blob/master/pom.xml) - - + - Onde ```3.0.1-SNAPSHOT``` é a versão atual do projeto definido no arquivo [pom.xml](https://github.com/wmixvideo/nfe/blob/master/pom.xml) ## Como usar Basicamente você precisará de uma implementação de **NFeConfig** (exemplificado abaixo), com informações de tipo de emissão, certificados @@ -180,7 +177,6 @@ Ou para uma nota já processada: final NFNotaProcessada notaProcessada = new NotaParser().notaProcessadaParaObjeto(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: ```java @@ -227,14 +223,14 @@ String xmlNotaProcessadaPeloSefaz = notaProcessada.toString(); ## Requisitos JDK >= 1.8
-Maven >= 1.x +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 critico já que estes tem validade de apenas um ano (certificado cliente). +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: ```java @@ -248,15 +244,6 @@ public static void main(String args[]){ } ``` -##Sugestão -Para a cadeia de certificados da SEFAZ necessária para o acesso, utilize a cadeia da unidade certificadora que emitiu o seu certificado. Após fazer o download da cadeia de certificado você obterá um arquivo no formato .cer como o exemplo abaixo: -* certificado.cer - -Com este arquivo é possível gerar a sua chave jks através do seguinte comando: - -keytool -import -alias certificado -keystore certificado.jks -file /path_arquivo/certificado.cer - - ## Licença Apache 2.0 diff --git a/pom.xml b/pom.xml index 0ec8d940d..af43e8ee6 100755 --- a/pom.xml +++ b/pom.xml @@ -4,8 +4,7 @@ com.github.wmixvideo nfe jar - - 3.0.0 + 3.0.1-SNAPSHOT nfe Biblioteca de comunicacao de nota fiscal eletronica brasileira https://github.com/wmixvideo/nfe @@ -277,7 +276,7 @@ maven-javadoc-plugin 3.0.0 - -Xdoclint:none + false