Numerações

A tabela que transforma a numeração do calçado no sufixo do SKU de cada variação.

GET/v1/numeracoes

Para que serve

Cada numeração de um produto é uma variação com SKU próprio: o SKU do produto seguido de um sufixo. O produto 320 na numeração 38 é o 320U.

Na maioria dos casos você não precisa desta tabela: o campo skuVariacao já vem pronto emListar produtos e em Estoque do produto. Ela existe para quem precisa montar ou conferir o SKU do próprio lado — por exemplo, ao receber de um marketplace só o SKU da variação.

Requisição

Sem parâmetros.

curl "https://api.otlshoes.com.br/v1/numeracoes" \
  -H "Authorization: Bearer otl_prod_SEU_TOKEN"

curl "https://api-sandbox.otlshoes.com.br/v1/numeracoes" \
  -H "Authorization: Bearer otl_sbx_SEU_TOKEN"

const resposta = await fetch('https://api.otlshoes.com.br/v1/numeracoes', {
  headers: {
    Authorization: 'Bearer otl_prod_SEU_TOKEN',
  },
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

const resposta = await fetch('https://api-sandbox.otlshoes.com.br/v1/numeracoes', {
  headers: {
    Authorization: 'Bearer otl_sbx_SEU_TOKEN',
  },
});

if (!resposta.ok) {
  const { erro } = await resposta.json();
  throw new Error(`${erro.codigo}: ${erro.mensagem} (${erro.requestId})`);
}
const dados = await resposta.json();

<?php
$ch = curl_init('https://api.otlshoes.com.br/v1/numeracoes');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_prod_SEU_TOKEN',
]);

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

<?php
$ch = curl_init('https://api-sandbox.otlshoes.com.br/v1/numeracoes');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer otl_sbx_SEU_TOKEN',
]);

$corpo = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new Exception($corpo['erro']['codigo'] . ': ' . $corpo['erro']['mensagem']);
}

import requests

resposta = requests.get(
    "https://api.otlshoes.com.br/v1/numeracoes",
    headers={
        "Authorization": "Bearer otl_prod_SEU_TOKEN",
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

import requests

resposta = requests.get(
    "https://api-sandbox.otlshoes.com.br/v1/numeracoes",
    headers={
        "Authorization": "Bearer otl_sbx_SEU_TOKEN",
    },
    timeout=30,
)

if not resposta.ok:
    erro = resposta.json()["erro"]
    raise RuntimeError(f'{erro["codigo"]}: {erro["mensagem"]} ({erro["requestId"]})')
dados = resposta.json()

Testar agora no ambiente de testes

A chamada é feita de verdade, do seu navegador para a API de testes (https://api-sandbox.otlshoes.com.br/v1). Use um token otl_sbx_…: ele fica só nesta aba, e some ao fechá-la. Token de produção não é aceito aqui.

Token de testeGET

Resposta

{
  "dados": [
    {
      "numeracao": "17",
      "sufixoSku": "AA"
    },
    {
      "numeracao": "18",
      "sufixoSku": "A"
    },
    {
      "numeracao": "19",
      "sufixoSku": "B"
    }
  ]
}

A lista completa, que raramente muda:

Numeração	Sufixo	Exemplo com o SKU 320
17	`AA`	`320AA`
18	`A`	`320A`
19	`B`	`320B`
20	`C`	`320C`
21	`D`	`320D`
22	`E`	`320E`
23	`F`	`320F`
24	`G`	`320G`
25	`H`	`320H`
26	`I`	`320I`
27	`J`	`320J`
28	`K`	`320K`
29	`L`	`320L`
30	`M`	`320M`
31	`N`	`320N`
32	`O`	`320O`
33	`P`	`320P`
34	`Q`	`320Q`
35	`R`	`320R`
36	`S`	`320S`
37	`T`	`320T`
38	`U`	`320U`
39	`V`	`320V`
40	`W`	`320W`
41	`X`	`320X`
42	`Y`	`320Y`
43	`Z`	`320Z`
44	`AB`	`320AB`
45	`AC`	`320AC`
46	`AD`	`320AD`
47	`AE`	`320AE`
48	`AF`	`320AF`

Regras que não se leem no JSON

Numeração em faixa usa o primeiro número. 27/28 tem o sufixo da 27: J.
Numeração fora desta tabela não tem sufixo: o skuVariacao dela vem null. Não invente um.
O sufixo pode ter uma ou duas letras. Para separar SKU e sufixo, parta do SKU do produto, não do tamanho do texto.