API
Interface para um sistema conversar com outro. A API do SI5 Global devolve, em JSON, os dados de um produto a partir do código de barras, direto para dentro do seu ERP ou aplicativo.
Terminologia
O que significa SI5
O nome "SI5" carrega o próprio conceito do sistema: inteligência aplicada à conectividade.
SI
Sistema Inteligente, ou Serviço de Internet.
5
Referência aos 5 pilares da conectividade e à quinta geração de tecnologia (5G).
Como ler um código de barras
Um GTIN-13 não é um número aleatório: cada parte tem um significado. Exemplo com o código 7891000325858.
7891000325858
789 · Prefixo GS1Indica a organização que licenciou o código. 789 e 790 são do Brasil.
1000 · EmpresaIdentifica o fabricante ou dono da marca. O tamanho varia conforme a empresa.
32585 · ItemIdentifica o produto específico dentro da empresa.
8 · Dígito verificadorCalculado a partir dos 12 anteriores, detecta erro de digitação.
Ferramentas rápidas
Funcionam direto no seu navegador: nada do que você digita é enviado.
Validador de GTIN
Confira se um código de barras está correto e descubra o tipo e o prefixo.
Digite 8, 12, 13 ou 14 dígitos.
Decifrar NCM e CEST
Digite um NCM (8 dígitos) ou um CEST (7 dígitos) e veja como o código se divide.
Pontos e traços são aceitos.
Glossário
Os termos técnicos que aparecem nas telas do SI5 Global, explicados em poucas linhas.
CEST
Código Especificador da Substituição Tributária. Usado junto com o NCM para identificar mercadorias sujeitas aos regimes de substituição tributária e antecipação do ICMS, conforme o Convênio ICMS 142/2018.
Classificação fiscal
Ato de enquadrar uma mercadoria no código NCM correto. É de responsabilidade de quem emite a nota fiscal, com o apoio de um contador ou profissional fiscal habilitado — um catálogo, como o SI5 Global, é apenas uma referência de apoio.
Confiança da classificação
Índice de 0% a 100% que indica o quanto o modelo de IA está seguro da sugestão de NCM. Confiança alta é cruzada com a tabela oficial e aceita automaticamente; média vai para curadoria; baixa é descartada.
Convênio ICMS 142/2018
Convênio que estabelece normas gerais da substituição tributária e do ICMS antecipado, e relaciona as mercadorias sujeitas a esses regimes com seus respectivos NCM e CEST.
Curadoria
Revisão manual de uma informação por uma pessoa. No SI5 Global, sugestões de NCM com confiança média passam por curadoria antes de serem aplicadas ao produto.
Dígito verificador
Último dígito de um GTIN, calculado a partir dos anteriores. Serve para detectar erros de digitação: se o dígito não bate com o cálculo, o código está errado. Use o validador desta página para conferir.
Enriquecimento
Processo de completar o cadastro de um produto com informações que faltam, como nome, imagem, categoria, marca e dados nutricionais, a partir de outras fontes.
ERP
Sistema de gestão empresarial que concentra cadastro de produtos, estoque, financeiro e fiscal. É onde o cadastro vindo do catálogo costuma ser usado.
Franquia diária
Número de consultas que o seu plano permite por dia (100 no plano Grátis). É compartilhada entre todos os seus tokens e renovada à meia-noite, no horário de Brasília.
GPC
Global Product Classification: classificação global de produtos da GS1, organizada em segmento, família, classe e brick. Descreve o que o produto é, e não deve ser confundida com a classificação fiscal (NCM).
GS1 Brasil
Associação responsável por administrar o padrão global de identificação de produtos (código de barras) no Brasil e por licenciar os prefixos de empresa aos fabricantes.
GTIN / EAN
Numeração global usada no código de barras de um produto. GTIN (Global Trade Item Number) é o nome técnico do padrão internacional; EAN (European Article Number) é o termo mais usado no dia a dia no Brasil para o mesmo número, geralmente com 8, 12, 13 ou 14 dígitos.
GTIN-13 (EAN-13)
Código de 13 dígitos, o mais comum nos produtos vendidos no varejo brasileiro. Os 3 primeiros dígitos indicam o prefixo GS1 (no Brasil, 789 ou 790) e o último é o dígito verificador.
GTIN-14 (DUN-14)
Código de 14 dígitos usado para identificar caixas e embalagens de agrupamento (por exemplo, a caixa com 12 unidades de um produto). O primeiro dígito é o indicador de embalagem; os demais repetem o GTIN do item.
HTTP 429
Código de resposta que significa "muitas requisições": a franquia diária do seu plano acabou. A API volta a responder normalmente na renovação da franquia, à meia-noite.
ICMS
Imposto sobre Circulação de Mercadorias e Serviços, de competência dos estados. A alíquota e o regime de cobrança dependem, entre outros fatores, do NCM da mercadoria.
IPI
Imposto sobre Produtos Industrializados, de competência federal, cobrado de indústrias e importadores. A alíquota de cada produto é definida pelo NCM.
JSON
Formato de texto leve para trocar dados entre sistemas. É o formato de resposta da API do SI5 Global.
Mercosul
Bloco econômico formado por países da América do Sul. A NCM é a nomenclatura comum adotada pelos países do bloco, o que facilita o comércio entre eles.
NCM
Nomenclatura Comum do Mercosul. Código de 8 dígitos que classifica fiscalmente uma mercadoria e define, entre outras coisas, a tributação aplicável a ela em uma nota fiscal.
NF-e
Nota Fiscal Eletrônica: documento fiscal digital que registra a circulação de mercadorias. Cada item da nota traz o seu GTIN, NCM e, quando aplicável, CEST.
PDV
Ponto de venda: o caixa ou sistema de frente de loja onde o código de barras é lido e a venda é registrada.
PIM
Product Information Management: sistema para centralizar, enriquecer e distribuir as informações de produtos de uma empresa para ERP, e-commerce e canais de venda.
Prefixo GS1
Dígitos iniciais do código de barras que indicam a organização GS1 que o emitiu. Os prefixos 789 e 790 pertencem ao Brasil; isso mostra onde o código foi licenciado, não necessariamente onde o produto foi fabricado.
Segmento do CEST
Os 2 primeiros dígitos do CEST, que agrupam as mercadorias por área (por exemplo, 17 corresponde a Produtos alimentícios). Os demais dígitos detalham o item e a especificação.
Sistema Harmonizado (SH)
Nomenclatura internacional de mercadorias de 6 dígitos, adotada por mais de 200 países. A NCM usa os 6 dígitos do SH e acrescenta mais 2, definidos pelo Mercosul.
SKU
Stock Keeping Unit: código interno que o lojista ou fabricante usa para controlar um item no estoque. Diferente do GTIN, que é público e único no mundo, o SKU só faz sentido dentro da empresa que o criou.
Substituição tributária (ST)
Regime em que um contribuinte (em geral o fabricante ou importador) recolhe antecipadamente o ICMS devido pelas etapas seguintes da cadeia, até o consumidor final. Quem vende mercadoria sujeita à ST precisa informar o CEST na nota fiscal.
TIPI
Tabela de Incidência do Imposto sobre Produtos Industrializados. Lista as alíquotas de IPI de cada NCM.
Token de API
Chave pessoal enviada em cada requisição para identificar quem está consultando a API. Cada plano define quantos tokens você pode criar; use um por integração e mantenha-o em segredo.
WEBP
Formato de imagem moderno, mais leve que JPG e PNG. As imagens do catálogo são servidas em WEBP; sistemas que não leem esse formato podem converter para JPG por um serviço de conversão (veja a documentação da API).
Nenhum termo encontrado. Tente outra palavra.
Ficou com alguma dúvida?
Veja como o catálogo é construído e de onde vêm os dados de NCM e CEST, ou consulte direto um produto.
Sobre o SI5 Global Buscar um produto Documentação da API