Intégrations / ERP / Visma L7
Guide d’intégration APS de Visma L7 pour l’ordonnancement de la production
Ce guide d’intégration de Visma L7 explique aux partenaires et aux équipes informatiques comment relier Visma L7 à SkyPlanner APS. SkyPlanner échange des données dans les deux sens avec Visma L7 via la Visma L7 REST API :
- Les numéros de travail (työnumero), les phases de travail (työnvaihe), les ressources, les structures de produits, les composants, les matières, les niveaux de stock, les lignes de vente et les lignes d’achat sont importés.
- Pour chaque fiche de travail, la ressource, la date de début, la priorité, la personne affectée et les heures prévues par jour sont renvoyées via
PUT /manufphases/. - La capacité du calendrier des ressources est synchronisée via
POST /resourceupdates/. - Les événements de production saisis dans les files de travail de L7 sont récupérés via
GET /manufevents/. - Les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles se produisent.
L’équipe SkyPlanner configure l’intégration en fonction de votre environnement L7 lors de la mise en place et en assure le support après la mise en production. Les partenaires et les développeurs peuvent aussi s’appuyer sur la REST API documentée de SkyPlanner (référence de l’API).
La REST API de Visma L7
L’API s’appelle Visma L7 – REST API. Sa documentation au format OpenAPI 3.0.3 comprend un historique des modifications (documentation). Elle fonctionne sur Visma LTR.
- Chemin de base. Il s’agit de
/ltrws/REST/L7sur votre propre serveur LTR, sur site ou dans le service d’hébergement d’applications de Visma. - Licences. Chaque point de terminaison nécessite une licence distincte. L’écriture du planning via
PUT /manufphases/nécessite la licence L7RMFPP, et les mises à jour de capacité nécessitent L7RMCAP. Les points de terminaison de lecture ont leurs propres licences. - Pagination. Les listes sont paginées avec
pageSizeetrecAfter, et filtrées avecqueryKey1,queryKey2etqueryString.
Authentification
Deux jetons accompagnent chaque appel à L7 :
- hash sélectionne la base de données et la société.
- token identifie l’utilisateur de l’API.
Votre administrateur LTR crée l’utilisateur de l’API dans Visma LTR, le rattache à la société L7, lui attribue des profils et crée son jeton utilisateur (premiers pas). Utilisez un compte dédié à l’intégration, doté uniquement des droits nécessaires.
Côté SkyPlanner, l’authentification à la REST API repose sur un jeton d’API envoyé dans l’en-tête Authorization-Token. Vous le créez dans Settings > API. Le tutoriel d’intégration vous guide dans les premiers appels.
Détection des modifications : modifiedAfter
La REST API de L7 ne propose pas de webhooks. Les modifications sont récupérées par interrogation périodique :
- Activez la journalisation des modifications (DBLOG) dans la maintenance des fichiers de L7 (Tiedostohuolto) pour les tables lues par l’intégration, notamment les fiches de travail et les composants.
- Appelez les points de terminaison de lecture en réglant
modifiedAftersur la date et l’heure de la dernière exécution. Les enregistrements supprimés sont renvoyés avec un indicateur de suppression : les travaux annulés sont ainsi retirés du planning. - Effectuez ces interrogations toutes les quelques minutes. SkyPlanner envoie des webhooks lorsque l’état ou le planning change : le renvoi des données vers L7 est donc déclenché par les événements.
Correspondance des données
| Objet Visma L7 (point de terminaison) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
Tuote (GET /products/) | Produits et matières | L7 → SkyPlanner | Chargement initial, puis à chaque modification |
Composants associés à un numéro de travail (GET /manufcomponents/) | Sous-produits | L7 → SkyPlanner | Interrogation périodique avec modifiedAfter |
Besoins en matières (GET /manufmaterials/) | Besoins en matières par opération | L7 → SkyPlanner | Interrogation périodique avec modifiedAfter |
Arborescence des ressources (KRYH) avec le nombre de machines (GET /manufresources/) | Postes de travail et groupes de postes de travail | L7 → SkyPlanner | Chargement initial, puis rarement |
Fiche de travail (TSUUNR) par phase (GET /manufphases/) | Opérations (étapes du processus) par poste de travail | L7 → SkyPlanner | Interrogation toutes les quelques minutes |
Niveaux de stock (GET /stockbalances/) | Stock | L7 → SkyPlanner | Interrogation périodique |
Lignes d’achat (GET /purchaserows/) | Commandes d’achat avec dates de livraison | L7 → SkyPlanner | Interrogation périodique |
Commandes et lignes de vente (GET /salesorders/, GET /salesrows/) | Échéances, priorité du client | L7 → SkyPlanner | Interrogation périodique |
Événements de production (GET /manufevents/) | Avancement par opération | L7 → SkyPlanner | Interrogation périodique |
Champs resource, startDate, priority, person, schedulingDays de la fiche de travail (PUT /manufphases/) | Poste de travail prévu, date de début, ordre de passage et heures prévues par jour | SkyPlanner → L7 | À chaque modification du planning, via un webhook SkyPlanner |
Capacité du calendrier des ressources (POST /resourceupdates/) | Capacité par équipe | SkyPlanner → L7 | Lors des changements d’horaires d’équipe |
| Règles d’ordonnancement définies dans SkyPlanner | Postes de travail autorisés, matrice des temps de réglage, outils, personnes | Gérées dans SkyPlanner | Configurées lors de la mise en place |
Schémas d’intégration
1. Chargement initial des données de base. Lisez l’arborescence des ressources et associez chaque machine à son propre poste de travail SkyPlanner. Lorsqu’une ressource L7 comprend plusieurs machines, créez un poste de travail par machine et un groupe de postes de travail pour la ressource. Lisez les produits et leurs structures, avec les phases de travail correspondantes.
2. Synchronisation des numéros de travail. Lisez les fiches de travail ouvertes via GET /manufphases/, puis maintenez-les à jour avec modifiedAfter. Lisez les composants et les besoins en matières de chaque numéro de travail, ainsi que les niveaux de stock et les lignes d’achat, afin que chaque phase attende la date de livraison de la ligne d’achat correspondante.
3. Renvoi du planning vers L7. Pour chaque phase placée ou déplacée par le moteur, SkyPlanner appelle PUT /manufphases/. Le corps de la requête contient une entrée workSheet par fiche de travail, avec :
number, la fiche de travail, etresource, la ressource choisiestartDateetpriority, pour que les files de travail de L7 affichent l’ordre défini par SkyPlannerperson, lorsqu’un opérateur est affecté nominativementschedulingDays, les heures prévues pour chaque date
L7 conserve telle quelle la priorité définie par un système externe (source) : l’ordre est donc maintenu dans les files de travail.
4. Synchronisation de la capacité. Lorsque les horaires d’équipe, les congés ou les heures supplémentaires changent dans SkyPlanner, POST /resourceupdates/ écrit la nouvelle capacité dans le calendrier des ressources de L7. Les vues de charge de L7 correspondent alors au planning.
5. Avancement en atelier. Les opérateurs continuent leurs saisies dans les files de travail de L7 et dans Visma LTR. SkyPlanner lit ces événements via GET /manufevents/. Les opérateurs peuvent aussi confirmer les travaux dans SkyPlanner Mobile Confirmations. Autopilot réordonnance à partir de l’une ou l’autre source, et le prochain renvoi vers L7 transmet les nouveaux horaires.
6. Responsabilité des données et gestion des conflits. Consignez ces règles avant la mise en production :
| Données | Système responsable |
|---|---|
| Produits, structures, phases de travail, quantités, état du numéro de travail | Visma L7 |
| Enchaînement des phases, dates de début, heures par jour, choix des ressources | SkyPlanner |
| Postes de travail autorisés, matrice des temps de réglage, outils, personnes | SkyPlanner |
| Horaires d’équipe et absences | SkyPlanner, avec écriture dans le calendrier des ressources de L7 |
| Événements de production et mouvements de stock | Files de travail de Visma L7 et LTR |
La principale source de conflits est la planification propre à L7. Le calcul des besoins et la planification détaillée peuvent repositionner les phases non verrouillées. Exécutez-les uniquement pour les matières et les réservations, sans replanifier les phases gérées par SkyPlanner.
Étapes habituelles du projet
La mise en œuvre est normalement achevée dans les semaines qui suivent le début de l’accompagnement. Avant cela, l’essai gratuit de 30 jours utilise vos propres données, issues d’un export Excel des numéros de travail, des phases et des ressources.
- Cadrage. Définissez la table de correspondance, les règles de responsabilité des données et l’intervalle d’interrogation.
- Accès et licences. Obtenez les licences des points de terminaison REST retenus. L’administrateur LTR crée l’utilisateur de l’API, le hash et le token, idéalement d’abord dans une société de test.
- Journalisation des modifications. Activez DBLOG pour les tables que vous lisez.
- Chargement initial. Ressources, produits, structures et phases de travail.
- Synchronisation des numéros de travail. Interrogation périodique avec modifiedAfter, gestion des suppressions et pagination.
- Configuration des contraintes dans SkyPlanner. Postes de travail autorisés, matrice des temps de réglage, outils et personnes.
- Renvoi des données vers L7.
PUT /manufphases/etPOST /resourceupdates/, testés dans la société de test. - Fonctionnement en parallèle et mise en service. Comparez les résultats au planning actuel, corrigez les données de base, puis activez la réécriture dans l’environnement de production.
Les points à prévoir pour une intégration avec Visma L7
- Licences par point de terminaison. Recensez tous les points de terminaison dès le début et obtenez les licences avant les tests.
- Nombre de machines. Dans L7, une ressource comportant plusieurs machines répartit le travail entre elles (source). Décomposez-la en postes de travail dans SkyPlanner et renvoyez la ressource attendue par L7.
- Heures par jour. L7 enregistre le planning sous forme d’heures par date. SkyPlanner envoie des données
schedulingDaysdont le total correspond à la durée de l’étape. - Calendrier de l’usine. Veillez à ce qu’il soit complet : les périodes manquantes placent les étapes à des dates passées (source).
- Ordres de fabrication sur stock.
mainNumber,subNumber,rowNumberetnewQuantityservent uniquement à modifier la quantité d’un ordre de fabrication sur stock. Ne les renseignez pas pour les travaux sur commande client. - Le prochain ERP. Visma a arrêté les nouveaux développements de L7, et l’utilisation du produit prendra fin à la fin de 2028 (annonce de Visma). Conservez les règles d’ordonnancement dans SkyPlanner, et non dans les champs de L7, pour les retrouver lorsque vous changerez d’ERP.
Intégration avec Visma L7 : qui assure la configuration et le support ?
Le travail comprend la mise en correspondance avec vos ressources, vos étapes de fabrication et votre configuration L7. Il porte aussi sur les règles d’ordonnancement conservées dans SkyPlanner : postes de travail autorisés, matrice des temps de réglage, outils et personnel.
- L’équipe SkyPlanner configure l’intégration lors du déploiement et en assure le support après la mise en service. Chaque usine utilise L7 à sa manière : c’est à cette étape que cette connaissance du terrain entre en jeu.
- Votre partenaire Visma peut participer. Il connaît votre configuration L7 et LTR et peut prendre en charge l’utilisateur API, les licences et la société de test. SkyPlanner fournit la REST API, la documentation Swagger/OpenAPI et les webhooks.
- Vos propres développeurs peuvent réaliser leurs développements en utilisant la même REST API documentée avec un jeton API. Un jeton API suffit pour démarrer, et l’équipe SkyPlanner vous accompagne si nécessaire.
Lorsque vous remplacez L7, la même configuration SkyPlanner se connecte au nouvel ERP. Consultez les pages consacrées à Business Central, Visma Net, Lemonsoft, Monitor ERP et Odoo.
SkyPlanner est proposé à partir de 199 € par mois, avec 5 postes de travail inclus et une facturation mensuelle. L’intégration fait l’objet d’un devis préalable, adapté à vos processus et à vos besoins, en même temps que votre abonnement. Vous connaissez ainsi le coût total avant de démarrer.
Pour comparer les fonctions de planification natives de L7, consultez Visma L7 propose-t-il un ordonnancement à capacité finie ? Retrouvez la vue d’ensemble sur la page Visma L7 et les autres systèmes sur la page des intégrations ERP.
Les industriels témoignent sur SkyPlanner
1 000 et plusordres de fabrication ordonnancés automatiquement
« Nous maîtrisons la production d’une tout autre manière, et notre connaissance de la capacité est passée à un tout autre niveau. »
Hannu Ryynänen, directeur général
Mamec · Mélangeurs industriels, pompes et sous-traitance de haute technologie
Des milliers d’ordres de fabrication sont ordonnancés automatiquement, et toute l’entreprise dispose d’une vue en temps réel de la production.
98 %de livraisons dans les délais, contre environ 50 % auparavant
« SkyPlanner joue un rôle décisif pour que nous continuions à respecter nos délais de livraison. »
Hannu Lahtinen, directeur général
KJH-Comp · Tôlerie mécanique et sous-traitance industrielle
Le taux de respect des délais de livraison est passé d’environ 50 % à un niveau atteignant 98 %, et l’ordonnancement ne mobilise désormais qu’un responsable au lieu de deux.
2 hgagnées chaque semaine
« Avec SkyPlanner, nous sommes passés d’une planification de la production sur des feuilles Excel à une optimisation de la production en temps réel. »
Kalle Kalliomäki, spécialiste de la chaîne logistique
UTU · Tableaux et appareillage électriques
La planification de la production permet de gagner 2 heures de travail par semaine, et une nouvelle file d’attente des opérations est transmise à la ligne de production en quelques secondes.
+90 %d’efficacité en production
« L’efficacité en production a augmenté de 90 %. »
Abdul Rucyinga, responsable informatique
Laboratory & Allied · Fabrication pharmaceutique
L’efficacité en production a augmenté de 90 %, et il faut moins de 30 minutes pour établir un planning optimisé sur trois mois couvrant tous les postes de travail.
FAQ
Visma L7 dispose-t-il d’une API pour les données de production ?
Oui. La REST API de Visma L7, sur Visma LTR, donne accès aux étapes de fabrication, ressources, pièces, matières, événements de production, produits, niveaux de stock, lignes de vente et lignes d’achat. Chaque point de terminaison nécessite une licence distincte. L’administrateur LTR crée l’utilisateur API et les jetons.
Comment le planning est-il retransmis à Visma L7 ?
Avec PUT /manufphases/, qui met à jour, pour chaque fiche de travail, la ressource, la date de début, la priorité, la personne affectée et les heures planifiées pour chaque date. POST /resourceupdates/ écrit la capacité dans le calendrier des ressources. L7 conserve la priorité externe : les files de travail suivent donc l’ordre défini par SkyPlanner.
Visma L7 prend-il en charge les webhooks ?
Aucun webhook n’est documenté. Activez la journalisation des modifications pour les tables concernées et interrogez-les périodiquement avec modifiedAfter. Les webhooks de SkyPlanner transmettent les changements du planning dès qu’ils se produisent.
Quel logiciel d’ordonnancement s’intègre à Visma L7 ?
SkyPlanner APS s’intègre à Visma L7 dans les deux sens via la REST API de L7. Visma référence Skycode avec SkyPlanner sur sa page des intégrations L7. L’équipe SkyPlanner configure l’intégration lors du déploiement.
Qui réalise l’intégration avec Visma L7 ?
L’équipe SkyPlanner adapte l’intégration bidirectionnelle à votre configuration L7 lors du déploiement et en assure le support après la mise en service. Votre partenaire Visma ou vos propres développeurs peuvent aussi réaliser des développements avec la REST API documentée de SkyPlanner. Un jeton API suffit pour démarrer.
Peut-on tester SkyPlanner avant de réaliser l’intégration ?
Oui. L’essai gratuit de 30 jours permet d’utiliser jusqu’à 20 postes de travail avec des imports Excel ou CSV depuis L7, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
