Importación de miembros y puntos

La herramienta de importación de RewardsWP te permite introducir miembros y saldos de puntos desde un archivo CSV. Ya sea que migres desde otro plugin de fidelización, incorpores una lista de clientes existente o apliques un crédito de puntos masivo, el flujo de trabajo de importación en tres pasos se encarga del trabajo pesado. Después de leer esta guía, sabrás cómo preparar tu CSV, mapear columnas, procesar la importación y solucionar cualquier error.

Antes de empezar

La herramienta de importación está disponible en todos los planes de RewardsWP. Para acceder a ella, navega a RewardsWP » Herramientas en tu administrador de WordPress. La pestaña Importar está seleccionada por defecto.

Antes de empezar, asegúrate de tener:

• Un archivo CSV con los datos de tus miembros y puntos. Si aún no tienes uno, descargarás una plantilla en el siguiente paso.
• Al menos un identificador por fila para que RewardsWP sepa a qué miembro acreditar. Los identificadores válidos son member_id, user_id, o email.
• Un valor de puntos por fila. La columna points es obligatoria para cada importación.

Descarga la plantilla y prepara tu CSV

Haz clic en el botón Descargar CSV de ejemplo en la pestaña Importar para obtener un archivo CSV preformateado. El archivo descargado se llama rewardswp-points-import-template-{FECHA}.csv (donde {FECHA} es la fecha de hoy) e incluye las 16 columnas disponibles como encabezados.

Columnas disponibles

Columna	Requerido	Descripción
member_id	Condicional	El ID de miembro de RewardsWP. Úsalo al actualizar miembros existentes.
user_id	Condicional	El ID de usuario de WordPress. Vincula al miembro con una cuenta de WordPress existente, o crea un nuevo miembro si no se encuentra una coincidencia.
email	Condicional	La dirección de correo electrónico del miembro. Coincide con un miembro existente por correo electrónico, o crea uno nuevo.
first_name	No	El nombre del miembro. Recomendado para miembros nuevos.
last_name	No	El apellido del miembro. Recomendado para miembros nuevos.
codigo_referencia	No	Un código de referencia personalizado para el miembro.
estado	No	El estado del miembro (p. ej., activo, excluido).
puntos	Sí	La cantidad de puntos a añadir. Cada fila crea una entrada de puntos separada.
tipo	No	El tipo de transacción de puntos.
tipo_fuente	No	De dónde proceden los puntos (p. ej., compra, manual).
id_fuente	No	Un ID que vincula los puntos a una fuente específica (p. ej., un ID de pedido).
estado_puntos	No	El estado de la entrada de puntos (p. ej., aprobado, pendiente).
creado_en	No	La fecha en que se creó la entrada de puntos. Recomendado para importaciones históricas.
expira_en	No	Cuándo caducan los puntos.
nota_publica	No	Una nota visible para el miembro en su registro de actividad. Recomendado para mayor claridad.
nota_interna	No	Una nota solo para administradores. No visible para los miembros.

Debe haber al menos una columna de identificador (id_miembro, id_usuario o email) presente junto con la columna requerida puntos. Puede incluir cualquier combinación de las columnas opcionales.

Preparando tus datos

Abre la plantilla en una aplicación de hoja de cálculo y rellena tus datos. Algunos consejos:

• Una fila por entrada de puntos. Si necesitas dar a un miembro 500 puntos como un único saldo, usa una fila con puntos establecido en 500. Si quieres importar su historial completo con múltiples transacciones, usa una fila por transacción.
• Usa identificadores consistentes. Elige un tipo de identificador (el correo electrónico suele ser el más fácil) y úsalo de forma consistente en todas las filas.
• Formato de fecha. Usa YYYY-MM-DD o YYYY-MM-DD HH:MM:SS para las columnas creado_en y expira_en.
• Guarda como CSV. Asegúrate de que tu hoja de cálculo se exporte como un archivo estándar .csv (valores separados por comas), no como .xlsx o .xls.

Subir y asignar columnas

En la pestaña Importar, carga tu archivo CSV usando el selector de archivos o el área de arrastrar y soltar. RewardsWP valida el archivo (se requiere formato CSV) y lee las cabeceras de las columnas.

Mapeo de columnas

Después de la carga, aparece una interfaz de mapeo de columnas. RewardsWP detecta automáticamente qué columnas CSV corresponden a qué campos de importación utilizando las cabeceras de las columnas. Cada mapeo muestra un nivel de confianza:

Confianza	Qué significa
Segura	La cabecera de la columna es una coincidencia exacta o casi exacta. No se necesita ninguna acción.
Moderada	La cabecera es una coincidencia parcial. Revisa el mapeo para confirmar que es correcto.
Baja	RewardsWP no pudo hacer coincidir esta columna con confianza. Deberás mapearla manualmente usando el menú desplegable.

Revisa cada mapeo y usa los menús desplegables para corregir los que no se hayan emparejado. Las columnas no emparejadas se omiten durante la importación.

Previsualiza tus datos

Después del mapeo, una ventana modal de vista previa muestra una muestra de tus datos con los mapeos aplicados. Revisa la vista previa para confirmar que los valores han llegado a las columnas correctas antes de continuar.

Revisar y procesar la importación

Una vez que estés satisfecho con el mapeo de columnas y la vista previa, haz clic en el botón para iniciar la importación. RewardsWP procesa el archivo en lotes de 50 registros por solicitud, por lo que verás un indicador de progreso que rastrea el recuento mientras trabaja en tu archivo.

Cómo maneja RewardsWP cada fila

La lógica de importación depende del identificador que hayas proporcionado:

Identificador proporcionado	Qué sucede
member_id	Actualiza al miembro existente con ese ID. Si no se encuentra ningún miembro, la fila se omite y se registra como un error.
user_id	Busca un miembro vinculado a ese usuario de WordPress. Si se encuentra, actualiza a ese miembro. Si no se encuentra, crea un nuevo miembro vinculado al usuario.
email	Busca un miembro con esa dirección de correo electrónico. Si se encuentra, actualiza a ese miembro. Si no se encuentra, crea un nuevo miembro con ese correo electrónico.

Cuando hay varios identificadores presentes en una sola fila, `member_id` tiene prioridad, seguido de `user_id`, luego `email`.

Cada fila en el CSV crea una entrada de puntos separada en el historial del miembro. Si una fila incluye campos opcionales como `first_name`, `last_name` o `referral_code`, esos valores también se aplican al registro del miembro.

Después de la importación

Cuando finalice la importación, verás un resumen que muestra el total de registros procesados, el número de éxitos y el número de fallos.

Si alguna fila falló, haz clic en **Descargar informe de errores** para obtener un archivo CSV que enumere cada fila fallida con el motivo por el que se omitió. Las razones comunes incluyen:

• Falta el valor de la columna requerida `points`
• No hay identificador válido (`member_id`, `user_id` o `email`) en la fila
• `member_id` no coincide con ningún miembro existente
• Formato de fecha no válido en `created_at` o `expires_at`

Puedes corregir los problemas en el CSV del informe de errores y volver a importar solo las filas fallidas.

Tras una importación exitosa, navega a RewardsWP » Miembros para verificar que tus miembros y saldos de puntos importados aparecen correctamente.

Preguntas frecuentes

---

¡Eso es todo! La herramienta de importación facilita la incorporación de miembros y saldos de puntos de cualquier fuente.