# A ficha de um vendedor e a carteira de clientes dele

> Para o administrador: ver a ficha de um vendedor, adicionar, transferir e remover clientes da carteira dele e conferir o que vem do ERP.

Fonte: https://vendria.com/ajuda/ficha-do-vendedor-e-a-carteira-dele

## Onde fica

No menu da sua conta, em **Vendedores**, clicando na linha do vendedor. O topo
mostra o nome e, ao lado, o código do vendedor (o código interno da Vendria, não
o código dele no ERP).

O cartão **Dados** mostra **Email** e **WhatsApp** só para leitura. Para mudar
nome, e-mail, telefone ou código, vá em **Usuários**, abra a pessoa e edite o
perfil de vendedor dela. O que esta página existe para fazer é mexer na
**carteira**: os clientes pelos quais aquele vendedor responde.

## Os três números do topo

**Clientes** soma os clientes das duas listas da página (a da Vendria e a do
ERP), sem contar duas vezes quem aparece nas duas. O rótulo ganha "(ao menos)"
sempre que a parte do ERP não está fechada: enquanto ela carrega, quando ela
falha, ou quando ainda há páginas do ERP que você não abriu. Nesses casos o
número é um piso, não o total. Se o ERP não respondeu e não há nada contado na
Vendria, aparece um travessão em vez de um zero.

**Cotações** conta as cotações salvas desse vendedor **nesta loja**. O carrinho
que ainda está sendo montado não entra.

**Receita** soma o total dos pedidos desse vendedor nesta loja que estão
**Confirmado** ou **Exportado**. Pedido aguardando, recusado ou cancelado não
entra.

Os dois últimos ignoram documentos de teste e olham só a loja em que você está,
então não confira esses números contra um total da organização inteira.

## Carteira na Vendria e carteira no ERP

A página mostra duas listas, e elas não são a mesma coisa:

- **Carteira na Vendria**: os clientes já cadastrados aqui que têm este vendedor
  como titular. É a única que você gerencia nesta tela, com **Cliente**, **CNPJ**
  e **Ações**.
- **No ERP (ainda não na Vendria)**: a carteira desse vendedor lida no ERP na
  hora em que você abre a página, só para leitura. Um cliente daí entra na Vendria
  sozinho quando alguém o usa numa cotação, já atribuído ao vendedor que o ERP
  indicar.

Na lista da Vendria, um selo ao lado do nome diz em que pé está o vínculo daquele
cliente com o ERP: **ERP + Vendria** (existe nos dois) ou **Vínculo caiu** (o ERP
não reconhece mais o cliente; pedido novo não é aceito lá até o vínculo ser
refeito). Cliente **sem selo** nesta lista foi criado aqui e não tem
correspondente no ERP: a cotação é montada normalmente, mas o ERP não reconhece o
CNPJ no envio. "Vínculo caiu" não é a mesma coisa que "nunca foi do ERP".

## Como funciona a lista do ERP nesta ficha

A lista **No ERP (ainda não na Vendria)** não tem busca nesta tela. Ela vem por
páginas, uma sequência por conexão, com **Anterior** e **Próxima**. Matriz e
filiais vêm agrupadas, e o selo de grupo conta só o que está **naquela página**;
a matriz pode estar na página seguinte.

Clicar numa linha abre o cliente: se ele já existe na Vendria, abre o cadastro
dele; se não, abre uma ficha só de leitura com o que o ERP tem.

**Trazer este cliente** cria o cadastro na Vendria na hora, sem esperar a primeira
cotação. Entra o cadastro inteiro (matriz e filiais do grupo, com o vínculo com o
ERP), não uma linha avulsa. Duas recusas possíveis:

- o aviso de que a importação de clientes do ERP não está habilitada: é uma
  chave ligada ou desligada por loja, não falta de permissão sua. Fale com o
  suporte da Vendria.
- "Não foi possível trazer o cliente.": tente de novo; se o registro saiu do ERP
  entre a sua busca e o clique, recarregue a página.

## Adicionar, transferir e remover clientes

1. **Adicionar cliente** abre **Adicionar cliente à carteira**, com busca por nome
   ou CNPJ. Cada resultado diz quem atende hoje ("vendedor atual", "atendido pela
   representação", "sem vendedor", "já na carteira" ou "atribuição vem do ERP"),
   e escolher alguém que já tem titular pede confirmação de transferência. ⚠️ Se
   quem atende é uma **representação**, trazer o cliente para um vendedor o tira
   da representação inteira: todos os membros dela perdem o acesso a ele, não só
   quem estava atendendo. A confirmação só nomeia a representação; o efeito é
   esse.
2. O botão de transferir, na linha, abre a escolha do vendedor de destino. Só
   aparecem destinos que podem ser titulares de carteira.
3. A lixeira remove o cliente da carteira e ele fica **sem vendedor** até nova
   atribuição. O cliente não é apagado.

Um cliente tem um titular só: uma pessoa **ou** uma representação, nunca os
dois.

## Quando a atribuição vem do ERP

Cliente cuja atribuição veio do ERP fica travado nesta ficha: o botão de
transferir e a lixeira ficam desabilitados, com o aviso "A atribuição vem do ERP
— corrija lá; o sync propaga". Na busca de **Adicionar cliente**, esse cliente
aparece marcado e não dá para escolher.

Forçar aqui não adiantaria: a próxima sincronização traria a atribuição de volta. O
conserto é no ERP. A trava vale enquanto a conexão da loja com o ERP estiver
ativa; desligada a conexão, o cliente volta a ser gerenciável na Vendria.

## Pré-vendas no ERP

O terceiro bloco, **Pré-vendas no ERP**, lista as pré-vendas que esse vendedor
tem abertas no ERP, lidas na hora e só para leitura; nada aqui altera o ERP. Cada
linha traz o pedido, a emissão, o cliente, o valor e o status; com mais de uma filial,
aparece também a coluna da filial. **Carregar mais** busca a próxima leva.

Três frases dizem coisas diferentes:

- "Este vendedor não tem vínculo com o ERP.": não há código do ERP ligado a ele.
- "O ERP deste vendedor não oferece pré-vendas.": ele tem vínculo, mas aquele ERP
  não trabalha com pré-venda.
- "Calibração do ERP incompleta — a lista pode não estar completa.": a lista veio,
  mas pode faltar pré-venda. Não conclua que ela não existe.

## Quando dá errado

Abrir esta página consulta o ERP na hora: a lista do ERP e parte do número de
clientes saem dessa consulta. Com o conector fora do ar, a página não chuta: o
número de **Clientes** vira travessão e a carteira avisa que não dá para conferi-la
agora, com o detalhe do erro ao lado.

Isso não é carteira vazia. Não recadastre nada nesse estado e não conclua que o
vendedor perdeu clientes.

"Não foi possível carregar o vendedor." com **Tentar novamente** é falha ao abrir a
própria ficha. Tente de novo; se persistir, confira se o vendedor não foi
removido.

## Perguntas comuns

**Por que o total de clientes diz "(ao menos)"?** Porque a lista do ERP ainda tem
páginas que você não abriu, ou não respondeu. O número só é exato quando as duas
metades estão completas.

**A receita do vendedor está menor do que eu esperava.** Ela conta só pedidos
confirmados ou exportados, só desta loja, e ignora documentos de teste.

**O cliente está no ERP do vendedor, mas não aparece na Carteira na Vendria.** Ele
ainda não tem cadastro aqui. Use **Trazer este cliente** ou espere a primeira
cotação para ele.

**Quero mudar o código do vendedor.** Isso é em **Usuários**, não aqui. E lembre:
esse é o código interno; o do ERP se liga em **Códigos de vendedor no ERP**, na
ficha da pessoa.
