Estoque do produto

Só o estoque por numeração de um produto. Leve — feito para ser consultado na hora da venda.

GET/v1/produtos/{sku}/estoque

Quando usar

Para confirmar o estoque de um produto antes de fechar uma venda ou de publicar um anúncio.

Não use para varrer o catálogo

Chamar esta rota para cada SKU, em laço, gasta o limite em minutos. Para acompanhar o estoque de tudo, use Listar produtos com atualizadoDesde: toda mudança de estoque atualiza o produto.

Parâmetros

Parâmetro	Tipo	Padrão	Descrição
`sku` obrigatório	texto	—	O SKU do produto, no caminho.

Exemplo

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

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

const resposta = await fetch('https://api.otlshoes.com.br/v1/produtos/320/estoque', {
  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/produtos/320/estoque', {
  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/produtos/320/estoque');
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/produtos/320/estoque');
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/produtos/320/estoque",
    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/produtos/320/estoque",
    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

{
  "sku": "320",
  "ativo": true,
  "numeracoes": [
    {
      "numeracao": "38",
      "skuVariacao": "320U",
      "estoque": 4
    },
    {
      "numeracao": "39",
      "skuVariacao": "320V",
      "estoque": 0
    },
    {
      "numeracao": "40",
      "skuVariacao": "320W",
      "estoque": 7
    }
  ],
  "atualizadoEm": "2026-09-29T10:12:00-03:00"
}

Campo	Tipo	Descrição
`sku`	texto	O SKU consultado.
`ativo`	booleano	`false` = o produto saiu do catálogo; não venda.
`numeracoes[].numeracao`	texto	A numeração.
`numeracoes[].skuVariacao`	texto ou null	SKU da variação, pronto.
`numeracoes[].estoque`	número ou null	Pares disponíveis para pedido. `null` = desconhecido, não zero.
`atualizadoEm`	data	Última alteração do produto.

Regras que não se leem no JSON

O número é o estoque disponível para pedido no momento da resposta. Não há reserva: dois parceiros podem ver o mesmo último par.
Estoque negativo no sistema de origem sai como 0.

Erros possíveis

HTTP	`codigo`	Quando
404	`NAO_ENCONTRADO`	Não existe produto com este SKU
403	`ESCOPO_INSUFICIENTE`	A integração não tem `produtos:ler`
429	`LIMITE_EXCEDIDO`	Passou do limite por minuto