> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/produtos/gerenciar-estoque.md).

# 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](/produtos/detalhes-do-produto.md)).

## 📤 Obter o estoque de um produto

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

Resposta:

```json
{
  "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 |

```bash
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:

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

Resposta:

```json
{
  "Disponivel": "222"
}
```

Alterar o estoque da variação:

```bash
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**.

{% hint style="info" %}
Referência completa destes endpoints:

{% embed url="<https://api.toplojas.com.br/doc/#/Produtos>" %}
{% endhint %}