Connexion entre le STS (SAM’URAI) et l’ERP client
⚠️ Prérequis important
L’API n’est pas encore disponible à ce jour ; en revanche, le SFTP est pleinement opérationnel. La mise à disposition de l’API est prévue prochainement.
Dans les deux cas (SFTP comme API), l’intervention d’un référent technique du SI client est indispensable.
Ces sujets sont techniques et nécessitent l’implication du service IT du client pour la configuration, la sécurité, les tests et la mise en production.
1️⃣ Contexte
Dans notre gamme de rangement SAM’URAI :
STM = logiciel embarqué sur la machine (écran utilisateur)
STS = logiciel de supervision (centralisation, gestion des droits, stocks, reporting)
ERP client = système de gestion du client (SAP, Oracle, Sage, etc.)
De plus en plus de clients demandent une connexion entre le STS et leur ERP pour automatiser :
Les mouvements de stock
Les consommations
Les utilisateurs
Les commandes C&C
etc
Deux solutions techniques principales existent : SFTP ou API.
2️⃣ Le SFTP : échange de fichiers
🔹 Définition simple
Le SFTP (Secure File Transfer Protocol) est un système d’échange de fichiers déposés sur un serveur sécurisé.
👉 On dépose un fichier → L’autre système le récupère → Il le traite.
🔹 Fonctionnement dans notre contexte
Exemple :
Le STS génère un fichier CSV (par exemple pour un rapport de consommation)
Il dépose ce fichier sur un serveur SFTP.
L’ERP du client récupère le fichier toutes les X minutes/heures.
L’ERP importe les données.
Inversement :
L’ERP peut déposer un fichier contenant des utilisateurs, articles, etc.
Le STS le récupère et l’intègre.
🔹 Caractéristiques
Critère | SFTP |
Type d’échange | Fichiers |
Temps réel | ❌ Non (traitement différé) |
Complexité | Simple à mettre en place |
Traçabilité | Fichiers archivables |
Dépendance IT client | Faible à moyenne (léger script à créer) |
3️⃣ L’API : communication en temps réel
🔹 Définition simple
Une API (Application Programming Interface) permet à deux logiciels de communiquer directement entre eux en temps réel.
👉 Le STS envoie une requête → L’ERP répond immédiatement.
🔹 Fonctionnement dans notre contexte
Exemple :
Un opérateur prend un article sur une machine SAM’URAI.
Le STM envoie l'information au STS.
Le STS appelle l’API de l’ERP.
L’ERP enregistre immédiatement la sortie de stock.
Ou inversement :
L’ERP envoie directement au STS la création d’un utilisateur.
Le STS l’intègre instantanément.
🔹 Caractéristiques
Critère | API |
Type d’échange | Requêtes directes |
Temps réel | ✅ Oui |
Complexité | Plus technique |
Maintenance | Gestion des versions API |
Traçabilité | Logs systèmes |
Dépendance IT client | Forte |
🔹 Avantages
✔️ Temps réel
✔️ Synchronisation immédiate
✔️ Moins de fichiers à gérer
✔️ Automatisation avancée
🔹 Inconvénients
❌ Mise en place plus complexe
❌ Dépend fortement du SI client
❌ Nécessite sécurité avancée (authentification, tokens, etc.)
❌ Maintenance plus technique
4️⃣ Comparaison synthétique
| SFTP | API |
Mode de communication | Échange de fichiers | Dialogue direct |
Temps réel | ❌ | ✅ |
Complexité | Moyenne | Élevée |
Robustesse | Très stable | Dépend de l’infrastructure |
Idéal pour | Clients IT simples | Gros groupes/beaucoup de changements internes |
Volume de données | Batch | Continu |
5️⃣ Quand proposer quoi ?
👉 SFTP recommandé si :
Le client a un ERP ancien
Le service IT est limité
Le besoin n’est pas en temps réel
Les échanges sont quotidiens / horaires
Projet rapide à mettre en œuvre
👉 API recommandée si :
Le client veut du temps réel
Le stock doit être synchronisé immédiatement
Projet Industrie 4.0
Intégration avancée (centres de coûts dynamiques, validation en direct)
ERP moderne (SAP S/4HANA, Oracle Cloud, etc.)
📌 Fonctionnalités actuelles via SFTP
🔄 Flux ERP → SFTP → STS
Le client dépose un fichier sur le serveur SFTP, qui est ensuite intégré par le STS.
✅ Ce que nous savons faire aujourd’hui :
Mise à jour des utilisateurs STM
Création d’utilisateurs
Modification des informations (nom, prénom, badge, etc.)
Mise à jour des produits / articles
Création de nouveaux articles
Modification des articles existants
Mise à jour des références, désignations, catégories, etc.
🔄 Flux STS → SFTP → ERP
Le STS génère des fichiers déposés sur le serveur SFTP, que l’ERP vient récupérer.
✅ Ce que nous savons exporter aujourd’hui :
Export de l’ensemble des rapports disponibles dans le STS, notamment :
Mouvements de stock
États de stock
(et tout autre rapport généré par le STS)