Saltar al contenido principal

Importar miembros

Resumen rápido — añadir miembros en bloque desde un CSV

1. Configuración → Importar miembros → Descargar plantilla — el CSV preformateado con las cabeceras de columna requeridas.
2. Rellena el CSV en tu herramienta de hojas de cálculo. Usa la coma como delimitador; no renombres, elimines ni reordenes las cabeceras de columna.
3. De vuelta en Importar miembros, suelta el archivo rellenado en el área de carga.
4. Elige el Campo único — Email o Número de teléfono — para identificar a cada miembro.
5. Activa Validar registros, marca el reconocimiento de consentimiento y haz clic en Importar.
6. Abre Resultados para ver qué se cargó y qué dio error. Corrige las filas y vuelve a importar.

Esta es la página a la que recurres cuando tienes una lista de clientes existentes (de un sistema de fidelización anterior, una hoja de cálculo que sacó tu POS, una exportación de CRM) y quieres tenerlos a todos en la plataforma de una sola vez. Las altas individuales se hacen mediante el Formulario de registro o el flujo desde el POS — Importar miembros es la vía masiva.

Anatomía de la página​

La página tiene tres tarjetas plegables apiladas verticalmente: Descargar plantilla, Importar miembros, Resultados. Las recorres en orden.

Página de importar miembros con tres tarjetas plegadas: "Descargar plantilla — Descarga la plantilla y rellena los datos", "Importar miembros — Sube tu plantilla rellenada", "Resultados — Comprueba los resultados de tu importación". Cada tarjeta tiene un chevron para desplegarla.

Paso 1 — Descarga la plantilla​

Despliega la tarjeta Descargar plantilla y haz clic en el botón Descargar plantilla. La descarga es un CSV con todas las cabeceras de columna requeridas ya colocadas.

Tarjeta Descargar plantilla desplegada. Dentro hay una nota con borde azul que explica que la plantilla viene preformateada con las cabeceras de columna para todos los datos del miembro, y que debes usar la coma como delimitador y no alterar las cabeceras. Debajo de la nota hay un botón negro "Descargar plantilla".

Dos cosas que leer de la nota dentro de la app:

  • Usa una coma (,) como delimitador. Ni puntos y comas, ni tabuladores.
  • No renombres, elimines ni reordenes las cabeceras de columna. Son la forma en que el importador asigna tus datos en la plataforma.

Abre el CSV descargado en la herramienta de hojas de cálculo que prefieras y rellena las filas.

Paso 2 — Rellena el archivo (las reglas que importan)​

Las columnas son en su mayoría autoexplicativas (nombre, apellido, email, teléfono, etc.) pero unas pocas tienen reglas de formato que, si se omiten, causan fallos silenciosos o parciales. Lee esto una vez antes de rellenar:

Reglas de formato de campos — léelas antes de rellenar el CSV

Fecha de nacimiento. Usa YYYY-MM-DD. Ejemplo: 1976-04-28.

Número de teléfono. Incluye el código de país, sin signo +. Ejemplo para España: 34634555666 (el 34 es el código de país de España).

Etiquetas. Varias reglas:

  • Separa varias etiquetas con punto y coma: Gold;VIP;SummerPromo.
  • Usa solo letras inglesas estándar y números (A–Z, a-z, 0-9). Evita caracteres acentuados (ñ, á, é, í, ó, ç, etc.) y caracteres especiales (%, &, $, etc.).
  • Usa guiones bajos en lugar de espacios: Gold_Member, no Gold Member.

creditBalance está en céntimos (sea cual sea la unidad monetaria más pequeña para tu tenant). Un saldo de 7,89 EUR debe enviarse como 789.

termsOfUse y gdpr — ambas columnas deben estar presentes y establecidas en TRUE para cada fila. (Estás declarando ante el importador que el miembro ha aceptado ambos. La casilla de reconocimiento al final del paso de carga es tu reconocimiento formal de eso para toda la importación.)

allowSMS y allowEmail — ponlos en TRUE solo si el negocio tiene consentimiento de comunicación del miembro para ese canal. Si no tienes prueba del consentimiento, déjalos en FALSE. Establecerlos en TRUE sin consentimiento es una violación de cumplimiento.

Paso 3 — Sube el archivo rellenado​

Despliega la tarjeta Importar miembros. Suelta el CSV rellenado en el área de carga o haz clic en el área para abrir un selector de archivos.

Tarjeta Importar miembros desplegada. Lado izquierdo: una zona de arrastre grande etiquetada "Para seleccionar un archivo, suéltalo aquí o haz clic — No hay ningún archivo seleccionado". Lado derecho: un panel "Opciones" con un menú desplegable Campo único (vacío) y un interruptor Validar registros (activado por defecto). Debajo del panel: una casilla sin marcar "Reconozco que he obtenido todos los consentimientos y aprobaciones necesarios para llevar a cabo esta importación de datos", y un botón Importar deshabilitado.

Elige el Campo único​

Abre el menú desplegable Campo único y elige Email o Número de teléfono — el que tu club use como identificador único (coincide con el Identificador de inicio de sesión en Configuración general).

Menú desplegable Campo único abierto, mostrando dos opciones: Email (resaltado) y Número de teléfono.

El Campo único es lo que el importador usa para detectar duplicados: si el email (o el teléfono, según la elección) de una fila coincide con un miembro ya existente, esa fila actualiza el registro existente en lugar de crear uno nuevo.

Validar registros​

Deja el interruptor Validar registros activado (lo está por defecto). El validador comprueba cada fila respecto a las reglas de formato anteriores antes de que se escriba ningún dato — una fila con una fecha mal formateada o un campo requerido faltante queda señalada para que la corrijas.

Siempre haz clic en Validar antes de finalizar la importación. La validación es rápida; ejecutar una importación sin validar sobre un archivo mal formateado significa limpiar después.

Reconoce e importa​

Marca la casilla de consentimiento:

"Reconozco que he obtenido todos los consentimientos y aprobaciones necesarios para llevar a cabo esta importación de datos."

Haz clic en Importar. El importador procesa el archivo. Para importaciones grandes, esto puede llevar un momento.

Paso 4 — Revisa los resultados​

Despliega la tarjeta Resultados. Verás una tabla que enumera cada importación que has ejecutado, mostrando cada fila:

  • Nombre — nombre del archivo CSV importado.
  • Tamaño — tamaño del archivo.
  • Fecha — cuándo se ejecutó la importación.
  • Estado — Finalizado (o un estado de error si algo salió mal).
  • Descargar — vuelve a descargar el archivo.

Tarjeta Resultados desplegada. Tabla con columnas Nombre, Tamaño, Fecha, Estado, Descargar. Muchas filas visibles, cada una con un nombre de archivo CSV (enmascarado), tamaño de archivo, fecha y hora, estado "Finalizado", y un icono de descarga.

Si una fila reporta un estado de error o de éxito parcial, haz clic en ella para ver qué filas del CSV fallaron en la validación y por qué. Corrige esas filas en tu hoja de cálculo, guarda y vuelve a importar. Volver a importar el mismo archivo es seguro: los duplicados se detectan mediante la comprobación del Campo único; los registros existentes se actualizan en lugar de duplicarse.

Errores comunes​

5 cosas que comúnmente hacen tropezar a la gente
  • Los números de teléfono sin código de país fallan silenciosamente en la validación. Una fila con 634555666 (sin prefijo 34) para un miembro español será rechazada. Añade el código de país en tu hoja de cálculo antes de subirla.
  • Las unidades de creditBalance pillan a la gente. Son céntimos, no euros. Una columna que muestre 7.89 se cargará como 7,89 céntimos (esencialmente cero). Multiplica por 100 (o mueve el punto decimal dos posiciones a la derecha) antes de guardar.
  • Las etiquetas con caracteres acentuados fallan silenciosamente al aplicarse. La fila se importa, pero la etiqueta no se queda. Si has puesto etiquetas como Próximo o Año_Nuevo, no aparecerán en el miembro. Quita los acentos.
  • termsOfUse / gdpr dejados como FALSE bloquea el inicio de sesión. Los miembros importados con estas marcas en falso no pueden iniciar sesión en la web app de fidelización aunque existan en la base de datos. Establece ambos en TRUE para cada fila, y haz eso solo si realmente tienes el consentimiento — eso es lo que afirma la casilla de reconocimiento.
  • La elección de Campo único debe coincidir con el identificador real de tu club. Si tu club está configurado para usar Número de teléfono como Identificador de inicio de sesión, importa con Campo único = Número de teléfono. No coincidir hace que la detección de duplicados se comporte mal (creará filas nuevas en lugar de actualizar las existentes).