SI5 Global SI5 Global

API do SI5 Global

NCM e CEST por código de barras, em 1 minuto.

Uma única chamada GET devolve o NCM com descrição oficial, o CEST, a marca, a categoria, a imagem e a tabela nutricional de qualquer produto do catálogo. Em JSON, pronta para ERP, PDV, e-commerce e PIM.

Criar conta e gerar token grátis →Documentação completa
30 consultas por dia grátis Sem cartão, sem senha Resposta em JSON

Três passos

Entre com o Google

Um clique cria sua conta, sem senha. Entrar →

Gere seu token

Na sua conta, dê um nome ao token (por exemplo, "ERP") e copie. Ele aparece uma única vez. Minha conta →

Faça a primeira chamada

Envie o token no cabeçalho Authorization e consulte um GTIN. Exemplos logo abaixo, na sua linguagem.

Sua primeira chamada

Troque SEU_TOKEN pelo token da sua conta. O código de barras do exemplo é um produto real do catálogo.

curl "https://global.si5.com.br/index.php/api/produtos/7891000002186" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json"

Guarde o token no seu servidor. Não o coloque em JavaScript de página nem em aplicativo distribuído: quem o vê consegue gastar sua franquia.

O que você recebe

Esta é a resposta real para o código 7891000002186, a mesma que a API devolve.

GET /api/produtos/7891000002186 — 200 OK
{
    "codbar": "7891000002186",
    "produto": "Corn Flakes Nestlé",
    "referencia": null,
    "marca": "NESTLE",
    "categoria": "MERCEARIA",
    "ncm": "19041000",
    "cest_codigo": "1703000",
    "peso": "240.00",
    "embalagem": "Unidade",
    "quantidade_embalagem": 1,
    "preco_medio": null,
    "imagem_url": "https://cdn3.si5.com.br/img/016108882457433196193500025765/78/91/7891000002186.webp",
    "codigo_barras_url": null,
    "ncm_descricao": "- Produtos à base de cereais, obtidos por expansão ou por torrefação",
    "ncm_descricao_completa": "- Produtos à base de cereais, obtidos por expansão ou por torrefação",
    "cest_segmento": "17. Produtos alimentícios",
    "ingredientes": "Milho integral (48%), farinha de milho enriquecida com ferro e ácido fólico, açúcar, minerais [cálcio (carbonato de cálcio), ferro (ferro reduzido por hidrogênio), sal, xarope de açúcar, extrato de malte, vitaminas [niacina (nicotinamida), ácido pantotênico (pantotenato de cálcio), B6 (cloridrato de piridoxina), B1 (tiamina HCL), B2 (riboflavina) e ácido fólico (ácido N-pteroil-L-glutâmico)], antiumectante fosfato tricálcico, estabilizante fosfato trissódico, antioxidante tocoferol e aromatizante. ALÉRGICOS: CONTÉM DERIVADOS DE CEVADA E DERIVADOS DE SOJA. PODE CONTER AMÊNDOA, LEITE, TRIGO, AVEIA E CENTEIO. CONTÉM GLÚTEN.",
    "alergenos": "gluten, soybeans",
    "pode_conter": "gluten, milk, pt:ALÉRGICOS: CONTÉM DERIVADOS DE CEVADA E DERIVADOS DE SOJA. PODE CONTER AMÊNDOA, pt:AVEIA E CENTEIO. CONTÉM GLÚTEN.",
    "porcao": "30gm",
    "nutrientes": {
        "energia_kcal": 376.67,
        "proteinas_g": 7,
        "carboidratos_g": 83.33,
        "acucares_g": 8.67,
        "gorduras_g": 2.33,
        "fibras_g": 5.67,
        "sodio_mg": 304.8
    },
    "medicamento": null
}

Campos principais

codbar
GTIN/EAN do produto, com zeros à esquerda quando existirem.
produto · marca · categoria
Nome, marca e categoria do catálogo.
ncm · ncm_descricao
NCM de 8 dígitos e a descrição oficial da tabela vigente.
cest_codigo · cest_segmento
CEST de 7 dígitos (quando se aplica) e o segmento oficial.
peso · embalagem · quantidade_embalagem
Dados de embalagem, quando conhecidos.
imagem_url
Foto do produto hospedada pelo SI5 Global (null se ainda não houver).
ingredientes · alergenos · pode_conter · porcao · nutrientes
Informação nutricional, quando disponível.
preco_medio
Preço médio observado em notas fiscais de fornecedores, quando existir.

Campos sem informação vêm como null. A lista completa está na documentação.

Para quem é

ERP e PDV

Preencha NCM, CEST, marca e imagem no cadastro de produtos a partir do código de barras, sem digitar.

E-commerce e marketplace

Enriqueça o catálogo com imagem, categoria e dados nutricionais e confira a classificação fiscal antes de emitir a nota.

Fiscal, contábil e PIM

Valide em lote o NCM e o CEST cadastrados contra a tabela oficial e a base de notas fiscais.

Se algo der errado

StatusO que significa e o que fazer
401Token ausente, inválido ou revogado. Confira o cabeçalho Authorization: Bearer ….
404O código de barras não existe no catálogo. Trate o caso e, se quiser, deixe o cadastro para preenchimento manual.
429A franquia diária do plano acabou (30 por dia no plano grátis). Ela renova à meia-noite, no horário de Brasília. Use cache local ou veja os planos.

Código pronto no GitHub

Exemplos completos em cURL, PHP, Python, Node.js, C# e Delphi, mais um script que preenche NCM e CEST de uma planilha inteira, com cache para não gastar sua franquia diária.

Abrir o repositório no GitHub →

Perguntas frequentes

Como consultar o NCM de um produto pelo código de barras via API?

Faça um GET em /api/produtos/{codigo-de-barras} com o token no cabeçalho Authorization. A resposta traz o NCM de 8 dígitos, a descrição oficial, o CEST e o segmento, além de marca, categoria, imagem e dados nutricionais quando existirem.

A API é gratuita?

Sim, até 30 consultas por dia com 1 token, sem cartão. Para mais volume e mais tokens há planos pagos, na página de preços da API.

Preciso de cadastro para usar?

Precisa de uma conta, que se cria com um clique pelo login do Google (sem senha). Na conta você gera o token e acompanha o uso.

O que acontece se o produto não existir no catálogo?

A API responde 404 para aquele código de barras. Trate esse caso no seu sistema e, se quiser, deixe o cadastro para preenchimento manual.

Posso usar o token direto no navegador, em JavaScript do front-end?

Não. O token é uma credencial: quem o vê consegue gastar sua franquia. Faça a chamada pelo seu servidor (back-end) e entregue ao navegador só o resultado.

O que fazer quando a franquia diária acaba?

A API responde 429 (Too Many Requests) e a franquia renova à meia-noite, no horário de Brasília. Guarde as respostas em cache local, porque o catálogo muda pouco, e considere um plano maior se o volume cresceu.

Comece agora, é grátis.

Crie a conta com o Google, gere o token e faça sua primeira consulta em menos de um minuto.

Criar conta e gerar token grátis →