# Entregas

> Lo que una entrega concede a quien compra: productos, tiempo de acceso, programación de liberación y etiquetas. Crea, duplica y archiva entregas.

La entrega une lo que vendes en el gateway con lo que el alumno recibe en tu Cademí. Dice qué productos recibe el alumno, por cuánto tiempo, con qué programación de liberación y con qué etiquetas. La entrega no cobra nada: el pago ocurre en el gateway.

## La idea en un minuto

La entrega está en medio del camino, entre la venta y el alumno.

- **De un lado, la venta.** Llega del gateway y trae el identificador del producto en el gateway.
- **En el medio, la entrega.** Une ese identificador con lo que recibe el alumno y dice por cuánto tiempo, con qué programación de liberación y con qué etiquetas.
- **Del otro lado, los productos.** Son lo que recibe el alumno, uno por uno o por vitrina completa.

Cuando llega una venta, la Cademí busca la entrega con el mismo identificador y crea la **matrícula** del alumno en ella. La matrícula es el alumno dentro de la entrega.

**La regla más importante:** la matrícula no guarda una copia de la entrega. Mira la entrega cada vez. Si cambias la entrega, cambias el acceso de todos los alumnos que ya entraron por ella. Por eso, un grupo nuevo del mismo curso pide una entrega nueva, y no la edición de la actual.

## Cómo una venta se convierte en acceso

La Cademí no le cobra a nadie. El pago ocurre en el gateway (Hotmart, Kiwify, Eduzz, Stripe y otros). El gateway avisa a la Cademí de cada venta por la **URL de Postback** de la entrega. La Cademí lee el identificador del producto que vino en la venta, encuentra la entrega que tiene ese identificador y crea la matrícula del alumno.

Cada entrega tiene estas partes:

| Parte de la entrega | Lo que tú defines |
|---|---|
| **Modalidad de Venta** | **Venta única** o **Suscripción** |
| **Contenido entregado** | Los productos que recibe el alumno: productos elegidos uno por uno, una vitrina completa, un grupo de vitrinas o la plataforma completa |
| **Tiempo de Acceso** | Por producto, en una venta única: acceso vitalicio o una duración en horas, días, semanas, meses o años |
| **Liberación** | La programación de liberación que sigue cada producto, cuando el producto tiene una |
| **Etiquetas** | Las etiquetas que recibe el alumno al entrar por esta entrega |
| **Conexión con la pasarela** | El **ID del producto**, el **Token** (en algunos gateways) y la **URL de Postback** |

### Un identificador, una entrega

- La venta encuentra la entrega por el identificador exacto, en ese gateway. Las mayúsculas y las minúsculas cuentan. Una parte del identificador no vale por el identificador completo.
- Una entrega puede tener varios identificadores: el producto, la oferta, el plan. Cualquiera de ellos concede el mismo paquete.
- Cada identificador solo puede estar en una entrega activa por gateway. Para que dos ofertas concedan cosas diferentes, necesitas dos entregas.

### Sin entrega, sin acceso

Si la venta llega con un identificador que ninguna entrega tiene, queda registrada con error y no libera nada. Después de crear o corregir la entrega, reprocesa la venta en [Ventas > Ventas](/es/vendas/vendas-recebidas).

El camino de una venta hasta la matrícula:

```mermaid
flowchart TD
    accTitle: De la venta a la matrícula
    accDescr: El gateway envía la venta por la URL de Postback. Si el identificador no está en una entrega activa de ese gateway, la venta queda con error y no se libera nada; después de corregir la entrega, reprocesa. Si está, el alumno se encuentra por el correo electrónico o se crea, y la matrícula en la entrega libera el contenido entregado, con el tiempo de acceso, la liberación y las etiquetas.
    venda["Venta en el gateway"]
    id{"¿Identificador en una entrega<br/>activa de este gateway?"}
    erro["Venta con error<br/>no se libera nada"]
    aluno["Alumno encontrado por el correo<br/>o creado"]
    mat["Matrícula en la entrega"]
    rec["Contenido entregado, Tiempo de Acceso,<br/>Liberación y Etiquetas"]
    venda -->|URL de Postback| id
    id -->|No| erro
    erro -->|Corregir la entrega y reprocesar| id
    id -->|Sí| aluno
    aluno --> mat
    mat --> rec
    classDef destaque stroke:#ff005c,stroke-width:2px
    class mat destaque
```

La matrícula apunta a la entrega: lo que recibe el alumno es siempre lo que la entrega dice ahora.

## Cómo la Cademí encuentra al alumno de la venta

Antes de crear la matrícula, la Cademí busca si el comprador ya tiene registro en tu cuenta. Así, la misma persona no recibe dos registros, y el acceso no va a un registro con el que el alumno no entra.

```mermaid
flowchart TD
    accTitle: Cómo la Cademí encuentra al alumno de la venta
    accDescr: Primero la Cademí busca un alumno con el correo electrónico de la compra. Si no lo encuentra, busca un alumno con el mismo documento, como el CPF. Si encuentra uno de los dos, usa ese registro; si hay más de uno, el más antiguo. Si no encuentra ninguno y la venta está aprobada, crea el alumno; si la venta no está aprobada, no se crea nada. Con el alumno definido, si ya tiene la matrícula de esta venta, de esta suscripción o una dada a mano en esta entrega, la Cademí actualiza esa matrícula; si no, crea una nueva.
    email{"¿Correo ya registrado?"}
    doc{"¿CPF ya registrado?"}
    usa["Usa ese registro"]
    aprovada{"¿Venta aprobada?"}
    cria["Crea el alumno"]
    nada["No se crea nada"]
    mat{"¿La matrícula ya existe?"}
    atualiza["Actualiza esa matrícula"]
    nova["Crea la matrícula"]
    email -->|Sí| usa
    email -->|No| doc
    doc -->|Sí| usa
    doc -->|No| aprovada
    aprovada -->|Sí| cria
    aprovada -->|No| nada
    usa --> mat
    mat -->|Sí| atualiza
    mat -->|No| nova
    cria --> nova
    classDef destaque stroke:#ff005c,stroke-width:2px
    class usa destaque
```

1. **El correo electrónico va primero.** Es con él que el alumno entra al área del alumno. Entonces el acceso va al registro donde él lo va a buscar. La comparación ignora las mayúsculas y los espacios.
2. **El documento va después.** La Cademí solo busca por el documento cuando el correo electrónico de la compra todavía no tiene registro. Esto cubre el caso común de quien compra de nuevo con otro correo electrónico, o con el correo electrónico mal escrito. La compra va al registro que la persona ya tiene, en lugar de crear un segundo. Los puntos y los guiones del CPF no cuentan.
3. **Más de un registro con el mismo correo electrónico o documento.** Vale el más antiguo, que concentra el historial del alumno.
4. **Ningún registro encontrado.** Una venta aprobada crea el alumno, con el nombre, el correo electrónico, el teléfono y el documento que vinieron del gateway. Una comunicación que no aprueba nada (una cancelación, un pago pendiente) no crea a nadie. Si la cuenta llegó al límite de alumnos, la venta queda con error.
5. **La matrícula tampoco se repite.** La misma venta, la misma suscripción o una entrega dada a mano al alumno se actualiza, y no se duplica. Una compra nueva de la misma oferta es una matrícula nueva. Así es como los períodos se suman.

La Cademí nunca une dos registros que ya existen. Algunas cuentas permiten varios registros con el mismo documento (una configuración que hace el soporte de la Cademí). En ellas, la búsqueda por el documento no ocurre: un correo electrónico nuevo siempre crea un alumno nuevo.

## Lo que recibe el alumno: Contenido entregado

El bloque **Contenido entregado** muestra tu plataforma en árbol. La primera línea, **Acceso completo a todos los productos**, entrega la plataforma completa. Debajo vienen las vitrinas (y los grupos de vitrinas), cada una con sus productos.

- Activar un producto entrega solo ese producto.
- Activar una vitrina entrega todos sus productos, incluso los que agregues a ella después. Los productos de la vitrina quedan cubiertos y pierden su propio interruptor.
- Activar **Acceso completo a todos los productos** entrega todo, incluso los productos creados después.

El resumen de la izquierda dice lo que la entrega está entregando: **Entrega la plataforma completa.**, **Entregando** 3 productos en 1 vitrina, o **Ningún contenido seleccionado todavía.**

Para encontrar un elemento en el árbol:

- **Filtrar vitrinas y productos** busca por el nombre;
- **Solo los entregados** muestra solo lo que está activado;
- **Contraer vitrinas** esconde los productos de dentro de las vitrinas.

**Atención: aquí es donde ocurren más errores.** La cobertura vale en vivo. La matrícula del alumno apunta a la entrega y no guarda una copia de la lista de productos. Carla vende el "Curso de Inglés" al grupo de marzo. En junio, abre un grupo nuevo y agrega un curso de regalo en la misma entrega. Resultado: el grupo de marzo también recibe el regalo. Agregar o quitar un producto de la entrega cambia el acceso de todos los alumnos que ya entraron por ella. Para evitarlo, crea una entrega nueva para el grupo nuevo.

## Por cuánto tiempo: Venta única o Suscripción

### Venta única

- Cada producto activado muestra la columna **Tiempo de Acceso**. Viene como **acceso vitalicio**.
- Déjalo así o elige una cantidad de horas, días, semanas, meses o años.
- El tiempo cuenta desde el inicio de la matrícula.
- Los meses y los años siguen el calendario: un mes desde el 31 de enero termina el 28 de febrero.

### Suscripción

- La columna **Tiempo de Acceso** no aparece.
- El acceso dura mientras el gateway informa la suscripción pagada.
- En caso de cancelación o atraso, el gateway define el fin del acceso.
- Cualquier duración que tuviera la entrega se ignora.

### En las dos modalidades

El acceso se quita automáticamente cuando el gateway informa una cancelación o un reembolso. En una suscripción cancelada, el acceso se quita en la fecha de fin que envíe el gateway.

Algunos gateways solo trabajan con suscripción: en ellos, **Modalidad de Venta** aparece fija en **Suscripción**. Otros gateways no tienen suscripción, y la opción no aparece.

## Cuándo abre cada clase: Liberación

Un producto que tiene una programación de liberación registrada muestra el selector **Liberación** en su línea.

- Elige ahí qué programación siguen los alumnos de esta entrega para ese producto.
- Dejarlo en blanco mantiene la liberación predeterminada del producto.
- El selector aparece incluso cuando el producto está cubierto por una vitrina activada.

La programación es compartida entre las entregas que la usan. Editar la programación cambia el calendario de todas ellas.

## Etiquetas

En **Etiquetas**, elige las etiquetas que recibe el alumno al entrar por esta entrega. Puedes crear una etiqueta nueva ahí mismo, con el selector. Ya nace seleccionada, y el vínculo se guarda cuando guardas la entrega.

Las etiquetas se aplican en el momento de la venta. Cambiar las etiquetas de la entrega vale para las ventas siguientes, no para quien ya compró. A diferencia de los productos, las etiquetas no valen en vivo.

Para aplicar las etiquetas actuales a quien ya entró, usa **Agregar a los alumnos que ya tienen esta Entrega**, en la edición de la entrega. La acción:

- agrega las etiquetas que faltan a todos los alumnos con acceso activo por esta entrega;
- nunca quita etiquetas;
- deja fuera a los alumnos con el acceso inactivo (reembolsados, cancelados).

**Atención:** aplicar etiquetas a todos los alumnos es retroactivo y masivo. No se puede deshacer de una sola vez.

## Conexión con la pasarela

El bloque **Conexión con la pasarela** tiene lo que la Cademí recibe del gateway y lo que el gateway recibe de la Cademí:

- **ID del producto**: los identificadores que el gateway da a cada producto u oferta. Algunos gateways le dan otro nombre a este campo. Pega uno o varios.
- **Token**: en algunos gateways, la clave que valida las ventas recibidas. Si ya registraste el token en otra entrega, elígelo en **Usar un token ya registrado**.
- **URL de Postback**: la dirección que pegas en el gateway, en la configuración de webhook o postback. Es por ella que cada venta llega a la Cademí.

El botón **Instrucciones** abre el paso a paso del gateway. Dónde encontrar el identificador y dónde pegar la URL en cada gateway está en [Gateways de pago](/es/vendas/gateways).

Después de la primera venta, el bloque muestra **Última venta recibida** con la fecha, o **Ninguna venta recibida todavía**. Si la última venta llegó con error, el bloque avisa y ofrece **Ver las ventas con error**.

## Paso a paso: crear una entrega

1. En el panel, abre **Ventas > Entregas**.
2. Haz clic en **Nueva Entrega**.
3. En **Seleccione un Gateway**, elige la plataforma por donde vendes. La pantalla agrupa los gateways en **Recientes** (los que tu cuenta ya usa), **Principales** y **Otros**. También tiene una búsqueda por el nombre. Si tu gateway no aparece, usa **Ponte en contacto**.
4. En **Nombre de la Entrega**, dale un nombre que te ayude a reconocerla después. El nombre del producto o de la oferta en el gateway suele bastar.
5. En **Modalidad de Venta**, elige **Venta única** o **Suscripción**, según el producto en el gateway.
6. En **Etiquetas**, elige las etiquetas que recibe el alumno. Este paso es opcional.
7. En **Conexión con la pasarela**, pega el **ID del producto** y, si lo hay, el **Token**.
8. Copia la **URL de Postback** y pégala en el gateway.
9. En **Contenido entregado**, activa los productos o las vitrinas que libera la venta.
10. En cada producto activado, define el **Tiempo de Acceso** (venta única) y, si la hay, la **Liberación**.
11. Haz clic en **Guardar ahora**, en la barra inferior.

No se guarda nada a medias. La entrega solo se guarda cuando la guardas, con todo lo que está en la pantalla. Si falta un campo obligatorio (nombre, modalidad, identificador o token), la pantalla señala el campo.

La entrega no se guarda en dos casos:

- el identificador ya está en otra entrega activa del mismo gateway. El mensaje dice que ya existe una oferta con ese ID del producto;
- el identificador es de suscripción y ya estuvo en una entrega archivada. No se puede reutilizar.

## La lista de entregas

En **Ventas > Entregas**:

- la búsqueda acepta nombre, gateway o ID del producto;
- los filtros **Gateway** y **Tipo** recortan la lista;
- cada línea muestra el gateway, el nombre, el identificador, la columna **Accesos** y el tipo (**Venta única** o **Suscripción**);
- **Accesos** dice cuántos accesos ya dio la entrega, con la proporción de activos.

Una entrega sin ningún producto activado aparece con el aviso **Sin accesos configurados**. Sus ventas se procesan, pero el alumno no recibe ningún producto.

**¿Cómo funcionan las Entregas?** vuelve a abrir el diagrama que explica la entrega como el punto de distribución de tu contenido.

## Duplicar, archivar y restaurar

### Duplicar

- **Duplicar** crea una copia con el mismo contenido, los mismos tiempos de acceso, las mismas programaciones y las mismas etiquetas. El nombre recibe "(Copia)".
- La copia nace **sin** el ID del producto y sin el Token. Así, no encuentra ninguna venta antes de que la completes.
- Las programaciones son las mismas de la original. Un grupo nuevo con calendario propio necesita una programación nueva en la copia.

### Archivar

**Archivar** saca la entrega de uso:

- deja de procesar ventas nuevas;
- ya no se puede conceder a un alumno a mano;
- los accesos ya entregados no cambian;
- los reembolsos y las cancelaciones que lleguen después todavía encuentran la matrícula.

La entrega va a **Archivadas**, en la esquina de la lista.

### Restaurar

**Restaurar**, dentro de **Archivadas**, trae la entrega de vuelta. Vuelve a procesar las ventas recibidas. Restaurar falla si otra entrega activa del mismo gateway pasó a usar el mismo ID del producto.

### Para dejar de vender una oferta

Para dejar de vender una oferta y mantener a los alumnos que ya tienen acceso, archiva la entrega. No revoques los accesos. No reutilices el identificador de una suscripción en una entrega nueva.

## Para tener en cuenta

- **Entrega gratuita de la cuenta.** En **Configuraciones > Alumnos > Registro gratuito**, el campo **Entrega liberada después del registro** elige la entrega que recibe quien se registra gratis. Ese acceso no aparece entre las compras del alumno y sigue la configuración actual de la entrega.
- **Réplica.** Una entrega sincronizada desde la cuenta de origen aparece con el sello **Réplica** y se abre solo para lectura. Se edita en la cuenta de origen.
- **Producto en borrador.** Sigue cerrado para el alumno, aunque esté cubierto por la entrega. Publicar el producto no da acceso. La entrega no libera borradores.
- **Acceso sin venta.** Para dar una entrega a un alumno sin compra, usa **Añadir entrega** en el perfil del alumno. Después, una venta real de la misma entrega asume esa matrícula y pasa a controlarla.

## Preguntas frecuentes

**¿Puedo usar el mismo ID del producto en dos entregas?** No. Cada identificador pertenece a una entrega activa por gateway. Si dos ofertas deben conceder cosas diferentes, registra el identificador de cada oferta en su entrega.

**Cambié la entrega. ¿Afecta a quien ya compró?** Productos, tiempo de acceso y programación, sí: la matrícula lee la entrega en vivo. Etiquetas, no: se aplican en la venta. Para quien ya compró, las etiquetas solo cambian con **Agregar a los alumnos que ya tienen esta Entrega**.

**Vendo un año de acceso. ¿Uso venta única o suscripción?** Venta única, con **Tiempo de Acceso** de 1 año. La suscripción es para el acceso que acompaña el pago y termina cuando el gateway avisa. Una duración en una entrega de suscripción se ignora.

**Voy a abrir un grupo nuevo del mismo curso. ¿Qué hago?** Duplica la entrega (o crea una). Pon en ella el identificador de la oferta nueva. Si el calendario es otro, pon también una programación nueva. Editar la entrega o la programación del grupo actual cambia el grupo actual también.

**Llegó una venta y el alumno no recibió nada. ¿Por dónde empiezo?** Mira si la venta encontró una entrega. Sin entrega, la venta queda con error y no libera nada. La guía completa está en [El alumno pagó y no tiene acceso](/es/vendas/pagou-e-nao-tem-acesso).