Mudanças entre as edições de "Manuais:UniNFe/EnvioCCG"

De unimake
Ir para: navegação, pesquisa
(Adicionado vídeo sobre a consulta GTIN)
(Ajustando documentação do GTIN)
 
Linha 12: Linha 12:
 
''Perdeu? Então clica nesse [https://youtu.be/QX6sPOkojK4 link] e se surpreenda!!''
 
''Perdeu? Então clica nesse [https://youtu.be/QX6sPOkojK4 link] e se surpreenda!!''
  
==<font color=#008000>Construindo o XML</font>==
+
==<font color=#008000>Construindo o XML/TXT</font>==
O XML de consulta é bem simples, terá somente a informação do número do GTIN que será consultado:
+
O arquivo de consulta é bem simples, terá somente a informação do número do GTIN que será consultado:
  
 
* <font color=#008000>'''Observação:'''</font> a versão tem que ser 1.00.
 
* <font color=#008000>'''Observação:'''</font> a versão tem que ser 1.00.
  
 +
<font color=#008000>'''Em XML'''</font>
 
<pre>
 
<pre>
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
Linha 22: Linha 23:
 
<GTIN>7894900019896</GTIN>
 
<GTIN>7894900019896</GTIN>
 
</consGTIN>
 
</consGTIN>
 +
</pre>
 +
 +
<font color=#008000>'''Em TXT'''</font>
 +
<pre>
 +
GTIN|7894900019896
 +
Versao|1.00
 
</pre>
 
</pre>
  
 
==<font color=#008000>Nomenclaturas</font>==
 
==<font color=#008000>Nomenclaturas</font>==
Para enviar o XML de consulta GTIN, basta gerar o arquivo no seguinte formato:
+
Para enviar o '''XML''' de consulta GTIN, basta gerar o arquivo no seguinte formato:
  
 
0000000000-consGTIN.xml
 
0000000000-consGTIN.xml
Linha 45: Linha 52:
  
 
0000000000-ret-consGTIN.err (''se houve algum erro'')
 
0000000000-ret-consGTIN.err (''se houve algum erro'')
 +
 +
----
 +
 +
Para enviar o '''TXT''' de consulta GTIN, basta gerar o arquivo no seguinte formato:
 +
 +
0000000000-consGTIN.txt
 +
 +
{| class="wikitable"
 +
|-
 +
||0000000000
 +
||Conteúdo livre
 +
|-
 +
| style="width: 120px;"|-consGTIN.txt
 +
||Conteúdo fixo. Sempre será "-consGTIN.txt"
 +
|}
 +
 +
O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:
 +
 +
0000000000-ret-consgtin.txt (''se tudo ocorreu bem'')
 +
 +
ou
 +
 +
0000000000-ret-consgtin.err (''se houve algum erro'')
  
 
==<font color=#008000>Pasta utilizada</font>==
 
==<font color=#008000>Pasta utilizada</font>==
Linha 54: Linha 84:
 
O retorno, se positivo, terá a estrutura abaixo:
 
O retorno, se positivo, terá a estrutura abaixo:
  
 +
<font color=#008000>'''Em XML'''</font>
 
<pre>
 
<pre>
 
<retConsGTIN versao="1.00 " xmlns="http://www.portalfiscal.inf.br/nfe">
 
<retConsGTIN versao="1.00 " xmlns="http://www.portalfiscal.inf.br/nfe">
Linha 65: Linha 96:
 
<NCM>22021000</NCM>
 
<NCM>22021000</NCM>
 
</retConsGTIN>
 
</retConsGTIN>
 +
</pre>
 +
 +
<font color=#008000>'''Em TXT'''</font>
 +
<pre>
 +
CStat|9490
 +
XMotivo|Consulta realizada com sucesso
 +
GTIN|7894900019896
 +
tpGTIN|GTIN13
 +
xProd|COCA&#45;COLA ORIGINAL PET FILME SHRINK 06 PACK 500ML LISO
 +
NCM|22021000
 
</pre>
 
</pre>
  
 
Se for enviado um código GTIN errado, terá a estrutura abaixo:
 
Se for enviado um código GTIN errado, terá a estrutura abaixo:
  
 +
<font color=#008000>'''Em XML'''</font>
 
<pre>
 
<pre>
<retConsGTIN versao="1.00 " xmlns="http://www.portalfiscal.inf.br/nfe">
+
<retConsGTIN versao="1.00" xmlns="http://www.portalfiscal.inf.br/nfe">
<verAplic>SVRS20220520163447</verAplic>
+
<verAplic>SVRS20220908180439</verAplic>
<cStat>9402</cStat>
+
<cStat>9491</cStat>
<xMotivo>Rejeição: GTIN com zeros ou dígito de controle inválido</xMotivo>
+
<xMotivo>Rejeicao: GTIN com digito verificador invalido</xMotivo>
<dhResp>2022-07-11T11:08:24-03:00</dhResp>
+
<dhResp>2023-01-04T08:31:55-03:00</dhResp>
<GTIN>78949000</GTIN>
+
<GTIN>7894900000000</GTIN>
 
</retConsGTIN>
 
</retConsGTIN>
 +
</pre>
 +
 +
<font color=#008000>'''Em TXT'''</font>
 +
<pre>
 +
CStat|9491
 +
XMotivo|Rejeicao: GTIN com digito verificador invalido
 +
GTIN|7894900000000
 +
tpGTIN|0
 +
xProd|
 +
NCM|
 
</pre>
 
</pre>
  

Edição atual tal como às 08h37min de 4 de janeiro de 2023

Consulta GTIN

ATENÇÃO: Você pode conferir o vídeo gravado em LIVE no dia 10/08/2022 sobre a consulta GTIN onde o Wandrey Descomplica explica:

  • A nota técnica da consulta GTIN via Web Service;
  • Como consultar o GTIN pelo monitor UniNFe e DLL Unimake.DFe;
  • Quais os impactos da NT no seu negócio, enquanto desenvolvedora de software;
  • Tirando dúvidas ao vivo;
  • E muito mais!!

Perdeu? Então clica nesse link e se surpreenda!!

Construindo o XML/TXT

O arquivo de consulta é bem simples, terá somente a informação do número do GTIN que será consultado:

  • Observação: a versão tem que ser 1.00.

Em XML

<?xml version="1.0" encoding="utf-8"?>
<consGTIN versao="1.00" xmlns="http://www.portalfiscal.inf.br/nfe">
	<GTIN>7894900019896</GTIN>
</consGTIN>

Em TXT

GTIN|7894900019896
Versao|1.00

Nomenclaturas

Para enviar o XML de consulta GTIN, basta gerar o arquivo no seguinte formato:

0000000000-consGTIN.xml

0000000000 Conteúdo livre
-consGTIN.xml Conteúdo fixo. Sempre será "-consGTIN.xml"

O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:

0000000000-ret-consGTIN.xml (se tudo ocorreu bem)

ou

0000000000-ret-consGTIN.err (se houve algum erro)


Para enviar o TXT de consulta GTIN, basta gerar o arquivo no seguinte formato:

0000000000-consGTIN.txt

0000000000 Conteúdo livre
-consGTIN.txt Conteúdo fixo. Sempre será "-consGTIN.txt"

O nome do arquivo de retorno é o mesmo do envio, mudando somente a extensão (final) do mesmo, conforme abaixo:

0000000000-ret-consgtin.txt (se tudo ocorreu bem)

ou

0000000000-ret-consgtin.err (se houve algum erro)

Pasta utilizada

Deverá ser utilizada a pasta "Envio" da empresa desejada. Exemplo:

\UniNFe\06117473000150\Envio

Retorno da consulta

O retorno, se positivo, terá a estrutura abaixo:

Em XML

<retConsGTIN versao="1.00 " xmlns="http://www.portalfiscal.inf.br/nfe">
	<verAplic>SVRS20220520163447</verAplic>
	<cStat>9490</cStat>
	<xMotivo>Consulta realizada com sucesso</xMotivo>
	<dhResp>2022-07-11T11:01:50-03:00</dhResp>
	<GTIN>7894900019896</GTIN>
	<tpGTIN>13</tpGTIN>
	<xProd>COCA&#45;COLA ORIGINAL PET FILME SHRINK 06 PACK 500ML LISO</xProd>
	<NCM>22021000</NCM>
</retConsGTIN>

Em TXT

CStat|9490
XMotivo|Consulta realizada com sucesso
GTIN|7894900019896
tpGTIN|GTIN13
xProd|COCA-COLA ORIGINAL PET FILME SHRINK 06 PACK 500ML LISO
NCM|22021000

Se for enviado um código GTIN errado, terá a estrutura abaixo:

Em XML

<retConsGTIN versao="1.00" xmlns="http://www.portalfiscal.inf.br/nfe">
	<verAplic>SVRS20220908180439</verAplic>
	<cStat>9491</cStat>
	<xMotivo>Rejeicao: GTIN com digito verificador invalido</xMotivo>
	<dhResp>2023-01-04T08:31:55-03:00</dhResp>
	<GTIN>7894900000000</GTIN>
</retConsGTIN>

Em TXT

CStat|9491
XMotivo|Rejeicao: GTIN com digito verificador invalido
GTIN|7894900000000
tpGTIN|0
xProd|
NCM|

Veja também