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