Intégrer des terminaux ZKTeco avec Mawered en moins de 30 minutes

Les terminaux ZKTeco sont omniprésents dans les entreprises de la région MENA : la marque détient une part de marché estimée à plus de 60 % dans le segment des badgeuses biométriques en Afrique du Nord. Si votre entreprise en possède déjà — ou si vous venez d'en acquérir — ce guide vous explique comment les connecter à Mawered en moins de 30 minutes, en utilisant le protocole ADMS natif, sans aucune exportation de fichier CSV et sans développement personnalisé.

Prérequis : ce dont vous avez besoin avant de commencer

Avant de démarrer la configuration, vérifiez les points suivants :

Modèle de terminal compatible : tous les terminaux ZKTeco supportant le protocole ADMS fonctionnent avec Mawered. Les modèles les plus courants dans la région sont le F18, F22, K40, MA300, SpeedFace V5L et ZKBio960. En cas de doute, vérifiez dans le menu du terminal que l'option "Serveur ADMS" ou "Cloud Server" est disponible.
Connectivité réseau : le terminal doit avoir accès à internet (connexion filaire Ethernet ou Wi-Fi). Vérifiez que le port 80 ou 443 sortant n'est pas bloqué par votre pare-feu.
Numéro de série du terminal : il se trouve dans le menu du terminal sous "Infos système" ou "Device Info". Il servira à l'identifier dans Mawered.
Accès administrateur Mawered : vous devez avoir les permissions "Gestion des terminaux biométriques" dans votre profil Mawered.

Étape 1 : Récupérer l'URL ADMS dans Mawered

Dans Mawered, naviguez vers Pointages → Terminaux biométriques → Ajouter un terminal. Sur l'écran de création, notez l'URL ADMS affichée — elle ressemble à https://votredomaine.mawered.com/iclock/cdata/. C'est l'adresse que vous allez saisir dans le terminal ZKTeco. Copiez-la exactement, avec le slash final.

Sur ce même écran, saisissez :

Le nom du terminal (ex : "Entrée principale - Siège")
Le numéro de série du terminal (trouvé à l'étape des prérequis)
Le site auquel il est rattaché

Enregistrez. Mawered crée maintenant un point d'accueil pour ce terminal. Passez à la configuration physique du boîtier.

Étape 2 : Configurer le terminal ZKTeco

Sur le terminal ZKTeco, accédez au menu administrateur (code par défaut : 0000 ou 12345 selon le modèle). La navigation varie légèrement selon les modèles, mais le chemin est toujours similaire :

Accédez à Paramètres réseau → Serveur cloud (ou "ADMS Settings" selon le firmware).
Activez la connexion cloud : réglez "Enable" ou "Activer" sur Oui.
Dans le champ Adresse du serveur (Server Address), saisissez l'URL ADMS copiée depuis Mawered. Si le terminal demande séparément le domaine et le chemin, séparez votredomaine.mawered.com et /iclock/cdata/.
Réglez le port sur 443 (HTTPS) ou 80 si votre instance Mawered n'est pas encore en HTTPS.
Dans le champ Numéro de terminal (Device ID), saisissez le numéro de série tel qu'il apparaît dans Mawered — c'est l'identifiant qui lie le terminal à son enregistrement dans la plateforme.
Sauvegardez et redémarrez le terminal si l'interface vous y invite.

Après redémarrage, le terminal tentera automatiquement de contacter le serveur ADMS. Vous devriez voir un indicateur de connexion (souvent une icône réseau ou un message "Server connected") s'activer dans les 60 secondes.

Étape 3 : Vérifier la connexion dans Mawered

Retournez dans Mawered sur la fiche du terminal que vous venez de créer. Si la connexion est établie, vous verrez :

Le statut passer à "Connecté" avec la date et l'heure du dernier contact.
Les informations du terminal apparaître automatiquement : firmware, capacité mémoire, nombre d'empreintes enregistrées.

Si le statut reste "Déconnecté" après 2 minutes, consultez la section dépannage en bas de cet article.

Étape 4 : Mapper les employés — la clé souvent oubliée

La connexion réseau est établie, mais les pointages ne seront correctement attribués aux employés que si la correspondance entre les données du terminal et les fiches Mawered est correcte. C'est l'étape la plus souvent ratée lors des intégrations.

Les terminaux ZKTeco identifient chaque employé par un User ID numérique. Dans Mawered, ce User ID correspond au champ Numéro matricule (registration_number) de la fiche employé — pas au numéro de badge, pas au numéro de contrat, pas à l'ID interne Mawered.

Pour mapper correctement :

Exportez la liste des utilisateurs depuis le terminal ZKTeco (menu Gestion des employés → Exporter).
Dans Mawered, vérifiez que chaque fiche employé a bien son numéro matricule renseigné, et que ce numéro correspond exactement au User ID du terminal.
Si ce n'est pas le cas, mettez à jour les fiches employés dans Mawered depuis la page de gestion des employés.
Vous pouvez également synchroniser les utilisateurs depuis Mawered vers le terminal : sur la fiche terminal, utilisez l'option "Envoyer les employés vers le terminal" — le SIRH poussera la liste des matricules directement sur le boîtier via la connexion ADMS.

Étape 5 : Tester avec un pointage réel

Une fois le mapping effectué, faites un test de pointage sur le terminal. Dans Mawered, naviguez vers Pointages → Logs de pointage. Le log doit apparaître en quelques secondes avec :

Le nom de l'employé correctement résolu (pas un User ID inconnu)
La date et l'heure exactes
Le type de pointage (Entrée/Sortie selon la configuration du terminal)
Le terminal source

Si le nom n'apparaît pas et que vous voyez "Employé non trouvé" ou un ID non résolu, vérifiez que le matricule de l'employé dans Mawered correspond bien au User ID dans le terminal.

Dépannage des problèmes courants

Le terminal reste "Déconnecté" dans Mawered

Vérifiez que l'URL ADMS est correcte, avec le slash final : /iclock/cdata/
Testez la connectivité depuis le terminal : certains modèles ont un outil de ping dans les paramètres réseau.
Vérifiez que le port 443 (HTTPS) ou 80 (HTTP) est ouvert en sortie sur votre réseau local.
Si votre instance Mawered est sur un sous-domaine personnalisé (ex : votreentreprise.mawered.com), assurez-vous que le certificat SSL est valide — les terminaux ZKTeco peuvent rejeter les connexions HTTPS avec certificat auto-signé.

Les pointages arrivent mais ne sont pas attribués à un employé

Le User ID dans le terminal ne correspond à aucun numéro matricule dans Mawered. Exportez la liste des User IDs depuis le terminal et comparez avec les matricules dans Mawered.
Le numéro matricule peut être stocké avec des zéros en préfixe dans l'un des systèmes et sans dans l'autre (ex : "042" vs "42"). Harmonisez le format.

Les pointages sont dupliqués

Le terminal est configuré avec un intervalle de synchronisation trop court et renvoie les mêmes pointages plusieurs fois. Dans les paramètres ADMS du terminal, augmentez l'intervalle d'envoi à 60 secondes minimum.
Mawered déduplique automatiquement les pointages identiques (même employé, même heure, même terminal), mais vérifiez dans les logs qu'aucun enregistrement parasite ne persiste.

Modèles ZKTeco compatibles et validés

Les modèles suivants ont été testés et validés en intégration native avec Mawered :

Empreinte digitale : F18, F22, MA300, K40, U160, UA860, SF100
Reconnaissance faciale : SpeedFace V5L, SpeedFace-V4L TI, ZKBio960, ProFace X
Multimodal (empreinte + visage + carte) : SpeedFace V5L TD, MA500, G4 Pro

Pour tout modèle non listé, vérifiez que le firmware supporte le protocole ADMS (version 6.60 ou supérieure recommandée). Les terminaux plus anciens peuvent nécessiter une mise à jour firmware avant d'activer la connexion cloud.

Aller plus loin : les commandes bidirectionnelles

L'intégration ADMS ne se limite pas à recevoir les pointages. Mawered peut également envoyer des commandes vers les terminaux :

Ajouter ou supprimer un employé (ajout/suppression du User ID et de l'empreinte)
Synchroniser l'heure du terminal depuis le serveur
Déclencher un redémarrage à distance
Effacer la mémoire de pointage après synchronisation confirmée

Ces commandes sont disponibles depuis la fiche du terminal dans Mawered, sous l'onglet "Commandes". Elles sont utiles notamment pour les déploiements multi-sites : un administrateur Mawered peut gérer tous les terminaux depuis une interface centrale sans se déplacer sur chaque site.

Voir aussi : Module de gestion des pointages — Module de planification