From 8de4db74066f201cfb04d36499213eab75323d86 Mon Sep 17 00:00:00 2001
From: SamuelOliveira
Date: Tue, 25 Apr 2023 02:20:13 -0300
Subject: [PATCH] - Atualizado Objeto e XSD NT 2023.001 1.20 - Adicionado
Validacao XML Manual
---
CHANGELOG.md | 3 +-
README.md | 10 +-
docs/docs/index.md | 8 +-
schemas.zip | Bin 133380 -> 135189 bytes
schemas/consReciNFe_v4.00.xsd | 4 +-
schemas/consStatServ_v4.00.xsd | 4 +-
schemas/enviNFe_v4.00.xsd | 4 +-
schemas/inutNFe_v4.00.xsd | 4 +-
schemas/leiauteConsultaCadastro_v2.00.xsd | 4 +-
schemas/leiauteNFe_v4.00.xsd | 41 ++-
schemas/nfe_v4.00.xsd | 4 +-
schemas/procInutNFe_v4.00.xsd | 4 +-
schemas/procNFe_v4.00.xsd | 4 +-
schemas/retConsReciNFe_v4.00.xsd | 4 +-
schemas/retConsSitNFe_v4.00.xsd | 4 +-
schemas/retConsStatServ_v4.00.xsd | 4 +-
schemas/retEnviNFe_v4.00.xsd | 4 +-
schemas/retInutNFe_v4.00.xsd | 4 +-
schemas/tiposBasico_v4.00.xsd | 4 +-
.../nfe/dom/ConfiguracoesNfe.java | 2 +-
.../nfe/schema_4/consReciNFe/TNFe.java | 249 ++++++++++++++----
.../nfe/schema_4/enviNFe/TNFe.java | 249 ++++++++++++++----
.../nfe/schema_4/retConsReciNFe/TNFe.java | 249 ++++++++++++++----
.../nfe/schema_4/retEnviNFe/TNFe.java | 249 ++++++++++++++----
24 files changed, 887 insertions(+), 229 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 09472bde..cce46674 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,4 @@
# Notas de versão
-- Correção de Build Maven
+- Atualizado Objeto e XSD NT 2023.001 1.20
+- Adicionado Validacao XML Manual
diff --git a/README.md b/README.md
index 97767bee..f6cde771 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Java-NFe [![Build Status](https://travis-ci.org/Samuel-Oliveira/Java_NFe.svg?branch=master)](https://travis-ci.org/Samuel-Oliveira/Java_NFe) [![MIT License](https://img.shields.io/github/license/Samuel-Oliveira/Java_NFe.svg) ](https://github.com/Samuel-Oliveira/Java_NFe/blob/master/LICENSE) [![Maven Central](https://img.shields.io/maven-central/v/br.com.swconsultoria/java-nfe.svg?label=Maven%20Central)](https://search.maven.org/artifact/br.com.swconsultoria/java-nfe/4.00.22/jar)
+# Java-NFe [![MIT License](https://img.shields.io/github/license/Samuel-Oliveira/Java_NFe.svg) ](https://github.com/Samuel-Oliveira/Java_NFe/blob/master/LICENSE) [![Maven Central](https://img.shields.io/maven-central/v/br.com.swconsultoria/java-nfe.svg?label=Maven%20Central)](https://search.maven.org/artifact/br.com.swconsultoria/java-nfe/4.00.23/jar)
Biblioteca Java para consumo do WebService de NFe/NFCe
## Dúvidas, Sugestões ou Consultoria
@@ -17,7 +17,7 @@ Para Iniciar :
br.com.swconsultoria
java-nfe
- 4.00.22
+ 4.00.23
```
@@ -29,7 +29,7 @@ repositories {
}
}
dependencies {
- implementation "br.com.swconsultoria:java-nfe:4.00.22"
+ implementation "br.com.swconsultoria:java-nfe:4.00.23"
}
```
@@ -39,6 +39,10 @@ ________________________________________________________________________________
# Historico de Versões
+## v4.00.23 - 25/04/2023 - Schemas PL.009k
+- Atualizado Objeto e XSD NT 2023.001 1.20
+- Adicionado Validacao XML Manual
+
## v4.00.22 - 22/03/2023 - Schemas PL.009k
- Correções Build Maven
diff --git a/docs/docs/index.md b/docs/docs/index.md
index 2628879c..757e9db6 100644
--- a/docs/docs/index.md
+++ b/docs/docs/index.md
@@ -1,4 +1,4 @@
-[![Build Status](https://travis-ci.org/Samuel-Oliveira/Java_NFe.svg?branch=master)](https://travis-ci.org/Samuel-Oliveira/Java_NFe) [![MIT License](https://img.shields.io/github/license/Samuel-Oliveira/Java_NFe.svg) ](https://github.com/Samuel-Oliveira/Java_NFe/blob/master/LICENSE) [![Maven Central](https://img.shields.io/maven-central/v/br.com.swconsultoria/java-nfe.svg?label=Maven%20Central)](https://search.maven.org/artifact/br.com.swconsultoria/java-nfe/4.00.22/jar) [![Language grade: Java](https://img.shields.io/lgtm/grade/java/g/Samuel-Oliveira/Java_NFe.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Samuel-Oliveira/Java_NFe/context:java) [![Total alerts](https://img.shields.io/lgtm/alerts/g/Samuel-Oliveira/Java_NFe.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Samuel-Oliveira/Java_NFe/alerts/)
+[![Build Status](https://travis-ci.org/Samuel-Oliveira/Java_NFe.svg?branch=master)](https://travis-ci.org/Samuel-Oliveira/Java_NFe) [![MIT License](https://img.shields.io/github/license/Samuel-Oliveira/Java_NFe.svg) ](https://github.com/Samuel-Oliveira/Java_NFe/blob/master/LICENSE) [![Maven Central](https://img.shields.io/maven-central/v/br.com.swconsultoria/java-nfe.svg?label=Maven%20Central)](https://search.maven.org/artifact/br.com.swconsultoria/java-nfe/4.00.23/jar) [![Language grade: Java](https://img.shields.io/lgtm/grade/java/g/Samuel-Oliveira/Java_NFe.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Samuel-Oliveira/Java_NFe/context:java) [![Total alerts](https://img.shields.io/lgtm/alerts/g/Samuel-Oliveira/Java_NFe.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Samuel-Oliveira/Java_NFe/alerts/)
***Biblioteca Java para consumo do WebService de NFe/NFCe***
@@ -11,7 +11,7 @@
Para Iniciar :
-- Caso use Libs baixe o [java-nfe-4.00.22.jar](https://github.com/Samuel-Oliveira/Java_NFe/raw/master/java-nfe-4.00.22.jar) e o adicione às bibliotecas de Seu Projeto.
+- Caso use Libs baixe o [java-nfe-4.00.23.jar](https://github.com/Samuel-Oliveira/Java_NFe/raw/master/java-nfe-4.00.23.jar) e o adicione às bibliotecas de Seu Projeto.
- Baixe o [Schemas.rar](https://github.com/Samuel-Oliveira/Java_NFe/raw/master/schemas.zip) e extraia na sua Máquina.
@@ -20,7 +20,7 @@ Para Iniciar :
br.com.swconsultoria
java-nfe
- 4.00.22
+ 4.00.23
```
@@ -32,7 +32,7 @@ repositories {
}
}
dependencies {
- implementation "br.com.swconsultoria:java-nfe:4.00.22"
+ implementation "br.com.swconsultoria:java-nfe:4.00.23"
}
```
diff --git a/schemas.zip b/schemas.zip
index ddb6d424bd18d2eb7a5eb18c7c15793a011511fe..deef36b565e23b351d9626be9323539d63efa5a8 100644
GIT binary patch
delta 68424
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 |