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_refsecod_externosó encontram produtos ativos;idecod_barrasencontram qualquer status.- Sem filtro: produtos ativos de coleções ativas, 20 por página.
- Preços:
preco_*é o preço de venda epreco_*_promoé o preço "de" (normal), quando há promoção. Veja Estoque e preço. - 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.
Exemplo #
curl "https://api.viashopmoda.com.br/via/produto/consultar/SEU_TOKEN?cod_ref=VES001"{
"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.