# Associar código do cliente no ERP

> Grava no cliente da loja o código que ele tem no ERP. Processamento assíncrono.

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


## O que faz

Liga o cliente da loja (pelo e-mail) ao código do cliente no ERP. Um cliente aceita uma única associação.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/cliente/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 |
|---|---|---|---|
| `email` | texto | **sim** | E-mail do cliente na loja. |
| `cod_externo` | texto | **sim** | Código do cliente no ERP. |

## Exemplo

```json
{ "email": "maria@exemplo.com.br", "cod_externo": "C-1020" }
```

Aceito (entrou na fila):

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

Recusas (na hora):

| Mensagem | Causa |
|---|---|
| `email_cliente e cod_externo são obrigatórios.` | Falta um campo (o campo se chama `email`). |
| `cliente não encontrado` | E-mail inexistente. |
| `cliente apresentando erro de duplicidade.` | Mais de um cliente com o e-mail. |
| `associação já realizada.` | O cliente já tem esse mesmo código. Trate como sucesso. |
| `cliente já associado ao cod_externo:X.` | O cliente já tem **outro** código. |

## Pode reenviar?

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

## Onde entra no processo

Guia [Clientes](https://api.viashopmoda.com.br/docs-api/?p=guias/clientes&formato=md#fluxo-cliente-se-cadastra-na-loja).
