# Associar nomes de status do ERP

> Grava o nome que o ERP usa para cada status de pedido da loja (de/para).

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


## O que faz

Para cada status da loja, grava os nomes equivalentes no ERP. Depois disso, `pedido/consultar` passa a trazer `status_pedido_externo`.

`pedido/atualizar` continua exigindo o **nome da loja**.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/status_pedido/associar/{TOKEN}` |
| **Corpo** | Lista JSON `[ {...}, {...} ]`, até 20 itens por requisição, cabeçalho `Content-Type: application/json` |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Campos (de cada item)

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `id_status_pedido` | número | **sim** | Id do status da loja ([`status_pedido/consultar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/status_pedido/consultar&formato=md)). |
| `status_envia` | texto | não | Nome do status no ERP, enviado ao ERP pela loja. |
| `status_recebe` | texto | não | Nome do status no ERP, recebido do ERP. |

## Exemplo

```json
[
  { "id_status_pedido": 5, "status_envia": "Despachado", "status_recebe": "Despachado" },
  { "id_status_pedido": 6, "status_envia": "Entregue", "status_recebe": "Entregue" }
]
```

```json
{ "atualizados": "5, 6", "nao_atualizados": [] }
```

Erro: `POST de associação de status deve ser um array. (object)`.

## Pode reenviar?

Sim.
