Cadastro de Clientes

📄️Lista clientes

Lista os clientes da empresa autenticada, com métricas agregadas: receita total (soma dos valores das contas a receber vinculadas), quantidade total de pedidos do cliente, receita de NFs de serviço emitidas (`ServiceOrder` em status `IDStatusInvoice=3`) e vendedores vinculados (lista de `UserName` via `ConsumerSalesman`). Paginação fixa em **3000 por página** (`Page=N` → offset `N*3000`). Por padrão, o sistema filtra por `StatusConsumer IN (1,2,3)` — clientes Deletados (`StatusConsumer=0`) não aparecem.

📄️Cria um cliente

Cria um cliente (pessoa física, jurídica ou estrangeiro) no cadastro central. Usado pelo modal Novo Cliente, pelo PDV e pela importação em massa via planilha (uma chamada por linha). Quando `ConsumerType=2`, o sistema consulta a base pública de CNPJ e sobrescreve razão social, nome fantasia, e-mail, telefone e data de início de atividade com o que vier de lá, além de cadastrar automaticamente o endereço e a inscrição estadual ativa da UF; se a consulta falhar ou não responder em 5 segundos, o cliente é criado normalmente apenas com os dados enviados. Não é possível ter dois clientes ativos com o mesmo CPF/CNPJ. Quando o usuário autenticado é vendedor (`Salesman=1`), ele já é vinculado ao cliente criado.

🗃Detalhe

8 itens