Saltar al contenido principal

Importar y exportar datos

Al principio cargarás registros a mano desde el formulario. Pronto vas a querer:

  • Traer datos desde una planilla Excel que ya tienes (importar).
  • Descargar un listado para procesarlo, compartirlo o respaldarlo (exportar).

Ambas operaciones están disponibles en el listado de cualquier tabla.

Exportar​

En la barra superior del listado, click en "Exportar" (o el ícono ⬇️). Puedes elegir el formato:

  • CSV — texto plano, universalmente compatible.
  • Excel (.xlsx) — formato de Microsoft Excel.
  • PDF — para imprimir o compartir con estilo.

Se descarga lo que estás viendo en ese momento: si filtraste, se exportan solo los registros filtrados; si buscaste, solo los que matchearon.

Qué columnas se exportan​

Se exportan las columnas que están visibles en el listado. Si necesitas exportar todos los campos, activa temporalmente la visibilidad de esas columnas desde el módulo, o usa la API REST.

Importar desde CSV​

Preparar el archivo CSV​

  • Primera fila: nombres de las columnas (deben coincidir con los alias de las columnas de tu tabla).
  • Filas siguientes: los datos.
  • Codificación: UTF-8 (Excel a veces guarda en Latin-1, revisa las tildes).
  • Separador: coma (,) o punto y coma (;) — el framework detecta cuál usaste.

Ejemplo de CSV para importar productos:

nombre,precio,stock,activo
Camisa azul,12990,15,1
Zapatos negros,29990,8,1
Pantalón beige,19990,0,0

Cargar el archivo​

  1. En el listado de la tabla, click en "Importar" (o ícono ⬆️).
  2. Selecciona el archivo CSV.
  3. El framework hace una previsualización de las primeras filas.
  4. Confirmas y se cargan.

Mapeo de columnas​

Si los nombres de las columnas del CSV no coinciden con los de tu tabla, el framework te muestra un paso de mapeo: eliges qué columna del CSV corresponde a qué campo de tu tabla.

Manejo de errores​

Si una fila falla (por ejemplo, un campo requerido está vacío, o un valor no es válido para su tipo):

  • Modo estricto: se detiene el import y no se guarda nada.
  • Modo tolerante: salta las filas problemáticas y muestra un reporte al final.

Actualizar vs crear​

Por defecto la importación crea nuevos registros. Si quieres actualizar registros existentes (por ejemplo, actualizar precios de productos), incluye la columna id en tu CSV con el ID del registro a actualizar.

Sincronización recurrente​

Si necesitas importar datos de forma regular (por ejemplo, sincronizar stock cada noche desde otro sistema), lo mejor no es hacerlo manualmente sino con la API REST. Tu equipo técnico puede programar un script que lo haga automáticamente.

Buenas prácticas​

  • Prueba con pocos registros primero. Nunca importes 10.000 filas de golpe la primera vez.
  • Respalda antes de una importación grande. Ver Respaldos.
  • Valida los tipos. Si tu columna "Fecha" espera formato YYYY-MM-DD, no envíes 29/07/2026.
  • Revisa las relaciones. Los campos de tipo Relación esperan el ID del registro destino, no el nombre. Si tu CSV trae cliente_nombre, tendrás que convertirlo al ID primero.

Errores comunes​

  • Codificación: los caracteres con tilde salen como ú o ?. Guarda tu CSV como UTF-8.
  • Separador: si Excel guardó con ; y esperabas ,, la primera fila se ve toda en una celda.
  • Columnas de más: si tu CSV tiene columnas que no existen en la tabla, algunas versiones las ignoran, otras avisan. Limpia el CSV antes.
  • IDs autoincrementales: no envíes id si estás creando — deja que el framework lo asigne.

¿Qué sigue?​

Con esto tienes las herramientas para construir cualquier aplicación de datos. Es hora de publicar algo: