# Consultar estoque

> Saldo e dados das variações — uma, as de um produto, as de um pedido ou todas (100 por página).

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/estoque/consultar · Atualizado em 18/11/2026


## O que faz

Devolve as variações com saldo, código de barras, nomes de grade e estampa e códigos externos.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/estoque/consultar/{TOKEN}` |
| **Corpo** | Nenhum. Filtros vão na query string (`?campo=valor&...`). |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Parâmetros

Todos os parâmetros são opcionais e vão na query string. Use um filtro por vez, salvo quando a descrição disser para combinar.

| Parâmetro | Descrição |
|---|---|
| `cod_barras` | Código de barras de uma variação. Usar sozinho. |
| `cod_produto` | Id do produto: todas as variações. Com cod_grade e cod_estampa: uma variação. |
| `cod_grade` | Id da grade (usar com cod_produto e cod_estampa). |
| `cod_estampa` | Id da estampa (usar com cod_produto e cod_grade). |
| `pedido` | Número do pedido: estoque dos itens desse pedido. |
| `pagina` | Página. Sem filtro, a consulta lista 100 variações por página. |


## Regras

- Sem filtro: lista as variações que têm código de barras, **100 por página** (não 20).
- `preco_*` vazio na variação = usa o preço do produto.
- Para conferir a loja inteira, faça no máximo uma vez por dia e fora do horário de pico.

## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/estoque/consultar/SEU_TOKEN?cod_barras=7890000000101"
```

```json
{
  "estoque": [
    {
      "cod_produto": "325",
      "cod_grade": "14",
      "cod_estampa": "709",
      "quantidade": "4",
      "preco_atacado": "",
      "preco_varejo": "",
      "cod_barras": "7890000000101",
      "nome_grade": "P",
      "cod_grade_externo": null,
      "nome_estampa": "AZUL CLARO",
      "cod_estampa_externo": null
    }
  ]
}
```

## Pode reenviar?

Sim (somente leitura). Cada página conta no limite.
