Intégrations / ERP / Lemonsoft
Guide d’intégration de Lemonsoft pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de Lemonsoft explique aux partenaires et aux équipes informatiques comment connecter l’ERP Lemonsoft à SkyPlanner APS. SkyPlanner échange des données avec Lemonsoft dans les deux sens via la REST API de Lemonsoft :
- Les numéros de fabrication (työnumero), les phases de fabrication (työvaihe), les machines, les structures de produits, les matières et les horaires d’équipe prévus sont importés dans SkyPlanner.
- Les dates et heures de début et de fin prévues ainsi que la machine choisie sont renvoyées vers les phases de fabrication.
- Les confirmations des opérateurs sont renvoyées sous forme de déclarations de production.
- Les webhooks SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
Kaskea Group utilise SkyPlanner avec une intégration bidirectionnelle à Lemonsoft. L’équipe SkyPlanner configure l’intégration selon votre installation Lemonsoft lors du déploiement et en assure le support après la mise en production. Les partenaires et les développeurs peuvent également s’appuyer sur la REST API documentée de SkyPlanner (référence de l’API).
La REST API de Lemonsoft
L’API d’intégration de Lemonsoft est LemonRest, documentée au format Swagger 2.0, version v1. La build « LemonRest 2026.10 release-2026.10.2 » répertorie 422 chemins. (Swagger)
- L’URL de base est propre à chaque environnement. Vous la trouverez dans la gestion des utilisateurs, sous la gestion des environnements et les adresses des services, dans le champ Rest API. Sur la plateforme Azure de Lemonsoft, l’URL de base est
https://rest.lemon.fi. - Disponibilité. Pour les clients du service de plateforme Lemonsoft (Alustapalvelu), les REST API sont préinstallées. Il suffit d’attribuer les droits utilisateur nécessaires. (source)
- Environnement de test. Le client final le commande auprès de Lemonsoft Service Desk.
L’API distincte de suivi des temps Kellokortti n’est pas nécessaire pour l’ordonnancement.
Authentification
LemonRest fonctionne avec une session :
- Un appel à
POST /api/auth/loginavec UserName, Password, Database et ApiKey renvoie unsession_id. - Transmettez-le dans l’en-tête
Session-Idà chaque appel. - Renouvelez la session avec
POST /api/auth/renew. UtilisezGET /api/auth/alivepour vérifier son état.
POST /api/auth/login/token accepte un Token à la place du nom d’utilisateur et du mot de passe. Créez un utilisateur dédié à l’intégration, doté d’une clé API et des seuls droits nécessaires à l’intégration. (source)
Côté SkyPlanner, l’authentification à la REST API utilise un jeton API (SkyPlanner Settings > API). L’API est documentée au format Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Détection des modifications : requêtes différentielles
LemonRest ne propose aucun point de terminaison pour les webhooks ou les abonnements. Les modifications sont récupérées par une requête différentielle :
GET /api/production/main_ws/changed?updated_after=...renvoie les opérations modifiées depuis la dernière exécution.- Ajoutez
optimization=true. Ce paramètre a été ajouté dans la version 2026.6.3 pour supprimer la dépendance au journal et accélérer la requête. (notes de version) GET /api/log/deletion_eventsdétecte les opérations supprimées afin de retirer du planning les travaux annulés.
Interrogez l’API à quelques minutes d’intervalle. SkyPlanner envoie des webhooks lorsque l’état ou le planning change : le renvoi des données vers Lemonsoft est donc déclenché par les événements.
Correspondance des données
| Objet Lemonsoft (point de terminaison) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
Tuote, product_code (/api/products) | Produits et matières | Lemonsoft → SkyPlanner | Chargement initial, puis à chaque modification |
Tuoterakenne avec les lignes Työvaiheet (/api/products/structure, all_levels) | Structure de produit, sous-produits, étapes de fabrication avec temps de préparation | Lemonsoft → SkyPlanner | Chargement initial, puis à chaque modification |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Postes de travail, groupes de postes de travail | Lemonsoft → SkyPlanner | Chargement initial, puis rarement |
Työnumero sous forme de ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Ordres avec dates d’échéance et priorité | Lemonsoft → SkyPlanner | Interrogation différentielle à quelques minutes d’intervalle |
Työvaihe sous forme de ProductSubWorkStage (main_ws/sub_ws) : machine, setting_time, duration, work_amount_left | Opérations (étapes de fabrication) par poste de travail | Lemonsoft → SkyPlanner | Interrogation différentielle à quelques minutes d’intervalle |
Besoin en composants (main_ws/{worknumber}/materials) | Besoins en matières par opération | Lemonsoft → SkyPlanner | Avec chaque opération |
Horaires d’équipe prévus (/api/persons/plannedshifts) | Horaires d’équipe, personnel | Lemonsoft → SkyPlanner | Chaque jour, ou gestion des horaires d’équipe dans SkyPlanner |
Commande client liée à un numéro de fabrication (/api/orders/work/{work_number}) | Informations sur le client et la priorité | Lemonsoft → SkyPlanner | Avec chaque opération |
Champs start_time, end_time, machine_id de Työvaihe (PUT /api/production/workstage) | Début, fin et poste de travail prévus | SkyPlanner → Lemonsoft | À chaque modification du planning, via un webhook SkyPlanner |
Déclaration de production (POST main_ws/sub_ws/completion_entry) | Confirmations : quantités produites et rebutées, heures, personne | SkyPlanner → Lemonsoft | À chaque confirmation |
| Règles d’ordonnancement définies dans SkyPlanner | Postes de travail autorisés par opération, matrice des temps de préparation, outils | Gestion dans SkyPlanner | Configuration lors du déploiement |
Schémas d’intégration
1. Chargement initial des données de base. Récupérez les machines et leurs groupes, les structures de produits avec leurs phases de fabrication, ainsi que les phases de travail standard. Faites correspondre chaque machine physique à un poste de travail SkyPlanner. Utilisez les machines parentes (Isäkone) uniquement pour le regroupement, car elles cumulent les capacités de leurs machines enfants.
2. Synchronisation des numéros de fabrication. Récupérez les numéros de fabrication ouverts avec leurs phases depuis /api/production/workstage ou main_ws/sub_ws, en filtrant par état et en paginant les résultats. Maintenez-les ensuite à jour avec main_ws/changed. Utilisez work_amount_left pour la correspondance, et non work_amount, car Lemonsoft ordonnance selon la quantité restante. Les commandes fournisseurs alimentent l’ordonnancement de SkyPlanner fondé sur la disponibilité des matières : une phase attend donc la date de livraison de la commande fournisseur.
3. Renvoi du planning. Pour chaque phase placée ou déplacée par le moteur, SkyPlanner envoie PUT /api/production/workstage avec l’opération et ses sub_workstages. Chaque phase contient start_time, end_time et, si elle a été transférée sur une autre machine, machine_id.
4. Confirmations en atelier. Les opérateurs confirment le travail effectué avec SkyPlanner Mobile Confirmations ou Production Timer. Chaque confirmation est envoyée à completion_entry avec sub_workstage_id, person_number, done_amount, hours, failed_amount et job_done. Joignez material_consumptions lorsque la phase consomme des matières : Lemonsoft enregistre alors une déclaration de production standard (valmistuskirjaus).
5. Responsabilité des données et règles de résolution des conflits. Consignez ces règles avant la mise en production :
| Données | Système responsable |
|---|---|
| Produits, structures, phases de fabrication, quantités, état des opérations | Lemonsoft |
| Séquence des phases, dates et heures de début et de fin, choix de la machine | SkyPlanner |
| Postes de travail autorisés par opération, matrice des temps de préparation, outils | SkyPlanner |
| Horaires d’équipe et absences | Un seul système, choisi lors du cadrage |
| Déclarations de production et mouvements de stock | Lemonsoft, à partir des confirmations SkyPlanner |
Les principales sources de conflit sont l’ordonnancement automatique de Lemonsoft et l’action d’actualisation : tous deux repositionnent les phases non verrouillées. Laissez AUTOTIMING à 0 tant que SkyPlanner gère le planning. Si vous le laissez activé, verrouillez le planning de chaque numéro de fabrication mis à jour ; ce verrouillage fige toutes les phases de ce numéro. Koneiden kapasiteetin lukitus ne suffit pas à lui seul, car l’ordonnancement automatique déplace les opérations non verrouillées hors d’une journée verrouillée. (source)
Étapes habituelles du projet
La mise en œuvre s’achève normalement en quelques semaines après le début de l’accompagnement au déploiement. Au préalable, l’essai gratuit de 30 jours utilise vos propres données, issues d’un export Excel des numéros de fabrication, des phases et des machines.
- Cadrage. Définissez la table de correspondance, les règles de responsabilité des données et l’intervalle d’interrogation.
- Accès. Le client final commande un environnement de test auprès de Lemonsoft Service Desk et crée l’utilisateur d’intégration ainsi que la clé API.
- Chargement initial. Machines, groupes, structures de produits et phases de fabrication.
- Synchronisation des numéros de fabrication. Interrogation périodique des modifications, événements de suppression et renouvellement des sessions.
- Paramétrage des contraintes dans SkyPlanner. Postes de travail autorisés pour chaque opération, matrice des temps de préparation et outils.
- Renvoi des données vers Lemonsoft. Horaires des phases et déclarations de production, testés dans l’environnement de test.
- Fonctionnement en parallèle et mise en service. Comparez les résultats au Gantt actuel, corrigez les données de base, puis activez le renvoi des données vers Lemonsoft en production.
Les points à prévoir pour une intégration avec Lemonsoft
- Une machine par phase. Dans Lemonsoft, une phase est associée à une seule machine. Lors de la mise en place, les machines admissibles pour chaque produit sont définies à partir d’une liste ou des propriétés du produit. SkyPlanner choisit ensuite parmi ces possibilités.
- Capacité quotidienne. La capacité fixe est exprimée par jour, et les écarts ne sont pas associés à des horaires précis. Modélisez les horaires réels des équipes dans SkyPlanner ou récupérez les horaires planifiés.
- Quantité restante. Établissez la correspondance avec
work_amount_left. Les paramètres STARTJOB_AUTOTIMENOW et JOBDONE_AUTOTIMENOW déplacent également la charge dans Lemonsoft. - Expiration des sessions. Renouvelez la session avant les synchronisations longues et prévoyez la gestion d’une reconnexion imposée.
- Règles de confirmation. Avant l’envoi, vérifiez que chaque confirmation est compatible avec l’état de la phase, et espacez les appels lors des envois en rafale.
- Deux clients. LemonOnline et la version Windows partagent une même base de données : l’intégration fonctionne donc pour les deux.
- Structures volumineuses. Pour les imports volumineux, utilisez
/api/async/product/structureavec/api/async/status/{jobId}.
Intégration avec Lemonsoft : qui assure le paramétrage et le support ?
Le travail comprend la mise en correspondance avec vos machines, vos phases de fabrication et votre configuration Lemonsoft. Il porte aussi sur les règles d’ordonnancement gérées dans SkyPlanner : postes de travail autorisés pour chaque opération, matrice des temps de préparation et outils.
- L’équipe SkyPlanner configure l’intégration lors de la mise en place et en assure le support après la mise en service. Chaque usine utilise Lemonsoft à sa manière : cette connaissance du terrain est prise en compte dans le paramétrage.
- Votre partenaire Lemonsoft peut participer. Il connaît votre configuration et peut gérer le compte utilisateur de l’API, les droits et l’environnement de test. SkyPlanner fournit la REST API, la documentation Swagger/OpenAPI et les webhooks.
- Vos propres développeurs peuvent réaliser des développements complémentaires en utilisant la même REST API documentée avec un jeton d’API. Un jeton d’API suffit pour commencer, et l’équipe SkyPlanner vous accompagne si nécessaire.
Une fois la connexion établie, le moteur Arcturus réalise l’ordonnancement à partir des numéros de fabrication à jour de Lemonsoft, et les horaires planifiés sont reportés sur les phases de fabrication. 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 commencer.
Comparez les fonctions de planification de Lemonsoft dans notre page sur l’ordonnancement à capacité finie avec Lemonsoft. Retrouvez une vue d’ensemble sur la page Lemonsoft et les autres systèmes dans la rubrique des intégrations ERP.
Les avis des industriels sur SkyPlanner
Lemonsoftintégration bidirectionnelle avec SkyPlanner
Kaskea Group
Fabrication en sous-traitance : usinage CNC, structures en acier et assemblage
La production est planifiée dans SkyPlanner, avec une intégration bidirectionnelle à Lemonsoft.
Moins d’arrêtsdus aux ruptures de matières
« La valeur que nous apporte SkyPlanner, c’est un outil qui fonctionne au quotidien, notamment pour fixer les dates de livraison. »
Tommi Männistö, responsable de la planification de la production
Eskomatic · Usinage en sous-traitance
L’ordonnancement automatique de la charge permet de fixer des dates de livraison plus précises, et les arrêts de production dus aux ruptures de matières ont fortement diminué.
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 appareillages électriques
La planification de la production permet de gagner 2 heures de travail chaque semaine, et une nouvelle file d’opérations est transmise à la ligne 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 pour l’ensemble des postes de travail.
FAQ
Lemonsoft dispose-t-il d’une API pour les données de production ?
Oui. LemonRest donne accès aux ordres et aux phases de fabrication, aux machines, aux structures de produits, aux matières et aux horaires d’équipe, et permet d’envoyer les déclarations de fin de production. Il est préinstallé pour les clients Alustapalvelu et nécessite une clé d’API ainsi que des droits utilisateur.
Lemonsoft prend-il en charge les webhooks ?
Aucun point de terminaison de webhook n’est répertorié dans LemonRest. Les modifications sont récupérées au moyen de la requête différentielle main_ws/changed et des événements de suppression, avec une interrogation à intervalles de quelques minutes. Les webhooks de SkyPlanner transmettent les changements d’ordonnancement dès qu’ils surviennent.
Comment les horaires planifiés sont-ils réécrits dans Lemonsoft ?
Avec PUT /api/production/workstage, qui met à jour un ordre et ses phases de fabrication avec l’heure de début, l’heure de fin et la machine. Tant que SkyPlanner gère l’ordonnancement, laissez l’ordonnancement automatique de Lemonsoft désactivé, ou verrouillez le planning de chaque numéro de fabrication mis à jour. Les horaires restent ainsi tels que SkyPlanner les a définis.
Les confirmations des opérateurs dans SkyPlanner peuvent-elles être envoyées à Lemonsoft ?
Oui. Chaque confirmation est envoyée sous forme de déclaration de fin de production, avec les quantités produites et rejetées, les heures et la personne concernée. Ce fonctionnement est utilisé quotidiennement dans des projets clients.
Qui réalise l’intégration avec Lemonsoft ?
L’équipe SkyPlanner configure l’intégration bidirectionnelle selon votre configuration Lemonsoft lors de la mise en place, puis en assure le support après la mise en service. Votre partenaire Lemonsoft ou vos propres développeurs peuvent aussi réaliser des développements à l’aide de la REST API documentée de SkyPlanner. Un jeton d’API suffit pour commencer.
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 Lemonsoft, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
