feat(web+api): tela de cadastro de cliente novo (CNPJ/CPF) com sync ERP

Web (NewClientPage):
- Segmentado PJ/CPF com campos específicos por categoria
- PJ: razão social, nome fantasia, CNPJ, IE, indicador IE, consumidor final
- PF: nome completo, CPF
- Endereço com auto-preenchimento via ViaCEP (CEP → rua/bairro/município)
- Município: Select com busca server-side (/catalog/municipios)
- Contato: DDD, telefone, email
- Comercial: forma pagamento, tabela de preços, limite crédito
- Feedback: código ERP exibido no sucesso; alerta de erro de sync sem bloquear

API:
- GET /catalog/municipios?q= — busca municipios da vw_municipios
- POST /clients/novo — INSERT em sar.clientes_novos; trigger sincroniza para sig.corrent
- Retorna { id, idCorrentErp, sincronizado, erroSync } após o trigger disparar
- Fix trigger fn_sync_cliente_to_erp: NULLIF para cgcpf vazio (evita violação
  do unique index key_corrent_cgcpf quando cliente não tem CPF/CNPJ)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/web/src/lib/queries/catalog.ts

@@ -1,10 +1,12 @@
 import { useQuery } from '@tanstack/react-query';
 import {
   FormaPagamentoSchema,
+  MunicipioSchema,
   PautaSchema,
   ProdutoListResponseSchema,
   ProdutoDetailSchema,
   type FormaPagamento,
+  type Municipio,
   type ProdutoListQuery,
   type ProdutoListResponse,
   type ProdutoDetail,
@@ -13,6 +15,19 @@ import {
 import { z } from 'zod';
 import { apiFetch } from '../api-client';
 
+export function useMunicipios(q?: string) {
+  return useQuery<Municipio[]>({
+    queryKey: ['catalog', 'municipios', q ?? ''],
+    queryFn: async () => {
+      const qs = q ? `?q=${encodeURIComponent(q)}` : '';
+      const res = await apiFetch(`/catalog/municipios${qs}`);
+      return z.array(MunicipioSchema).parse(res);
+    },
+    staleTime: 24 * 60 * 60 * 1000,
+    enabled: !q || q.length >= 2,
+  });
+}
+
 export function usePautas() {
   return useQuery<Pauta[]>({
     queryKey: ['catalog', 'pautas'],

apps/web/src/lib/queries/clients.ts

@@ -1,10 +1,13 @@
-import { useQuery } from '@tanstack/react-query';
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import {
-  ClientListResponseSchema,
   ClientDetailSchema,
+  ClientListResponseSchema,
+  ClientNovoResultSchema,
+  type ClientDetail,
   type ClientListQuery,
   type ClientListResponse,
-  type ClientDetail,
+  type ClientNovoResult,
+  type CreateClientNovo,
 } from '@sar/api-interface';
 import { apiFetch } from '../api-client';
 
@@ -42,3 +45,20 @@ export function useClientDetail(id: number | string | undefined) {
     enabled: !!id,
   });
 }
+
+export function useCreateClientNovo() {
+  const queryClient = useQueryClient();
+  return useMutation<ClientNovoResult, Error, CreateClientNovo>({
+    mutationFn: async (data) => {
+      const res = await apiFetch('/clients/novo', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(data),
+      });
+      return ClientNovoResultSchema.parse(res);
+    },
+    onSuccess: () => {
+      void queryClient.invalidateQueries({ queryKey: CLIENT_KEYS.all });
+    },
+  });
+}

apps/web/src/lib/router.tsx

@@ -13,6 +13,7 @@ import { ClientDetailPage } from '../cockpits/rep/ClientDetailPage';
 import { OrdersPage } from '../cockpits/rep/OrdersPage';
 import { OrderDetailPage } from '../cockpits/rep/OrderDetailPage';
 import { OrderPrintPage } from '../cockpits/rep/OrderPrintPage';
+import { NewClientPage } from '../cockpits/rep/NewClientPage';
 import { NewOrderPage } from '../cockpits/rep/NewOrderPage';
 import { CatalogPage } from '../cockpits/rep/CatalogPage';
 import { ApprovalQueuePage } from '../cockpits/supervisor/ApprovalQueuePage';
@@ -75,6 +76,12 @@ const clientesRoute = createRoute({
   component: ClientsPage,
 });
 
+const novoClienteRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: '/clientes/novo',
+  component: NewClientPage,
+});
+
 const clienteDetailRoute = createRoute({
   getParentRoute: () => rootRoute,
   path: '/clientes/$id',
@@ -121,6 +128,7 @@ const routeTree = rootRoute.addChildren([
   indexRoute,
   rafaelRoute,
   clientesRoute,
+  novoClienteRoute,
   clienteDetailRoute,
   pedidosRoute,
   novoOrderRoute,