Artículos de Importador
Configuración
Casos prácticos
GuíaNivel intermedio4 min de lecturaRevisado el
Ejecutar una importación de datos
Usa el asistente de importación para cargar un Excel o CSV, revisar la vista previa y enviar los registros a su destino.
El Importador carga datos masivos desde una planilla. Cada fila del archivo se convierte con un transformador y se envía a un destino. El Asistente de Importación te guía en tres pasos: elegir el esquema, cargar los datos y previsualizar.
En WeSyncro:ImportadorImportaciones
Antes de empezar#
Una importación combina cuatro piezas. Ten las tres primeras creadas antes de abrir el asistente.
| Pieza | Qué define | Dónde se crea |
|---|---|---|
| Esquema de datos | Qué columnas esperas en el archivo. | En el mismo asistente. Revisa esquemas de datos. |
| Transformador | Cómo se convierte cada fila al formato que espera el destino. | Importador > Transformadores. |
| Destino | A dónde se envía cada registro ya convertido. | Importador > Destinos. |
| Archivo | Los datos, con los nombres de columna en la primera fila. | Tu computador. |
Pasos#
Abre el asistente
En Historial de Importaciones haz clic en Nueva Importación.
Paso 1: elige esquema, transformador y destino
Bajo la pregunta "¿Qué tipo de datos deseas importar?":
- En Buscar esquema... selecciona el esquema. Si no existe, usa Crear nuevo esquema.
- En el selector de transformador elige el que corresponde a este archivo.
- En Destino de Datos elige a dónde se enviarán los registros.
El panel Esquema Seleccionado muestra los campos que se esperan. Haz clic en Continuar.
Paso 2: carga los datos
Bajo "Aporta los datos a procesar" tienes dos opciones:
- Subir Archivo Excel/CSV: acepta archivos
.xlsx,.xlsy.csv. Se lee solo la primera hoja del libro. - Pegar desde el Portapapeles: copia las celdas en Excel o Google Sheets, incluida la fila de títulos, y pégalas con este botón.
En ambos casos, la primera fila se toma como los nombres de las columnas.
- Subir Archivo Excel/CSV: acepta archivos
Paso 3: revisa la vista previa
Previsualización de Datos muestra las filas detectadas, de 50 en 50. Revisa que cada columna del esquema traiga datos.
Procesa
Haz clic en el botón Procesar N Registros. Verás "Importación registrada correctamente." y volverás al historial, donde puedes seguir el avance.
Cómo leer la vista previa#
| Lo que ves | Qué significa |
|---|---|
| Una columna del esquema con guiones | El archivo no trae una columna con ese nombre exacto. |
| Una columna marcada (Ignorada) | Está en el archivo pero no en el esquema. |
La vista previa compara nombres de columna tal como están escritos. Si tu esquema dice nombre_cliente y el archivo dice "Nombre Cliente", verás la primera con guiones y la segunda como ignorada.
Si algo no calza, usa Cambiar Archivo para volver al paso 2.
Qué pasa después de procesar#
- Se crea la importación con un nombre automático que incluye el transformador y el archivo.
- Cada fila se convierte con el transformador. Si la conversión falla, esa fila queda con error y el mensaje "Error en la transformación:" seguido del detalle.
- Las filas convertidas se envían al destino una por una. El avance se actualiza en vivo en el historial.
Recomendaciones para el archivo#
- Deja los títulos en la fila 1 y los datos desde la fila 2, sin filas vacías ni totales al final.
- Usa una sola hoja: las demás no se leen.
- Mantén los mismos títulos que usaste al crear el transformador, respetando mayúsculas, tildes y espacios.
- En cargas muy grandes, divide el archivo. La planilla se lee en tu navegador y se envía completa en una sola solicitud.
Problemas frecuentes#
"Error al registrar la importación."#
La importación no se pudo crear. La causa más común es no haber elegido transformador o destino en el paso 1. Vuelve atrás y selecciona ambos.
"Transformador no encontrado."#
El transformador elegido ya no existe o no pertenece a tu cuenta. Elige otro.
"Error al procesar el archivo Excel."#
El archivo no se pudo leer. Ábrelo, comprueba que la primera hoja tenga los datos y guárdalo de nuevo como .xlsx.
Cuando la lectura funciona verás un aviso con la cantidad de filas, por ejemplo "120 filas cargadas en memoria." Si el número es menor al que esperabas, revisa que no haya filas vacías intercaladas ni datos en otra hoja.
"El portapapeles está vacío."#
No hay nada copiado. Copia las celdas en tu planilla y vuelve a presionar el botón.
"Error al leer del portapapeles. Asegúrate de dar permisos al navegador."#
El navegador bloqueó el acceso al portapapeles. Acepta el permiso cuando lo pida o sube el archivo.
"No se proporcionaron registros para importar."#
El archivo solo tenía la fila de títulos. Agrega al menos una fila de datos.