Função: Este método deve ser utilizado quando houver necessidade de validar o codigo GTIN do produto utilizado na NF-e ou NFC-e antes do seu envio para SEFAZ.
Release: Disponível a partir do Release 12.1.33
Deck of Cards |
---|
effectDuration | 0.5 |
---|
history | false |
---|
id | samples |
---|
effectType | fade |
---|
|
Card |
---|
default | true |
---|
id | 1 |
---|
label | Parâmetros de Entrada |
---|
| Bloco de código |
---|
language | xml |
---|
firstline | 1 |
---|
title | Exemplo XML de envioConsulta |
---|
linenumbers | true |
---|
| <soapenv:Body>
<nfs:CONSULTAGTIN>
<nfs:USERTOKEN>STRING</nfs:USERTOKEN>
<nfs:ID_ENT>STRING</nfs:ID_ENT>
<nfs:GTIN>INTEGER</nfs:GTIN>
<nfs:VERSAO>STRING</nfs:VERSAO>
</nfs:CONSULTAGTIN>
</soapenv:Body> |
Parâmetro | Tipo | Tam | Pai | Observação | USERTOKEN | Alfanumérico | 006 | - | Token de bilhetagem para execução do serviço. | ID_ENT | Alfanumérico | 006 | - | Código da entidade retornado pelo WS SpedAdm/AdmEmpresas. | GTIN | Numérico | 8,12,13,14 | - | Informar o código GTIN a ser consultado. | VERSAO | Alfanumérico | 2v2 | - | Informar a versão a ser utilizada. Atualmente disponível apenas a versão "1.00" |
|
Card |
---|
default | true |
---|
id | 2 |
---|
label | Parâmetros de Saída |
---|
| Bloco de código |
---|
language | xml |
---|
firstline | 1 |
---|
title | Exemplo XML de envioresultado da consulta |
---|
linenumbers | true |
---|
| <CONSULTAGTINRESPONSE xmlns="http://webservices.totvs.com.br/nfsebra.apw">
<CONSULTAGTINRESULT>
<CSTAT>INTEGER</CSTAT>
<DHRESP>DATE<<DHRESP>STRING</DHRESP>
<VERAPLIC>STRING</VERAPLIC>
<XMOTIVO>STRING</XMOTIVO>
<GTIN>INTEGER</GTIN>
<tpGTIN>INTEGER</tpGTIN>
<xProd>STRING</xProd>
<NCM>INTEGER</NCM>
<CEST>INTEGER</CEST>
</CONSULTAGTINRESULT>
</CONSULTAGTINRESPONSE> |
Parâmetro | Tipo | Tam | Ocorrências | Pai | Observação | CONSULTAGTINRESULT | Estrutura | - | - | CONSULTAGTINRESPONSE | - | CSTAT | Numérico | 4 | 1-1 | CONSULTAGTINRESULT | Código do status de resposta. Se não tiver erro, será retornado: "9490 - Consulta realizada com sucesso" | DHRESP |
Data e Hora | - | CONSULTAGTINRESULT | Data e hora de resposta da requisição | VERAPLIC | Alfanumérico | 1-20 | 1-1 | CONSULTAGTINRESULT | Versão da aplicação que atendeu a requisição | XMOTIVO | Alfanumérico | 1-255 | 1-1 | CONSULTAGTINRESULT | Descrição do status da resposta | GTIN | Numérico | 8-14 | 0-1 | CONSULTAGTINRESULT | Código GTIN consultado. | tpGTIN | Numérico | 1-2 |
CONSULTAGTINRESULT | Número do protocolo da NFe para cancelamento, inutilização e autorização.0-1 | CONSULTAGTINRESULT | Tipos possíveis: 8, 12, 13, 14 | xProd | Alfanumérico | 1-500 | 0-1 | CONSULTAGTINRESULT | Descrição do produto, cadastrado pelo "Dono da Marca" na "GS1", para o GTIN consultado. | NCM | Numérico | 8 | 0-1 | CONSULTAGTINRESULT | Data de processamento. | CEST | Numérico | 7 | 0-3 | CONSULTAGTINRESULT | Código do CEST, cadastrado pelo "Dono da Marca" na "GS1", para o GTIN consultado. |
|
Card |
---|
default | true |
---|
id | 3 |
---|
label | Soap Fault |
---|
| Fault | Descrição | Invalid Token | O parâmetro USERTOKEN foi passado incorretamente. | 001 | Código da entidade inválida. | 002 | Código da entidade em branco. | 003 | Versão inválida. Versão permitida: 1.00 | 004 | Código GTIN inválido ou em branco |
|
|
Aviso |
---|
|
Método disponível a partir do release 12.1.33 |