Intégrations / ERP / SAP Business ByDesign
Guide d’intégration de SAP Business ByDesign pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de SAP Business ByDesign explique aux partenaires et aux équipes informatiques comment connecter ByDesign à SkyPlanner APS. SkyPlanner échange des données avec ByDesign dans les deux sens, à l’aide des services web publiés par SAP :
- SkyPlanner reçoit les ordres de fabrication lancés avec leurs opérations, les Production Models, les Bills of Material et les Bills of Operations, les équipements et les ressources de main-d’œuvre, les articles, les stocks et les commandes d’achat.
- Le début planifié de chaque ordre de fabrication et la ressource principale de chaque opération sont renvoyés à ByDesign.
- Les quantités confirmées, les rebuts et les tâches terminées peuvent être renvoyés vers les lots de production.
- Les webhooks SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
L’équipe SkyPlanner configure l’intégration à votre tenant ByDesign via la REST API lors de la mise en route, puis en assure le support après la mise en production. Ce guide s’adresse aux partenaires et aux développeurs qui souhaitent participer au projet ou développer eux-mêmes à partir de la REST API documentée de SkyPlanner (référence de l’API).
Les interfaces d’intégration de SAP ByDesign
Pour chaque version, ByDesign répertorie ses services web SOAP A2X publiés dans la liste des API de services web. Voici les services utilisés pour une intégration d’ordonnancement :
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER renvoie les dates de début et de fin demandées, au plus tôt et au plus tard, les ressources avec les durées prévues et réalisées, la priorité, le statut d’exécution et le statut d’ordonnancement. MAINTAIN_BUNDLE_V2 met à jour EarliestStartPeriod ou LatestEndPeriod, ainsi que MainResourceID pour l’opération (aide SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle crée ou met à jour les tâches de production : quantité confirmée, rebuts et indicateur de fin de confirmation par point de déclaration, clôture de la tâche avec le salarié exécutant et le temps d’exécution, et utilisation des ressources (aide SAP).
- Services de requête. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (également par ressource), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks et Determine Availability of Products.
- OData. Des services OData personnalisés pour les objets métier, ainsi que des services OData pour les sources de données et les rapports analytiques. Concernant le choix des objets métier à exposer, SAP précise : « companies are fully empowered to decide which business objects » (les entreprises sont entièrement libres de décider quels objets métier exposer) (scénarios d’intégration SAP).
Utilisez les services de requête ou OData pour les lectures, et les deux services Manage pour toutes les écritures.
Authentification et licences
Côté ByDesign, créez un système de communication pour SkyPlanner et un accord de communication pour les services utilisés. Chaque accord dispose de son propre utilisateur technique. Le guide de sécurité SAP prévoit l’authentification des intégrations applicatives avec « user ID plus password, and the X.509 client certificate » (un identifiant utilisateur avec mot de passe, ainsi que le certificat client) (guide de sécurité). OAuth 2.0 peut être configuré pour OData. Téléchargez le WSDL de chaque service depuis l’accord de communication ou le Service Explorer.
Côté SkyPlanner, chaque appel transmet un jeton API dans l’en-tête Authorization-Token. Créez ce jeton dans SkyPlanner sous Settings > API. Un jeton API suffit pour commencer à développer.
Événements et interrogation périodique
SkyPlanner envoie des webhooks à chaque modification du planning : les mises à jour sont ainsi renvoyées à ByDesign au fil des changements.
Pour détecter les changements dans ByDesign, interrogez périodiquement les services de requête. Lisez les ordres de fabrication lancés et les lots de production à quelques minutes d’intervalle, et les articles, les stocks et les commandes d’achat à une fréquence plus faible. Les résultats sont paginés à l’aide de QueryHitsMaximumNumberValue et LastReturnedObjectID ; SAP indique la taille de page par défaut sur sa page consacrée aux services web.
Correspondance des données
| Objet ByDesign (interface) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
| Articles (Query Materials) | Produits et matières | ByDesign → SkyPlanner | Chargement initial, puis interrogation périodique |
| Production Bill of Material (Query Production Bill of Materials) | Structure du produit, matières par produit | ByDesign → SkyPlanner | Chargement initial, puis à chaque modification |
| Production Bill of Operations : opérations, activités Setup, Produce et Tear down (Query Production Bill of Operations) | Étapes de fabrication avec leurs durées, temps de préparation et de démontage | ByDesign → SkyPlanner | Chargement initial, puis à chaque modification |
| Production Model (Query Production Model) | Gamme de fabrication du produit par site | ByDesign → SkyPlanner | Chargement initial, puis à chaque modification |
| Équipements et groupes de ressources (Read Equipment Resources) | Postes de travail, groupes de postes de travail, outils | ByDesign → SkyPlanner | Chargement initial, puis rarement |
| Ressources de main-d’œuvre, horaires de travail (Query Labour Resource) | Personnel et horaires d’équipe | ByDesign → SkyPlanner | Chaque jour, ou horaires d’équipe gérés directement dans SkyPlanner |
| Ordres de fabrication lancés et opérations (Query Production Orders, READ_PROD_ORDER) | Ordres et opérations avec échéances et besoins en matières | ByDesign → SkyPlanner | Interrogation à quelques minutes d’intervalle |
| Lots et tâches de production (Query Production Lots) | Avancement des opérations | ByDesign → SkyPlanner | Interrogation à quelques minutes d’intervalle |
| Stocks identifiés, disponibilité des produits (Query Identified Stocks, Determine Availability of Products) | Quantités en stock | ByDesign → SkyPlanner | Interrogation toutes les heures ou à chaque calcul du planning |
| Commandes d’achat (Query Purchase Orders) | Commandes d’achat, réceptions de matières par date de livraison | ByDesign → SkyPlanner | Interrogation toutes les heures ou à chaque calcul du planning |
| EarliestStartPeriod, MainResourceID de l’opération (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Début planifié, poste de travail affecté | SkyPlanner → ByDesign | À chaque modification du planning, via un webhook SkyPlanner |
| Quantité confirmée, rebuts, clôture de tâche (Manage Production Lots, MaintainBundle) | Relevés de temps et confirmations des opérateurs | SkyPlanner → ByDesign | À chaque confirmation ou par équipe, si cette option est retenue |
| Absent de ByDesign | Matrice des temps de préparation, besoins en effectifs pour les opérations nécessitant plusieurs opérateurs, machines et personnel de remplacement | Géré dans SkyPlanner | Configuré lors de la mise en route |
Schémas d’intégration
1. Chargement initial des données de base. Lisez les articles, les Production Models, les Bills of Material et les Bills of Operations, les équipements et les ressources de main-d’œuvre. Définissez soigneusement la correspondance des ressources : un groupe de ressources comprenant quatre machines devient un groupe de postes de travail ou quatre postes de travail. Les équipements qui sont des outils deviennent des outils à capacité limitée dans SkyPlanner.
2. Synchronisation des ordres de fabrication. Lisez les ordres de fabrication lancés avec leurs opérations et leurs matières, ainsi que les commandes d’achat ouvertes. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande d’achat et met le stock à jour lorsque celle-ci passe au statut Delivered. Les propositions de fabrication restent dans ByDesign Supply Planning jusqu’à leur transformation en ordres de fabrication.
3. Renvoi du planning vers ByDesign. Lorsque le moteur place ou déplace un ordre, un webhook SkyPlanner déclenche MAINTAIN_BUNDLE_V2 sur Manage Production Orders. Cet appel définit EarliestStartPeriod et MainResourceID pour l’opération choisie par SkyPlanner.
4. Confirmations en atelier. Les opérateurs enregistrent leur travail avec SkyPlanner Mobile Confirmations ou le Production Timer, et les relevés de temps maintiennent le planning à jour. Vous choisissez si les données réelles sont renvoyées à ByDesign. Si oui, MaintainBundle sur Manage Production Lots transmet la quantité confirmée, les rebuts et la tâche terminée avec le salarié exécutant. Sinon, les confirmations sont saisies dans ByDesign comme auparavant.
5. Responsabilité des données et règles de gestion des conflits. Consignez-les avant la mise en production :
| Données | Système de référence |
|---|---|
| Articles, Production Models, quantités, statuts des ordres et des lots | ByDesign |
| Séquencement des opérations, heures de début et de fin, affectation des ressources | SkyPlanner |
| Matrice des temps de préparation, besoins en outils et en opérateurs, ressources de remplacement | SkyPlanner |
| Horaires d’équipe et jours non travaillés | Un seul système, choisi lors du cadrage |
| Confirmations, mouvements de marchandises, calcul des coûts | ByDesign, par saisie directe ou transmission des relevés de temps SkyPlanner |
Désignez un seul système pour écrire les dates des ordres. N’exécutez pas Load Leveling sur les ressources ordonnancées par SkyPlanner, et vérifiez que le calcul de planification ne déplace pas les ordres lancés dont SkyPlanner a la maîtrise.
Étapes types du projet
La mise en œuvre s’achève normalement en quelques semaines après le début de la mise en route. Au préalable, validez le planning pendant l’essai gratuit de 30 jours, avec les ressources, les Bills of Operations et les ordres de fabrication ouverts exportés de ByDesign au format CSV ou Excel.
- Correspondance des données. Arrêtez la table de correspondance, les règles de maîtrise des données, les fréquences de synchronisation et le choix de renvoyer ou non les confirmations.
- Accès à ByDesign. Créez le système de communication et les accords de communication, puis téléchargez les WSDL. Effectuez d’abord les tests dans votre tenant de test ByDesign.
- Chargement initial. Articles, Production Models, Bills of Material et Bills of Operations, ressources, horaires de travail.
- Synchronisation des ordres de fabrication et des commandes d’achat. Interrogation périodique avec pagination, filtres et nouvelles tentatives en cas d’échec.
- Paramétrage des contraintes dans SkyPlanner. Matrice des temps de préparation, outils, nombre d’opérateurs par opération et machines ou personnel de remplacement.
- Renvoi du planning vers ByDesign. Appels MAINTAIN_BUNDLE_V2 déclenchés par les webhooks de SkyPlanner, avec les confirmations de lots si vous retenez cette option.
- 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 le renvoi des données vers ByDesign une fois leur concordance vérifiée.
Les points à prévoir pour une intégration SAP ByDesign
- Une seule date par appel. « The EarliestStartPeriod and the LatestEndPeriod cannot be updated together. » (EarliestStartPeriod et LatestEndPeriod ne peuvent pas être mis à jour simultanément.) Utilisez la date de début comme référence pour le renvoi des données vers ByDesign.
- Aucun verrouillage. Les services A2X sont sans état : selon SAP, aucun verrouillage transactionnel ou logique ne peut donc être imposé. Relisez l’ordre avant chaque écriture et gérez les conflits.
- Une clôture est définitive. « Confirmation Finished Indicator cannot be unchecked once it is set. » (L’indicateur Confirmation Finished Indicator ne peut plus être décoché une fois activé.) Ne transmettez la fin de tâche que lorsque l’opérateur clôture celle-ci.
- Ressources principales et supplémentaires. L’ordonnancement de ByDesign tient compte des ressources principales. Dans SkyPlanner, modélisez les opérateurs et les outils des ressources supplémentaires comme des ressources à capacité finie pour que le planning en tienne compte.
- Préparation et démontage. Dans les Bills of Operations, la préparation et le démontage sont enregistrés comme des activités. Reportez les temps de changement de série qui dépendent de l’enchaînement des opérations dans la matrice des temps de réglage.
Qui configure l’intégration SAP ByDesign et en assure le support ?
- L’équipe SkyPlanner configure l’intégration lors de la mise en place et en assure le support après la mise en service, sur le périmètre convenu des services web et des requêtes OData. Chaque entreprise utilise ByDesign à sa manière : ce savoir-faire est pris en compte à cette étape.
- Votre partenaire SAP ByDesign peut participer. Il connaît votre tenant, votre cadrage et vos extensions, et peut configurer les accords de communication aux côtés de l’équipe SkyPlanner.
- Vos propres développeurs peuvent enrichir l’intégration en s’appuyant sur la REST API de SkyPlanner, avec un jeton API dans l’en-tête
Authorization-Token. L’équipe SkyPlanner les accompagne si nécessaire. Consultez la documentation d’intégration de 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, avec votre abonnement. Consultez les tarifs, la page sur l’ordonnancement à capacité finie avec SAP ByDesign, la page SAP Business ByDesign et la rubrique des intégrations ERP. D’autres systèmes SAP disposent de leur propre guide : SAP Business One et SAP S/4HANA.
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 par 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 la création d’un planning optimisé sur trois mois pour tous les postes de travail prend moins de 30 minutes.
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 agroalimentaire
Les délais de livraison sont respectés à 100 % depuis le début de l’utilisation de SkyPlanner, en 2021.
Moinsd’arrêts dus aux pénuries de matières
« La valeur de SkyPlanner pour nous, c’est d’être 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 pénuries de matières ont fortement diminué.
FAQ
Quelles API de SAP ByDesign SkyPlanner utilise-t-il ?
Les services web A2X publiés par SAP. Les lectures passent par les services Query, comme Query Production Orders et Query Purchase Orders, ou par des services OData personnalisés. Les écritures utilisent Manage Production Orders et Manage Production Lots.
Quelles données SkyPlanner réécrit-il dans ByDesign ?
EarliestStartPeriod et le MainResourceID de l’opération pour chaque ordre de fabrication. Si vous retenez cette option, les quantités confirmées, les rebuts et les tâches terminées sont enregistrés dans le lot de production.
ByDesign envoie-t-il des événements à SkyPlanner ?
SkyPlanner interroge les services Query de ByDesign à intervalles de quelques minutes pour récupérer les ordres et les lots. De son côté, SkyPlanner envoie des webhooks à chaque modification du planning, ce qui déclenche la réécriture.
Comment SkyPlanner s’authentifie-t-il auprès de ByDesign ?
Au moyen d’un système de communication et d’un accord de communication associés à un utilisateur technique, comme le décrit le guide de sécurité de SAP. L’API de SkyPlanner utilise quant à elle un jeton API dans l’en-tête Authorization-Token.
Les propositions de production sont-elles transmises à SkyPlanner ?
SkyPlanner ordonnance les ordres de fabrication lancés. Les propositions restent dans ByDesign Supply Planning jusqu’à leur conversion en ordres de fabrication.
Qui met en place l’intégration ?
L’équipe SkyPlanner la configure lors de la mise en place et en assure le support après la mise en service. Votre partenaire SAP ByDesign ou vos propres développeurs peuvent aussi s’appuyer sur la REST API de SkyPlanner avec un jeton API pour développer l’intégration.
