Clientes

📄️Lista clientes

Lista os clientes da empresa autenticada, com métricas agregadas de receita (soma de `AccountsPayableReceivable.Value`), quantidade de pedidos (`COUNT(Orders.IDOrder)`), receita de NFs de serviço emitidas (`ServiceOrder` em status `IDStatusInvoice=3`) e vendedores vinculados (`User.UserName` via `ConsumerSalesman`). Paginação fixa em **3000 por página** (`Page=N` → offset `N*3000`). Por padrão, o handler filtra por `StatusConsumer IN (1,2,3)` — clientes Deletados (`StatusConsumer=0`) não aparecem.

📄️Cria um cliente

Cria um cliente (PF ou PJ) no cadastro central. Usado pelo modal **Novo Cliente** e pela importação em massa via planilha (uma chamada por linha).

📄️Detalhe do cliente

Retorna o cadastro completo do cliente (dados básicos + dados fiscais + métricas agregadas). Endpoints separados servem cada bloco do detalhe (`/consumer/{idconsumer}/address`, `/consumer/{idconsumer}/salesman`, `/consumer/{idconsumer}/credit`, `/consumer/{idconsumer}/voucher`).

📄️Atualiza dados do cliente

Atualiza dados básicos do cliente. Os blocos do detalhe (endereços, vendedores, créditos) têm endpoints próprios.

📄️Remove cliente (soft delete)

Marca o cliente como **Deletado** (`StatusConsumer=0`). **Não apaga fisicamente** — preserva histórico de pedidos, contas a receber e NFs emitidas. O cliente deixa de aparecer na listagem padrão (que filtra `StatusConsumer IN (1,2,3)`).