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

# grupos de clientes

## o que é o grupo de clientes

configurar cliente por cliente funciona quando a base é pequena. mas conforme a marca cresce, repetir a mesma configuração de acesso, preço ou condição comercial para dezenas ou centenas de clientes, um a um, vira um trabalho que não escala.

é para isso que existe o grupo de clientes na teceo: reunir vários clientes que compartilham algo em comum, para que a marca configure uma vez e aplique para todos de uma só vez.

## uma configuração, muitos clientes

ao criar um grupo, a marca define o que aquele conjunto de clientes tem em comum, seja região, perfil de compra, porte da loja ou qualquer outro critério relevante para o negócio. a partir daí, a [tabela de preço](/docs/configuracoes/tabelas-de-preco) e as [formas de pagamento](/docs/configuracoes/formas-de-pagamento) definidas no grupo podem ser direcionadas ao grupo inteiro, em vez de cliente por cliente.

é a diferença entre repetir a mesma configuração dezenas de vezes e configurar uma única vez para todos que precisam dela.

## flexibilidade sem perder o controle individual

fazer parte de um grupo não impede que um cliente também tenha configurações próprias. a marca pode combinar as duas coisas: regras que valem para o grupo inteiro e ajustes específicos para um cliente em particular, quando a situação exigir.

a marca ganha agilidade para tratar muitos clientes de uma vez, sem abrir mão da possibilidade de tratar um caso específico de forma diferente.

o grupo de clientes é a forma da marca crescer a base de clientes sem multiplicar o trabalho operacional de configurar cada um individualmente.

## criar um grupo de clientes

a tabela de preço e as formas de pagamento que o grupo vai usar precisam existir antes.

1. **abra o cadastro**

   em configurações, abra [**grupos de clientes**](https://app.teceo.co/settings/customer-groups) e clique em **adicionar grupo de clientes**.

2. **informe o nome**

   é o que identifica o grupo na seleção do cadastro do cliente, nos filtros e nas colunas. o nome não pode se repetir entre os grupos da sua marca, e é obrigatório.

3. **opcional: informe o código**

   é por ele que o seu sistema de gestão identifica o grupo. o código também não pode se repetir entre os grupos da sua marca.

4. **descreva o grupo**

   a descrição é obrigatória.

5. **decida se o grupo já entra em uso**

   ativo vem marcado. é ele que decide se a planilha e a integração aceitam vincular clientes ao grupo, e se a opção de usar a tabela de preço dele pode ser marcada em um cliente. para preparar o grupo antes de liberar, desmarque.

6. **clique em salvar**

   o salvar grava a aba **dados gerais**. a aba **regras** fica desabilitada até este primeiro salvamento, e é onde a tabela de preço e as formas de pagamento são definidas.

## a tabela de preço do grupo

na aba **regras**, escolha a tabela de preço. a troca é salva imediatamente, sem passar pelo salvar, e a plataforma confirma com tabela de preço alterada com sucesso!

o grupo sempre tem uma tabela de preço, e só uma. quando o grupo é criado sem nenhuma escolhida, ele recebe a tabela principal da sua marca. a lista oferece só tabelas de preço ativas.

quem compra pela tabela do grupo depende da marcação no cadastro do cliente:

* com utilizar a tabela de preço do grupo de clientes marcado no [cadastro do cliente](/docs/clientes/criar-um-cliente-v2), ele compra pela tabela do grupo, e o campo de tabela de preço dele fica bloqueado.
* sem a marcação, ele compra pela tabela dele, e a tabela do grupo não tem efeito.

o pedido já criado guarda a tabela de preço que usou. trocar o grupo do cliente, ou trocar a tabela do grupo, não altera o preço desse pedido.

## as formas de pagamento do grupo

ainda na aba **regras**, em formas de pagamento, clique em **adicionar**. a seleção abre com as formas atuais já marcadas e substitui a lista inteira ao salvar: o que entrar nela é vinculado, e o que sair é desvinculado. cada linha também tem a ação **remover**.

quais formas o cliente enxerga no pedido seguem esta ordem:

* o cliente com formas de pagamento próprias enxerga só as dele, e as do grupo não têm efeito.
* o cliente sem formas próprias enxerga as do grupo.
* quando nem o cliente nem o grupo têm formas vinculadas, o cliente enxerga todas as formas ativas da sua marca.

na seleção de grupo do cadastro do cliente, o grupo sem nenhuma forma vinculada aparece como sem restrição de formas de pagamento.

## adicionar clientes ao grupo

o vínculo é feito no cadastro do cliente, não no do grupo, por três caminhos.

| caminho | o que ele faz |
| - | - |
| [cadastro do cliente](/docs/clientes/criar-um-cliente-v2) | no campo grupo de clientes, da seção regras. cada opção da lista mostra a tabela de preço daquele grupo e até três formas de pagamento dele |
| [listagem de clientes](/docs/clientes/usar-a-listagem-de-clientes-v2) | a ação em massa editar grupo de clientes aplica o mesmo grupo a vários clientes ao mesmo tempo, e já marca a opção de usar a tabela de preço dele nesses clientes. deixar o campo vazio remove o grupo atual deles |
| [planilha de clientes](/docs/clientes/criar-clientes-via-planilha-v2) | a coluna grupo do cliente identifica o grupo pelo nome, e aceita só grupo ativo |

## editar, ativar e inativar um grupo

na lista, clique em qualquer informação da linha para abrir o cadastro. é o mesmo formulário da criação, com as duas abas.

a coluna ativo é um botão: clique nela para ativar ou inativar o grupo direto na linha, sem abrir o cadastro e sem confirmação.

inativar um grupo faz a planilha recusar a linha que o indica e impede marcar a opção de usar a tabela de preço dele em um cliente. o que já estava vinculado não muda: os clientes continuam no grupo, e quem já comprava pela tabela de preço dele continua comprando por ela.

## excluir um grupo de clientes

na lista, clique em **excluir**, no fim da linha. na confirmação deseja excluir?, clique em **continuar**.

<Warning>
  a exclusão é definitiva. não há como desfazer.
</Warning>

a plataforma informa qual condição impediu a exclusão:

* o grupo precisa estar inativo.
* o grupo não pode ter clientes vinculados. troque o grupo desses clientes antes.
* o grupo não pode ter formas de pagamento vinculadas. remova as formas na aba **regras** antes.

## encontrar um grupo na lista

a lista mostra nome, tabelas de preço, formas de pagamento e ativo. clique no cabeçalho para ordenar por nome, por tabela de preço ou por ativo. a coluna de formas de pagamento não ordena.

* o campo de busca procura pelo nome do grupo.
* os filtros são tabela de preço, formas de pagamento e status.
* a escolha de quais colunas aparecem fica salva e vale nos próximos acessos.

## o grupo e o seu sistema de gestão

o grupo de clientes é cadastrado na teceo. a integração vincula o cliente a um grupo que já existe, pelo código, e o código precisa estar cadastrado antes.

o grupo do cliente segue no pedido enviado ao sistema de gestão, e o código dele pode determinar qual código de operação o pedido recebe lá.


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