Intégrations / ERP / SAP Business One
Guide d’intégration de SAP Business One pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide explique aux partenaires SAP Business One et aux équipes informatiques comment connecter B1 à SkyPlanner APS. Il présente les API à utiliser, les objets échangés et leur destination, ainsi que les écueils des projets B1. SkyPlanner échange avec SAP Business One dans les deux sens via Service Layer :
- Les ordres de fabrication, les étapes de gamme, les ressources, les articles et les commandes d’achat sont importés dans SkyPlanner.
- Les dates de début et d’échéance planifiées sont réécrites dans les ordres de fabrication.
- Les relevés de temps des opérateurs sont enregistrés sous forme de documents Receipt and Issue for Production.
- Les webhooks SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
SAP Business One conserve la gestion des articles, des nomenclatures, des ordres de fabrication, des stocks et des finances. Votre module de production reste inchangé. L’équipe SkyPlanner configure l’intégration avec les objets standard de B1 lors de la mise en place et en assure le support après la mise en service. Chaque base de données société a ses propres étapes de gamme, groupes de ressources, champs personnalisés et extensions : la configuration établit les correspondances pour ces particularités.
Laboratory & Allied utilise SkyPlanner avec SAP Business One sur HANA. Pour en connaître les avantages métier, consultez la page consacrée à l’ordonnancement de la production avec SAP Business One.
Options d’intégration de SAP Business One
SAP Business One propose trois interfaces d’intégration. Pour un outil d’ordonnancement dans le cloud, Service Layer est le choix par défaut.
| Option | Description | Pertinence pour l’intégration APS |
|---|---|---|
| Service Layer | API REST/OData. /b1s/v1 utilise OData v3, /b1s/v2 utilise OData v4. Fonctionne avec la version de SAP Business One pour SAP HANA et avec Microsoft SQL Server depuis la version 10.0 PL01. | Voie privilégiée. Utilise HTTP et JSON, accessible depuis un service cloud. |
| DI API | Bibliothèque COM pour Windows. Les ordres de fabrication correspondent à l’objet ProductionOrders, stocké dans la table OWOR (type d’objet 202). | Pour un middleware existant ou sur site. Nécessite un hôte Windows. |
| Integration Framework (B1if) | Middleware SAP pour les scénarios d’intégration au niveau des documents. | Utile si le partenaire exploite déjà des scénarios B1if. |
Authentification
Service Layer utilise une authentification par session. Envoyez une requête POST /b1s/v1/Login avec CompanyDB, UserName et Password pour recevoir un cookie B1SESSION (ainsi qu’un cookie ROUTEID facultatif dans les configurations avec répartition de charge). Par défaut, SessionTimeout est fixé à 30 minutes d’inactivité. Appelez explicitement Logout à la fin de chaque synchronisation. Créez un utilisateur B1 dédié à l’intégration pour que toute modification écrite depuis SkyPlanner soit traçable dans le journal des modifications.
Entités Service Layer pour l’ordonnancement de la production
| Données | Entité Service Layer |
|---|---|
| Articles et données de planification | Items |
| Nomenclatures et étapes de gamme | ProductTrees (Lines, Stages) |
| Machines, main-d’œuvre et autres ressources | Resources, ResourceGroups |
| Ordres de fabrication | ProductionOrders (Lines, Stages) |
| Stock par magasin | Données de stock de Items, Warehouses |
| Commandes d’achat ouvertes et dates de livraison | PurchaseOrders (DocumentLines : quantité ouverte, ShipDate) |
| Réceptions de marchandises sur commandes d’achat | PurchaseDeliveryNotes (Goods Receipt PO, type d’objet 20) |
| Sorties pour production | InventoryGenExits |
| Entrées de production | InventoryGenEntries |
| Configuration des webhooks | EventSubscriptions, EventNotifications |
Par défaut, une page contient 20 enregistrements. Augmentez cette limite avec l’en-tête Prefer: odata.maxpagesize (ou PageSize dans b1s.conf) et suivez odata.nextLink. Utilisez $expand pour récupérer les lignes et les étapes d’un ordre de fabrication en un seul appel, et regroupez les requêtes en lots pour les écritures en masse vers B1.
Événements et webhooks
Depuis SAP Business One 10.0 FP 2602, Service Layer prend en charge les webhooks. Ils sont désactivés par défaut. Activez-les pour chaque société avec CompanyService_UpdateAdminInfo (EnableWebhook = tYES). Envoyez ensuite une requête POST EventSubscriptions avec trois éléments :
- une
WebhookURL - un
AuthenticationType: None, Basic, HMAC ou OAuth, avec HMAC par défaut - une
EventCollectiond’objets métier et de types de transaction
La WebhookURL doit utiliser HTTPS avec un certificat correspondant à l’hôte. EventSubscriptionsService_GetEventCatalog répertorie les événements auxquels vous pouvez vous abonner. Le Webhook Messenger Service doit être en cours d’exécution.
Sur les versions antérieures, utilisez une interrogation périodique (voir le piège lié à UpdateDate ci-dessous). SBO_SP_TransactionNotification est un mécanisme de validation au niveau de la base de données, pas un canal de transmission.
Correspondance des données de SAP Business One vers SkyPlanner
| SAP Business One (Service Layer) | Objet SkyPlanner | Sens du flux | Fréquence |
|---|---|---|---|
Items (articles à fabriquer, Procurement Method) | Produits | B1 → SkyPlanner | Chargement initial, puis à intervalles planifiés |
Lines de ProductTrees (lignes d’articles) | Matières et composants des produits | B1 → SkyPlanner | Chargement initial, puis à chaque modification |
Stages et lignes de ressources de ProductTrees | Étapes de fabrication et temps d’exécution | B1 → SkyPlanner | Chargement initial, puis à chaque modification |
Resources (Machine, Labor, Other) | Postes de travail et personnel | B1 → SkyPlanner | Chargement initial, modifications rares |
ResourceGroups | Groupes de postes de travail | B1 → SkyPlanner | Chargement initial |
ProductionOrders (Planned, Released) | Ordres et opérations | B1 → SkyPlanner | Webhook (FP 2602+) ou interrogation toutes les quelques minutes |
Stages de ProductionOrders | Étapes des opérations avec leur ordre d’exécution | B1 → SkyPlanner | Avec l’ordre |
Stock de Items par Warehouses | Stock de matières et composants | B1 → SkyPlanner | À intervalles planifiés, par exemple toutes les heures |
Lignes ouvertes de PurchaseOrders (type d’objet 22) avec date de livraison | Commandes d’achat / approvisionnements attendus avec date de livraison prévue | B1 → SkyPlanner | À intervalles planifiés, par exemple toutes les heures |
Lignes de PurchaseDeliveryNotes (Goods Receipt PO) avec BaseType 22 | Quantité reçue sur la ligne de commande d’achat, stock mis à jour | B1 → SkyPlanner | À intervalles planifiés, par exemple toutes les heures |
| Début et fin planifiés | PATCH ProductionOrders({DocEntry}) : StartDate, DueDate, ainsi que StartDate et EndDate sur la ligne de ressource | SkyPlanner → B1 | Webhook SkyPlanner à chaque modification du planning |
| Quantités déclarées | InventoryGenEntries (entrée de production) | SkyPlanner → B1 | À la confirmation ou par lots |
| Heures et consommations de matières déclarées | InventoryGenExits (sortie pour production) | SkyPlanner → B1 | À la confirmation ou par lots |
Les calendriers d’équipes, le personnel et les absences sont gérés dans SkyPlanner. Les valeurs de capacité journalière de B1 ne sont pas transférées (voir le premier écueil ci-dessous).
Schémas d’intégration
1. Chargement initial des données de base. Récupérez Resources, ResourceGroups, les Items dont Procurement Method vaut Make, ainsi que leurs ProductTrees avec les étapes. Associez chaque ressource machine à un poste de travail SkyPlanner. Passez la liste en revue avec les planificateurs avant la première synchronisation des ordres.
2. Synchronisation des ordres. Lisez les ProductionOrders aux statuts Planned et Released en utilisant $expand sur les lignes et les étapes. Les ordres de fabrication B1 reprennent les étapes de gamme de la nomenclature, mais les planificateurs peuvent modifier un ordre après sa création. Utilisez donc les étapes de l’ordre, et non celles de la nomenclature. Un ordre de fabrication produit un seul produit : un produit à plusieurs niveaux nécessite donc un ordre de fabrication par niveau. Reliez ces ordres pour que SkyPlanner ordonnance les produits des niveaux inférieurs avant le produit parent.
Synchronisez également les lignes ouvertes de PurchaseOrders, avec leur quantité ouverte et leur date de livraison, vers les endpoints de commandes d’achat de SkyPlanner. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande d’achat. Dans B1, le stock évolue lorsqu’une réception sur commande d’achat (PurchaseDeliveryNotes) est comptabilisée. L’intégration lit ces réceptions, marque la quantité reçue comme livrée dans SkyPlanner et conserve le solde ouvert. Les réceptions partielles ne sont comptées qu’une fois, et les contrôles de disponibilité des matières couvrent le stock et les approvisionnements attendus.
3. Écriture du planning dans B1. Les webhooks de SkyPlanner se déclenchent lorsque le planning change. L’intégration envoie une requête PATCH /b1s/v1/ProductionOrders({DocEntry}) avec les nouvelles valeurs de StartDate et DueDate, ainsi que StartDate et EndDate sur les lignes de ressources de l’ordre (ProductionOrderLines), afin que chaque étape porte son créneau planifié. Le corps de la requête ne contient que les champs dont SkyPlanner a la responsabilité, et plusieurs ordres sont regroupés dans une seule requête $batch. Les utilisateurs B1 voient alors les dates planifiées sur l’ordre de fabrication et dans la fenêtre Resource Capacity. Sur les installations où Service Layer n’est pas disponible, un service sur site effectue la même mise à jour via l’objet ProductionOrders de DI API (GetByKey, définition des dates, Update).
4. Déclarations d’atelier. Les opérateurs déclarent leur travail dans SkyPlanner avec Mobile Confirmations ou Production Timer. Chaque relevé de temps donne lieu à une requête POST /b1s/v1/InventoryGenEntries pour la quantité terminée (entrée de production) et à une requête POST /b1s/v1/InventoryGenExits pour les composants et le temps des ressources (sortie pour production).
Chaque ligne de document porte un BaseType de 202 et un BaseEntry défini sur le DocEntry de l’ordre de fabrication ; les lignes de sortie indiquent aussi le BaseLine de la ligne de composant ou de ressource. Les quantités partielles sont comptabilisées au fur et à mesure des déclarations. Les numéros de lot et de série sont renseignés pour les articles gérés par lot ou par numéro de série, et l’ordre doit être au statut Released.
L’identifiant du relevé de temps SkyPlanner est stocké dans le document B1 : un événement relancé ne crée donc jamais deux écritures. En cas d’échec, l’enregistrement fait l’objet de nouvelles tentatives et d’un signalement, au lieu d’être abandonné.
5. Systèmes de référence et règles de gestion des conflits. Définissez ces règles ensemble avant de coder :
- B1 fait référence pour les articles, les nomenclatures, les quantités, les magasins et la création des ordres.
- SkyPlanner fait référence pour le séquencement, les heures de début et de fin et l’affectation aux postes de travail.
- Si les dates d’un ordre sont modifiées des deux côtés, le prochain calcul de SkyPlanner prévaut, sauf si les planificateurs ont verrouillé l’opération dans SkyPlanner.
- Lorsqu’un ordre passe au statut Closed ou Cancelled dans B1, l’opération est retirée du planning.
Ce que comprend le projet
La mise en œuvre s’achève généralement dans les semaines qui suivent le début de l’accompagnement. Auparavant, l’essai gratuit de 30 jours vous permet de travailler avec vos propres données. Exportez les articles, les ressources et les ordres de fabrication ouverts de B1 au format CSV ou Excel, puis chargez-les avec l’outil d’import de données de SkyPlanner. Les planificateurs disposent ainsi d’un planning réel avant même l’écriture du code d’intégration.
Un projet SAP Business One type comprend :
- La correspondance des données de base. Les ressources et groupes de ressources B1 sont associés aux postes de travail, les étapes de gamme aux étapes de processus et les articles Make aux produits.
- Le chargement initial. Articles, Product Trees avec leurs étapes et lignes d’articles, ressources et stocks par magasin.
- La synchronisation des ordres et des commandes d’achat. Ordres de fabrication ouverts avec leurs lignes et étapes, ainsi que commandes d’achat ouvertes avec leurs dates de livraison.
- Écriture du planning dans B1. Transmission des dates de début et d’échéance planifiées à
ProductionOrders. - Les déclarations d’atelier. Les documents Receipt and Issue for Production sont enregistrés à partir des relevés de temps SkyPlanner.
- Les tests en parallèle du planning actuel. Les planificateurs comparent le planning SkyPlanner à leur méthode de planification actuelle.
- La mise en service. Le planning SkyPlanner devient le planning de référence.
Des ressources et des étapes de gamme bien tenues dans B1 simplifient la mise en correspondance. Chez Laboratory & Allied, l’intégration a été l’un des volets les plus légers du projet. L’équipe informatique interne a réalisé l’intégration à SAP Business One sur HANA en grande partie de façon autonome. L’équipe SkyPlanner est intervenue sur les cas les plus complexes, notamment les produits qui se combinent au fil de processus en plusieurs étapes.
Les écueils de SAP Business One
La capacité journalière ne remplace pas un calendrier d’équipes.
B1 stocke les valeurs Daily Internal Capacity et Single Run Capacity par ressource et par jour (« These capacities are defined on a daily basis, » (ces capacités sont définies sur une base journalière), selon SAP Learning). Le guide SAP précise que le calcul Required Days suppose que « a single production order can be produced on a single machine » (un ordre de fabrication peut être réalisé sur une seule machine) (guide pratique SAP). Ne reprenez pas ces valeurs comme capacités réellement disponibles pour l’ordonnancement de production. Définissez les équipes, le personnel et les rendements des postes de travail dans SkyPlanner.
La gamme de fabrication est intégrée à la nomenclature.
Il n’existe pas de gamme de fabrication indépendante dans les données de base. Les lignes Route Stage de Product Tree définissent l’ordre des étapes, et les Waiting Days sont saisis à la main. Lisez les Stages de ProductTrees et de ProductionOrders, puis vérifiez que chaque ligne de ressource est rattachée à une étape. Sans étapes dans l’ordre, le moteur d’ordonnancement ne dispose d’aucune séquence d’opérations.
Les quantités des lignes de ressources doivent être converties.
Le champ Quantity d’une ligne de nomenclature correspond à la quantité nécessaire pour produire celle indiquée dans l’en-tête, et non une unité. Additional Quantity s’ajoute au temps planifié « regardless of the quantity of the parent item produced » (quelle que soit la quantité de l’article parent produite) (guide pratique SAP). Traitez cette valeur comme un temps fixe par ordre, à l’image d’un réglage. Divisez par la quantité d’en-tête avant de calculer les temps d’exécution unitaires, sinon la durée de chaque opération sera faussée d’un facteur multiplicatif.
Les données de base des ressources sont rarement bien tenues.
Les ressources sont de type Machine, Labor ou Other. Les machines peuvent être liées à des immobilisations et la main-d’œuvre à des employés. Une ressource peut aussi être associée à un article non géré en stock pour permettre son achat ou sa vente. Rien de tout cela n’indique quelles ressources sont de véritables machines à ordonnancer. Nettoyez les groupes de ressources et éliminez les doublons avant d’en faire votre liste de postes de travail.
Les règles de gestion des stocks peuvent bloquer les déclarations.
Les entrées et les sorties sont des documents de stock. Les erreurs courantes sont la confusion entre InventoryGenEntries et InventoryGenExits, l’absence de numéros de lot ou de série sur les articles gérés ainsi, ou une comptabilisation sur un ordre au statut Planned.
Sessions et pagination.
Une session expirée renvoie le message « Invalid session or session already timeout. » (Session non valide ou déjà expirée.) Reconnectez-vous lorsque cette erreur survient. La pagination par défaut de 20 enregistrements tronque sans avertissement les synchronisations qui ignorent odata.nextLink.
UpdateDate ne contient pas l’heure.
Dans la table OWOR, UpdateDate est un champ de date ; l’heure de mise à jour est stockée séparément dans UpdateTS. Une interrogation filtrée uniquement sur UpdateDate récupère à chaque exécution tous les ordres modifiés dans la journée. Combinez les deux champs ou dédupliquez les résultats de votre côté.
Les webhooks garantissent une livraison au moins une fois.
En cas d’échec de livraison, Webhook Messenger effectue jusqu’à cinq nouvelles tentatives (2, 4, 8, 16 et 32 secondes), puis marque la livraison comme échouée. Ces tentatives peuvent créer des doublons, et l’ordre n’est garanti qu’au sein d’une même société. Rendez les gestionnaires idempotents en vous appuyant sur l’identifiant d’événement et maintenez un contrôle de concordance des données par interrogation chaque nuit.
Qui met en place l’intégration à SAP Business One ?
Le travail consiste à établir les correspondances pour vos étapes de gamme, vos ressources et votre configuration B1. Il couvre aussi les contraintes que B1 ne prend pas en compte dans l’ordonnancement : matrice des temps de réglage, outils, nombre d’opérateurs et ressources alternatives.
- 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 entreprise utilise B1 différemment : cette connaissance du terrain entre en jeu à ce stade. C’est l’approche par défaut.
- Votre partenaire SAP Business One peut participer. Les partenaires qui connaissent votre base de données société, vos extensions et vos champs personnalisés peuvent développer l’intégration à l’aide de Service Layer et de l’API REST de SkyPlanner (référence de l’API).
- Vos propres développeurs peuvent réaliser l’intégration. L’API REST de SkyPlanner permet de lire et d’écrire les ordres, produits, matières, étapes de processus, commandes d’achat et relevés de temps. Elle utilise l’authentification par jeton Bearer JWT et est documentée au format Swagger/OpenAPI. La documentation publique est disponible dans la documentation SkyPlanner. Les webhooks transmettent les changements de planning et de statut en temps réel. Une clé API SkyPlanner suffit pour commencer à développer (tutoriel d’intégration), et l’équipe SkyPlanner vous aide si nécessaire. C’est l’approche choisie par l’équipe informatique interne de Laboratory & Allied.
Validez d’abord le planning pendant l’essai gratuit de 30 jours : l’intégration partira ainsi d’un planning déjà adapté à l’usine.
Pourquoi les équipes techniques choisissent SkyPlanner pour B1
- Choisissez SkyPlanner pour une intégration limitée et bien définie. Le flux reçoit les objets standard de B1 (ordres de fabrication, Product Trees, Resources, Items) et renvoie les dates ainsi que les documents Issue and Receipt from Production. Le module de production de B1 reste inchangé, sans migration de données.
- Choisissez SkyPlanner si le projet doit faire ses preuves rapidement. L’essai gratuit de 30 jours fonctionne à partir d’un export CSV, avec jusqu’à 20 postes de travail et sans carte bancaire. L’entreprise visualise son propre planning avant le début de l’intégration.
- Choisissez SkyPlanner si le planning doit respecter les contraintes réelles. Temps de changement de série, outils partagés, opérations à plusieurs opérateurs, ressources alternatives, stocks et commandes d’achat ouvertes sont tous modélisés dans SkyPlanner. L’intégration ne fait que transmettre les données B1.
- Choisissez SkyPlanner pour réunir planificateurs et opérateurs dans un même système. Le moteur Arcturus construit le planning en quelques secondes, et Autopilot le recalcule automatiquement lorsque la production change. Les opérateurs saisissent leur travail sur téléphone ou tablette, puis votre intégration renvoie ces déclarations dans B1.
- Choisissez SkyPlanner pour des coûts prévisibles. Les tarifs commencent à 199 € par mois, avec 5 postes de travail inclus, une facturation mensuelle et une résiliation possible à tout moment. L’intégration fait l’objet d’un devis préalable adapté à vos processus et à vos besoins, présenté avec votre abonnement. Vous connaissez ainsi le coût total avant de commencer.
Pour comprendre les limites de la planification, consultez notre guide de l’ordonnancement de production avec SAP Business One. Pour les autres ERP, rendez-vous sur la page des intégrations ERP.
Avis d’industriels sur SkyPlanner
+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 l’ensemble des postes de travail prend moins de 30 minutes.
2 hgagnées chaque semaine
« Grâce à SkyPlanner, notre planification de la production est passée des feuilles de calcul Excel à l’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 chaque semaine, et une nouvelle file d’opérations est transmise à la ligne en quelques secondes.
6 moisde visibilité sur la capacité disponible pour les commerciaux
« SkyPlanner donne des bases solides et fiables à 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, dont le traitement prenait une heure ou plus, reçoivent désormais une réponse en quelques secondes.
99,2 %de respect des délais de livraison
« SkyPlanner nous a donné la visibilité nécessaire pour repérer les goulots d’étranglement et a clarifié la gestion de la production. »
Toni Tuori, responsable de production
Piristeel · Systèmes de sécurité pour toiture et d’évacuation des eaux pluviales
Le taux de respect des délais de livraison a atteint 99,2 % cette année, et l’ordonnancement permet de gagner jusqu’à quatre heures de travail par jour.
Questions fréquentes
Qui met en place l’intégration avec SAP Business One ?
L’équipe SkyPlanner configure l’intégration bidirectionnelle pendant la mise en place et en assure le support après la mise en production. Les ordres de fabrication, les étapes de gamme, les ressources, les commandes fournisseurs et les réceptions de marchandises sont importés dans SkyPlanner. Les dates planifiées et les documents Issue and Receipt from Production sont renvoyés vers SAP Business One. Votre partenaire B1 ou vos propres développeurs peuvent aussi créer l’intégration à l’aide de Service Layer et de l’API REST de SkyPlanner. Une clé API suffit pour commencer.
Combien de temps prend le déploiement de SkyPlanner avec SAP Business One ?
Le déploiement est normalement achevé en quelques semaines après le début de l’accompagnement. L’équipe établit les correspondances des ressources et des étapes de gamme avec celles de SkyPlanner, connecte les ordres de fabrication et les commandes fournisseurs, puis teste l’ordonnancement en le comparant à votre planning actuel avant la mise en production.
Service Layer ou DI API ?
Privilégiez Service Layer pour les nouveaux développements. Cette interface repose sur HTTP, fonctionne sur HANA et SQL Server et convient à un outil d’ordonnancement cloud. N’utilisez DI API que si votre middleware existant en dépend déjà.
Faut-il disposer de SAP Business One 10.0 FP 2602 ?
Uniquement pour les webhooks. Avec les versions 10.0 antérieures, l’intégration repose sur des interrogations périodiques.
Comment les dates planifiées sont-elles réécrites dans SAP Business One ?
Via PATCH /b1s/v1/ProductionOrders({DocEntry}), en renseignant StartDate et DueDate sur l’ordre, ainsi que StartDate et EndDate sur ses lignes de ressources. Cette mise à jour est déclenchée par le webhook de modification du planning de SkyPlanner. Les quantités produites et les temps sont renvoyés sous forme de documents InventoryGenEntries et InventoryGenExits, liés à l’ordre par BaseType 202 et BaseEntry.
Faut-il un module complémentaire de gestion de la production dans B1 ?
Non. L’intégration utilise uniquement les objets standard de B1 : ordres de fabrication, Product Trees, Resources, Items, commandes fournisseurs et documents de stock. Aucune donnée n’est migrée vers un nouveau modèle de données de production.
Peut-on tester SkyPlanner avec nos données B1 avant l’intégration ?
Oui. L’essai de 30 jours couvre jusqu’à 20 postes de travail, avec import CSV ou Excel, sans carte bancaire. Démarrez l’essai gratuit ou contactez notre équipe commerciale pour discuter de votre configuration B1.
