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

# o ciclo de vida dos clientes

os status de cadastro definem o que cada cliente pode fazer na plataforma, e mudam por ação da marca.

## os status

### rascunho

o cadastro iniciado e ainda incompleto. exige apenas localização, tipo do documento e nome, o que permite registrar o cliente antes de reunir todos os dados. o pedido já pode ser aberto, e a finalização não é liberada neste status. as ações disponíveis são enviar para pendente e inativar.

### pendente

o cadastro completo, à espera da ativação pela marca. é o estado em que entram, por padrão, o cliente criado pela tela e o criado por conexão. o pedido pode ser aberto, e a finalização depende da ativação do cliente. as ações disponíveis são ativar, voltar para rascunho e inativar.

### ativo

o cliente em operação, e o único status que finaliza pedido sem configuração adicional. do ativo em diante não existe ação principal: bloquear e inativar acontecem pelo menu de mais ações.

### bloqueado

o cliente impedido de comprar por decisão da marca, normalmente por inadimplência ou suspensão comercial. somente cliente ativo aceita bloqueio, e a única saída é voltar para ativo.

o cliente bloqueado não abre pedido novo, e o pedido que já estava em andamento permanece no status em que estava. as duas situações admitem exceção configurada pela marca.

### inativo

o cliente fora de operação. nenhuma configuração libera pedido para cliente inativo, em nenhuma hipótese, e é isso que o separa do bloqueado. a volta passa por rascunho ou pendente, com nova ativação.

| status | cria pedido | finaliza pedido |
| - | - | - |
| rascunho | sim | não |
| pendente | sim | não |
| ativo | sim | sim |
| bloqueado | não | não |
| inativo | não | não |

## as exceções do cliente bloqueado

o bloqueio admite duas exceções, ligadas em **configurações** → **definições gerais**. as duas vêm desligadas e funcionam de forma independente.

a primeira libera a criação de pedido para um cliente que já está bloqueado, inclusive a cópia de um pedido anterior. com ela ligada, o bloqueio deixa de impedir o início da compra e continua valendo para a conclusão, a menos que a segunda também esteja ligada.

a segunda trata do pedido que já existia. ela permite que um pedido em andamento siga para a finalização, o envio e a sincronização quando o cliente é bloqueado no meio do caminho. sem ela, esse pedido fica parado até o cliente voltar a ativo.

a exceção existe apenas para o bloqueio. inativo não tem equivalente.

## a obrigatoriedade cresce com o status

os campos exigidos mudam conforme o status de destino. rascunho pede apenas localização, tipo do documento e nome. pendente e ativo passam a exigir também telefone e ao menos um endereço, e no Brasil somam tipo de pessoa, e-mail, CNPJ ou CPF e a razão social em pessoa jurídica. bloqueado repete a exigência de ativo.

por isso a validação acontece na transição, e não durante o preenchimento: é a mudança de status que revela o que ainda falta.

## cliente sincronizado

quando o cadastro está sincronizado com o sistema de gestão, a troca manual de status fica travada na plataforma. a mudança precisa vir do próprio sistema de gestão.

## avançar o cadastro

<Steps>
  <Step title="abra o cliente">
    acesse **clientes** e clique sobre o cliente na listagem.

    o botão de ação principal muda conforme o status: rascunho exibe **enviar para pendente**, pendente exibe **ativar**.
  </Step>

  <Step title="dispare a ação">
    clique no botão de ação principal e confirme.

    com o cadastro completo, o cliente muda de status imediatamente.
  </Step>

  <Step title="resolva as pendências">
    com campo faltando, as seções com pendência abrem, o erro fica visível na tela e os campos exigidos ganham marcação.

    preencha o que falta. o botão volta a liberar quando o cadastro atende ao status de destino.

    sair da tela ou recarregar a página cancela a ação e limpa o estado de erro. a ação precisa ser disparada novamente.
  </Step>
</Steps>

## revisar clientes em sequência

<Steps>
  <Step title="filtre a listagem">
    em **clientes**, selecione a aba do status a revisar.
  </Step>

  <Step title="abra o primeiro cliente">
    clique sobre o cliente. a navegação no topo mostra a posição dentro do conjunto filtrado.
  </Step>

  <Step title="avance pelo conjunto">
    revise, dispare a ação e use as setas do topo para ir ao próximo cliente.

    a navegação respeita o filtro de origem e troca todo o conteúdo da tela. o acesso por link salvo ou por busca global não tem conjunto de origem e não exibe as setas.
  </Step>
</Steps>

## bloquear e desbloquear

<Steps>
  <Step title="bloqueie o cliente">
    no menu de mais ações, selecione **bloquear** e confirme.
  </Step>

  <Step title="registre o motivo">
    opcional: abra o painel de detalhes e, em dados gerais, selecione o **motivo do bloqueio**.

    o campo fica disponível apenas com o cliente já bloqueado.
  </Step>

  <Step title="desbloqueie quando for o caso">
    no menu de mais ações, selecione **ativar**. o cliente volta a ativo e retoma a compra.
  </Step>
</Steps>

## inativar e reativar

no menu de mais ações, selecione **inativar**. a ação está disponível em rascunho, pendente e ativo.

para trazer o cliente de volta, selecione **voltar para pendente** ou **voltar para rascunho** e conduza o cadastro até a ativação.

## conteúdos relacionados

<div className="relacionados">
  <CardGroup cols={1}>
    <Card title="criar clientes" icon="file-lines" href="/docs/clientes/criar-um-cliente-v2" horizontal />

    <Card title="listagem de clientes" icon="file-lines" href="/docs/clientes/usar-a-listagem-de-clientes-v2" horizontal />
  </CardGroup>
</div>


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