Gerenciar Estoque

Consulta e altera o estoque disponível de um produto. Estes endpoints são a única forma de alterar quantidades — a edição de produto (PUT /produtos/{Codigo}/) não modifica o estoque.

GET  /produtos/estoque/{CodigoProduto}/
PUT  /produtos/estoque/{CodigoProduto}/

Para produtos com variação, o estoque é controlado por variação, usando as rotas com {CodigoVariacao}:

GET  /produtos/estoque/{CodigoProduto}/{CodigoVariacao}/
PUT  /produtos/estoque/{CodigoProduto}/{CodigoVariacao}/

Onde {CodigoProduto} é o código do produto e {CodigoVariacao} é o código da variação (obtido nos detalhes do produto).

📤 Obter o estoque de um produto

curl -X GET "https://api.toplojas.com.br/produtos/estoque/1287407/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"

Resposta:

{
  "Disponivel": "222"
}

✏️ Alterar o estoque de um produto

Envie a nova quantidade disponível no corpo da requisição:

Campo	Tipo	Obrigatório	Descrição
Disponivel	inteiro	✅ Sim	Nova quantidade em estoque

curl -X PUT "https://api.toplojas.com.br/produtos/estoque/1287407/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]" \
  -H "Content-Type: application/json" \
  -d '{
    "Disponivel": 333
  }'

Em caso de sucesso, a API retorna o HTTP Code 204.

🎨 Estoque de uma variação

Para produtos com variação, informe também o {CodigoVariacao}.

Obter o estoque da variação:

curl -X GET "https://api.toplojas.com.br/produtos/estoque/1287408/6880215/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]"

Resposta:

{
  "Disponivel": "222"
}

Alterar o estoque da variação:

curl -X PUT "https://api.toplojas.com.br/produtos/estoque/1287408/6880215/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]" \
  -H "Content-Type: application/json" \
  -d '{
    "Disponivel": 333
  }'

Em caso de sucesso, a API retorna o HTTP Code 204.

Referência completa destes endpoints:

Swagger UIapi.toplojas.com.br