Ir al contenido

Revisar y solucionar errores de importación de registros

Cuando subes un archivo, Prolibu abre el panel flotante Importar datos en la esquina inferior derecha y va procesando fila por fila. Si alguna no entra, el contador Errores sube y el panel te ofrece el detalle.

  1. Sube el archivo desde Más acciones → Importar, en el módulo que estés cargando.
  2. Espera a que el panel Importar datos avance. Junto al resto de contadores va sumando el de Errores — ver Usar el panel Importar datos para qué muestra el panel completo.
  3. Si hay errores, selecciona el enlace “Ver errores (N) →” que aparece junto a ese conteo.

Panel Importar datos con una carga de Contactos que terminó con 2 errores y el enlace Ver errores (2) resaltado

Se abre el diálogo Registro de errores, encabezado con el módulo al que corresponde la carga (por ejemplo Contactos), con:

  • Un campo para filtrar por fila o mensaje.
  • Un botón Descargar registro de errores.
  • La lista numerada de errores, cada uno con su mensaje.

Diálogo Registro de errores con el primer error resaltado: Documento no encontrado por la llave primaria 'NotARealStage12345' en 'stage'

Por ejemplo, si escribes en stage un valor que no corresponde a ninguna etapa existente (la fase del proceso comercial en la que está el registro), como NotARealStage12345, Prolibu rechaza esa fila con “Documento no encontrado por la llave primaria ‘NotARealStage12345’ en ‘stage’”. Pasa porque algunas columnas —como stage— no son texto libre, sino referencias a un registro que ya debe existir: la importación falla fila por fila cuando el valor no coincide con ninguno.

Descargar el registro para trabajarlo aparte

Sección titulada «Descargar el registro para trabajarlo aparte»
  1. En el diálogo Registro de errores, selecciona Descargar registro de errores.
  2. Guarda el .csv que baja, llamado import-errors-<id de la importación>.csv.

Diálogo Registro de errores con el botón Descargar registro de errores resaltado

Trae dos columnas —Row y Error— y una línea por fila fallida, con el mismo texto que ves en pantalla:

Row,Error
1,"Documento no encontrado por la llave primaria 'NotARealStage12345' en 'stage'"
2,"Documento no encontrado por la llave primaria 'NotARealStage12345' en 'stage'"

Descárgalo antes de cerrar el panel o de recargar la página, porque el panel no se conserva — ver Usar el panel Importar datos.

No todas las filas problemáticas generan un error:

  • Una fila completamente vacía (sin ningún valor en ninguna columna) no se importa, pero tampoco se cuenta como error: Prolibu la ignora en silencio.
  • Una fila con un valor de stage inexistente sí genera el error de arriba.
  • Una fila marcada con TRUE en la columna skip tampoco se importa ni cuenta como error.
  • Una etiqueta escrita con su nombre visible (Servicio) en vez de con su clave (servicio) sí genera el error de llave primaria: ver Formatear archivos de importación.
  • Para que la fila de un contacto sea válida, escribe el correo completo (nombre@dominio.com).

Con un archivo de 30 filas, todas con el mismo valor de stage inexistente, la importación termina en 30 / 30 filas, 100%, 0 importados, 30 errores, y el enlace aparece como “Ver errores (30) →”.

El diálogo muestra el total («30 errores») y a continuación la lista numerada del 1 al 30, una entrada por fila, con el mismo mensaje en todas. Se recorre con la barra de desplazamiento del propio diálogo.

Preguntas frecuentes

¿Te fue útil este artículo?