Aller au contenu

Intégration API et systèmes : pointeuses, documents, e-mail, ERP Vos logiciels reliés au terrain

ANTASY IT (a.it) relie vos logiciels de gestion à ce qui les entoure : pointeuses ZKTeco et Hikvision, lecture automatique des factures fournisseurs par IA, circuits de validation des e-mails, boutiques en ligne et API tierces. Nous construisons chaque liaison, puis nous l’exploitons et la surveillons : une intégration qui s’arrête sans bruit est pire que pas d’intégration.

Déjà reliés
Pointeuses · Lecture IA de factures · E-mail
Protocoles
REST · Webhooks · WebSockets · ISAPI · ZK/TCP
En production
Facturty (notre produit) · Groupe Damak
Mis à jour

Pointeuses, lecteurs et équipements : nous les relions à vos logiciels.

Pointeuse biométrique à empreinte digitale
Photo : équipement générique (Pexels), pas un matériel client.

Présentation

Qu’est-ce que l’intégration de systèmes, et quand en a-t-on besoin ?

L’intégration fait échanger des données entre des systèmes séparés sans ressaisie : la pointeuse envoie les pointages à l’application RH, la facture scannée remplit l’achat, la commande en ligne arrive dans l’ERP. On en a besoin dès qu’une information est recopiée à la main d’un outil à l’autre. ANTASY IT construit ces liaisons et les maintient en marche.

Le coût d’une intégration absente passe inaperçu parce qu’il est éparpillé : dix minutes par jour à ressaisir des factures fournisseurs, un export hebdomadaire des pointages vers Excel, une commande recopiée du back-office de la boutique vers la gestion. Chaque copie est une occasion d’erreur que quelqu’un découvre des semaines plus tard.

L’intégration supprime la copie. Le plus difficile est rarement le premier transfert ; c’est le jour où la pointeuse est hors ligne, où l’API répond par une erreur, où le document n’est pas tout à fait celui attendu. C’est là que va l’essentiel de notre travail.

Déjà relié

Qu’avons-nous déjà relié ?

Quatre types d’intégration tournent en production. Deux d’entre eux, le pointage et la gouvernance des e-mails, sont présentés sans nommer le client, avec leurs fonctions telles que publiées.

  • ISAPI · ZK/TCP

    Pointeuses biométriques

    Des terminaux Hikvision et ZKTeco sur plusieurs sites alimentent une application RH web : entrées, sorties, retards, anomalies et heures, avec l’état de chaque pointeuse en direct. Voir pointage biométrique.

  • Mistral Pixtral

    Lecture de documents par IA

    Dans Facturty, une facture fournisseur photographiée est lue par un modèle de vision et pré-remplit une facture d’achat vérifiée avant enregistrement. Voir logiciel de facturation.

  • Circuit de validation

    Gouvernance des e-mails

    Une couche au-dessus de la messagerie : les messages externes, entrants et sortants, attendent une approbation, chaque décision est gardée dans un historique consultable, et l’administration supervise toutes les boîtes.

  • Groupe Damak

    Plateforme en ligne et ERP

    La plateforme en ligne du groupe et l’ERP qui gère commandes, livraisons, factures et règlements, construits par nous comme un seul système. Voir plateforme B2B.

Mohamed Damak et Cie

Importation et distribution de pneus, depuis 1967 · Sfax et Tunis

La plateforme en ligne du groupe et l’ERP qui la sert, construits comme un seul système : commandes, livraisons, factures et règlements, avec des prix et des accès selon le segment du client.

Ce que nous avons construitVoir le site ↗ (nouvel onglet)

notre produit

Facturty

Logiciel de facturation et de gestion

Les factures fournisseurs sont lues par Pixtral, le modèle de vision de Mistral, puis affichées dans un formulaire modifiable où montants des lignes et totaux se recalculent avant qu’une personne n’enregistre la facture d’achat.

Nos règles

Comment construire des intégrations qui tiennent dans la durée ?

Six règles que nous appliquons à chaque liaison, quel que soit le protocole.

  1. Partir de vrais échantillons

    La documentation dit ce qu’un système devrait envoyer. Une journée de vrais pointages, de vraies factures ou de vraies réponses d’API montre ce qu’il envoie vraiment. Nous réunissons les deux avant d’écrire le connecteur.

  2. Donner une identité à chaque événement

    Un pointage, une commande ou un document est reconnu par ses propres identifiants : le lire deux fois ne le compte jamais deux fois.

  3. Rattraper après une coupure

    Le connecteur retient le dernier élément enregistré et reprend de là quand l’autre côté revient, au lieu de perdre ce qui s’est passé entre-temps.

  4. Ne jamais croire une donnée extérieure sur parole

    Tout est validé avant d’être écrit. Le résultat d’une IA est une proposition : dans Facturty, les totaux sont recalculés à partir des lignes et une personne confirme.

  5. Garder secrets et équipements privés

    Clés et mots de passe restent sur le serveur, jamais dans le navigateur. Les pointeuses se joignent par le chemin réseau convenu avec votre administrateur, et leurs adresses n’apparaissent dans aucune capture ni aucun document.

  6. Surveiller en production

    Erreurs et silences sont supervisés comme le reste de l’application. Voir DevOps et hébergement.

Gouvernance e-mail

Peut-on soumettre les e-mails entrants et sortants à validation ?

Oui. ANTASY IT a construit une couche de gouvernance sur la messagerie d’une entreprise : les messages externes, entrants et sortants, attendent une approbation avant d’être délivrés. Chaque message garde sa décision (approuvé, rejeté ou automatique) dans un historique consultable, avec une piste d’audit par expéditeur et par destinataire, supervisée par l’administration.

Ce type de contrôle convient aux entreprises qui doivent prouver ce qui est sorti et quand : documents envoyés aux clients, offres, fichiers transmis à des tiers. Les règles d’approbation, qui approuve et ce qui passe automatiquement se décident avec vous ; c’est l’historique qui rend le système utile des mois plus tard.

Déroulement

Comment se déroule un projet d’intégration ?

Cinq étapes, chacune avec un résultat vérifiable. Les délais se fixent une fois les deux côtés connus.

  1. 01

    Cartographier

    Les deux systèmes, leurs interfaces, leurs responsables et ce qui doit circuler dans quel sens.

  2. 02

    Échantillonner

    De vraies données de chaque côté : événements, documents, réponses d’API, y compris les cas bizarres.

  3. 03

    Construire

    Le connecteur, ses règles de validation et sa logique de rattrapage, sur une copie de test.

  4. 04

    Tester sur du réel

    Une vraie journée rejouée de bout en bout, comparée à ce qui avait été noté à la main.

  5. 05

    Exploiter

    Hébergé, surveillé, et mis à jour quand l’un des deux côtés change.

Technologies et limites

Avec quelles technologies, et que n’avons-nous pas encore relié ?

Nous travaillons avec ce que propose l’autre système : API REST, webhooks, WebSockets pour les écrans en direct, interfaces constructeur comme ISAPI chez Hikvision et le protocole ZKTeco, et modèles d’IA via leur API.

En production

  • REST
  • Webhooks
  • WebSockets
  • ISAPI
  • ZK/TCP
  • Mistral API
  • SMTP

Rien n’est annoncé avant de tourner

Deux intégrations ne figurent pas ici : les passerelles de paiement en ligne, parce que les boutiques que nous exploitons fonctionnent en paiement à la livraison, et El Fatoora (TTN), parce que notre travail s’arrête pour l’instant au format de la facture, pas au raccordement (voir logiciel de facturation). Les deux sont possibles ; aucune n’est présentée comme faite avant de tourner.

Voir aussi

Services liés

FAQ

Questions sur l’intégration API

Pouvez-vous relier notre ERP à une API tierce ?

En général, oui, dès lors que l’autre système propose une interface : API REST, webhooks, échange de fichiers ou base de données accessible. Nous partons de sa documentation et de vraies réponses, puis nous construisons un connecteur avec validation, reprises et rattrapage, et nous le surveillons une fois en ligne.

Que se passe-t-il quand l’autre système est en panne ?

Rien ne devrait se perdre. Nous construisons chaque connecteur pour qu’il retienne le dernier élément enregistré et reprenne de là au retour de l’autre côté, et chaque élément a une identité pour qu’une seconde lecture ne crée pas de doublon. Un long silence est traité comme un incident, pas comme une journée calme.

La lecture des documents par IA se fait-elle chez vous ou chez un prestataire ?

Chez un prestataire. Facturty envoie l’image de la facture à l’API de Mistral, où le modèle de vision Pixtral la lit et renvoie des données structurées. Nous le précisons pour la confidentialité : si vos documents ne doivent pas quitter vos serveurs, nous étudions d’autres options avant de développer quoi que ce soit.

Utilisez-vous des webhooks ou une interrogation régulière ?

Ce que l’autre système permet de façon fiable. Les webhooks transmettent les événements au moment où ils arrivent ; l’interrogation régulière est souvent la seule option avec des équipements. Dans les deux cas, le connecteur note où il s’est arrêté, pour rattraper un webhook manqué ou une interrogation interrompue.

Qui maintient l’intégration quand l’autre côté change ?

Nous, lorsque nous hébergeons et maintenons l’application. Les connecteurs sont supervisés comme le reste du système : une API modifiée se voit en général comme une erreur avant que quelqu’un ne constate des données manquantes. La correction se planifie alors comme toute autre évolution du logiciel que nous exploitons pour vous.

De quels accès avez-vous besoin pour relier nos systèmes ?

Idéalement, un environnement ou un compte de test de chaque côté, avec la documentation de l’interface. Quand seule la production existe, nous commençons par lire de vrais échantillons sans rien écrire, et convenons avec vous du moment où les écritures commencent. Clés et mots de passe restent sur le serveur.

Deux logiciels qui devraient se parler ? Dites-nous lesquels

Nommez les systèmes, les données et le sens. Nous revenons avec ce que propose chaque côté et ce que nous aurions besoin de voir.