Ventas recibidas
La pantalla Ventas > Ventas: cada comunicación del gateway, el estado de la venta y su efecto en el acceso, ventas con error y cómo reprocesar.
En Ventas → Ventas está todo lo que los gateways enviaron a tu Cademí: cada compra aprobada, cada renovación, cada cancelación y cada reembolso. Es la primera pantalla que debes abrir cuando un alumno dice que pagó y no entró.
La idea en un minuto
Piensa en esta pantalla como el seguimiento de un paquete. Cada línea es un aviso del gateway sobre una venta. Llamamos a cada aviso comunicación.
- Una compra al contado suele generar una comunicación (aprobada) y, si la hay, otra después (reembolso).
- Una suscripción genera varias a lo largo del tiempo: la adhesión, cada renovación, un atraso, la cancelación. Todas tienen el mismo ID de la recurrencia.
Cada línea tiene dos estados, uno al lado del otro:
- Estado de la venta es lo que dijo el gateway: Aprobada, Pendiente de pago, Atrasada, Reembolso, Cancelada y otros.
- Estado es lo que hizo la Cademí con la comunicación: Procesado (la aplicó), En cola (la va a aplicar) o Con error (no pudo aplicarla; el motivo está en los detalles).
El camino de una comunicación, desde la llegada hasta el resultado:
Carregando diagrama…
La regla más importante: solo En cola, Procesado y Con error aparecen en tu lista. Lo que se descarta no cambia ningún acceso.
Lo que hace cada estado de la venta con el alumno
| Estado de la venta | Lo que ocurre |
|---|---|
| Aprobada, Prueba | El acceso empieza o vuelve. Si el correo electrónico de la compra es nuevo, se crea el alumno. La renovación de una suscripción reactiva la misma matrícula. Se aplican las etiquetas de la entrega |
| Pendiente de pago, Pendiente de análisis, Expirada, Abandonada | Nada. En una venta única, la comunicación se descarta y no aparece en la lista: boleto y PIX solo aparecen cuando llega la aprobación, en una comunicación nueva. En una suscripción, la línea aparece y no cambia el acceso |
| Atrasada | El acceso se suspende. Si el gateway envió una fecha de fin, el acceso sigue hasta ella y después se detiene |
| Reembolso (incluye chargeback) | El acceso se suspende al momento. En una suscripción, una fecha de fin programada se borra: el período pagado no sobrevive a la devolución |
| Cancelada | En una venta única, el acceso se quita. En una suscripción, el alumno sigue con acceso hasta la fecha que el gateway envió en La suscripción finaliza el. Sin esa fecha, el acceso se detiene al momento |
En una suscripción, quien decide es el Estado de la suscripción (Activa, Atrasada, Cancelada), no el cobro aislado.
El reembolso, el atraso y la cancelación nunca quitan las etiquetas que el alumno recibió en la compra.
La Cademí no inventa un plazo de tolerancia. Suspende el acceso. Después de la suspensión, solo mantiene el acceso hasta una fecha que el propio gateway envió.
Cómo encontrar una venta
- Últimas, En Cola y Con error, encima de la lista, cambian lo que muestra. En Cola y Con error traen el conteo al lado.
- La búsqueda elige el campo en el propio control: Correo electrónico, Nombre, el documento del alumno (CPF o el documento que usa tu cuenta), ID de la venta o ID de la recurrencia.
- Usa el correo electrónico del comprador como vino del gateway.
- El filtro Gateway recorta la lista por los gateways que ya enviaron ventas.
Cada línea muestra:
- el gateway y el número de la comunicación;
- el Cliente: correo electrónico, nombre y documento;
- la Fecha: cuándo llegó y cuándo se actualizó;
- el Estado de la venta y el Estado.
El menú de la línea tiene Ver detalles, Reprocesar (o Forzar reprocesamiento, cuando ya está procesada) y Copiar #ID.
Detalles de la venta
Haz clic en la línea (o en Ver detalles) para abrir Detalles de la Venta. La ventana tiene dos pestañas.
Datos muestra:
- Recibido el, Estado de la venta, Gateway, ID de la venta;
- Oferta: la entrega que encontró la venta. Si la entrega se archivó después, Oferta muestra el nombre con "(eliminada)";
- Producto, ID del producto en el gateway, Valor, Método de pago;
- Cliente, el documento y el Correo electrónico;
- en una suscripción, también Estado de la suscripción, ID de la recurrencia y La suscripción finaliza el.
Payload muestra el contenido bruto que envió el gateway, como llegó. Copiar payload copia todo. Es lo que suele pedir el soporte del gateway.
Una compra puede tener más de un ítem (carrito, combo, order bump). En ese caso, la pestaña Datos lista los Ítems. Cada ítem muestra el producto, los identificadores que vinieron y Oferta: con la entrega que encontró. Un ítem que no encontró entrega aparece como Sin entrega. Un ítem de la lista de ignorados aparece como Ignorado.
Qué hacer con una venta Con error
Una venta Con error llegó a la Cademí, pero no se convirtió en acceso. Abre los detalles. El motivo aparece destacado arriba en la pestaña Datos. Los motivos más comunes, con el texto que muestra la pantalla:
| Lo que aparece | Qué hacer |
|---|---|
| Erro ao construir carga: Não existe nenhuma entrega configurada para o ID: (no existe ninguna entrega configurada para el ID) seguido del identificador que vino en la venta (o de más de uno, separados por comas). | Ninguna entrega de ese gateway tiene el identificador. Crea la entrega en Ventas → Entregas, o agrega el identificador a la entrega correcta, del mismo gateway. Después reprocesa la venta |
| El mismo mensaje en una venta con Ítems (carrito, combo, order bump) | El identificador citado es el del ítem sin entrega. Toda la venta falla, incluso los ítems que encontraron entrega. Si el ítem debe dar acceso, crea su entrega. Si no debe (un producto físico, un regalo que ya está en la oferta principal), pon el identificador en la lista de productos ignorados. Después reprocesa |
| Erro ao construir carga: Token invalido (token inválido) | El token que vino en la venta no coincide con el de ninguna entrega de ese gateway. Corrige el Token en la entrega, con el valor que muestra el gateway. Después reprocesa |
| Erro ao processar carga: Seu limite para novos usuários foi atingido. (se alcanzó tu límite de usuarios nuevos) | La cuenta llegó al límite de alumnos, y el comprador era nuevo. Libera un cupo o aumenta el límite de la cuenta. Después reprocesa |
Atención: aquí es donde ocurren más errores. Rui vende un curso en Hotmart con dos ofertas. La entrega tiene solo el identificador del producto. Hotmart envía el código de la oferta. La venta queda Con error, con el código de la oferta en el mensaje. Para resolverlo, compara el identificador del mensaje con el ID del producto de la entrega, letra por letra. Agrega el identificador que faltaba y reprocesa.
Lista de productos ignorados
Algunos productos vendidos en el gateway no deben liberar nada en la Cademí: un libro físico, una mentoría, un regalo que ya forma parte de la oferta. Para que su venta no quede con error, usa la lista de productos ignorados:
- Abre Ventas → Ventas → Con error.
- Haz clic en Lista de productos ignorados.
- En IDs de producto a ignorar, escribe los identificadores. Sepáralos con Enter o con comas; puedes pegar una lista completa.
- Haz clic en Guardar.
Atajo: en los detalles de una venta con error, cada identificador se convierte en un botón. Al hacer clic en él, se abre la lista con el identificador ya incluido. Solo confirmas.
La lista vale para toda la cuenta y para las ventas que lleguen después:
- una venta en la que todos los ítems están en la lista se descarta sin error y no aparece en tu lista de ventas;
- un ítem ignorado dentro de un carrito se salta, y los otros ítems siguen.
Reprocesar
Reprocesar devuelve la comunicación a la cola. La Cademí vuelve a leer lo que envió el gateway, vuelve a buscar las entregas y aplica el resultado. Úsalo después de corregir la entrega, el token o la lista de ignorados.
- En una venta ya Procesado, la opción se llama Forzar reprocesamiento. Hace lo mismo.
- El botón Reprocesar, arriba en la pantalla, reprocesa en lote. Con error devuelve a la cola las ventas con error. En Cola no cambia nada: lo que está en la cola ya se va a procesar.
Reprocesar no duplica la matrícula y no suma un segundo período. La Cademí encuentra la matrícula de esa venta o de esa suscripción, en lugar de crear otra. Reprocesar una venta Pendiente de pago sigue sin liberar nada.
Atención: reprocesa la comunicación que debe valer. Reprocesar una aprobación antigua después de un reembolso o una cancelación le devuelve el acceso al alumno, porque esa comunicación es una aprobación.
Para tener en cuenta
La misma comunicación repetida cuenta una vez.
Si el gateway reenvía la misma venta con el mismo estado, la Cademí no crea una segunda matrícula.
Al comprador se lo encuentra por el correo electrónico.
Si el correo electrónico es nuevo y la cuenta verifica el documento, la venta va al alumno más antiguo que ya tiene ese documento. La Cademí nunca une dos registros.
Un boleto cancelado antes de pagarse se descarta.
No aparece en la lista y no toca ningún acceso. La cancelación solo quita el acceso cuando existe un acceso de esa venta.
Acceso dado a mano.
Una compra suelta creada en Añadir entrega, en el perfil del alumno, la asume una venta real de la misma entrega. Desde ese momento, el gateway controla la matrícula, y un reembolso puede suspenderla.
La entrega muestra si las ventas están llegando.
En Ventas → Entregas, el bloque Conexión con la pasarela dice Última venta recibida o Ninguna venta recibida todavía. Si no llega nada, el problema está en la configuración del postback en el gateway, no en la Cademí.
Preguntas frecuentes
La venta está Procesado y el alumno dice que no tiene acceso. ¿Y ahora?
Sigue la guía de El alumno pagó y no tiene acceso. Revisa la entrega que encontró la venta, la matrícula en el perfil del alumno y el correo electrónico que está usando.
Cancelé la suscripción de un alumno en el gateway y sigue accediendo. ¿Es correcto?
Sí, si el gateway envió una fecha en La suscripción finaliza el. El alumno sigue con acceso hasta el fin del período que ya pagó. Sin la fecha, el acceso se detiene en el momento de la cancelación.
¿Qué es la Oferta en los detalles de la venta?
Es el nombre de la entrega que encontró la venta. Sin entrega, la venta queda con error.
El gateway dice que la venta está aprobada y no aparece aquí. ¿Por qué?
La comunicación de aprobación todavía no llegó, o llegó y está En Cola. En una venta única, las comunicaciones de pago pendiente (boleto, PIX) no entran en la lista: solo entra la aprobación. Busca por el ID de la venta para ver todas sus comunicaciones.
Corregí la entrega. ¿Tengo que hacer algo más?
Sí. Reprocesa la venta con error. La corrección de la entrega vale para las ventas nuevas; la venta que ya falló solo cambia cuando la reprocesas.
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.
El alumno pagó y no tiene acceso
Guía en orden para quien pagó y no entra: si la venta llegó o vino con error, si la entrega tiene el identificador, la matrícula y el correo de la compra.