API ViaShopModa documentação

produto/consultar

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.

Ver como Markdown Baixar coleção Postman 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étodoGET
URLhttps://api.viashopmoda.com.br/via/produto/consultar/{TOKEN}
CorpoNenhum. Filtros vão na query string (?campo=valor&...).
TokenSubstitua {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âmetroDescrição
idId do produto na loja (qualquer status).
cod_refCódigo de referência (só produtos ativos).
cods_refsVárias referências separadas por vírgula (só ativos).
cod_externoCódigo do produto no ERP (só ativos).
cod_barrasCódigo de barras de uma variação (qualquer status).
data_inicialInício do período de atualização (aaaa-mm-dd). Usar com data_final.
data_finalFim do período de atualização (aaaa-mm-dd).
paginaPá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.
  • 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.