API ViaShopModa documentação

cliente/associar_codexterno

Associar código do cliente no ERP

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

Ver como Markdown Baixar coleção Postman Atualizado em 18/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étodoPOST
URLhttps://api.viashopmoda.com.br/via/cliente/associar_codexterno/{TOKEN}
CorpoObjeto JSON { ... }, cabeçalho Content-Type: application/json
TokenSubstitua {TOKEN} pelo token da loja. Ele vai no caminho da URL, não em cabeçalho.
ProcessamentoAssíncrono. A resposta confirma que a ação entrou na fila (automacao_id). Acompanhe com automacao/consultar.

Campos #

CampoTipoObrigatórioDescrição
emailtextosimE-mail do cliente na loja.
cod_externotextosimCódigo do cliente no ERP.

Exemplo #

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

Aceito (entrou na fila):

{
  "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):

MensagemCausa
email_cliente e cod_externo são obrigatórios.Falta um campo (o campo se chama email).
cliente não encontradoE-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.