list_customers
Clientes (cadastro) · domínio Clientes · escopo mcp:customers
O que faz
Lista/pesquisa o cadastro de clientes ativos: nome, fantasia, documento (CGCENT), município, RCA principal, bloqueio. Filtre por cliente, RCA, rede, atividade ou município. Use para 'qual o cadastro do cliente X?'.
Exemplo de pergunta
“qual o cadastro do cliente X?” — o assistente escolhe esta ferramenta sozinho; você não digita o nome dela.
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Significado |
|---|---|---|---|---|
customer_code | integer | não | — | |
rep_code | integer | não | — | |
network_code | integer | não | — | |
municipality_code | integer | não | — | |
limit | integer (1–1000) | não | 100 |
O que você recebe
customer_code— Cliente (cód.)name— Nometrade_name— Nome fantasiatax_id— CNPJ/CPFmunicipality_name— Municípiostate— UFrep_code— Vendedor (RCA)is_blocked— Bloqueado
Cuidados ao ler o resultado
Leia antes de interpretar
- Documento = CGCENT (CNPJ/CPF). Apenas cadastro ativo (DTEXCLUSAO nula).
- rep_code = RCA principal (CODUSUR1); a carteira completa está em get_rep_portfolio.
Por trás da ferramenta
Esta ferramenta consulta o endpoint /v1/customers da API REST — as mesmas permissões e o mesmo recorte da sua credencial valem nos dois caminhos.
Esta página ajudou? Conte para a gente — lemos tudo.