# Atualizar cliente

> Altera só os campos enviados de um cliente, localizado por cod_cliente, CPF, CNPJ ou e-mail na URL.

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


## O que faz

Atualiza um cliente existente. Só os campos enviados (e diferentes de `null`) são alterados.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/cliente/atualizar/{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. |


**Qual cliente:** informe **na URL** um destes (nesta prioridade): `?cod_cliente=`, `?cpf=`, `?cnpj=`, `?email=`.

```text
https://api.viashopmoda.com.br/via/cliente/atualizar/{TOKEN}?email=maria@exemplo.com.br
```

## Campos

Os mesmos de [`cliente/cadastrar`](https://api.viashopmoda.com.br/docs-api/?p=recursos/cliente/cadastrar&formato=md), todos opcionais, **exceto** os que não podem ser alterados pela API:

`tipo_pessoa`, `nome_completo`, `nome_empresa`, `responsavel_empresa`, `ie`, `cpf`, `cnpj`, `condicao_diferenciada`, `compra_minima_atacado`, origem/UTM, `moeda`.

Para trocar o vendedor, envie `vendedor_email` com o e-mail de um vendedor existente.

## Exemplo

```json
{
  "telefone_celular": "35999990000",
  "endereco": "Rua Nova",
  "numero": "200",
  "liberado_para_comprar": "S",
  "vendedor_email": "outra.vendedora@loja.com.br"
}
```

Sucesso: `{"retorno": true, "msg": "Cliente alterado com sucesso"}`.

Erros:

| Mensagem | Causa |
|---|---|
| `Cliente não encontrado.` | Nenhum cliente com o filtro da URL. |
| `A busca retornou mais de um cliente. Utilize 'cod_cliente' para atualizar.` | Filtro ambíguo. |
| `Cliente não alterado` | Nada foi gravado. |

## Pode reenviar?

Sim.

## Onde entra no processo

Guia [Clientes](https://api.viashopmoda.com.br/docs-api/?p=guias/clientes&formato=md).
