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 : dans notre réseau de clients en Tunisie, au Maroc et dans le Golfe, plus de 60 % des terminaux biométriques installés sont des boîtiers ZKTeco — F18, F22, K40, MA300 et SpeedFace en tête. 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. Le tableau ci-dessous vous aide à choisir le boîtier adapté à votre contexte :

Modèle	Biométrie	Capacité	Connectivité	Idéal pour
F18	Empreinte digitale	3 000 empreintes / 100 000 logs	Ethernet, Wi-Fi (option), USB	Bureau, PME 20–100 salariés
F22	Empreinte + carte RFID	3 000 empreintes / 100 000 logs	Ethernet, Wi-Fi (option), Wiegand	Sites avec contrôle d'accès physique
K40	Empreinte + carte RFID	3 000 empreintes / 100 000 logs	Ethernet, RS232/485, USB	Environnements industriels, ateliers
MA300	Empreinte + carte RFID	10 000 empreintes / 200 000 logs	Ethernet, Wi-Fi, 4G (slot SIM intégré)	Sites distants, zones sans réseau filaire stable
SpeedFace V5L	Faciale + empreinte + carte	30 000 visages / 1 000 000 logs	Ethernet, Wi-Fi, 4G (option)	Entrées principales, volume élevé, sans contact
ZKBio960	Faciale + empreinte + carte + veine	50 000 visages / 1 000 000 logs	Ethernet, Wi-Fi, USB	Sites haute sécurité, accès multi-facteurs
ProFace X	Faciale (avec masque) + empreinte	50 000 visages / 10 000 empreintes	Ethernet, Wi-Fi, USB	Zones médicales, milieux post-COVID

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. En cas de doute, le numéro de série du terminal permet à l'équipe Mawered de confirmer la compatibilité avant l'achat.

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.

Déploiement multi-sites : architecture et bonnes pratiques

Pour les entreprises avec plusieurs établissements ou ateliers, Mawered organise les terminaux par site. Chaque site dispose de son propre périmètre : terminaux rattachés, plannings, calendriers de jours fériés, et gestionnaires RH locaux. La vue consolidée reste accessible au niveau direction.

Ce que la structure par site vous permet de faire

Consulter les logs de pointage par site ou de manière agrégée sur tous les établissements — sans avoir à croiser manuellement des exports provenant de plusieurs sources.
Assigner des plannings rotatifs différents par site : une usine de Sfax en 3×8 et un siège à Tunis en horaires fixes peuvent coexister dans le même compte Mawered.
Restreindre les droits des managers locaux à leur propre périmètre. Un superviseur de l'entrepôt de Monastir n'accède pas aux données salariales des commerciaux de Tunis.
Consolider la masse salariale multi-sites pour la direction financière sans double-saisie.

Prérequis réseau pour les terminaux distants

Le protocole ADMS est conçu pour fonctionner sur des connexions basiques. Les exigences minimales :

Un seul port à ouvrir : le port 443 (HTTPS) sortant vers le domaine Mawered. Aucun port entrant n'est requis — c'est toujours le terminal qui initie la connexion vers le serveur.
4G suffit pour un site isolé : les modèles MA300 et SpeedFace V5L disposent d'un slot SIM intégré. Un terminal dans un hangar sans Ethernet peut fonctionner sur une SIM data standard.
Résilience aux coupures réseau : en cas de perte de connexion, le terminal continue d'enregistrer les pointages en mémoire locale (jusqu'à 200 000 logs selon le modèle). À la reconnexion, il transmet automatiquement le backlog — Mawered déduplique les transactions pour éviter tout double comptage.

Centralisation opérationnelle : ce que vous pilotez à distance

Depuis la console Mawered, l'administrateur voit en temps réel l'état de chaque terminal de l'entreprise — statut de connexion, date du dernier contact, nombre de pointages en attente de synchronisation, espace mémoire disponible. Les actions à distance disponibles :

Synchronisation forcée : récupérer immédiatement les pointages d'un terminal avant une clôture de paie, sans attendre le prochain cycle automatique.
Mise à jour de la liste des employés : envoyer simultanément la liste des matricules vers tous les terminaux d'un site après une intégration de nouveaux salariés ou un transfert inter-sites.
Redémarrage à distance : relancer un terminal défaillant sans envoyer de technicien sur place — particulièrement utile pour les sites industriels de province.
Synchronisation horaire : aligner l'heure de tous les terminaux depuis le serveur NTP Mawered, pour éviter les dérives temporelles qui faussent le calcul des retards.

Pour les PME industrielles tunisiennes avec des sites dans les zones de Sfax, Monastir ou Sousse, cette centralisation opérationnelle élimine les déplacements sur site pour chaque opération d'administration des terminaux — un gain de temps réel estimé à 1 à 2 jours par mois pour les entreprises avec 5 terminaux ou plus.

Voir aussi : Module de gestion des pointages — Module de planification — Gestion des absences et pointage biométrique pour les PME