InvoiCy GTIN

Olá! Nesse artigo iremos explicar sobre a extensão “InvoiCy GTIN”, que permite ao usuário realizar consultas de GTIN para sanear o cadastro de produtos e evitar possíveis rejeições ao emitir uma NF-e ou NFC-e.

Mas o que é o GTIN?

O GTIN, sigla de “Global Trade Item Number”, é a parte numérica que aparece abaixo do código de barras, sendo criado e administrado pela GS1.Os GTINs, anteriormente chamados de códigos EAN, são atribuídos para qualquer item (produto ou serviço) que pode ser precificado, pedido ou faturado em qualquer ponto da cadeia de suprimentos.

Um Número global de item comercial (GTIN) é um identificador único e reconhecido internacionalmente de um produto. Depois que você especifica um determinado GTIN para um produto, ele jamais poderá ser alterado ou utilizado em outro item.

Ativação da extensão via tela

O acesso para ativar a extensão pode ser realizado por meio dos atalhos disponibilizados na janela Extensões, localizado na parte superior direita da aplicação, como demonstrado no artigo Extensões do InvoiCy.

Na tela de extensões, ao clicar sobre a imagem relacionada ao InvoiCy GTIN, abrirá uma nova tela contendo a aba “Visão geral”, que apresentará uma breve explicação sobre a extensão, com imagens de demonstração das telas.

Já na aba “Ativação”, como demonstra a imagem a seguir, serão apresentadas as empresas que o usuário tem acesso, podendo ativar ou desativar o uso da extensão.

Ao selecionar uma ou mais das empresas listadas, a extensão será ativada automaticamente e a aba “Ativação” passa a se chamar “Configurações”, estando disponível para ativar ou desativar o serviço a outras empresas sempre que necessário.

Ativação da Extensão via Web Service

A ativação da extensão também pode ser realizada no momento do cadastro da empresa, para empresas novas ou através da atualização das informações de uma empresa já cadastrada no InvoiCy.

Em ambos os casos, é preciso adicionar o grupo de informações referente a nova extensão no layout de cadastro de empresas, conforme o exemplo a seguir:

TipoExtensao – Código da extensão que será ativada. Para InvoiCy GTIN informar o valor “14”.
Ativar – Informar ‘S’ para Ativar a extensão e ‘N’ para Desativar.

Para ter acesso a um XML de exemplo para cadastro de empresas, clique aqui.

Consulta GTIN via Web Service

Com a extensão ativada, será possível realizar as consultas de código GTIN utilizando a estrutura abaixo. Vale ressaltar que todos os campos são de preenchimento obrigatório.

Clique aqui para efetuar o download do exemplo de consulta GTIN.

Após a consulta ser efetivada, o serviço irá retornar uma estrutura com os dados do produto em questão, ou então, a invalidez do código.

Consulta GTIN via API Rest

A consulta disponibilizada via API Rest segue as mesmas configurações de envio que a realizada via Web Service.

Clique aqui para visualizar um exemplo no formato JSON.