Guía de solución de problemas para la carga masiva de usuarios en BioStar Air

Varios clientes y partners han reportado inconvenientes al cargar listas de usuarios de forma masiva. La mayoría de los problemas se deben a archivos CSV con un formato incorrecto. Por favor, siga las instrucciones a continuación exactamente para asegurarse de que la carga funcione correctamente.

Nota: A partir de la versión 2.10, BioStar Air genera un reporte de validación cuando un administrador carga un archivo CSV con entradas inválidas. Después de corregir los errores, vuelva a cargar el archivo.

Preparación del archivo CSV

1. Use exactamente el formato de la plantilla CSV

• Descargue la plantilla desde el Portal de Administración:
  Gestión de usuarios → Usuarios → + Agregar usuario → Importar usuarios → Descargar
• No agregue ni elimine columnas manualmente. El sistema rechazará el archivo si detecta columnas inesperadas.
• Si necesita incluir campos adicionales como ID de empleado o Departamento, vaya a Configuración de plantillas de usuario y agregue estos campos allí. Una vez añadidos, aparecerán automáticamente en el archivo CSV descargado.

2. Clave de usuario (ID de usuario)

• Este es el identificador numérico único de cada usuario.
• Puede dejar esta columna en blanco y el sistema asignará los valores automáticamente.
• Si decide completarlo manualmente:
  • El valor debe ser solo numérico
  • El valor debe ser único
  • No incluya letras, espacios, guiones ni caracteres especiales
• Importante: Si intenta ingresar un ID interno de la empresa (que normalmente contiene letras), no use el campo Clave de usuario. En su lugar, cree un campo personalizado usando Configuración de plantillas de usuario.

3. Dirección de correo electrónico

• Debe cumplir con un formato de correo electrónico válido:
  • Sin espacios
  • Debe contener @
  • El dominio debe incluir un punto y un dominio de nivel superior (ej.: ejemplo.com, gmail.com, suprema.co.kr)
  • Sin puntos adicionales al final
  • Sin caracteres ocultos o especiales
  • Debe ser un correo real (evite valores como “No proporcionado”)
• Debe ser único tanto en el archivo como en el sistema.
• Es obligatorio si el usuario recibirá:
  • Credencial móvil
  • LinkPass
  • Credencial QR
• No es obligatorio si el usuario solo tendrá tarjeta RFID.

4. Número de teléfono

• Opcional, excepto si se usará para envío de credenciales por SMS.
• Debe ser único, igual que el correo electrónico.
• Se recomienda el uso de correo electrónico, ya que los SMS generan un costo adicional.

5. Campos de fecha

Todos los campos de fecha deben usar exactamente el siguiente formato:

YYYY-MM-DDTHH:MM:SS.sssZ

Ejemplo:

1995-05-09T00:00:00.000Z

Cualquier variación —como omitir la “Z”, usar barras o no incluir la hora— hará que la carga falle.

6. Requisitos según el tipo de credencial

• Las credenciales deben enviarse por correo electrónico o teléfono.
• Puede proporcionar ambos, pero al menos uno es obligatorio para credenciales móviles.
• Correo electrónico: gratuito · SMS: con costo.

Fórmulas de Excel para validación previa

Se recomienda usar estas fórmulas en columnas auxiliares antes de cargar el archivo.

Detectar correos o teléfonos duplicados

=IF(E2="", "", IF(COUNTIF(E$2:E2, E2)>1, "Duplicado", "Primera aparición"))

Validar formato de fecha ISO 8601 (columna Q)

=IF(Q2="", "", IF(AND(LEN(Q2)=24,
ISNUMBER(VALUE(MID(Q2,1,4))), MID(Q2,5,1)="-",
ISNUMBER(VALUE(MID(Q2,6,2))), MID(Q2,8,1)="-",
ISNUMBER(VALUE(MID(Q2,9,2))), MID(Q2,11,1)="T",
ISNUMBER(VALUE(MID(Q2,12,2))), MID(Q2,14,1)=":",
ISNUMBER(VALUE(MID(Q2,15,2))), MID(Q2,17,1)=":",
ISNUMBER(VALUE(MID(Q2,18,2))), MID(Q2,20,1)=".",
ISNUMBER(VALUE(MID(Q2,21,3))), RIGHT(Q2,1)="Z"),
"Válido","Inválido"))

Validar formato de correo electrónico (columna E)

=IF(TRIM(E2)="", "", IF(AND(
ISNUMBER(FIND("@",E2)),
ISNUMBER(FIND(".",E2)),
FIND("@",E2)>1,
FIND(".",E2,FIND("@",E2))>FIND("@",E2)+1,
LEN(E2)-LEN(SUBSTITUTE(E2,"@",""))=1,
ISERROR(FIND(" ",E2))
),"Válido","Inválido"))

¿Errores en la carga? Revise lo siguiente

• ¿Usó la plantilla correcta sin agregar columnas?
• ¿Completó todos los campos obligatorios para credenciales móviles?
• ¿Correos y teléfonos son únicos?
• ¿Los formatos cumplen exactamente lo indicado?

Nota importante: No ofrecemos servicios de corrección de archivos. Use las validaciones anteriores para resolver errores antes de reenviar el archivo.

Esta guía está diseñada para permitir una carga exitosa sin intervención manual del equipo de soporte.