For the complete documentation index, see llms.txt. This page is also available as Markdown.

Entrega masiva de beneficios

Importe un archivo con las personas a las que va a entregar un beneficio: el sistema valida el inventario, descuenta las unidades y envía los documentos por correo automáticamente, sin necesidad de un radicado por cada persona.

¿Qué es la entrega masiva?

La entrega masiva le permite entregar un beneficio a muchas personas de una sola vez. Usted importa un archivo CSV con los datos de las personas o entidades, indica cuántas unidades recibe cada una, y el sistema:

  1. Valida que el archivo esté correcto y que haya inventario suficiente.

  2. Descuenta las unidades del inventario del producto.

  3. Asigna a cada persona sus documentos PDF.

  4. Envía un correo a cada persona con sus documentos adjuntos.

A diferencia del flujo por formulario, aquí no se genera un radicado ni se requiere aprobación: quien ejecuta la entrega es el responsable del módulo.

Ejemplo. Su empresa compró 200 boletas de cine para el Día de la Familia y va a entregar 2 a cada uno de sus 100 asociados. En lugar de aprobar 100 solicitudes una por una, importa el listado y el sistema envía los 100 correos con sus 2 boletas cada uno.

Antes de empezar

Para poder ejecutar una entrega masiva necesita, desde la pestaña Productos:

  • Un producto activo que tenga marcada la opción de documento por unidad.

  • Los documentos PDF cargados en el punto de redención desde el que va a entregar.

  • Unidades disponibles suficientes en el inventario del producto.

Cómo acceder

  1. Ingrese al módulo Beneficios (ruta /beneficios).

  2. Abra la pestaña Entregas masivas.

  3. Haga clic en Nueva entrega.

La pestaña muestra el histórico de todas las entregas realizadas, con su producto, punto de redención, cantidad de personas, enviados, errores y estado.

El archivo CSV

Columnas requeridas

Columna
Obligatoria
Descripción

cedula

Número de identificación. Solo dígitos, máximo 15.

nombre

Nombre de la persona o entidad. Aparece en el saludo del correo.

correo

Dirección a la que se envían los documentos.

celular

No

Número de contacto. Se guarda con la entidad.

Los nombres de las columnas no distinguen mayúsculas ni tildes, y se aceptan estas variantes:

  • cedula, identificacion, documento, nit, cc

  • nombre, nombres, nombre completo

  • correo, email, correo electronico, mail

  • celular, telefono, movil, numero

Ejemplo

Validaciones del archivo

Al cargar el archivo, el sistema revisa fila por fila:

  • Que la cédula esté presente, contenga dígitos y no supere 15 caracteres.

  • Que la cédula no esté repetida dentro del mismo archivo.

  • Que el nombre esté presente.

  • Que el correo tenga un formato válido.

Paso a paso

1

Producto y punto de redención

Seleccione el beneficio que va a entregar y el punto de redención del que se tomarán los documentos PDF.

Al elegirlos, el asistente muestra dos indicadores que conviene revisar antes de seguir:

  • Unidades disponibles del producto: el saldo del inventario.

  • Documentos PDF libres en el punto: cuántos archivos sin asignar quedan en ese punto.

Estos dos números son independientes y pueden diferir. El primero es el contador de inventario del producto; el segundo cuenta los PDF realmente cargados y disponibles. Para poder entregar, ambos deben alcanzar.

2

Cargue el archivo

Seleccione o arrastre el archivo CSV. El sistema lo lee, valida los registros y muestra la vista previa.

En la columna Entidad verá, para cada persona:

  • Existe: la cédula ya está registrada como entidad en su empresa.

  • Se creará: la cédula no existe y se creará automáticamente con el nombre, el correo y el celular del archivo.

Las entidades que ya existen no se modifican: el sistema respeta la información que usted ya tiene registrada y solo crea las que faltan.

3

Defina la cantidad

Indique cuántas unidades recibe cada persona. La cantidad es la misma para todo el lote (entre 1 y 50).

El asistente calcula las unidades requeridas (personas × cantidad) y las compara contra los dos inventarios. Si no alcanza, muestra exactamente cuánto falta y no permite continuar:

Inventario insuficiente. Faltan 5 documento(s) PDF en el punto de redención (hay 5).

Para resolverlo puede reducir la cantidad por persona, cargar más documentos PDF en el punto o dividir la entrega en varios lotes.

4

Ejecute la entrega

Revise el resumen (producto, punto, personas, unidades por persona y total a entregar) y haga clic en Ejecutar entrega.

El proceso avanza por bloques y muestra una barra de progreso con el número de correos enviados y de errores.

Qué hace el sistema con cada persona

Cada persona se procesa de forma independiente: si una fila falla, las demás continúan normalmente.

Estados

Estado del lote

Estado
Significado

Validado

El lote se creó pero aún no se ha ejecutado.

En proceso

La entrega está en curso o quedó a medias.

Completado

Todas las personas recibieron su beneficio.

Completado con errores

La entrega terminó, pero algunas filas fallaron.

Cancelado

El lote se anuló antes de ejecutarse.

Estado de cada persona

Estado
Significado
Qué pasó con el inventario

Pendiente

Aún no se ha procesado.

No se ha descontado.

Enviado

Recibió su correo con los documentos.

Descontado.

Error de asignación

No se pudo reservar el beneficio (por ejemplo, se agotaron los PDF del punto).

No se descontó nada.

Error de envío

El beneficio quedó asignado pero el correo no pudo enviarse.

Ya se descontó.

Después de la entrega

Desde la pestaña Entregas masivas, el botón Ver detalle abre el resultado del lote persona por persona, con su estado, el número de intentos, la observación del error y la fecha de envío.

Acción
Cuándo aparece
Qué hace

Reanudar

Cuando quedan personas pendientes.

Continúa el proceso donde se quedó.

Reintentar fallidos

Cuando hay filas con error.

Vuelve a procesar solo las que fallaron.

Exportar resultados

Siempre.

Descarga el detalle completo en CSV para archivar o auditar.

Cancelar

Solo si el lote no se ha ejecutado.

Anula el lote.

El correo que recibe la persona

Cada persona recibe un solo correo con el asunto "Beneficio asignado – <nombre del producto>", que incluye el logo de su empresa, el nombre del beneficio, la cantidad asignada y los documentos PDF adjuntos.

El envío de estos correos no tiene costo adicional y no consume créditos de su plan.

Límites y consideraciones

Aspecto
Límite

Registros por archivo

1.000

Tamaño del archivo

2 MB

Unidades por persona

Entre 1 y 50

Los correos se envían de forma espaciada para respetar los límites del servicio de correo, por lo que un lote grande puede tardar varios minutos.

Preguntas frecuentes

¿Se genera un radicado por cada persona? No. La entrega masiva no crea radicados ni solicitudes. La trazabilidad queda en el detalle del lote y en la pestaña Movimientos del módulo.

¿Puedo entregar cantidades distintas a cada persona? No en un mismo lote: la cantidad es única para todo el archivo. Si necesita cantidades distintas, cree un lote por cada cantidad.

¿Qué pasa si una persona aparece dos veces en el archivo? El sistema lo reporta como error de cédula duplicada y no permite ejecutar el lote hasta que corrija el archivo.

¿Puedo usar un producto sin documentos PDF? No. La entrega masiva solo lista productos con documento por unidad, porque el PDF es lo que se adjunta al correo.

Cerré el navegador a la mitad, ¿perdí la entrega? No. El lote queda en estado En proceso; abra Ver detalle y presione Reanudar para terminarlo.

¿Cómo sé a quién se le entregó qué? En el detalle del lote, con opción de exportar a CSV. Los movimientos de inventario también quedan registrados en la pestaña Movimientos del módulo de Beneficios.

Última actualización