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 completaTrê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"<?php
$ch = curl_init('https://global.si5.com.br/index.php/api/produtos/7891000002186');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer SEU_TOKEN', 'Accept: application/json'],
CURLOPT_TIMEOUT => 15,
]);
$resposta = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status === 200) {
$produto = json_decode($resposta, true);
echo $produto['ncm'].' / '.$produto['cest_codigo'];
}import requests
r = requests.get(
"https://global.si5.com.br/index.php/api/produtos/7891000002186",
headers={"Authorization": "Bearer SEU_TOKEN", "Accept": "application/json"},
timeout=15,
)
if r.status_code == 200:
p = r.json()
print(p["ncm"], p["cest_codigo"], p["ncm_descricao"])const resp = await fetch("https://global.si5.com.br/index.php/api/produtos/7891000002186", {
headers: { Authorization: "Bearer SEU_TOKEN", Accept: "application/json" },
});
if (resp.ok) {
const p = await resp.json();
console.log(p.ncm, p.cest_codigo, p.ncm_descricao);
}using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "SEU_TOKEN");
http.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
var json = await http.GetStringAsync("https://global.si5.com.br/index.php/api/produtos/7891000002186");
using var doc = JsonDocument.Parse(json);
Console.WriteLine(doc.RootElement.GetProperty("ncm").GetString());uses System.Net.HttpClient, System.JSON;
var
Http: THTTPClient;
Resp: IHTTPResponse;
begin
Http := THTTPClient.Create;
try
Http.CustomHeaders['Authorization'] := 'Bearer SEU_TOKEN';
Http.CustomHeaders['Accept'] := 'application/json';
Resp := Http.Get('https://global.si5.com.br/index.php/api/produtos/7891000002186');
if Resp.StatusCode = 200 then
Writeln(TJSONObject.ParseJSONValue(Resp.ContentAsString).GetValue<string>('ncm'));
finally
Http.Free;
end;
end; 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.
{
"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
| Status | O que significa e o que fazer |
|---|---|
| 401 | Token ausente, inválido ou revogado. Confira o cabeçalho Authorization: Bearer …. |
| 404 | O código de barras não existe no catálogo. Trate o caso e, se quiser, deixe o cadastro para preenchimento manual. |
| 429 | A 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.
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 →