Pular para o conteúdo
platform
PT EN

Referência da API · Módulo Vendedor

Gerenciar Carteira em Lote

Método
POST
Rota
/sellerModule/manageBulkWallet/:attendantInfo
URL base
https://ws.autorei.net
Parâmetros de rota
:attendantInfo
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

Monta a carteira de um vendedor em lote: vincula, desvincula ou substitui a lista de clientes numa única chamada, em vez de uma requisição por cliente.

Parâmetros de Rota

Parâmetro Tipo Obrigatório Descrição
attendantInfo string Sim Identifica o vendedor por três formas: o UUID do vendedor, o CPF/CNPJ do titular da conta dele, ou o e-mail de acesso. A rota reconhece qual delas você enviou.

Corpo da Requisição (JSON)

Campo Tipo Obrigatório Descrição
action string Sim BIND acrescenta os clientes à carteira, UNBIND os remove, REPLACE troca a carteira inteira pela lista enviada.
users array Sim Clientes da operação. Não pode ser lista vazia.
Identificação do cliente - Sim Não é um campo, é um grupo. Em cada item de users, envie username ou document.
users[].username string Condicional E-mail de acesso do cliente. Obrigatório se document não for enviado.
users[].document string Condicional CPF ou CNPJ do cliente. Obrigatório se username não for enviado.

Não envie attendantId nem storeId: os dois são resolvidos pelo backend, a partir do path e do seu token.

Regras de negócio

O processamento é assíncrono

A resposta 200 confirma que a CWS recebeu a lista, não que os vínculos foram criados. O processamento acontece em segundo plano e não há rota para consultar o resultado, confira a carteira depois com GET /sellerModule/listCustomers/:id.

REPLACE apaga o que não está na lista

Com REPLACE, a carteira passa a ser exatamente a lista enviada: quem estava vinculado e não aparece em users é desvinculado.

Resposta · 200

Campo Tipo Descrição
status string OK.
message string Os dados foram recebidos e o processamento será realizado em segundo plano.

Erros

Código Quando
400 Corpo ausente (Body não informado), action ou users ausentes, inclusive users vazio, (Campos obrigatórios ausentes: action ou users.), action fora da lista (O campo 'action' é inválido. Valores permitidos: BIND, UNBIND, REPLACE), item de users sem username e sem document (Todos os usuários devem conter pelo menos um dos campos: 'username' ou 'document'.), ou vendedor não encontrado pela forma informada no path.
401 Token ausente, malformado ou expirado.

Exemplo de requisição

curl --request POST 'https://ws.autorei.net/sellerModule/manageBulkWallet/:attendantInfo' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "action": "BIND",
  "users": [
    {
      "document": "29.893.264/0001-01"
    },
    {
      "username": "contato@lojaexemplo.com.br"
    }
  ]
}'

Respostas de exemplo

200Sucesso: lote recebido para processamento

{
  "status": "OK",
  "message": "Os dados foram recebidos e o processamento será realizado em segundo plano."
}

Usado em

Endpoints relacionados

← Ver o grupo: Módulo Vendedor

Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.