# Definir limite de cliente consignado

> Torna clientes consignados e define o valor máximo de compra, por e-mail, em lote.

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


## O que faz

Para cada item, marca o cliente (localizado pelo e-mail) como **Consignado** e grava o valor máximo de compra.

## Requisição

| | |
|---|---|
| **Método** | `POST` |
| **URL** | `https://api.viashopmoda.com.br/via/cliente/atualizar_consignado/{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 |
|---|---|---|---|
| `email` | texto | **sim** | E-mail do cliente. |
| `compra_maxima_atacado` | número | **sim** | Valor máximo de compra. `0` não é aceito. Valor negativo é gravado como `-1`. |

Aceita um objeto ou uma lista de até 20.

## Exemplo

```json
[
  { "email": "maria@exemplo.com.br", "compra_maxima_atacado": 5000 },
  { "email": "joana@exemplo.com.br", "compra_maxima_atacado": -1 }
]
```

```json
{
  "atualizacoes": [
    { "retorno": true, "tipo_cliente": "Consignado" },
    { "retorno": false, "msg_erro": "..." }
  ]
}
```

O resultado vem na mesma ordem dos itens enviados.

## Pode reenviar?

Sim.
