> ## 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.

# referência de campos do representante

o cadastro do representante se divide em três abas: dados gerais, vendedores e tabelas de preço. a aba tabelas de preço é exibida somente quando habilitar tabela de preço por representante está ligada em definições gerais.

## dados gerais

| campo | tipo | obrigatório | comportamento |
| - | - | - | - |
| nome | texto | sim, ao criar e ao editar | não se repete entre os representantes da mesma marca |
| código | texto livre, não gerado pela plataforma | sim, ao criar e ao editar | não se repete entre os representantes da mesma marca. em marca integrada, é o código do sistema de gestão |
| ativo | opção | não, e já vem marcada em um representante novo | com a opção desmarcada, a plataforma recusa o pedido com representante inativo. a listagem não exibe esse valor em coluna nem em filtro |
| acesso a pedidos | seleção única de três opções | sim, ao criar e ao editar | em um representante novo, abre sem valor selecionado |
| descrição | texto longo | não | sem tamanho mínimo |

## acesso a pedidos do representante

o acesso a pedidos do representante e o de cada vendedor vinculado valem ao mesmo tempo. o efeito de cada opção está em [criar, editar e excluir representantes](/docs/representantes/criar-e-editar-representantes).

| opção |
| - |
| todos os pedidos do cliente |
| pedidos do próprio representante e pedidos sem representante |
| apenas os pedidos do próprio representante |

## acesso a pedidos do vendedor

cada vendedor vinculado tem o próprio acesso a pedidos, com três opções de texto diferente das do representante. o valor é editado na célula da coluna acesso a pedidos, na aba vendedores, e a alteração é salva imediatamente, com a confirmação alterado com sucesso!

um vínculo novo é criado em pedidos do próprio vendedor e pedidos sem vendedor.

| opção |
| - |
| todos os pedidos a que o representante tem acesso |
| pedidos do próprio vendedor e pedidos sem vendedor |
| apenas os pedidos do próprio vendedor |

## colunas da listagem

| coluna | comportamento |
| - | - |
| código | abre o cadastro do representante |
| nome | abre o cadastro do representante |

a listagem tem uma busca por código ou nome, e nenhum outro filtro.

## colunas da aba vendedores

| coluna | comportamento |
| - | - |
| usuário | nome da pessoa vinculada ao representante |
| acesso a pedidos | seleção editada na própria célula, entre as três opções do vendedor |
| telefone | exibe não cadastrado quando o telefone da pessoa está em branco |
| função | a função registrada no cadastro da pessoa |
| perfil | o perfil de acesso da pessoa no time da marca |

a aba tem uma busca por nome ou email do vendedor, e a seleção de vendedores busca por digite o nome do vendedor. a ação excluir na linha remove o vínculo, não a pessoa.

## colunas da aba tabelas de preço

somente tabelas de preço ativas da marca podem ser vinculadas.

| coluna | comportamento |
| - | - |
| nome | o nome da tabela de preço, como está no cadastro dela |
| código | o código da tabela de preço, como está no cadastro dela |
| padrão | define a tabela padrão do representante. existe uma padrão por representante: definir uma retira a marcação das demais. a primeira tabela vinculada é marcada como padrão, e ao desvincular a padrão outra tabela vinculada recebe a marcação |

a aba tem uma busca por nome da tabela de preço, e a seleção de tabelas busca por digite o nome da tabela de preço.

## definições gerais de representante

| configuração | o que define |
| - | - |
| habilitar tabela de preço por representante | exibe a aba tabelas de preço no cadastro do representante, e o pedido do vendedor vinculado começa na tabela padrão do representante dele, descrito em [criar, editar e excluir representantes](/docs/representantes/criar-e-editar-representantes) |
| habilitar alteração de representante no pedido | controla se o representante do pedido pode ser alterado |
| permitir que representantes visualizem outros representantes vinculados ao mesmo cliente | desligada por padrão. com ela ligada, o vendedor também vê os representantes que atendem os mesmos clientes que ele |

## mensagens da tela

| mensagem | quando aparece |
| - | - |
| obrigatório | nome, código ou acesso a pedidos em branco |
| representante inativo | o pedido usa um representante com a opção ativo desmarcada |
| representante com código ou nome já existente | a criação ou a edição usa um código ou um nome já registrado em outro representante da mesma marca |
| não é possível excluir um representante vinculado a um pedido | exclusão de um representante com pedido vinculado |
| não é possível excluir um representante com tabelas de preço vinculadas a ele | exclusão de um representante com tabela de preço vinculada |
| um vendedor não pode criar pedido sem estar vinculado a um representante | um vendedor sem vínculo com representante cria um pedido |

cliente vinculado não impede a exclusão do representante. a confirmação de exclusão é deseja excluir?, com continuar e cancelar.


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