# Associar código do ERP a produto, tipo, grade ou estampa

> Grava o código que o ERP usa para um produto, tipo, grade ou estampa, para o ERP localizar o registro pelo código dele.

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


## O que faz

Grava `cod_externo` em até 20 registros. Depois disso, as consultas aceitam `?cod_externo=` e as respostas trazem o código.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/cod_externo/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 |
|---|---|---|---|
| `item` | texto | **sim** | `produto`, `tipo`, `grade` ou `estampa`. |
| `id` | texto | **sim** | Id do registro na loja. |
| `cod_externo` | texto | **sim** | Código do ERP. |

## Regras

- Um `cod_externo` não pode se repetir dentro do mesmo tipo de item.
- **Variações e clientes não usam esta rota:** o código externo da variação vai em `estoque[].cod_externo` de [`produto/cadastrar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/produto/cadastrar&formato=md); o do cliente, em [`cliente/associar_codexterno`](https://api.viashopmoda.com.br/docs-api/?p=recursos/cliente/associar_codexterno&formato=md).

## Exemplo

```json
[
  { "item": "produto", "id": "325", "cod_externo": "ERP-VES001" },
  { "item": "grade", "id": "17", "cod_externo": "T-GG" }
]
```

```json
{
  "retorno": true,
  "qtd_atualizar": 2,
  "qtd_atualizados": 2,
  "qtd_nao_atualizados": 0,
  "qtd_erros": 0,
  "atualizados": [ ... ],
  "nao_atualizados": [],
  "erros": []
}
```

Erros: `POST enviado não é um array.`, `Máximo de 20 itens por requisição. Enviados N.`, e por item `Algum dos itens obrigatórios não foi enviado: item, id, cod_externo. index[N]`.

## Pode reenviar?

Sim.
