# Entregas

> O que uma entrega concede a quem compra: produtos, tempo de acesso, programação de liberação e tags. Criar, duplicar e arquivar em Vendas > Entregas.

A entrega liga o que você vende no gateway ao que o aluno recebe na sua Cademí. Ela diz quais produtos o aluno recebe, por quanto tempo, com qual programação de liberação e com quais tags. A entrega não cobra nada: o pagamento acontece no gateway.

## A ideia em um minuto

A entrega fica no meio do caminho, entre a venda e o aluno.

- **De um lado, a venda.** Ela chega do gateway e traz o identificador do produto no gateway.
- **No meio, a entrega.** Ela liga esse identificador ao que o aluno recebe e diz por quanto tempo, com qual programação de liberação e com quais tags.
- **Do outro lado, os produtos.** São o que o aluno recebe, um a um ou por vitrine inteira.

Quando uma venda chega, a Cademí procura a entrega com o mesmo identificador e cria a **matrícula** do aluno nela. A matrícula é o aluno dentro da entrega.

**A regra mais importante:** a matrícula não guarda uma cópia da entrega. Ela olha a entrega toda vez. Se você muda a entrega, muda o acesso de todos os alunos que já entraram por ela. Por isso, uma turma nova do mesmo curso pede uma entrega nova, e não a edição da atual.

## Como uma venda vira acesso

A Cademí não cobra ninguém. O pagamento acontece no gateway (Hotmart, Kiwify, Eduzz, Stripe e outros). O gateway avisa a Cademí de cada venda pela **URL de Postback** da entrega. A Cademí lê o identificador do produto que veio na venda, encontra a entrega que tem esse identificador e cria a matrícula do aluno.

Cada entrega tem estas partes:

| Parte da entrega | O que você define |
|---|---|
| **Modalidade de Venda** | **Venda única** ou **Assinatura** |
| **Conteúdo entregue** | Os produtos que o aluno recebe: produtos escolhidos um a um, uma vitrine inteira, um grupo de vitrines ou a plataforma completa |
| **Tempo de Acesso** | Por produto, numa venda única: acesso vitalício ou uma duração em horas, dias, semanas, meses ou anos |
| **Liberação** | A programação de liberação que cada produto segue, quando o produto tem uma |
| **Tags** | As tags que o aluno recebe ao entrar por esta entrega |
| **Conexão com o gateway** | O **ID do Produto**, o **Token** (em alguns gateways) e a **URL de Postback** |

### Um identificador, uma entrega

- A venda encontra a entrega pelo identificador exato, naquele gateway. Maiúsculas e minúsculas contam. Um pedaço do identificador não vale pelo identificador inteiro.
- Uma entrega pode ter vários identificadores: o produto, a oferta, o plano. Qualquer um deles concede o mesmo pacote.
- Cada identificador só pode estar em uma entrega ativa por gateway. Para duas ofertas concederem coisas diferentes, você precisa de duas entregas.

### Sem entrega, sem acesso

Se a venda chega com um identificador que nenhuma entrega tem, ela fica registrada com erro e não libera nada. Depois de criar ou corrigir a entrega, reprocesse a venda em [Vendas > Vendas](https://help.cademi.cloud/pt/vendas/vendas-recebidas.md).

O caminho de uma venda até a matrícula:

```mermaid
flowchart TD
    accTitle: Da venda à matrícula
    accDescr: O gateway envia a venda pela URL de Postback. Se o identificador não está numa entrega ativa desse gateway, a venda fica com erro e nada é liberado; depois de corrigir a entrega, reprocesse. Se está, o aluno é encontrado pelo e-mail ou criado, e a matrícula na entrega libera o conteúdo entregue, com o tempo de acesso, a liberação e as tags.
    venda["Venda no gateway"]
    id{"Identificador numa entrega<br/>ativa deste gateway?"}
    erro["Venda com erro<br/>nada é liberado"]
    aluno["Aluno encontrado pelo e-mail<br/>ou criado"]
    mat["Matrícula na entrega"]
    rec["Conteúdo entregue, Tempo de Acesso,<br/>Liberação e Tags"]
    venda -->|URL de Postback| id
    id -->|Não| erro
    erro -->|Corrigir a entrega e reprocessar| id
    id -->|Sim| aluno
    aluno --> mat
    mat --> rec
    classDef destaque stroke:#ff005c,stroke-width:2px
    class mat destaque
```

A matrícula aponta para a entrega: o que o aluno recebe é sempre o que a entrega diz agora.

## Como a Cademí encontra o aluno da venda

Antes de criar a matrícula, a Cademí procura se o comprador já tem cadastro na sua conta. Assim, a mesma pessoa não ganha dois cadastros, e o acesso não vai para um cadastro em que o aluno não entra.

```mermaid
flowchart TD
    accTitle: Como a Cademí encontra o aluno da venda
    accDescr: Primeiro a Cademí procura um aluno com o e-mail da compra. Se não acha, procura um aluno com o mesmo documento, como o CPF. Achando um dos dois, usa esse cadastro; com mais de um, o mais antigo. Se não acha nenhum e a venda está aprovada, cria o aluno; se a venda não está aprovada, nada é criado. Com o aluno definido, se ele já tem a matrícula desta venda, desta assinatura ou uma dada à mão nesta entrega, a Cademí atualiza essa matrícula; senão, cria uma nova.
    email{"E-mail já cadastrado?"}
    doc{"CPF já cadastrado?"}
    usa["Usa esse cadastro"]
    aprovada{"Venda aprovada?"}
    cria["Cria o aluno"]
    nada["Nada é criado"]
    mat{"Matrícula já existe?"}
    atualiza["Atualiza essa matrícula"]
    nova["Cria a matrícula"]
    email -->|Sim| usa
    email -->|Não| doc
    doc -->|Sim| usa
    doc -->|Não| aprovada
    aprovada -->|Sim| cria
    aprovada -->|Não| nada
    usa --> mat
    mat -->|Sim| atualiza
    mat -->|Não| nova
    cria --> nova
    classDef destaque stroke:#ff005c,stroke-width:2px
    class usa destaque
```

1. **O e-mail vem primeiro.** É com ele que o aluno entra na área do aluno. Então o acesso vai para o cadastro em que ele vai procurar. A comparação ignora maiúsculas e espaços.
2. **O documento vem depois.** A Cademí só procura pelo documento quando o e-mail da compra ainda não tem cadastro. Isso pega o caso comum de quem compra de novo com outro e-mail, ou com o e-mail digitado errado. A compra vai para o cadastro que a pessoa já tem, em vez de criar um segundo. Pontos e traços do CPF não contam.
3. **Mais de um cadastro com o mesmo e-mail ou documento.** Vale o mais antigo, que concentra o histórico do aluno.
4. **Nenhum cadastro encontrado.** Uma venda aprovada cria o aluno, com o nome, o e-mail, o telefone e o documento que vieram do gateway. Uma comunicação que não aprova nada (um cancelamento, um pagamento pendente) não cria ninguém. Se a conta chegou ao limite de alunos, a venda fica com erro.
5. **A matrícula também não se repete.** A mesma venda, a mesma assinatura ou uma entrega dada à mão ao aluno é atualizada, e não duplicada. Uma compra nova da mesma oferta é uma matrícula nova. É assim que os períodos se somam.

A Cademí nunca junta dois cadastros que já existem. Algumas contas permitem vários cadastros com o mesmo documento (uma configuração feita pelo suporte da Cademí). Nelas, a busca pelo documento não acontece: um e-mail novo sempre cria um aluno novo.

## O que o aluno recebe: Conteúdo entregue

O bloco **Conteúdo entregue** mostra a sua plataforma em árvore. A primeira linha, **Acesso completo a todos os produtos**, entrega a plataforma completa. Abaixo vêm as vitrines (e os grupos de vitrines), cada uma com os seus produtos.

- Ligar um produto entrega só aquele produto.
- Ligar uma vitrine entrega todos os produtos dela, inclusive os que você incluir nela depois. Os produtos da vitrine ficam cobertos e perdem o interruptor próprio.
- Ligar **Acesso completo a todos os produtos** entrega tudo, inclusive os produtos criados depois.

O resumo à esquerda diz o que a entrega está entregando: **Entrega a plataforma completa.**, **Entregando** 3 produtos em 1 vitrine, ou **Nenhum conteúdo selecionado ainda.**

Para achar um item na árvore:

- **Filtrar vitrines e produtos** busca pelo nome;
- **Só os entregues** mostra apenas o que está ligado;
- **Recolher vitrines** esconde os produtos de dentro das vitrines.

**Atenção: é aqui que mais acontece erro.** A cobertura vale ao vivo. A matrícula do aluno aponta para a entrega e não guarda uma cópia da lista de produtos. A Carla vende o "Curso de Inglês" para a turma de março. Em junho, ela abre uma turma nova e inclui um curso bônus na mesma entrega. Resultado: a turma de março também ganha o bônus. Incluir ou tirar um produto da entrega muda o acesso de todos os alunos que já entraram por ela. Para evitar isso, crie uma entrega nova para a turma nova.

## Por quanto tempo: Venda única ou Assinatura

### Venda única

- Cada produto ligado mostra a coluna **Tempo de Acesso**. Ela vem como **acesso vitalício**.
- Mantenha assim ou escolha uma quantidade de horas, dias, semanas, meses ou anos.
- O tempo conta a partir do início da matrícula.
- Meses e anos seguem o calendário: um mês a partir de 31 de janeiro termina em 28 de fevereiro.

### Assinatura

- A coluna **Tempo de Acesso** não aparece.
- O acesso dura enquanto o gateway informa a assinatura paga.
- Em caso de cancelamento ou atraso, o gateway define o fim do acesso.
- Qualquer duração que a entrega tivesse é ignorada.

### Nas duas modalidades

O acesso é removido automaticamente quando o gateway informa cancelamento ou reembolso. Numa assinatura cancelada, a remoção acontece na data de fim que o gateway enviar.

Alguns gateways só trabalham com assinatura: neles, **Modalidade de Venda** aparece fixa em **Assinatura**. Outros gateways não têm assinatura, e a opção não aparece.

## Quando cada aula abre: Liberação

Um produto que tem programação de liberação cadastrada mostra o seletor **Liberação** na linha dele.

- Escolha ali qual programação os alunos desta entrega seguem para esse produto.
- Deixar em branco mantém a liberação padrão do produto.
- O seletor aparece mesmo quando o produto está coberto por uma vitrine ligada.

A programação é compartilhada entre as entregas que a usam. Editar a programação muda o calendário de todas elas.

## Tags

Em **Tags**, escolha as tags que o aluno recebe ao entrar por esta entrega. Você pode criar uma tag nova ali mesmo, pelo seletor. Ela já nasce selecionada, e o vínculo é gravado quando você salva a entrega.

As tags são aplicadas no momento da venda. Mudar as tags da entrega vale para as vendas seguintes, não para quem já comprou. Ao contrário dos produtos, as tags não valem ao vivo.

Para aplicar as tags atuais a quem já entrou, use **Aplicar tags em todos os alunos**, na edição da entrega. A ação:

- adiciona as tags que faltam a todos os alunos com acesso ativo por esta entrega;
- nunca remove tag;
- deixa de fora os alunos com o acesso inativo (reembolsados, cancelados).

**Atenção:** aplicar tags em todos os alunos é retroativo e em massa. Não dá para desfazer de uma vez.

## Conexão com o gateway

O bloco **Conexão com o gateway** tem o que a Cademí recebe do gateway e o que o gateway recebe da Cademí:

- **ID do Produto**: os identificadores que o gateway dá para cada produto ou oferta. Alguns gateways chamam este campo de outro nome. Cole um ou vários.
- **Token**: em alguns gateways, a chave que valida as vendas recebidas. Se você já cadastrou o token em outra entrega, escolha-o em **Usar um token já cadastrado**.
- **URL de Postback**: o endereço que você cola no gateway, na configuração de webhook ou postback. É por ele que cada venda chega até a Cademí.

O botão **Instruções** abre o passo a passo do gateway. Onde achar o identificador e onde colar a URL em cada gateway está em [Gateways de pagamento](https://help.cademi.cloud/pt/vendas/gateways.md).

Depois da primeira venda, o bloco mostra **Última venda recebida** com a data, ou **Nenhuma venda recebida ainda**. Se a última venda chegou com erro, o bloco avisa e oferece **Ver as vendas com erro**.

## Passo a passo: criar uma entrega

1. No painel, abra **Vendas > Entregas**.
2. Clique em **Nova Entrega**.
3. Em **Selecione um Gateway**, escolha a plataforma por onde você vende. A tela agrupa os gateways em **Recentes** (os que a sua conta já usa), **Principais** e **Outros**. Ela também tem uma busca pelo nome. Se o seu gateway não aparece, use **Entre em contato**.
4. Em **Nome da Entrega**, dê um nome que ajude a reconhecê-la depois. O nome do produto ou da oferta no gateway costuma bastar.
5. Em **Modalidade de Venda**, escolha **Venda única** ou **Assinatura**, conforme o produto no gateway.
6. Em **Tags**, escolha as tags que o aluno recebe. Este passo é opcional.
7. Em **Conexão com o gateway**, cole o **ID do Produto** e, se houver, o **Token**.
8. Copie a **URL de Postback** e cole no gateway.
9. Em **Conteúdo entregue**, ligue os produtos ou as vitrines que a venda libera.
10. Em cada produto ligado, defina o **Tempo de Acesso** (venda única) e, se houver, a **Liberação**.
11. Clique em **Salvar agora**, na barra do rodapé.

Nada é salvo pela metade. A entrega só é gravada quando você salva, com tudo o que está na tela. Se faltar um campo obrigatório (nome, modalidade, identificador ou token), a tela aponta o campo.

A entrega não salva em dois casos:

- o identificador já está em outra entrega ativa do mesmo gateway. A mensagem diz que já existe uma oferta com esse ID de Produto;
- o identificador é de assinatura e já esteve numa entrega arquivada. Ele não pode ser reaproveitado.

## A lista de entregas

Em **Vendas > Entregas**:

- a busca aceita nome, gateway ou ID do produto;
- os filtros **Gateway** e **Tipo** recortam a lista;
- cada linha mostra o gateway, o nome, o identificador, a coluna **Acessos** e o tipo (**Venda única** ou **Assinatura**);
- **Acessos** diz quantos acessos a entrega já deu, com a proporção de ativos.

Uma entrega sem nenhum produto ligado aparece com o aviso **Sem acessos configurados**. As vendas dela são processadas, mas o aluno não recebe produto nenhum.

**Como funcionam as Entregas?** reabre o diagrama que explica a entrega como o ponto de distribuição do seu conteúdo.

## Duplicar, arquivar e restaurar

### Duplicar

- **Duplicar** cria uma cópia com o mesmo conteúdo, os mesmos tempos de acesso, as mesmas programações e as mesmas tags. O nome ganha "(Cópia)".
- A cópia nasce **sem** o ID do Produto e sem o Token. Assim, ela não encontra nenhuma venda antes de você preenchê-la.
- As programações são as mesmas da original. Uma turma nova com calendário próprio precisa de uma programação nova na cópia.

### Arquivar

**Arquivar** tira a entrega de uso:

- ela deixa de processar novas vendas;
- ela não pode mais ser concedida a um aluno à mão;
- os acessos já entregues não mudam;
- reembolsos e cancelamentos que chegarem depois ainda encontram a matrícula.

A entrega vai para **Arquivadas**, no canto da lista.

### Restaurar

**Restaurar**, dentro de **Arquivadas**, traz a entrega de volta. Ela volta a processar as vendas recebidas. Restaurar falha se outra entrega ativa do mesmo gateway passou a usar o mesmo ID de Produto.

### Para parar de vender uma oferta

Para parar de vender uma oferta e manter os alunos que já têm acesso, arquive a entrega. Não revogue os acessos. Não reaproveite o identificador de uma assinatura numa entrega nova.

## Bom saber

- **Entrega gratuita da conta.** Em **Configurações > Alunos > Cadastro gratuito**, o campo **Entrega liberada após o cadastro** escolhe a entrega que quem se cadastra de graça recebe. Esse acesso não aparece entre as compras do aluno e segue a configuração atual da entrega.
- **Réplica.** Uma entrega sincronizada da conta de origem aparece com o selo **Réplica** e abre só para leitura. Ela se edita na conta de origem.
- **Produto em rascunho.** Continua fechado para o aluno, mesmo coberto pela entrega. Publicar o produto não dá acesso. A entrega não libera rascunho.
- **Acesso sem venda.** Para dar uma entrega a um aluno sem compra, use **Adicionar entrega** no perfil do aluno. Depois, uma venda real da mesma entrega assume essa matrícula e passa a controlá-la.

## Perguntas frequentes

**Posso usar o mesmo ID de Produto em duas entregas?** Não. Cada identificador pertence a uma entrega ativa por gateway. Se duas ofertas devem conceder coisas diferentes, cadastre o identificador de cada oferta na entrega dela.

**Mudei a entrega. Quem já comprou é afetado?** Produtos, tempo de acesso e programação, sim: a matrícula lê a entrega ao vivo. Tags, não: elas são aplicadas na venda. Para quem já comprou, as tags só mudam com **Aplicar tags em todos os alunos**.

**Vendo um ano de acesso. Uso venda única ou assinatura?** Venda única, com **Tempo de Acesso** de 1 ano. Assinatura é para o acesso que acompanha o pagamento e termina quando o gateway avisa. Uma duração numa entrega de assinatura é ignorada.

**Vou abrir uma turma nova do mesmo curso. O que faço?** Duplique a entrega (ou crie uma). Coloque nela o identificador da oferta nova. Se o calendário for outro, coloque também uma programação nova. Editar a entrega ou a programação da turma atual muda a turma atual junto.

**Uma venda chegou e o aluno não recebeu nada. Por onde começo?** Veja se a venda encontrou uma entrega. Sem entrega, a venda fica com erro e não libera nada. O roteiro completo está em [O aluno pagou e não tem acesso](https://help.cademi.cloud/pt/vendas/pagou-e-nao-tem-acesso.md).