# Consultar produtos

> Busca produtos por id, referência, código externo, código de barras ou período de atualização, com variações e fotos.

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


## O que faz

Devolve produtos com as variações (`estoque`) e as fotos. Use **um** filtro por vez.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/produto/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 |
|---|---|
| `id` | Id do produto na loja (qualquer status). |
| `cod_ref` | Código de referência (só produtos ativos). |
| `cods_refs` | Várias referências separadas por vírgula (só ativos). |
| `cod_externo` | Código do produto no ERP (só ativos). |
| `cod_barras` | Código de barras de uma variação (qualquer status). |
| `data_inicial` | Início do período de atualização (aaaa-mm-dd). Usar com data_final. |
| `data_final` | Fim do período de atualização (aaaa-mm-dd). |
| `pagina` | Página (20 registros por página). Ex.: pagina=2 |


## Regras

- Ordem de prioridade se vier mais de um filtro: `id`, `cod_ref`, `cod_externo`, `cods_refs`, `cod_barras`, período.
- `cod_ref`, `cods_refs` e `cod_externo` só encontram produtos **ativos**; `id` e `cod_barras` encontram qualquer status.
- Sem filtro: produtos ativos de coleções ativas, 20 por página.
- Preços: `preco_*` é o preço de venda e `preco_*_promo` é o preço "de" (normal), quando há promoção. Veja [Estoque e preço](https://api.viashopmoda.com.br/docs-api/?p=guias/estoque-e-preco&formato=md#promocao-de-por).
- Preço vazio na variação = usa o preço do produto.
- As URLs das fotos têm validade curta (cerca de 10 minutos). Para renovar, use [`imagens/novo_token`](https://api.viashopmoda.com.br/docs-api/?p=recursos/imagens/novo_token&formato=md).

## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/produto/consultar/SEU_TOKEN?cod_ref=VES001"
```

```json
{
  "produto": [
    {
      "id": "325",
      "cod_ref": "VES001",
      "cod_externo": "ERP-VES001",
      "titulo": "VESTIDO XADREZ FLANELA",
      "preco_atacado": "59.90",
      "preco_varejo": "99.90",
      "preco_atacado_promo": "0.00",
      "preco_varejo_promo": "119.90",
      "data_atualizacao": "2026-11-16",
      "colecao": "INVERNO 2026",
      "tipo": "VESTIDO",
      "genero": "FEMININO",
      "fotos": [ { "cod_estampa": "709", "arquivo": "https://imagens.viashopmoda.com.br/api?img=..." } ],
      "estoque": [
        { "cod_produto": "325", "cod_grade": "14", "cod_estampa": "709", "quantidade": "5", "preco_atacado": "", "preco_varejo": "", "cod_barras": "7890000000101", "cod_grade_externo": null, "cod_estampa_externo": null }
      ]
    }
  ]
}
```

## Pode reenviar?

Sim (somente leitura). Cada página conta uma requisição no limite.

## Onde entra no processo

Conferência do catálogo — guia [Catálogo](https://api.viashopmoda.com.br/docs-api/?p=guias/catalogo-carga-inicial&formato=md).
