# Associar número do pedido no ERP

> Depois de criar o pedido no ERP, informa à loja o número que ele ganhou no ERP. Processamento assíncrono.

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


## O que faz

Liga o pedido da loja ao pedido do ERP. É o passo que fecha a importação de cada pedido. Um pedido aceita uma única associação, e um número do ERP só pode estar em um pedido.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/pedido/associar_codexterno/{TOKEN}` |
| **Corpo** | Objeto JSON `{ ... }`, cabeçalho `Content-Type: application/json` |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |
| **Processamento** | **Assíncrono.** A resposta confirma que a ação entrou na fila (`automacao_id`). Acompanhe com [`automacao/consultar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/automacao/consultar&formato=md). |


## Campos

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `numero_pedido` | texto | **sim** | Número do pedido na loja (6 dígitos). |
| `numero_pedido_externo` | texto | **sim** | Número do pedido no ERP. |

## Exemplo

```json
{ "numero_pedido": "111111", "numero_pedido_externo": "ERP-98765" }
```

Aceito (entrou na fila):

```json
{
  "retorno": true,
  "msg": "A automação 'pedido.cadastrar_codexterno' foi cadastrada e será processada.",
  "automacao_id": "123456",
  "consultar_automacao": "via/automacao/consultar/{TOKEN}?id=123456"
}
```

Recusas (na hora):

| Mensagem | Significado |
|---|---|
| `numero_pedido e numero_pedido_externo são obrigatórios.` | Falta um campo. |
| `associação já realizada.` | Esse par já estava associado. Trate como sucesso. |
| `numero_pedido_externo já associado ao pedido NNNNNN.` | O número do ERP está em **outro** pedido. |
| `pedido não encontrado.` | Número da loja inexistente. |
| `pedido já associado ao numero_pedido_externo:X.` | O pedido já tem outro número do ERP. |

## Pode reenviar?

Sim: o reenvio devolve "associação já realizada".

## Onde entra no processo

Guia [Pedidos](https://api.viashopmoda.com.br/docs-api/?p=guias/pedidos&formato=md#3-o-erp-informa-o-numero-do-pedido-no-erp).
