Clientes

A tela de Clientes no SuperMobile é somente consulta. O cadastro de clientes acontece no ERP central da empresa — o app apenas reflete esses dados via integração.

Por que não dá pra cadastrar pelo app? Porque cadastro de cliente envolve fluxos comerciais e fiscais que precisam passar pelo ERP (validação de CNPJ, análise de crédito, etc). Manter consulta-only no app evita divergência.

O que aparece

A tela de listagem mostra os clientes do tenant com:

• Razão social (com nome fantasia logo abaixo, quando diferente)
• CPF/CNPJ
• Código (do ERP/retaguarda)
• Tipo — Jurídica ou Física
• Cidade/UF
• Telefone (prioriza comercial; cai pro celular se não houver)
• Status — Ativo (verde) ou Inativo (vermelho)
• Visualizar — botão pra abrir detalhes

A vista é adaptativa: tabela em desktop, cards empilhados em mobile.

Buscar

A barra de busca aceita texto livre e procura simultaneamente em:

• Razão social
• Nome fantasia
• CPF/CNPJ
• Código

A busca reconhece se você está digitando dígitos (procura em campos numéricos) ou texto (procura em nomes). Você não precisa escolher entre os dois.

Visualizar detalhes

Clicar em Visualizar abre um modal com:

• Razão social, nome fantasia, CPF/CNPJ, código
• Tipo (Física/Jurídica)
• E-mail e telefones
• Cidade, UF, bairro, CEP
• Endereço completo
• Contato responsável
• Inscrição estadual
• Observações

Paginação e ordenação

• Itens por página: 25, 50 ou 100 (botão na barra inferior)
• Ordenação: clique nos cabeçalhos das colunas — Razão Social, Código ou Cidade/UF

Triagem rápida — suporte

Sintoma	Causa provável	Ação
Cliente que existe no ERP não aparece	Sincronização atrasada ou cliente está marcado como Inativo	Aguardar próxima sincronização; conferir status no ERP
CPF/CNPJ está aparecendo sem máscara	Máscara é aplicada na renderização — se mostra cru, é dado corrompido	Reportar pro time técnico
Endereço incompleto	Cadastro original no ERP está incompleto	Pedir time fiscal/comercial para complementar no ERP
Não acho cliente pelo nome fantasia	Pode estar cadastrado só com razão social	Buscar pelo CNPJ ou código
Botão Editar não existe	Comportamento intencional — consulta-only	Encaminhar pro fluxo do ERP

Atualizar a listagem

Clique em Atualizar (ícone de seta circular) para forçar refresh — útil quando você sabe que o cliente foi cadastrado/alterado agora no ERP e quer ver no app sem esperar a paginação.

E o pedido?

Quando você cria um pedido, o cliente é selecionado pelo código ou pela busca textual no campo Cliente da aba "Dados Principais". A lista no popover é a mesma vista aqui — então se um cliente aparece em Clientes, aparece no campo de pedido.