# 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).

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


## O que faz

As rotas assíncronas — [`imagens/upload`](https://api.viashopmoda.com.br/docs-api/?p=recursos/imagens/upload&formato=md), [`pedido/associar_codexterno`](https://api.viashopmoda.com.br/docs-api/?p=recursos/pedido/associar_codexterno&formato=md) e [`cliente/associar_codexterno`](https://api.viashopmoda.com.br/docs-api/?p=recursos/cliente/associar_codexterno&formato=md) — respondem com um `automacao_id`. Esta rota mostra o que aconteceu com ele.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/automacao/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` | automacao_id devolvido pela rota assíncrona. |


## Status

| `status_envio` | Significado |
|---|---|
| `cadastrado` | Entrou na fila. |
| `pendente` | Aguardando ou em nova tentativa (veja `reprogramado_para`). |
| `enviado` | Executado. Confira `response_body` para o resultado. |
| `erro` | Falhou. O motivo está em `response_body`. |

## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/automacao/consultar/SEU_TOKEN?id=123456"
```

```json
{
  "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.
