Intégrations / ERP / Comarch ERP XL
Guide d’intégration de Comarch ERP XL pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide explique aux partenaires et aux équipes informatiques comment connecter Comarch ERP XL à SkyPlanner APS. SkyPlanner échange des données avec Comarch ERP XL dans les deux sens, par les interfaces de Comarch :
- Les ordres de fabrication (zlecenia produkcyjne), avec leurs processus et opérations, les technologies, les postes de charge, les ressources, les articles, les stocks et les commandes fournisseurs sont importés dans SkyPlanner.
- Les dates et heures de début et de fin planifiées sont renvoyées vers chaque opération de l’ordre de fabrication via XL API.
- Si vous le souhaitez, les temps saisis par les opérateurs sont renvoyés sous forme de déclarations de réalisation des opérations.
- Les webhooks SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
L’équipe SkyPlanner configure l’intégration en fonction de votre installation Comarch ERP XL lors du déploiement et en assure le support après la mise en service. Ce guide s’adresse aux partenaires et aux développeurs qui souhaitent y participer ou développer eux-mêmes à partir de la REST API documentée de SkyPlanner (documentation de référence de l’API).
Les interfaces d’intégration de Comarch ERP XL
Comarch indique trois moyens de communiquer avec ERP XL : « DCOM, direct database connection (SQL Client), REST API » (DCOM, connexion directe à la base de données via SQL Client, REST API) (Comarch, traduction). Pour un outil d’ordonnancement, deux de ces interfaces assurent les échanges :
- XL API (CDN_API.DLL). « These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system. » (Ces fonctions sont regroupées dans la bibliothèque CDN_API.DLL, installée avec l’ensemble du système Comarch ERP XL.) (Aide Comarch, traduction) Un programme externe se connecte avec XLLogin, appelle des fonctions qui partagent la même session, puis se déconnecte avec XLLogout. Chaque structure possède un champ Wersja qui sélectionne la version du jeu de paramètres correspondant à votre version d’ERP XL.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 expose des microservices REST : « Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint. » (Chaque microservice RestAPI expose sa propre documentation interactive au point d’accès /swagger.) (Aide Comarch, traduction)
La connexion directe SQL Client donne accès en lecture à la base de données ERP XL pour consulter les données de base et les ordres, selon les modalités convenues avec votre équipe informatique et votre partenaire Comarch.
Les fonctions de XL API pour la production
Comarch documente les fonctions de production suivantes (XL128) :
| Domaine | Fonction | Rôle |
|---|---|---|
| Technologies | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Crée une technologie, une opération, ou ajoute un poste de charge, une matière ou un produit à une opération |
| Ordres de fabrication | XLNoweZlecenieProd | Crée un ordre de fabrication |
| Ordres de fabrication | XLZamknijZlecenieProd | Planifie, replanifie, solde ou clôture un ordre de fabrication selon le code d’action choisi |
| Opérations | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Ajoute une opération ou une ressource à un processus de production |
| Planning | XLDodajTerminDoProcesuProd | Ajoute une plage de dates à une opération : IdCzynnosci, TerminOd, TerminDo |
| Réalisation | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Ajoute une déclaration de réalisation d’opération à l’ordre et modifie la quantité réalisée |
| Documents | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Génère les documents RW et PW pour les objets de production |
Authentification et accès
- XL API. L’intégration se connecte à une base de données avec XLLogin en tant qu’opérateur ERP XL et obtient une session pour les appels suivants. La DLL s’exécute sur une machine Windows où ERP XL est installé. Le service de réécriture fonctionne donc dans votre réseau, à proximité d’ERP XL.
- REST API. L’accès est configuré pour chaque installation d’ERP XL Web ; la page Swagger de chaque microservice en documente les appels.
- Lecture SQL. Un compte d’accès à la base de données en lecture seule, approuvé par votre équipe informatique.
Côté SkyPlanner, l’authentification à la REST API repose sur un jeton API transmis dans l’en-tête Authorization-Token (SkyPlanner Settings > API). L’API est documentée dans Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Événements et interrogation périodique
La documentation consultée pour Comarch ERP XL ne mentionne aucun webhook sortant. L’APS de Comarch récupère les données lorsque le planificateur clique sur « Aktualizuj dane z ERP » (actualiser les données depuis l’ERP) (Aide Comarch APS).
ERP XL est donc interrogé périodiquement. Les lectures, filtrées sur les ordres de fabrication ouverts et les modifications récentes, permettent de récupérer les nouvelles tâches de production. La fréquence est définie pour chaque usine : à quelques minutes d’intervalle pour les ordres de fabrication, jusqu’à une fois par heure pour les stocks.
SkyPlanner envoie des webhooks lorsque l’état ou le planning change. La réécriture dans l’ERP est donc déclenchée par ces événements.
Correspondance des données
| Objet Comarch ERP XL (interface) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
| Karty towarów, unités de mesure (REST ou lecture SQL) | Produits et matières | ERP XL → SkyPlanner | Chargement initial, puis interrogation périodique |
| Technologia : opérations, matières, produits semi-finis et produits par opération | Structure du produit, sous-produits et matières par étape du processus | ERP XL → SkyPlanner | Chargement initial, puis à chaque modification |
| Opérations de Technologia : postes de charge, ressources et temps | Étapes du processus avec durées, temps de réglage et de démontage | ERP XL → SkyPlanner | Chargement initial, puis à chaque modification |
| Gniazda robocze et zasoby (machines, outils, salariés) | Postes de travail, groupes de postes de travail, outils et personnel | ERP XL → SkyPlanner | Chargement initial, puis rarement |
| Kalendarze i okresy, przestoje i awarie | Horaires d’équipe, périodes non travaillées et arrêts | ERP XL → SkyPlanner | Chaque jour, ou gestion des horaires d’équipe directement dans SkyPlanner |
| Zlecenia produkcyjne (ZP) avec processus, opérations, matières, échéance et priorité | Ordres et opérations avec échéances et besoins en matières | ERP XL → SkyPlanner | Interrogation à quelques minutes d’intervalle |
| Stock par entrepôt | Quantités en stock | ERP XL → SkyPlanner | Interrogation chaque heure ou à chaque calcul du planning |
| Zamówienia zakupu (ZZ) avec dates de livraison | Commandes fournisseurs et matières attendues par date de livraison | ERP XL → SkyPlanner | Interrogation chaque heure ou à chaque calcul du planning |
| Dates des opérations : TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Début et fin planifiés par opération | SkyPlanner → ERP XL | À chaque modification du planning, via un webhook SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Temps saisis et confirmations des opérateurs | SkyPlanner → ERP XL | À chaque confirmation ou par équipe, si cette option est retenue |
| Absent d’ERP XL | Matrice des temps de changement, outils gérés comme ressources à capacité limitée, opérations à plusieurs opérateurs, machines et personnel de substitution | Géré dans SkyPlanner | Configuré lors du déploiement |
Schémas d’intégration
1. Chargement initial des données de base. Récupérez les articles, les technologies, les postes de charge, les ressources et les calendriers. Définissez précisément la correspondance des postes de charge dans SkyPlanner : un poste de charge comptant quatre machines devient un groupe de postes de travail ou quatre postes de travail. Les outils répertoriés dans les ressources ERP XL deviennent des outils à capacité limitée dans SkyPlanner, et les salariés deviennent du personnel associé à des horaires d’équipe.
2. Synchronisation des ordres et des commandes. Récupérez les ordres de fabrication avec leurs opérations et leurs matières, ainsi que les commandes fournisseurs ouvertes. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande fournisseur et met à jour le stock lorsque celle-ci passe au statut Delivered.
3. Réécriture du planning dans l’ERP. Lorsque le moteur place ou déplace une opération, un webhook SkyPlanner déclenche le service de réécriture. Celui-ci appelle XLDodajTerminDoProcesuProd avec les valeurs TerminOd et TerminDo de l’opération. Chaque opération ZP dispose ainsi des dates de début et de fin prévues par SkyPlanner.
4. Déclarations en atelier. Les opérateurs déclarent leur travail avec SkyPlanner Mobile Confirmations ou Production Timer, et les relevés de temps maintiennent le planning à jour. Vous choisissez si les temps réels sont renvoyés à l’ERP. Si oui, le service ajoute les réalisations avec XLDodajRealizacjeOperacjiProd, et les documents RW et PW suivent vos règles ERP XL. Si vous utilisez Comarch MES sur certains postes, conservez une seule source de déclaration par opération.
5. Responsabilité des données et gestion des conflits. Consignez les règles avant la mise en production :
| Données | Système responsable |
|---|---|
| Articles, gammes de fabrication, quantités, statut ZP, calcul des coûts | Comarch ERP XL |
| Séquence des opérations, dates de début et de fin, affectation des ressources | SkyPlanner |
| Matrice des temps de changement de série, besoins en outils et en opérateurs, ressources alternatives | SkyPlanner |
| Horaires des équipes, calendriers et arrêts | Un seul système, choisi lors du cadrage |
| Réalisations, documents RW et PW | Comarch ERP XL, avec saisie directe ou transfert depuis les relevés de temps SkyPlanner |
Désignez un seul système pour écrire les dates des opérations. Si la replanification automatique d’ERP XL ou Comarch APS continue d’écrire des dates sur les mêmes ordres de fabrication, désactivez cette fonction pour les ordres ordonnancés par SkyPlanner.
Les étapes habituelles du projet
La mise en œuvre s’achève généralement en quelques semaines après le début de l’accompagnement. Au préalable, validez le planning pendant l’essai gratuit de 30 jours avec les postes de charge, les gammes de fabrication et les ordres de fabrication ouverts exportés d’ERP XL au format CSV ou Excel.
- Correspondance des données. Définissez la table de correspondance, les règles de responsabilité des données, les fréquences de synchronisation et le renvoi éventuel des réalisations à l’ERP.
- Accès à ERP XL. Créez le compte opérateur dédié à l’intégration, configurez la connexion en lecture et déployez le service de réécriture sur un hôte où ERP XL est installé. Effectuez d’abord les tests sur une copie de la base de données.
- Chargement initial. Articles, gammes de fabrication, postes de charge, ressources et calendriers.
- Synchronisation des ordres de fabrication et des commandes fournisseurs. Interrogation périodique avec filtres et nouvelles tentatives en cas d’échec.
- Configuration des contraintes dans SkyPlanner. Matrice des temps de changement de série, outils, nombre d’opérateurs par opération et machines ou personnel de remplacement.
- Réécriture du planning dans l’ERP. Appels à XLDodajTerminDoProcesuProd déclenchés par les webhooks SkyPlanner, avec transfert des réalisations si cette option est retenue.
- Tests en parallèle. Faites fonctionner SkyPlanner en parallèle du planning actuel, comparez les dates et corrigez les données de base.
- Mise en production. Activez la réécriture dans l’ERP une fois les données concordantes.
Les points à prévoir pour une intégration avec Comarch ERP XL
- Capacité saisie manuellement. Dans ERP XL, la capacité d’un poste de charge est une valeur définie par l’utilisateur, assortie d’un % de charge autorisé. SkyPlanner calcule au contraire la capacité à partir des horaires réels et des ressources. Configurez donc soigneusement les horaires des équipes et n’utilisez plus ce pourcentage.
- Ressources illimitées. Dans ERP XL, les ressources déclarées à capacité illimitée ne font pas l’objet d’un contrôle d’occupation. Décidez pour chacune si elle doit devenir un poste de travail à capacité limitée dans SkyPlanner.
- Ordres lancés. ERP XL exclut de la replanification les opérations lancées en production, sauf si l’option « Przesuń na zwolnionych » est cochée. Convenez de la manière dont les dates SkyPlanner s’appliquent aux ordres lancés et utilisez Running Time Lock pour figer les prochaines heures de production.
- Versions des structures. Les structures de XL API comportent un champ Wersja. Renseignez-le en fonction de votre version d’ERP XL et refaites les tests après chaque mise à niveau annuelle.
- Unités et temps du système polonais. Les temps opératoires et les unités des calendriers doivent être convertis exactement à l’importation, sinon toutes les durées seront fausses.
Qui configure l’intégration avec Comarch ERP XL et en assure le support ?
- L’équipe SkyPlanner la configure pendant l’accompagnement initial et en assure le support après la mise en production, pour les lectures et les appels à XL API convenus. Chaque usine utilise Comarch ERP XL différemment : c’est à cette étape que cette connaissance du terrain entre en jeu.
- Votre partenaire Comarch peut participer. Il connaît votre configuration, vos licences et XL API. Il peut configurer le compte opérateur, la connexion en lecture et l’hôte du service de réécriture aux côtés de l’équipe SkyPlanner.
- Vos propres développeurs peuvent étendre l’intégration en utilisant la REST API de SkyPlanner avec un jeton API. Un jeton API suffit pour commencer, et l’équipe SkyPlanner vous aide au besoin. Consultez la documentation d’intégration SkyPlanner.
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. Consultez les tarifs, l’ordonnancement à capacité finie avec Comarch ERP XL, la page Comarch ERP XL et la rubrique des intégrations ERP.
Les avis des industriels sur SkyPlanner
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 l’établissement d’un planning optimisé sur trois mois pour l’ensemble des postes de travail prend moins de 30 minutes.
6 moisde visibilité sur la capacité disponible pour les commerciaux
« SkyPlanner apporte une base solide et la fiabilité nécessaire à toute la planification de la production. »
Anu Järvinen, responsable de production
Fredman Operations · Papiers d’emballage aptes au contact alimentaire
Les commerciaux voient la capacité disponible six mois à l’avance. Les demandes de modification du planning, qui prenaient une heure ou plus, reçoivent désormais une réponse en quelques secondes.
100%de respect des délais de livraison depuis 2021
« SkyPlanner nous donne de la visibilité sur la capacité et rend la planification prévisible. »
Dan Berglund, COO/CFO
Opes Corporation · Industries chimique et alimentaire
Les délais de livraison sont respectés à 100 % depuis le début de l’utilisation de SkyPlanner, en 2021.
FAQ
Comarch ERP XL dispose-t-il d’une API pour les ordres de fabrication ?
Oui. XL API (CDN_API.DLL) crée les ordres de fabrication, les planifie et les replanifie avec XLZamknijZlecenieProd, ajoute les dates des opérations avec XLDodajTerminDoProcesuProd et enregistre les réalisations avec XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web ajoute des microservices REST documentés dans Swagger.
Comment les dates planifiées sont-elles réécrites dans Comarch ERP XL ?
Par XLDodajTerminDoProcesuProd, qui ajoute une plage de dates (TerminOd, TerminDo) à chaque opération de l’ordre de fabrication. Un webhook SkyPlanner déclenche l’appel à chaque modification du planning.
Comarch ERP XL prend-il en charge les webhooks ?
Aucun webhook sortant n’est documenté. L’intégration interroge donc ERP XL à une fréquence définie pour chaque usine. Les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles se produisent.
Un partenaire Comarch doit-il proposer Comarch APS ou SkyPlanner ?
SkyPlanner, lorsque le client souhaite disposer en quelques semaines d’un ordonnancement de la production qui respecte les capacités et se maintient à jour automatiquement. Comarch APS est une application distincte, avec sa propre base PostgreSQL, son intégrateur et sa clé de licence. La synchronisation se fait sur clic du planificateur, et le temps de réglage est une valeur fixe par opération (aide Comarch APS). SkyPlanner est un logiciel cloud qui replanifie automatiquement et planifie les changements de série, les outils, les équipes et les matières, à partir de 199 € par mois.
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 CSV ou Excel depuis ERP XL, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
