---
title: "Buscar estoque"
method: GET
path: "/estoque/{produtoId}"
tags: ["Estoque"]
---

# Buscar estoque

`GET /estoque/{produtoId}`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/estoque/{produtoId}`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Retorna o estoque do produto já com o `codigo` (SKU) de cada
combinação, para permitir cruzar o saldo com o catálogo de
combinações do produto sem depender de outro método.

**OBS:**

- Uma combinação cadastrada no produto mas que nunca teve
  movimentação de estoque **não aparece** em `combinacoes` — a
  ausência significa saldo zero.
- `codigo` só é retornado quando a combinação possui um SKU
  cadastrado. Para cadastrar ou alterar o SKU de uma combinação,
  utilize `produtoCombinacoes`.
- Produtos inativos respondem normalmente, da mesma forma que o
  método **PUT** acima.
- A resposta não traz o `id` do item de estoque. Para atualizar o
  estoque, utilize o método **PUT** acima com `combinacaoSKU` (ou
  `combinacaoId` das combinações do produto).

## Response `200`

Estoque do produto.

- EstoqueProduto
  - `controlaEstoque` boolean, required: Indica se o lojista controla o estoque deste produto. Quando `false`, os números retornados (se houver) não representam saldo real e não devem ser tratados como tal.
  - `_produto` integer: Saldo do produto sem variação. Presente apenas quando o produto não possui variações.
  - `combinacoes` EstoqueCombinacaoItem[]: Estoque de cada combinação. Presente apenas quando o produto possui variações.
    - `combinacao` object, required: Mapa de `nome da variação` para `nome do valor`.
    - `quantidade` integer, required
    - `codigo` string: SKU cadastrado para a combinação em `combinacoes` do produto. Ausente quando a combinação não possui SKU cadastrado.

## Other responses

- `400`: Erro na requisição que não foi possível ser completada. O erro é retornado em uma string (não JSON).
- `401`: Credenciais informadas inválidas.
- `404`: Recurso não encontrado. O erro é retornado em uma string (não JSON).

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)