# Matrículas e acessos

> O que é uma matrícula, o que cada status faz, até quando o acesso vale, como conceder uma entrega à mão, ajustar o acesso de um aluno, inativar e excluir.

A matrícula decide **se** o aluno abre um produto e **até quando**. Por exemplo: a Ana compra um curso de 1 ano e ganha uma matrícula que abre o curso por 1 ano. A matrícula não decide **quando** cada módulo abre; isso é o [conteúdo programado](https://help.cademi.cloud/pt/conteudo/conteudo-programado.md).

## A ideia em um minuto

Pense no curso como um prédio. A matrícula é a chave da porta do prédio.

- A **entrega** diz qual prédio a chave abre e por quanto tempo. Veja [Entregas](https://help.cademi.cloud/pt/vendas/entregas.md).
- A **matrícula** é a chave de um aluno. Ela guarda de onde veio, quando começou, o status e, se houver, um encerramento programado.
- O **acesso** é o resultado: o aluno abre o produto ou não, e até quando.

Um aluno pode ter várias chaves do mesmo prédio. A Cademí junta todas elas, o acesso gratuito e os ajustes que você fez para ele.

**A regra mais importante:** para saber se o aluno abre um produto, olhe a aba **Produtos** do perfil. A aba **Compras** mostra as chaves uma por uma; a aba **Produtos** mostra o resultado.

## De onde vem cada matrícula

| Origem | Quem cria | Quem controla | Como aparece em **Compras** |
|---|---|---|---|
| Venda | Uma compra avulsa aprovada no gateway | O gateway | Com o **ID Venda** |
| Assinatura | Um plano recorrente no gateway | O gateway | Com o **ID - ASSINATURA** |
| Manual | Você, pelo painel, uma importação ou uma integração | A conta | Com o selo **Entrega avulsa** |

- Cada venda e cada assinatura ganha a própria matrícula. Quem compra a mesma oferta duas vezes tem duas linhas em **Compras**.
- A matrícula manual é uma só por entrega. Se você concede a mesma entrega de novo, a Cademí usa a matrícula que já existe.

## O que cada status quer dizer

| Como aparece | O que quer dizer | O aluno abre o produto? | Como desfazer |
|---|---|---|---|
| **Ativo** | A matrícula conta | Sim, até o fim do acesso | Não se aplica |
| **Ativo**, mas vencida | O status é ativo e o acesso já acabou. Vencer não é um status: a Cademí calcula pelas datas | Não | Prorrogue: ajuste de tempo, encerramento mais tarde ou compra nova |
| **Inativo** | Desligada, mas guardada | Não. Exceção: um encerramento programado no futuro | Clique no status para ativar |
| **Cancelado** | Assinatura cancelada no gateway. O fim do período pago está marcado | Sim, até o fim do período pago. Veja em **Liberado até**, aba **Produtos** | Pelo gateway |
| Excluída | Só matrículas manuais | Não | Não há como restaurar |

O ciclo de uma matrícula na aba **Compras** fica assim. "Vencida" não é um status gravado: é o nome de uma matrícula ativa cujo acesso já acabou.

```mermaid
stateDiagram-v2
    accTitle: Status de uma matrícula
    accDescr: Uma matrícula começa ativa, por uma venda aprovada ou por Adicionar entrega. Ela pode ser inativada à mão ou por reembolso e atraso, e ativada de novo à mão ou por um pagamento aprovado. Quando o acesso acaba, ela continua ativa, mas vencida, até você prorrogar. Só uma entrega avulsa pode ser excluída, e a exclusão não se desfaz.
    state "Ativo" as Ativo
    state "Inativo" as Inativo
    state "Ativo, mas vencida" as Vencida
    state "Excluída" as Excluida
    [*] --> Ativo: Venda aprovada ou Adicionar entrega
    Ativo --> Inativo: Inativar, reembolso ou atraso
    Inativo --> Ativo: Ativar ou pagamento aprovado
    Ativo --> Vencida: O acesso acabou
    Vencida --> Ativo: Prorrogar
    Ativo --> Excluida: Excluir (só Entrega avulsa)
    Inativo --> Excluida: Excluir (só Entrega avulsa)
    Excluida --> [*]
```

O diagrama mostra o status. Se o aluno abre o produto, isso ainda depende das datas.

**Atenção: é aqui que mais acontece erro.** A Carla tem uma matrícula com encerramento programado para 30 de junho. Você inativa a matrícula em 10 de maio. Resultado: a Carla continua abrindo o curso até 30 de junho. Uma matrícula inativa com encerramento no futuro vale até essa data. É assim que uma assinatura cancelada mantém o período pago. Para fechar o acesso agora, inative a matrícula **e** remova o encerramento programado.

**O gateway vence o que você fez à mão.** Numa venda ou assinatura, o próximo evento do gateway decide. Um pagamento aprovado ativa a matrícula de novo e apaga o encerramento que você programou.

## Até quando o acesso vale

- A entrega dá a cada produto um acesso **vitalício** ou uma **duração**: horas, dias, semanas, meses ou anos. A duração conta do início da matrícula.
- Meses e anos seguem o calendário. Um mês a partir de 31 de janeiro acaba em 28 de fevereiro.
- Uma entrega de assinatura vale "enquanto pago". A duração dela não conta. O fim é a data que o gateway envia quando a assinatura é cancelada.
- Um **encerramento programado** por você vence tudo naquela matrícula: a duração da entrega, o ciclo do gateway e o vitalício.
- Um encerramento com data no passado fecha o acesso na hora, mesmo com o status ativo.

## Quando o aluno compra o mesmo produto mais de uma vez

- Vitalício vence qualquer duração.
- Se ele compra de novo **antes** do fim do acesso, o tempo novo se soma ao que falta. Renovar antes nunca perde dias.
- Se ele compra de novo **depois** do fim, começa um período novo. O tempo que sobrou não passa para o novo.
- Datas de fim fixas não se somam. Data de fim fixa é um encerramento programado ou o fim de uma assinatura. Vale a mais tarde.
- As regras de "abre N dias após a compra" contam sempre da primeira compra que ainda vale. Comprar de novo não fecha de novo um módulo que já abriu.

Quando duas compras cobrem o mesmo produto, o fim do acesso sai assim:

```mermaid
flowchart TD
    accTitle: Como várias compras viram um acesso
    accDescr: Se alguma compra é vitalícia, sem encerramento programado, o acesso é vitalício. Se não, e a compra nova chegou antes do fim do acesso, vale a data mais tarde quando alguma das duas tem data de fim fixa; sem data fixa, o tempo se soma. Se a compra nova chegou depois do fim, começa um período novo.
    vit{"Alguma é vitalícia, sem encerramento?"}
    vitalicio["Vitalício"]
    antes{"A nova chegou antes do fim?"}
    fixa{"Alguma tem data de fim fixa?"}
    tardia["Vale a data mais tarde"]
    soma["O tempo se soma"]
    novo["Começa um período novo"]
    vit -->|Sim| vitalicio
    vit -->|Não| antes
    antes -->|Sim| fixa
    antes -->|Não| novo
    fixa -->|Sim| tardia
    fixa -->|Não| soma
```

## Passo a passo

### Conceder uma entrega à mão

1. Abra o perfil do aluno.
2. Na lateral, no bloco de ações, clique em **Adicionar entrega**.
3. Em **Entrega**, escolha a entrega.
4. Clique em **Adicionar**.

A Cademí cria a matrícula manual, aplica as tags da entrega e avisa o aluno por e-mail.

**Atenção: conceder de novo não renova.** O Bruno tinha uma matrícula manual desta entrega, que já venceu. Você concede a mesma entrega de novo. A Cademí ativa a matrícula antiga, com a data de início original. Ele não recebe e-mail novo nem as tags de novo. O acesso continua vencido. Para dar mais tempo ao Bruno, use o ajuste por aluno (abaixo).

Entregas arquivadas não aparecem na lista. Se não há nada para escolher, a tela avisa que não há entregas novas para esse aluno.

### Inativar e ativar

1. Abra a aba **Compras** do perfil.
2. Clique no status da linha.

**Clique para inativar a compra** desliga a matrícula e guarda tudo. **Clique para ativar a compra** liga de novo, com a mesma data de início. Se a linha tem **Válido até** no futuro, o acesso continua até essa data.

### Programar um encerramento

1. Na aba **Compras**, abra o menu da linha.
2. Escolha **Programar encerramento**.
3. Em **Encerrar acesso em**, escolha a data e a hora. Deixe em branco para não ter data de encerramento.
4. Clique em **Salvar**.

A linha passa a mostrar **Válido até** com a data. Uma data no passado fecha o acesso na hora. Numa venda ou assinatura, o próximo pagamento aprovado apaga essa data. Para desfazer, abra a mesma janela e clique em **Remover encerramento**.

### Excluir uma matrícula manual

1. Na aba **Compras**, abra o menu de uma linha com o selo **Entrega avulsa**.
2. Escolha **Excluir**.
3. Confirme em **Excluir compra**.

O aluno perde o acesso a essa entrega. Só a **Entrega avulsa** pode ser excluída. Matrículas de venda ou assinatura não se excluem pelo painel: reembolso e cancelamento passam pelo gateway.

### Ajuste por aluno

A entrega e a programação valem para todos os compradores. Mas sempre aparece um aluno fora da regra. Um pede mais uns dias, outro entra atrasado na turma, outro precisa ver tudo de uma vez. O ajuste por aluno muda o acesso de um aluno a um produto, sem mexer na entrega. Ele fica na aba **Produtos** do perfil.

**Alterar tempo de acesso.** Abra o menu da linha do produto, ou clique na data em **Liberado até**. A janela mostra o **Acesso atual** e três saídas:

1. **Escolha uma data** final.
2. Libere como **Vitalício**.
3. Adicione anos, meses, semanas e dias ao fim atual.

A prévia **Novo acesso** mostra o resultado antes de salvar. Marque **Aplicar a todos os cursos do aluno** para usar a mesma duração em todos os produtos dele. Cada produto conta do próprio início. **Limpar customização** volta ao prazo da entrega.

- O ajuste conta do início do acesso do aluno, não de hoje. A tela faz essa conta por você.
- O ajuste só prorroga. Uma data antes do fim atual é recusada: "Escolha uma data depois de ... para estender o acesso". Para encurtar, programe um encerramento na matrícula.
- Num acesso vitalício, um ajuste com fim troca o vitalício por esse fim. O fim precisa ser no futuro.
- Um ajuste nunca dá acesso sozinho. Ele precisa de uma matrícula que ainda vale.

**Alterar cronograma de liberação.** Coloca esse aluno em outra programação do mesmo produto, como outra turma. **Definido na entrega** volta à programação padrão. O produto precisa ter programações para haver o que escolher.

**Liberação.** O selo da coluna troca entre **Programada** e **Imediata**. Em **Programada**, as regras valem. Em **Imediata**, as regras de tempo, data, prova e porcentagem não valem para esse aluno, nem a do certificado. Conteúdo oculto e "em breve" continua como está. Com algum produto em **Imediata**, a aba mostra o aviso **Conteúdo liberado imediatamente**.

**Excluir progresso.** Apaga todo o progresso do aluno nesse produto. Não dá para desfazer.

**Iniciar todos os acessos.** Cria o registro de acesso de cada produto que o aluno ainda não abriu. A linha passa a mostrar as datas e a aceitar as ações acima.

## O que o aluno vê

| Situação | Na área do aluno |
|---|---|
| Matrícula ativa, antes do fim do acesso | O produto abre |
| Acesso vencido ou encerramento no passado | O produto fica fechado, com **Encerrado em** e a data |
| Inativa sem data no futuro, excluída ou sem matrícula | O produto aparece fechado. Se estiver como "não listado", nem aparece |
| Regra do conteúdo programado ainda fechada | **Abre em** e a data, ou **Em breve** quando não há data |

## Bom saber

- **Excluir o aluno não exclui matrículas.** Elas ficam e voltam quando você restaura o aluno. Para fechar o acesso de quem tem matrícula manual, exclua a matrícula, ou inative e remova o encerramento.
- **Arquivar uma entrega.** Ela para de receber vendas novas e some de **Adicionar entrega**. Quem já tem a entrega continua com ela.
- **Reprocessar uma venda.** Não cria uma segunda matrícula nem prorroga duas vezes.
- **Recomeçar do zero.** Para um recomeço de verdade, com a programação de liberação recomeçando junto, exclua a matrícula e conceda de novo. Só uma matrícula nova ganha um início novo.
- **Cadastro gratuito da conta.** Ele não aparece em **Compras**: não é matrícula e não pode ser excluído. Ele segue a entrega gratuita de **Configurações > Alunos**.

## Perguntas frequentes

**Como dou mais 7 dias para um aluno?** Na aba **Produtos**, use **Alterar tempo de acesso** e adicione 7 dias. A prévia mostra a data nova. Não mude a entrega: ela vale para todos os compradores.

**O aluno pediu reembolso. Excluo a matrícula?** Não. Faça o reembolso no gateway. O aviso do gateway inativa a matrícula. As tags da compra continuam no aluno; tire-as à mão se algum grupo depende delas.

**Concedi a entrega de novo e o aluno continua sem acesso.** Ele já tinha uma matrícula manual vencida dessa entrega. Conceder de novo usa essa matrícula, com o início antigo. Prorrogue com **Alterar tempo de acesso** ou com um encerramento mais tarde.

**Inativei a matrícula e o aluno ainda abre o curso.** A matrícula tem um encerramento programado no futuro, e vale até ele. Remova o encerramento em **Programar encerramento**.

**Por que o acesso acaba antes do que eu esperava?** Veja **Liberado até** em **Produtos** e **Válido até** em **Compras**. Um encerramento programado vence a duração da entrega e o vitalício. Datas fixas não se somam a durações. Se o aluno comprou de novo depois do fim, o período começou do zero.

**O aluno não consegue acessar. Por onde começo?** O roteiro completo está em [Por que o aluno não consegue acessar](https://help.cademi.cloud/pt/alunos/por-que-o-aluno-nao-acessa.md).