> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# criar, editar e excluir representantes

ao criar um representante, registre o nome e o código, defina o acesso a pedidos e vincule os vendedores que operam por ele e as tabelas de preço que eles usam.

## criar o cadastro

1. **abra o formulário**

   em [**representantes**](https://app.teceo.co/settings/sales-representatives), clique em **adicionar representante**.

2. **identifique o representante**

   insira o nome e o código. o código é texto livre, e em marca integrada é o do sistema de gestão.

   nenhum dos dois se repete entre os representantes da marca: a plataforma recusa com representante com código ou nome já existente.

3. **defina se o cadastro fica ativo**

   o campo ativo já vem marcado. desmarque para tirar o representante de circulação: a plataforma recusa o pedido com representante inativo.

4. **defina o acesso a pedidos**

   o campo abre sem valor selecionado. em todas as opções, o vendedor alcança os pedidos dos clientes que estão na carteira deste representante. o que muda é quanto dos pedidos desses clientes ele vê.

   * para que ele veja todos os pedidos desses clientes, inclusive os que outro representante atendeu, selecione todos os pedidos do cliente.
   * para que ele veja os pedidos atendidos por este representante mais os que estão sem representante, selecione pedidos do próprio representante e pedidos sem representante.
   * para que ele veja apenas os pedidos atendidos por este representante, selecione apenas os pedidos do próprio representante.

5. **descreva o representante**

   opcional: na descrição, registre a anotação que a marca quer manter junto do cadastro.

6. **salve o cadastro**

   clique em **salvar**.

## vincular os vendedores

<Warning>
  o que estiver selecionado quando você salvar é o que fica vinculado: tirar um vendedor da seleção desvincula esse vendedor, e salvar com o campo vazio desvincula todos. a desvinculação é imediata, sem confirmação.
</Warning>

1. **abra a seleção de vendedores**

   na aba **vendedores**, clique em **adicionar vendedores**.

2. **selecione quem vende pelo representante**

   no campo digite o nome do vendedor, selecione quantas pessoas quiser. o campo abre preenchido com quem já está vinculado.

   a busca oferece apenas pessoas que já estão no time da marca, com perfil admin da marca ou vendedor, e que não estão vinculadas a outro representante.

3. **confirme o vínculo**

   clique em **salvar**. cada pessoa vinculada é exibida em uma linha da aba.

cada pessoa é vinculada a um representante por marca. quem ainda não está no time entra por [convidar pessoas ao time](/docs/usuarios/convidar-pessoas-ao-time), e vincular um vendedor não consome licença, como [o que é o representante](/docs/representantes/o-que-e-um-representante) descreve.

sem vínculo com um representante, o vendedor não cria pedido: a plataforma recusa com um vendedor não pode criar pedido sem estar vinculado a um representante.

## o acesso a pedidos de cada vendedor

cada vendedor vinculado tem o seu acesso a pedidos, com três opções diferentes das do representante: todos os pedidos a que o representante tem acesso, pedidos do próprio vendedor e pedidos sem vendedor, e apenas os pedidos do próprio vendedor.

a coluna acesso a pedidos é editada na linha do vendedor, e a alteração é salva imediatamente: a plataforma confirma com alterado com sucesso! o vínculo é criado em pedidos do próprio vendedor e pedidos sem vendedor.

o acesso do vendedor restringe dentro do que o representante já alcança: ele nunca amplia. o representante define o teto, e o vendedor recebe esse teto inteiro, só os pedidos dele mais os sem vendedor, ou só os dele.

## desvincular um vendedor

* para tirar um vendedor do representante, abra as ações da linha dele e clique em **excluir**. na confirmação deseja excluir?, clique em **continuar**. a pessoa continua no time da marca.
* para ajustar mais de um vínculo ao mesmo tempo, abra **adicionar vendedores** e altere a seleção.

## vincular as tabelas de preço

<Info>
  a aba tabelas de preço aparece no cadastro do representante quando habilitar tabela de preço por representante está ligada em **configurações** → **definições gerais**.
</Info>

aqui também, o que estiver selecionado quando você salvar é o que fica vinculado: tirar uma tabela da seleção desvincula.

1. **abra a seleção de tabelas**

   na aba **tabelas de preço**, clique em **adicionar tabelas de preço**.

2. **selecione as tabelas**

   no campo digite o nome da tabela de preço, busque e selecione as tabelas, e clique em **salvar**. a busca oferece apenas as tabelas ativas da marca.

3. **defina a tabela padrão**

   na coluna padrão, clique na marcação da tabela que o representante usa por padrão.

   a primeira tabela vinculada é marcada como padrão automaticamente. existe uma padrão por representante: definir uma retira a marcação das demais, e ao desvincular a padrão outra tabela vinculada recebe a marcação.

para desvincular pela lista, abra as ações da linha e clique em **excluir**.

**exemplo: a tabela com que o pedido começa**

* habilitar tabela de preço por representante está ligada em definições gerais
* o representante tem duas tabelas vinculadas, atacado e outlet, e atacado está marcada como padrão
* o vendedor vinculado a esse representante abre um pedido: o pedido começa na tabela atacado
* com a configuração desligada, a aba deixa de ser exibida e a tabela do pedido é definida fora do representante

## editar um representante

a alteração acontece no mesmo formulário da criação: na listagem, clique no código ou no nome do representante.

## excluir um representante

na listagem, abra as ações da linha e clique em **excluir**. na confirmação deseja excluir?, clique em **continuar**.

a exclusão é recusada em dois casos:

* com pedido vinculado, com não é possível excluir um representante vinculado a um pedido
* com tabela de preço vinculada, com não é possível excluir um representante com tabelas de preço vinculadas a ele

cliente vinculado não impede a exclusão. os vínculos de vendedor são removidos junto com o representante, e as pessoas continuam no time da marca. excluir a pessoa do time apaga o vínculo dela com o representante.

## o que é obrigatório

| campo | obrigatório |
| - | - |
| nome | sim, e não se repete entre os representantes da marca |
| código | sim, e não se repete entre os representantes da marca |
| acesso a pedidos | sim, e o campo abre sem valor selecionado |
| ativo | não, e já vem marcado |
| descrição | não |

## saiba mais

os campos, as colunas e os valores de cada aba estão em [referência de campos do representante](/docs/representantes/referencia-de-campos-do-representante).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.