API ViaShopModa documentação

automacao/consultar

Acompanhar uma ação assíncrona

Mostra o andamento de uma ação que foi para a fila (upload de imagem, associação de código do ERP).

Ver como Markdown Baixar coleção Postman Atualizado em 18/11/2026

O que faz #

As rotas assíncronas — imagens/upload, pedido/associar_codexterno e cliente/associar_codexterno — respondem com um automacao_id. Esta rota mostra o que aconteceu com ele.

Requisição #

MétodoGET
URLhttps://api.viashopmoda.com.br/via/automacao/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
idautomacao_id devolvido pela rota assíncrona.

Status #

status_envioSignificado
cadastradoEntrou na fila.
pendenteAguardando ou em nova tentativa (veja reprogramado_para).
enviadoExecutado. Confira response_body para o resultado.
erroFalhou. O motivo está em response_body.

Exemplo #

curl "https://api.viashopmoda.com.br/via/automacao/consultar/SEU_TOKEN?id=123456"
{
  "automacao": {
    "evento": "produto.upload_foto",
    "data_criacao": "2026-11-16 10:00:00",
    "data_execucao": "2026-11-16 10:00:05",
    "status_envio": "enviado",
    "request_body": { ... },
    "response_code": 200,
    "response_body": { ... },
    "quantidade_executada": 1,
    "reprogramado_para": null
  }
}

Não encontrada: {"automacao": [], "msg": "automação não encontrada"}. Sem id: 'id' não enviado.

Pode reenviar? #

Sim (somente leitura). Não consulte em ciclo curto: espere alguns segundos entre consultas, ou confira o resultado depois de um tempo.