Ir al contenido

Caso de uso

Configurar y conectar Suprema

Cómo conectar los terminales de fichaje Suprema (BioStar 2) para que los fichajes lleguen solos a Asistencia o se importen por CSV, y cómo dar de alta empleados en el terminal, con sus limitaciones.

Módulos

Asistencia Asistencia Interfaces Interfaces IoT IoT
M

Autor

Miquel Romera Luis

Actualizado 22/11/2026
Versión 18.8
9 min de lectura

Suprema fabrica terminales biométricos de control de presencia (huella, cara, tarjeta o PIN) que se gestionan con su programa BioStar 2. Con esta integración, los fichajes que tus empleados hacen en el terminal Suprema llegan a la Asistencia de Astro HMS como entradas y salidas, sin teclearlas a mano. Está pensada para la persona responsable de RR. HH. o de la configuración de interfaces del establecimiento.

Interfaces > Asistencia > Dispositivos

¿Qué permite esta integración?

De Suprema se integra el terminal de fichaje. Lo que hace:

  • Del terminal a Astro HMS: fichajes. Cada fichaje correcto del terminal se convierte en una entrada o una salida en Asistencia. Se puede traer de dos formas, según el Origen de la importación (Suprema):
  • API REST (automático): todas las noches, sobre las 3:00 (hora peninsular en invierno; las 4:00 en verano), Astro HMS pide a BioStar 2 los fichajes desde la última importación hasta las 0:00 de ese día, a través de la caja de IoT del hotel. Si en algún momento necesitas los del día en curso, el botón Importar ahora trae todo lo que haya en el terminal hasta ese momento.
  • CSV (manual): exportas el informe de eventos desde BioStar 2 y lo subes en Interfaces > Asistencia > Importación de fichajes.
  • De Astro HMS al terminal: alta de empleados. Desde la ficha del empleado, el botón Sincronización con un sistema externo crea al empleado como usuario en BioStar 2, con su Código de empleado en Suprema, las fechas de su contrato y su correo. El resultado de cada intento queda en la pestaña Sistema de asistencia del empleado.

Para saber de quién es cada fichaje se usa el Código de empleado en Suprema: tiene que ser el mismo número que el usuario tiene en BioStar 2.

Requisitos

  • Un terminal Suprema con el programa BioStar 2 instalado en un equipo de la red del hotel, y un usuario y contraseña de BioStar 2 con permiso para consultar eventos (y para crear usuarios, si vas a dar de alta empleados desde Astro HMS).
  • Para la importación automática y el alta de empleados: una caja de IoT (Raspberry Pi) dada de alta en IoT > Dispositivos, en marcha y en la misma red que el servidor de BioStar 2. Astro HMS nunca se conecta directamente a la IP de BioStar 2: la llamada la hace la Raspberry. Para la importación por CSV no hace falta.
  • Permisos en Astro HMS: ver los dispositivos de asistencia requiere ser Oficial de Asistencia; el botón Importar ahora solo lo ve el Administrador de Asistencia, y el botón Sincronización con un sistema externo, el responsable de Empleados. La Contraseña de Suprema solo la ve y la rellena el Administrador de Asistencia; los botones siguen funcionando para quien puede pulsarlos.

Configuración paso a paso

1º Crear el dispositivo

En Interfaces > Asistencia > Dispositivos, pulsa Nuevo y rellena:

  • Nombre: un nombre que lo identifique (por ejemplo, el lugar donde está el terminal).
  • Marca y Compañía: el establecimiento y la empresa del terminal. La Compañía es importante: la importación automática solo busca los fichajes de los empleados de esa empresa.
  • Fabricante: Suprema.

2º Elegir la caja de IoT

En la pestaña caja de IoT, elige en Dispositivo la Raspberry del hotel. El Identificador de caja de IoT y la IP se rellenan solos.

3º Datos de BioStar 2

En la pestaña Software local:

  • Dirección del servidor local y Puerto: la IP y el puerto del equipo donde corre BioStar 2, dentro de la red del hotel.
  • Tiempo de espera (segundos): cuánto se espera la respuesta de BioStar 2 (30 por defecto).
  • Los campos Usuario y Contraseña generales de esta pestaña no los usa Suprema; usa los del bloque Suprema que hay debajo.

En el bloque Suprema de la misma pestaña:

  • Origen de la importación (Suprema): CSV si vas a subir los ficheros a mano, o API REST si quieres que los fichajes lleguen solos.
  • Tipo de importación: solo aparece con API REST. Ponlo en Automático para que la tarea nocturna recoja este dispositivo; en Manual solo se importa con el botón Importar ahora.
  • Usuario de Suprema y Contraseña de Suprema: el usuario de BioStar 2. Son obligatorios aunque uses CSV. La contraseña solo aparece si eres Administrador de Asistencia.
  • Protocolo de Suprema: HTTP o HTTPS, según cómo responda tu servidor de BioStar 2.
  • Última importación hasta (Suprema): solo lectura. Indica hasta qué momento se han traído los fichajes; la siguiente importación empieza ahí, así que una noche fallida se recupera en la siguiente sin duplicar nada.

Guarda el dispositivo.

4º Poner el código de Suprema a cada empleado

En la ficha de cada empleado, pestaña Ajustes de RR. HH., bloque Asistencia/Punto de Venta, revisa el Código de empleado en Suprema. Al crear un empleado se rellena solo con su número interno de Astro HMS; si el empleado ya existía en BioStar 2 con otro número, cámbialo por el de BioStar 2. No puede haber dos empleados con el mismo código.

5º Dar de alta a los empleados en el terminal (opcional)

Si el empleado aún no existe en BioStar 2, abre su ficha y pulsa Sincronización con un sistema externo (también puedes seleccionar varios empleados de la misma empresa en la lista y lanzar la acción con el mismo nombre). En la ventana se propone la Interfaz de asistencia de su empresa; pulsa Iniciar sincronización. Verás un aviso con los empleados dados de alta o con el error del terminal, y en la pestaña Sistema de asistencia del empleado quedará una línea con el resultado (Dado de alta o Fallido).

La huella, la cara o la tarjeta del empleado se registran después en el propio terminal o en BioStar 2.

6º Traer los fichajes

Con API REST: no tienes que hacer nada; cada noche llegan los del día anterior. Para traer los de hoy, abre el dispositivo y pulsa Importar ahora: aparece un aviso con el número de fichajes importados («… fichajes importados del terminal.») o con las filas que se han saltado y por qué.

Con CSV: exporta el informe de eventos desde BioStar 2 y entra en Interfaces > Asistencia > Importación de fichajes:

  • Dispositivo de origen: el dispositivo Suprema. Limita la búsqueda de empleados a su empresa y fija la zona horaria con la que se leen las horas del fichero (la de su marca).
  • Fichero y Extensión: el fichero y si es CSV o XLSX.
  • Duración máxima del turno (horas): 14 por defecto. Una entrada que lleve abierta más tiempo no se empareja con la siguiente salida: se cierra como anomalía.

Pulsa Procesar fichero. El fichero se revisa en el momento y, si es correcto, se importa en segundo plano; al terminar te llega el aviso «Importación de asistencias finalizada».

El fichero debe tener, como mínimo, las columnas Fecha, Usuario, Evento y Tecla CP, separadas por comas, con estos formatos:

ColumnaQué debe contener
FechaEn CSV, AAAA-MM-DD HH:MM:SS. En XLSX, DD/MM/AAAA HH:MM.
UsuarioEl código de empleado en Suprema seguido del nombre entre paréntesis, por ejemplo 25(Nombre).
EventoSolo se importan las filas cuyo evento contiene «correcta» (identificaciones correctas).
Tecla CPDebe contener «Entrada» o «Salida».

Limitaciones

  • Entrada o salida según la tecla. El terminal no decide si un fichaje es de entrada o de salida: lo marca la tecla de presencia que pulsa el empleado. En la importación automática, las teclas 1 y 3 son entrada y las 2 y 4, salida; un fichaje sin tecla de presencia se salta y aparece en el aviso. En CSV, una fila correcta sin «Entrada» ni «Salida» en Tecla CP hace que se rechace todo el fichero.
  • Empleados sin código. Un fichaje de un usuario de BioStar 2 cuyo código no tiene ningún empleado se salta (importación automática) o hace que se rechace el fichero (CSV), indicando la fila.
  • Fichajes sin pareja. Una salida sin entrada abierta se guarda como un fichaje de un segundo. Una entrada con otra entrada aún abierta cierra la anterior un segundo antes. Revisa estos casos en el Tablero del Día o en la revisión de incidencias antes de cerrar el mes.
  • Los fichajes del día llegan al día siguiente con la importación automática; para tenerlos antes, usa Importar ahora.
  • Alta en el terminal. Siempre se da de alta en el grupo «All Users» de BioStar 2; si el contrato no tiene fecha de fin, el usuario caduca en BioStar 2 el 31/12/2030. Esta función aún no se ha probado contra un terminal real: pruébala primero con un empleado de prueba y comprueba que aparece en BioStar 2.
  • Solo fichajes. Las cerraduras y los lectores de documentos Suprema no están soportados. En el desplegable de cerraduras aparece «Suprema (no soportado)» y al grabar una tarjeta sale «Las cerraduras Suprema no están soportadas: no se puede grabar ninguna tarjeta con ellas.». En lectores de documentos aparece «Suprema (no soportado)» y al escanear sale el aviso de que su conector no está implementado y no se rellena ningún dato del huésped.
  • Sin caja de IoT no hay importación automática. Si el dispositivo no tiene caja de IoT elegida, la importación falla con el aviso «Importación REST de Suprema: no hay dispositivo IoT configurado en …».

Resultado esperado

Los fichajes del terminal Suprema aparecen en Asistencia como entradas y salidas de cada empleado, cada noche o al pulsar Importar ahora (o al procesar el fichero CSV), y los empleados nuevos pueden darse de alta en BioStar 2 sin salir de Astro HMS.

Valoración

¿Te ha resultado útil este documento?

33 visitas

¿No has encontrado lo que buscabas?

Abrir ticket de soporte

Ver también

Artículos relacionados

Revisar los fichajes en tiempo real en el Parte diario de jornada

Cómo revisar en el Parte diario de jornada quién está dentro, quién ha salido y quién no ha fichado, comparando los fichajes con los turnos del Cuadrante.

Empleados

¿Necesitas ayuda?

¿No encuentras lo que buscas?

Explora todos los procesos o contacta con soporte para recibir ayuda personalizada.