Saltar al contenido principal

Guía de mapeo de columnas

Después de leer esta página podrás leer la tabla Revisar la asignación de columnas en Configuración → Migración, entender cuáles de tus columnas asoció Agon, corregir una asociación incorrecta y gestionar las columnas que Agon no pudo ubicar, para clientes, membresías y clases.

Esta es una página complementaria del Resumen de la migración: empieza por ahí para conocer el flujo de importación completo.


Cómo asocia Agon tus columnas​

Antes de subir el archivo, eliges qué estás importando —Clientes, Membresías o Clases— en ¿Qué estás importando?. Esa elección decide a qué conjunto de campos de Agon se pueden asociar tus columnas; cada entidad tiene su propia lista de campos, tratada en su propia sección más abajo.

Cuando haces clic en Analizar archivo, Agon examina cada encabezado de columna de tu archivo e intenta alinearlo con uno de los campos de la entidad elegida. Los encabezados que coinciden de forma obvia con el nombre de un campo (por ejemplo email, Email, email_address) se asocian directamente; el resto se asocian interpretando el texto del encabezado (y, en columnas con mucho texto, también algunos valores de la propia columna, para distinguir encabezados como "Tipo" o "Plan"). Luego la tabla te muestra lo que decidió, con el mensaje "Hemos asociado cada columna de tu archivo con un campo de Agon".

En este punto no se importa nada. La asociación es solo una sugerencia de partida que revisas y ajustas antes de confirmar.


Campos de cliente​

Cada fila de la tabla de asignación tiene un menú desplegable Campo de Agon con estas opciones al importar Clientes:

OpciónQué hace
Nombre completoEl nombre del cliente. Si no hay ninguna columna asignada aquí, se usa el correo del cliente como nombre.
Correo electrónicoLa dirección de correo del cliente. Obligatorio: una fila sin correo se omite. Si el correo ya pertenece a un cliente en Agon, la fila se omite en lugar de sobrescribir ese cliente.
TeléfonoEl número de teléfono del cliente. Opcional.
Fecha de nacimientoLa fecha de nacimiento del cliente. Opcional. Usa YYYY-MM-DD.
NotasNotas libres sobre el cliente. Opcional.
Nombre de facturaciónEl nombre que aparecerá en las futuras facturas de este cliente, si es distinto de su nombre completo, por ejemplo el nombre de una empresa. Opcional.
Dirección de facturaciónLa dirección que aparecerá en las futuras facturas de este cliente. Opcional.
NIF/CIF / Número de IVAEl NIF/CIF o número de IVA del cliente, para sus futuras facturas. Opcional.
— no importar —Ignora esta columna. Sus valores no se importan.

El nombre de facturación, la dirección de facturación y el NIF/CIF o número de IVA solo se usan para las facturas que genera Agon después de importar el cliente: no cambian en nada la ejecución de la propia importación. Agon no importa las facturas históricas del cliente desde tu plataforma anterior; esas permanecen archivadas en el sistema antiguo, y la migración no intenta traerlas. Si un cliente debe aparecer correctamente en las facturas futuras (por ejemplo, una empresa a la que se factura, o un cliente cuyo país exige un NIF/número de IVA en la factura), rellena estos tres campos; si no, déjalos fuera.

Renombrar las columnas de tu archivo como alternativa​

Renombra tu encabezado aPara
full_nameEl nombre del cliente
emailLa dirección de correo del cliente
phoneEl número de teléfono del cliente
date_of_birthLa fecha de nacimiento del cliente
notesNotas libres sobre el cliente
billing_nameEl nombre de facturación para las futuras facturas de este cliente
billing_addressLa dirección de facturación para las futuras facturas de este cliente
tax_idEl NIF/CIF o número de IVA del cliente para sus futuras facturas

Pon las fechas de nacimiento en formato YYYY-MM-DD, por ejemplo 1990-01-15.


Campos de membresía​

Opciones ofrecidas al importar Membresías:

OpciónQué hace
Correo del clienteEl correo del cliente al que pertenece esta membresía. Obligatorio: el cliente ya debe existir en Agon (importa primero tus clientes). Una fila cuyo correo no coincida con ningún cliente en Agon se omite.
Tipo de membresíaEl nombre del tipo de membresía en Agon (por ejemplo, "Bono de 10 clases"). Obligatorio: se asocia por nombre a un tipo de membresía existente (las mayúsculas/minúsculas no importan, la ortografía sí). Si nada coincide, la fila se omite: crea primero el tipo de membresía en Agon (Membresías en el menú lateral izquierdo) y vuelve a importar.
Fecha de inicioCuándo empieza la membresía. Obligatorio. Usa YYYY-MM-DD.
Fecha de caducidadCuándo termina la membresía. Opcional. Usa YYYY-MM-DD. Una fecha ya pasada se importa igualmente, como membresía con estado caducada, no se descarta, para conservar tu historial.
Créditos restantesEl número de créditos restantes en la membresía. Opcional, solo números enteros.
— no importar —Ignora esta columna.

Renombrar las columnas de tu archivo como alternativa​

Renombra tu encabezado aPara
client_emailLa dirección de correo del cliente
membership_type_nameEl nombre del tipo de membresía en Agon
starts_atLa fecha de inicio de la membresía
expires_atLa fecha de caducidad de la membresía
credits_remainingLos créditos restantes de la membresía

Campos de clase​

Opciones ofrecidas al importar Clases:

OpciónQué hace
Nombre de la claseEl nombre de la clase (por ejemplo, "Yoga Flow"). Obligatorio. Se asocia por nombre a un tipo de clase existente en Agon: a diferencia de los tipos de membresía, si nada coincide, Agon crea automáticamente un tipo de clase nuevo usando la hora de inicio/fin (para su duración) y la capacidad de esa fila como valores por defecto, en lugar de omitir la fila. Esto es intencionado: una primera migración suele ser la llegada, por primera vez, de todo el catálogo de clases del estudio.
Fecha de inicioCuándo empieza la clase. Obligatorio. Usa YYYY-MM-DD HH:MM:SS. Una hora de inicio que no esté estrictamente en el futuro se omite: solo se importan las clases futuras.
Fecha de finCuándo termina la clase. Obligatorio. Usa YYYY-MM-DD HH:MM:SS.
CapacidadNúmero máximo de clientes que pueden reservar. Opcional, solo números enteros. Por defecto es 1 si se deja en blanco.
Nombre del instructorEl nombre del instructor. Opcional. Se asocia por nombre a un instructor existente en Agon. A diferencia de los campos anteriores, que no haya coincidencia no hace que se omita la fila: la clase se importa igualmente sin instructor, y asignas uno manualmente después desde la propia pantalla de edición de la clase.
— no importar —Ignora esta columna.

Renombrar las columnas de tu archivo como alternativa​

Renombra tu encabezado aPara
class_nameEl nombre de la clase
starts_atLa fecha y hora de inicio de la clase
ends_atLa fecha y hora de fin de la clase
capacityEl número máximo de reservas
instructor_nameEl nombre del instructor

Columnas que Agon no pudo asociar​

Una columna que Agon no pudo ubicar muestra una etiqueta sin asignar en la tabla.

Una columna que se deja como sin asignar se omite: sus datos no se importan. Ese es el resultado correcto para las columnas para las que Agon no tiene un campo, como ID internos de registro o etiquetas. (Al importar Clientes, una columna "Notes" no tiene por qué quedar sin asignar: asóciala al campo Notas de arriba si quieres que se importe.)

Si una columna sin asignar debería importarse, abre su menú desplegable y elige el campo correcto de la lista para la entidad que estás importando.


Corregir una asociación​

  1. Encuentra la fila en la tabla Revisar la asignación de columnas.
  2. Abre el menú desplegable de la columna Campo de Agon.
  3. Elige el campo correcto, o — no importar — para omitir la columna.
  4. Repite para cada fila que esté mal.
  5. Haz clic en Confirmar importación cuando toda la tabla esté bien.

Los encabezados que coinciden con los nombres propios de los campos de Agon (ver las tablas de renombrado de arriba, una por entidad) se asocian directamente, así que la tabla vuelve correcta. Después de renombrar, guarda el archivo y ejecuta Analizar archivo de nuevo.


¿Qué hacer si algo va mal?​

Una columna se asoció al campo equivocado Usa el menú desplegable Campo de Agon de esa fila para elegir el correcto. La asociación automática es solo una sugerencia, y los nombres de encabezado inusuales son fáciles de fallar.

Una columna que necesito muestra "sin asignar" Abre su menú desplegable y elige el campo al que pertenece. Las columnas sin asignar se omiten, así que no se importa nada de esa columna hasta que la asignes.

Dos de mis columnas contienen el mismo tipo de dato Solo una columna puede alimentar cada campo de Agon. Asigna la mejor y pon la otra en — no importar —, o combínalas en tu hoja de cálculo antes de subirla.

Mi archivo tiene más de una fila de encabezado, o celdas combinadas Agon espera una única fila de encabezado seguida de una fila por registro. Aplana las celdas combinadas y quita las filas de encabezado adicionales en tu hoja de cálculo, y vuelve a subirla.

Mi columna "Tipo de membresía" siempre vuelve como sin asignar, o no se encuentra el tipo El campo Tipo de membresía solo asocia un tipo de membresía existente por nombre; nunca crea uno. Comprueba que el nombre de tu archivo coincide exactamente con un tipo de membresía ya configurado en Agon (Membresías en el menú lateral izquierdo) y vuelve a ejecutar Analizar archivo. Esto es distinto de Nombre de la clase, más abajo, que crea automáticamente un tipo de clase cuando nada coincide.

Una fila de clase creó un tipo de clase que no esperaba Esto es lo esperado para Nombre de la clase: si el nombre no coincide con ningún tipo de clase existente en Agon, se crea automáticamente uno nuevo a partir de la hora de inicio/fin y la capacidad de esa fila, en lugar de omitirla. Renombra o combina los nombres de tipo de clase duplicados en tu archivo de origen antes de importar si quieres que se fusionen en un solo tipo de clase en Agon.

"Nombre del instructor" no parece importar Es opcional y nunca hace que se omita una fila de clase. Si no coincide exactamente con el nombre de un instructor en Agon, la clase se importa igualmente sin instructor: asigna uno manualmente después.

Páginas relacionadas​