eIDPlugin
eIDPlugin
Un plug-in pour FileMaker Pro sur macOS et Windows qui lit la puce à contact de la carte d'identité belge via un lecteur ordinaire. Nom, prénoms, date et lieu de naissance, sexe, adresse avec code postal et commune, nationalité, numéro de carte, date d'expiration, numéro de registre national et la photo — en un seul appel de fonction, en JSON.
Écrit pour les développeurs FileMaker. Un calcul dans votre script et les champs sont remplis. Pas d'OCR, pas de photos de cartes, pas de recopie — ni au comptoir, ni à l'accueil, ni lors d'une inscription.
Télécharger gratuitement Acheter une licence 99 € paiement unique, TVA comprise · tous les Mac et PC de votre société
Dix minutes gratuites à chaque démarrage de FileMaker — sans inscription, sans clé d'essai.
Un Mac ou un PC, FileMaker Pro et un lecteur de cartes à une quinzaine d'euros. Rien de plus : le plug-in parle directement au lecteur et n'a besoin ni d'internet, ni d'un serveur, ni d'un compte.
macOS 12 Monterey ou plus récent, sur puce Apple et sur Intel. Ou Windows 10 ou 11, 64 bits. Les deux utilisent la couche lecteur intégrée au système — PCSC sur Mac, PC/SC sur Windows.
Sur Mac — macOS 12 Monterey ou plus récent — testé sur sept versions : FileMaker Pro 26 (2026), 22 (2025), 21 (2024), 20 (2023), 19, 18 et 17. Sur Windows, testé sur FileMaker Pro 22 (2025). Compilé avec le Claris Plug-In SDK 26, et compatible jusqu'à l'API plug-in de la version 15.
Tout lecteur PC/SC reconnu par votre système. Testé avec le Sitecom MD-1002 et le Xssive CR02, tous deux autour de 15 €.
L'eID belge, ancien ou nouveau modèle. C'est la puce à contact qui est lue : la carte entre dans le lecteur, elle ne se pose pas dessus.
Ces sept versions ont chacune été essayées sur un Mac, et non déduites d'un tableau. Attention toutefois à la différence entre les deux exigences ci-dessus : la version de FileMaker peut être ancienne, la version de macOS non — le plug-in demande macOS 12 Monterey ou plus récent. Si vous faites tourner FileMaker 17 sur un Mac de la même époque, c'est le système qui bloque, pas FileMaker.
Vous vous demandez si cela fonctionnera chez vous ? Installez le plug-in et appelez EID_Readers. Si le nom de votre lecteur s'affiche, le reste fonctionnera aussi. Cinq minutes, et cela ne coûte rien.
Le plug-in est un téléchargement gratuit ordinaire. Rien n'en est retiré, il n'existe pas de version d'essai bridée, et vous n'avez besoin ni d'un compte ni d'une clé d'essai. Ce que vous téléchargez, c'est le plug-in complet.
Ouvrez eIDPlugin_Demo.fmp12 depuis le téléchargement, insérez une carte et cliquez sur read eID. C'est le moyen le plus rapide de voir si votre lecteur fonctionne.
Sur Mac : placez macOS/eIDPlugin.fmplugin dans ~/Bibliothèque/Application Support/FileMaker/Extensions/. Sur Windows : placez Windows/eIDPlugin.fmx64 dans le dossier Extensions à côté de FileMaker Pro. Quittez ensuite complètement FileMaker et relancez-le — un plug-in n'est chargé qu'au démarrage.
Sans clé, EID_Read lit les cartes pendant dix minutes, comptées depuis le démarrage de FileMaker. Ensuite la fonction renvoie un message d'erreur clair, et relancer FileMaker vous redonne dix minutes. Rien n'est conservé sur votre disque.
EID_Readers, EID_Version et EID_License fonctionnent toujours, même sans licence. Vous pouvez donc vérifier que votre lecteur est reconnu avant d'acheter quoi que ce soit.
Le téléchargement apparaîtra ici dès que la première version sera prête. Vous voulez l'essayer maintenant ? Écrivez à info@filemakerlab.be.
Ce que vous achetez n'est donc pas le logiciel mais la levée de ces dix minutes. Si cela ne vous convient pas, supprimez le fichier : vous n'avez rien perdu.
Le téléchargement contient eIDPlugin_Demo.fmp12 : un fichier FileMaker avec toutes les rubriques, un bouton et le script ci-dessus. Carte dans le lecteur, un clic, c'est fait — vous n'avez rien à construire pour savoir si cela fonctionne. Il affiche aussi la version et le temps d'essai restant.
Placez le .fmplugin dans le dossier Extensions et redémarrez FileMaker. Les cinq fonctions apparaissent alors dans la fenêtre de calcul.
Carte dans le lecteur, puis appelez EID_Read depuis votre script. Le plug-in parle directement au lecteur et renvoie un seul JSON.
Avec JSONGetElement, prenez ce dont vous avez besoin. La photo arrive en base64 et entre directement dans un champ conteneur avec Base64Decode.
Toujours du JSON, y compris en cas d'erreur, et toujours avec un champ error. Votre script n'a donc qu'une seule forme à connaître : si error est vide, utilisez le reste. Les clés sont en anglais : surname pour le nom, givenNames pour les prénoms, nationalNumber pour le numéro de registre national, cardNumber pour le numéro de carte et photo pour la photo.
{ "error": "", "cardNumber": "592-1234567-89", "surname": "PIENS", "givenNames": "FILIP", "dateOfBirth": "08.08.1964", "placeOfBirth": "GENT", "gender": "M", "nationality": "Belg", "validUntil": "09.03.2032", "nationalNumber": "64080812345", "street": "Waregemsesteenweg 80", "postalCode": "9770", "municipality": "Kruisem", "photo": "/9j/4AAQSkZJRgABAQ…" } // et en cas d'erreur, la même forme : { "error": "There is no card in the reader.", "errorDetail": "0x8010000C" }
Set Variable [ $json ; EID_Read ] If [ JSONGetElement ( $json ; "error" ) ≠ "" ] Show Custom Dialog [ JSONGetElement ( $json ; "error" ) ] Exit Script [] End If Set Field [ eIDPlugin::surname ; JSONGetElement ( $json ; "surname" ) ] Set Field [ eIDPlugin::givenNames ; JSONGetElement ( $json ; "givenNames" ) ] Set Field [ eIDPlugin::street ; JSONGetElement ( $json ; "street" ) ] Set Field [ eIDPlugin::postalCode ; JSONGetElement ( $json ; "postalCode" ) ] Set Field [ eIDPlugin::municipality ; JSONGetElement ( $json ; "municipality" ) ] // la photo directement dans un champ conteneur Set Field [ eIDPlugin::photo ; Base64Decode ( JSONGetElement ( $json ; "photo" ) ; "photo.jpg" ) ]
Ceci est littéralement le script du fichier eIDPlugin_Demo.fmp12, l'exemple fourni avec le téléchargement. Les noms de rubriques sont identiques aux clés JSON, il n'y a donc rien à traduire. Notez le contrôle sur error en haut : sans lui, une lecture ratée remplit une fiche vide sans que vous le remarquiez.
Les données arrivent nettoyées, pas telles que la carte les livre. La puce complète les champs avec des espaces et des octets nuls, écrit la date de naissance sous la forme 08 AUG 1964, et après une fusion de communes accole l'ancienne commune au nom de rue : Waregemsesteenweg(KRU) 80. C'est utile pour la poste, pas pour un fichier clients — et cela casse vos recherches, vos tris et vos dédoublonnages. Le plug-in l'enlève et met la date de naissance dans la même forme que la date d'expiration.
EID_Read( { reader } )Lit la carte et renvoie tous les champs en JSON, avec la photo en base64. Sans argument, le premier lecteur est utilisé.
EID_ReadersLes lecteurs connectés, un par ligne. Vide signifie que le système ne voit aucun lecteur — la première question devant tout problème.
EID_VersionLa version du plug-in, utile dans un message d'erreur ou un écran d'informations.
EID_Register( key )Active la licence pour cette session. Un seul argument : la clé porte le nom auquel elle a été délivrée.
EID_LicenseL'état de la licence en clair — à quel nom elle est enregistrée, ou combien de temps d'essai il reste.
Appelez EID_Read depuis un script, derrière un bouton. Chaque appel est une conversation complète avec la puce et dure environ une seconde. Dans une rubrique de calcul, un calcul non stocké ou une expression surveillée du visualiseur de données, la carte est donc relue sans cesse, ce qui ralentit FileMaker. Les quatre autres fonctions sont peu coûteuses et peuvent être utilisées partout.
Le plug-in parle directement au lecteur. Pas de serveur, pas d'API, pas de compte, pas de connexion internet. Les données vont du lecteur vers votre fichier et nulle part ailleurs. Sous le RGPD, cela vous épargne un sous-traitant et un contrat de sous-traitance : aucun tiers ne voit les données d'identité des personnes à votre comptoir.
Le même code qui tourne dans eIDRent sur de vraies cartes, y compris la correction qui y tronquait la photo. Pas une nouvelle implémentation du protocole BELPIC.
Les erreurs reviennent aussi en JSON, avec le même champ error. Votre script n'a jamais deux formats à connaître, et un lecteur vide est un état du comptoir, pas une erreur de calcul.
La licence est délivrée à votre société et fonctionne sur chaque machine où vous l'installez, Mac ou Windows. Une nouvelle machine ou une réinstallation n'y change rien.
Dix minutes à chaque démarrage de FileMaker, sans clé et sans inscription. De quoi voir si votre lecteur suit et si le résultat vous convient.
Via Réglages → Plug-Ins → Configure, une fois par machine. Ou avec EID_Register dans votre script de démarrage, si vous préférez livrer la clé dans la solution.
Tout lecteur PC/SC reconnu par votre système convient. Ces deux-là sont testés et coûtent ensemble moins qu'une heure de votre temps.
Vous avez déjà un lecteur eID de votre banque ou de votre comptable ? Essayez-le : appelez EID_Readers et voyez s'il apparaît dans la liste.
Le plug-in lit une carte insérée dans un lecteur : sa place est sur la machine où quelqu'un se tient au comptoir. Sur FileMaker Server ou dans WebDirect, il n'y a pas de lecteur, donc rien à lire.
FileMaker Go ne charge pas de plug-ins — c'est une limite de FileMaker lui-même. Pour iPhone et iPad il y a eID 2 FMP, une application distincte qui lit la carte et transmet les données.
C'est la puce à contact qui est lue, donc la carte entre dans un lecteur. C'est volontaire : cela fonctionne aussi avec les cartes d'avant 2020, et aucun numéro CAN n'est nécessaire.
Uniquement la carte d'identité belge. Un passeport porte une puce d'un tout autre type, qu'un lecteur de cartes ordinaire n'atteint pas. Les permis de conduire non plus.
Encore une chose à savoir, car vos clients vous le demanderont : le numéro de registre national figure dans le résultat. C'est un numéro d'identification dont la conservation exige une base légale. Le transmettre est une chose ; le laisser atterrir sans qu'on s'en aperçoive dans chaque fichier clients en est une autre. Si vous n'en voulez pas, ignorez simplement ce champ dans votre script.
Vous recevez une clé au nom de votre société. Collez-la dans Réglages → Plug-Ins → eIDPlugin → Configure et elle fonctionne aussitôt — sans redémarrage.
Vous saisissez les coordonnées de votre société sur la page de commande — elles figureront sur votre facture. La clé arrive juste après le paiement.
Vers le paiementBancontact · Visa · Mastercard
Merci
Installation : dans FileMaker Pro, allez dans Réglages → Plug-Ins → eIDPlugin → Configure, collez la clé et cliquez sur Save. Cela prend effet immédiatement, et une seule fois par machine.
Nous vous avons également envoyé cette clé par e-mail.
Un instant
Nous vérifions votre paiement…