Skiply - Ubiqod Key

Avec Ubiqod Key, Skiply propose une solution de pointage basée sur un QR code à usage unique. Ce code est affiché sur un écran epaper qui change à intervalles réguliers. Le collaborateur scanne le QR code grâce à son smartphone.

Deux options sont possibles :

• Skiply vérifie la validité du token (technique). Si le token est valide, le collaborateur est redirigé vers l'interface Skiply et se connecte avec son identifiant pour enregistrer son horodatage. Skiply envoie l'horodatage de pointage à Timesquare en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.
• Le collaborateur est redirigé vers My Timesquare et se connecte avec ses identifiants My Timesquare habituels. Timesquare contrôle le timeout paramétré. Si le contrôle est valide, Skiply envoie l'horodatage du pointage à Timesquare en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.

Pour en savoir plus sur la marketplace, je me réfère au site Holy-Dis.

Vérifier l'activation de l'application

Je peux vérifier si Skiply est activé.

Activer Skiply

Pour activer Skiply, je prends contact avec les équipes Holy-Dis.

Option 1 : connexion du collaborateur à Skiply

Le collaborateur scanne le QR code grâce à son smartphone. Skiply vérifie la validité du token (technique). Si le token est valide, il est redirigé vers l'interface Skiply et se connecte avec son identifiant pour enregistrer son horodatage. Skiply envoie l'horodatage du pointage à Timesquare en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.

Pour utiliser le pointage par scan de Skiply, il est nécessaire de s'assurer que le smartphone utilisé dispose des fonctionnalités habituelles pour scanner un QR code (appareil photo ou encore application à télécharger). Pour en savoir plus, se reporter à la page Solidarite-numerique.fr.

Schéma simplifié de l'infrastructure avec connexion à Skiply (en bleu ce qui relève de Skiply, en orange ce qui relève de Timesquare)

Paramétrer Skiply et Timesquare pour l'intégration des pointages

L'administrateur crée les identifiants de badgeuses (trackers) dans l'interface Skiply. Ces identifiants de badgeuses doivent être créés dans Timesquare depuis la page Configuration / Gestion des temps / Badgeuses. L'identifiant interne de la badgeuse dans Timesquare doit correspondre au label de la balise tracker défini dans le paramétrage de Skiply (exemple QRCODEHD01).

L'administrateur crée les badges des personnes (pincode) dans l'interface Skiply. Ces badges doivent être créés et affectés aux personnes concernées dans Timesquare depuis la page Administratif / Affectations / Badges. Ils peuvent également être importés. Le code du badge dans Timesquare doit correspondre au pincode de la balise Data / Pincode / Code défini dans le paramétrage de Skiply (exemple 4321).

L'administrateur paramètre les types de pointage dans l'interface Skiply. Le type de pointage correspond à la balise data / action / code défini dans le paramétrage de Skiply. Il est indispensable pour le bon fonctionnement de l'interface que Skiply soit paramétré avec les types de pointage suivants :

• 1 pour entrée
• 2 pour sortie
• 5 pour pause

Intégrer les pointages issus de Skiply

Les pointages par QR code issus de Skiply sont récupérés par Timesquare en temps réel. A chaque nouveau pointage, le webhook de Skiply appelle un Web Service Timesquare. Ces pointages bruts sont immédiatement disponibles dans la section Liste pointage du bloc du bas de l'écran de Suivi du réalisé. Une fois le traitement des pointages effectué (toutes les nuits), ils seront disponibles dans le réalisé pointé après traitement.

Les informations utilisées par Timesquare, transmises par le Web Service, sont les suivantes :

• Identifiant interne de la badgeuse / label du tracker
• Code du badge de la personne / pincode
• Date et heure du pointage / timestamp
• Type de pointage (1 pour entrée, 2 pour sortie, 5 pour pause) / action / code

Si le code PIN (badge) est inexistant dans Timesquare, ou que le salarié saisit un code PIN erroné au moment du pointage, il n’est pas possible de récupérer les pointages.

Option 2 : Connexion du collaborateur à My Timesquare

Le collaborateur scanne le QR code grâce à son smartphone. Il est redirigé vers My Timesquare et se connecte avec ses identifiants My Timesquare habituels. Timesquare contrôle le timeout paramétré. Si le contrôle est valide, Timesquare récupère l'horodatage de pointage en temps réel pour la personne qui s'est connectée. Le pointage est alors disponible directement dans Timesquare.

Pour utiliser le pointage par scan de Skiply, il est nécessaire de s'assurer que le smartphone utilisé dispose des fonctionnalités habituelles pour scanner un QR code (appareil photo ou encore application à télécharger). Pour en savoir plus, se reporter à la page Solidarite-numerique.fr.

Schéma simplifié de l'architecture avec connexion à My Timesquare (en bleu ce qui relève de Skiply, en orange ce qui relève de Timesquare)

Paramétrer Skiply et Timesquare pour l'intégration des pointages

Skiply crée un token et un horodatage de pointage dans Skiply. Ce token est envoyé en variable dans l'URL de connexion à My Timesquare. C'est grâce à ce token que Timesquare peut interroger la base Skiply pour récupérer l'horodatage associé.

Dans l'interface Skiply, il est nécessaire de saisir l'URL de connexion de My Timesquare.

Les équipes techniques Holy-Dis enregistrent l'API Key fournie par Skiply dans un fichier de configuration. Pour des raisons de sécurité, l'API Key est cryptée.

Elles définissent également un timeout entre la connexion du collaborateur à My Timesquare et l'horodatage enregistré par Skiply. Si le contrôle de ce timeout échoue, un message d'erreur s'affiche et le pointage n'est pas enregistré. Par défaut, le timeout est de 5mn.

Dans tous les cas, même si le pointage n'est pas autorisé / enregistré, l'horodatage, quant à lui, est enregistré dans les logs (pour une période de 3 mois).

Vérifier les interdictions de pointage

Si le contrôle du timeout aboutit correctement, Timesquare vérifie s'il y a des interdictions de pointages qui bloqueraient l'enregistrement du pointage.

• Si le pointage est autorisé, il est enregistré en base, un message de confirmation s'affiche.
• Si le pointage est interdit, il n'est pas enregistré en base, un message d'erreur s'affiche.

Schéma simplifié des interdictions de pointages

Intégrer les pointages issus de Skiply

Les pointages par QR code issus de Skiply sont récupérés par Timesquare en temps réel. A chaque nouveau pointage, le webhook de Skiply appelle un Web Service Timesquare. Ce Web Service contient en paramètre le token envoyé par Skiply dans l'URL de connexion à My Timesquare.

Ces pointages bruts récupérés par Web Services sont immédiatement disponibles dans la section Liste pointage du bloc du bas de l'écran de Suivi du réalisé. Par la suite, une fois le traitement des pointages effectué, ils seront disponibles dans le réalisé pointé après traitement. 

Les informations utilisées par Timesquare, transmises par le Web Service, sont les suivantes :

• Date et heure du pointage / timestamp

Gestion des crédits (Ubiqoins)

Il est possible que la gestion des crédits soit attribuée à Holy-Dis. Dans ce cas, la plateforme fonctionne de la manière suivante :

Depuis son interface Skiply, le client peut déléguer à Holy-Dis la gestion des Ubiqod et par conséquent celle des Ubiqoins. Holy-Dis accepte la demande pour que ce soit effectif (sous réserve que cela a bien été prévu dans le cadre des accord commerciaux).

A partir de ce moment-là, les crédits (Ubiqoins) sont débités directement sur le compte de Holy-Dis.

Le client continue à gérer l'intégralité des paramètres, y compris l'activation / désactivation, mais Holy-Dis a également la possibilité à terme de révoquer la prise en charge (par exemple en fin de contrat).

Ressources disponibles

• www.skiply.eu
• Le blog Skiply
• Spécifications techniques
• Scanner un QR code avec son smartphone - Source : Solidarite-numerique.fr