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, oemail. - Un valor de puntos por fila. La columna
pointses 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 |
|---|---|---|
id_miembro | Condicional | El ID de miembro de RewardsWP. Úsalo al actualizar miembros existentes. |
id_usuario | 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. |
correo_electronico | Condicional | La dirección de correo electrónico del miembro. Coincide con un miembro existente por correo electrónico, o crea uno nuevo. |
nombre | No | El nombre del miembro. Recomendado para miembros nuevos. |
apellido | 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
puntosestablecido en500. 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-DDoYYYY-MM-DD HH:MM:SSpara las columnascreado_enyexpira_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.xlsxo.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 |
|---|---|
id_miembro | Actualiza al miembro existente con ese ID. Si no se encuentra ningún miembro, la fila se omite y se registra como un error. |
id_usuario | 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. |
correo_electronico | 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
Sí. Exporta tus datos del otro plugin como un CSV, luego reformatea las columnas para que coincidan con la plantilla de RewardsWP. El requisito clave es tener al menos un identificador (email suele ser el más fácil de emparejar) y un valor de points para cada fila.
RewardsWP empareja la fila con el miembro existente con esa dirección de correo electrónico y añade los puntos como una nueva entrada en su historial. No creará un miembro duplicado.
El límite de tamaño de archivo depende de la configuración PHP de tu servidor (específicamente los ajustes upload_max_filesize y post_max_size). La mayoría de los entornos de alojamiento permiten al menos 2 MB, lo que es suficiente para decenas de miles de filas. Si tu archivo es demasiado grande, intenta dividirlo en lotes más pequeños.
¡Eso es todo! La herramienta de importación facilita la incorporación de miembros y saldos de puntos de cualquier fuente.