Documentação da API

Uma chamada HTTP devolve o cadastro completo de um produto pelo código de barras. Se você usa Delphi ou C#, os exemplos abaixo são coláveis.

A primeira chamada

Autenticação é um cabeçalho Authorization: Bearer com o seu token. Não há OAuth, não há renovação de sessão, não há segredo na URL.

copiarcurl -H "Authorization: Bearer sc_SEU_TOKEN_AQUI" \
  https://syscatalogo.wxdev.com.br/v1/produtos/7894900011517

O código pode ir com ou sem o dígito verificador à esquerda: internamente tudo vira GTIN-14, então 7894900011517 e 07894900011517 são o mesmo produto.

Delphi e C#

Os dois trechos são completos — cabeçalho, chamada e leitura do JSON.

uses System.Net.HttpClient, System.Net.URLClient, System.JSON;

function ConsultarProduto(const Gtin: string): TJSONObject;
var
  Http: THTTPClient;
  Resposta: IHTTPResponse;
begin
  Http := THTTPClient.Create;
  try
    Http.CustomHeaders['Authorization'] := 'Bearer sc_SEU_TOKEN_AQUI';
    Resposta := Http.Get('https://syscatalogo.wxdev.com.br/v1/produtos/' + Gtin);

    if Resposta.StatusCode = 200 then
      Result := TJSONObject.ParseJSONValue(Resposta.ContentAsString) as TJSONObject
    else
      Result := nil;   // ver a tabela de erros mais abaixo
  finally
    Http.Free;
  end;
end;

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text.Json;

var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "sc_SEU_TOKEN_AQUI");

var resposta = await http.GetAsync("https://syscatalogo.wxdev.com.br/v1/produtos/7894900011517");

if (resposta.IsSuccessStatusCode)
{
    var json = await resposta.Content.ReadAsStringAsync();
    using var doc = JsonDocument.Parse(json);
    var produto = doc.RootElement.GetProperty("produto");
    Console.WriteLine(produto.GetProperty("descricao").GetString());
}

Os campos da resposta

{
  "gtin": "07894900011517",
  "origem": "cache",
  "encontrado": true,
  "produto": {
    "descricao": "Coca-Cola Original 350ml",
    "marca": "Coca-Cola",
    "categoria": "Bebidas",
    "ncm": "22021000",
    "cest": "0300700",
    "unidade": "UN",
    "peso_liquido": 0.35,
    "fonte": "cadastroproduto",
    "confianca": 90,
    "imagem": {
      "thumb":  "https://.../thumb.webp",
      "media":  "https://.../media.webp",
      "grande": "https://.../grande.webp",
      "licenca": "CC BY-SA 4.0",
      "atribuicao": "Foto: Open Food Facts, sob licença CC BY-SA"
    }
  }
}

Sincronização incremental

É o endpoint que serve melhor a um ERP desktop: o cliente manda a lista de códigos que tem, recebe tudo de uma vez, grava no próprio banco e passa a ler do disco. No dia a dia o caixa bipa e o ERP responde sem tocar a rede — o que também significa que continua funcionando com a internet caída.

POST https://syscatalogo.wxdev.com.br/v1/sincronizar
Authorization: Bearer sc_SEU_TOKEN_AQUI
Content-Type: application/json

{ "gtins": ["7894900011517", "7891000100103"], "desde": "2026-09-01T00:00:00Z" }

Sem desde, vem o catálogo inteiro. Com desde, só o que mudou desde aquela data — guarde o sincronizado_em da resposta e mande de volta na próxima vez. Até 5.000 códigos por chamada.

A resposta separa quatro situações, e a diferença entre elas importa:

Licença da foto

Quando licenca vem nulo, não há exigência de crédito.

Códigos de erro

Como a cota funciona

A conta é de produtos distintos, não de consultas. O caixa bipar o mesmo refrigerante mil vezes por dia não custa nada e nunca é recusado — o que consome a faixa é conhecer um produto novo.

Duas consequências práticas:

• Estourar a faixa não derruba a loja. Tudo que você já cadastrou continua respondendo normalmente; o que para é aprender produto novo.
• Código interno e produto que não temos não consomem nada. Você só paga pelo que a gente de fato entrega.

Toda resposta traz o seu consumo nos cabeçalhos:

X-Produtos-Usados:     1842
X-Produtos-Limite:     2000
X-Produtos-Restantes:   158
X-Quota-Restante:     19873   (requisições restantes hoje)

Estabilidade do contrato

ERP instalado em loja física quase nunca é atualizado. Por isso a v1 é tratada como permanente: campo novo entra sempre opcional, e campo em uso nunca é removido nem renomeado. Você pode integrar hoje e não mexer mais.

Existe também um openapi.json, se a sua ferramenta gerar cliente a partir dele.