Referência da API · Clientes · Grupo de Clientes
Vincular cliente a um Grupo
- Método
- PUT
- Rota
-
/customer/:document/priceType/:customerGroupId - URL base
https://ws.autorei.net- Parâmetros de rota
:document:customerGroupId- Token
- Exige token Bearer
Testar no Postman
Abre esta requisição na documentação pública da API, a fonte oficial da referência.
Descrição
Vincula um tipo de preço ao cliente. É o que faz o cliente passar a receber a tabela de preços daquele tipo.
Parâmetros de Rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
document |
string | Sim | CPF ou CNPJ do cliente, sem pontuação. Ver a regra abaixo. |
customerGroupId |
integer | Sim | Id do grupo de clientes ou do tipo de preço, os dois vivem na mesma tabela, e o grupo é um tipo de preço. É o internalId que a consulta de grupos devolve. |
Regras de negócio
O documento vai sem pontuação
Envie só os dígitos: 70041364856, não 700.413.648-56. Um CNPJ pontuado carrega uma barra, que parte o caminho em dois segmentos, a requisição não chega a este endpoint.
Vincular duas vezes não é erro
Se o cliente já estava vinculado àquele tipo de preço, a resposta é 200 com a mensagem de que o vínculo já existe. O estado final é o mesmo.
Resposta · 200
| Campo | Tipo | Descrição |
|---|---|---|
status |
string | OK. |
message |
string | Confirmação do vínculo, ou o aviso de que ele já existia. |
Erros
| Código | Quando |
|---|---|
| 404 | {"status":"NOT_FOUND","message":"Cliente não encontrado!"}, documento sem cadastro na sua loja. |
| 404 | {"status":"NOT_FOUND","message":"PriceType não encontrado!"}, o grupo não existe ou não é da sua loja. Também é a resposta para um id não numérico ou zero. |
| 401 | Token ausente, malformado ou expirado. |
Exemplo de requisição
curl --request PUT 'https://ws.autorei.net/customer/:document/priceType/:customerGroupId' \
--header 'Authorization: Bearer {{access_token}}'Respostas de exemplo
200Sucesso: tipo de preço vinculado
{
"status": "OK",
"message": "PriceType associado"
}Usado em
- Casos de usoIntegração ERP: o caminho típico pela API
- Casos de usoPortal B2B próprio: o caminho típico pela API
- Casos de usoVarejo complexo e B2B2C: o caminho típico pela API
Endpoints relacionados
Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.