Manual de Visibilidade de Clientes e Pedidos — SuperMobile
Para quem é: equipe de suporte, administradores e vendedores que usam o app de pedidos do Supermobile.
O que este manual responde:
- Por que um vendedor não vê todos os clientes da empresa?
- Por que a lista de pedidos só mostra os pedidos do próprio vendedor?
- O que acontece quando o usuário é admin ou superadmin?
- Por que um cliente "sumiu" da carteira de um vendedor?
- O que verificar quando um vendedor reclama que não enxerga um cliente que deveria?
1. Visão geral
O sistema exibe automaticamente apenas os clientes e pedidos relacionados ao usuário logado, conforme o perfil dele. Cada vendedor enxerga somente sua carteira; administradores mantêm a visão completa.
Esse filtro é aplicado na origem — no servidor — e cobre tanto a tela de listagem quanto a busca de cliente dentro do formulário de novo/editar pedido.
2. Quem vê o quê
2.1. Vendedor (perfil user) com código de vendedor preenchido
| Tela | O que vê |
|---|---|
| Lista de Clientes | Apenas os clientes da carteira dele (associação em "Vendedores do Cliente"). |
| Lista de Pedidos | Apenas os pedidos lançados em nome dele (campo MOB_COD_VENDEDOR). |
| Novo/Editar Pedido — busca de cliente | Sugere apenas clientes da sua carteira. |
2.2. Vendedor (perfil user) sem código de vendedor preenchido
Enxerga tudo — todos os clientes e todos os pedidos. Comportamento idêntico ao anterior à existência do filtro.
Por quê? Sem código de vendedor, o sistema não tem como saber qual subconjunto deveria mostrar. Em vez de não mostrar nada, o filtro é desativado.
2.3. Administrador (admin) e Super Administrador (superadmin)
Visão completa, independentemente do código de vendedor. Útil para supervisão, conferência e operação em nome de qualquer vendedor.
3. Como o filtro é aplicado
3.1. Filtro de clientes
O sistema cruza o código de vendedor do usuário logado com a tabela "Vendedores do Cliente":
Mostra um cliente apenas se existir um registro em "Vendedores do Cliente" onde:
- código do vendedor = código do vendedor do usuário logado
- código do cliente = código de retaguarda do cliente
Tradução prática: para um cliente aparecer para o vendedor João, é preciso ter um registro em "Vendedores do Cliente" ligando aquele cliente ao código do João.
3.2. Filtro de pedidos
O sistema compara diretamente o código de vendedor do pedido com o código de vendedor do usuário logado:
Mostra um pedido apenas se o código de vendedor do pedido = código de vendedor do usuário logado.
4. Lógica de decisão
A cada requisição, o servidor decide assim, nesta ordem:
- Usuário é admin ou superadmin? → mostra tudo (sem filtro).
- Usuário não tem código de vendedor cadastrado? → mostra tudo (sem filtro).
- Caso contrário → aplica o filtro descrito acima.
5. O toggle "Meus pedidos" na lista de pedidos
A tela de pedidos tem um botão "Meus pedidos" que liga/desliga o filtro pelo código do vendedor.
- Para vendedor (
user): o botão é praticamente redundante — o servidor já entrega só os pedidos dele. Ligar ou desligar não muda o resultado. - Para admin/superadmin: o botão funciona normalmente. Ligado, mostra apenas pedidos do código de vendedor do próprio admin (útil quando o admin também atua como vendedor). Desligado, mostra todos os pedidos do tenant.
6. Cenários comuns
6.1. "Vendedor novo entrou na empresa e não vê nenhum cliente"
Verificar, nesta ordem:
- O código de vendedor está preenchido no perfil de usuário dele?
- Existem clientes ligados a esse código em "Vendedores do Cliente"?
- Os clientes têm o campo código de retaguarda preenchido? (É o que casa com o cadastro de "Vendedores do Cliente".)
Se nenhuma das três condições for verdadeira, o vendedor não verá ninguém.
6.2. "Transferência de carteira de um vendedor para outro"
Basta atualizar a relação em "Vendedores do Cliente" — trocar o código de vendedor associado ao cliente. A visibilidade no app reflete imediatamente, sem precisar mexer em permissões nem reiniciar nada.
6.3. "Vendedor está vendo clientes que não deveria"
Provavelmente o perfil do usuário está como admin ou superadmin em vez de user. Ajustar no cadastro de usuário.
Outra possibilidade: o código de vendedor do perfil dele não está preenchido — nesse caso, o filtro fica desativado e ele vê tudo. Preencher o código corrige.
6.4. "Pedido lançado para um cliente, mas o cliente não aparece na lista"
Esse cenário não acontece pelo filtro de clientes, mas pode ocorrer se:
- O cliente foi removido da relação "Vendedores do Cliente" depois do pedido ter sido lançado.
- O pedido foi originalmente lançado por outro vendedor e transferido sem atualizar a carteira.
Solução: ajustar a relação em "Vendedores do Cliente" para incluir o cliente na carteira do vendedor atual.
6.5. "Vendedor não vê um pedido específico que ele acha que lançou"
Verificar no cadastro do pedido qual é o código do vendedor registrado nele. Se for diferente do código de vendedor do usuário logado, o pedido não aparece para ele. Pode ter sido um lançamento por outro usuário, ou o código foi alterado.
Admin/superadmin consegue abrir o pedido e ajustar o vendedor responsável (ver manual de Preços do Pedido, seção sobre edição de pedidos alheios).
7. Resumo executivo
| Você é... | Tem código de vendedor? | Vê quais clientes? | Vê quais pedidos? |
|---|---|---|---|
superadmin | Tanto faz | Todos | Todos |
admin | Tanto faz | Todos | Todos |
user | Sim | Apenas os da carteira | Apenas os do próprio código |
user | Não | Todos | Todos |
8. Para a equipe de suporte
Quando um chamado entrar com queixa do tipo "não estou vendo X":
- Identificar qual é a role do usuário no perfil.
- Identificar qual é o código de vendedor preenchido no perfil dele.
- Para queixa sobre cliente: conferir se existe registro em "Vendedores do Cliente" ligando aquele cliente ao código do vendedor.
- Para queixa sobre pedido: conferir se o pedido tem o código de vendedor correto no cadastro.
Isso resolve a grande maioria dos casos.