Intégrations / ERP / Acumatica Cloud ERP
Guide d’intégration d’Acumatica pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration d’Acumatica explique aux partenaires et aux équipes informatiques comment connecter Acumatica Cloud ERP (Manufacturing Edition) à SkyPlanner APS. L’intégration entre SkyPlanner et Acumatica fonctionne dans les deux sens :
- SkyPlanner reçoit les ordres de fabrication et leurs opérations, les postes de charge, les machines, les outils, les horaires d’équipe, les articles stockés et les commandes fournisseurs.
- Les dates de début et de fin planifiées sont inscrites dans les opérations de l’ordre de fabrication, puis l’ordre est affermi.
- Les relevés de temps des opérateurs sont renvoyés sous forme d’écritures de main-d’œuvre et de mouvements.
- Les webhooks SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
L’équipe SkyPlanner configure l’intégration en fonction de votre environnement Acumatica lors de la mise en place et en assure le support après la mise en production. Ce guide s’adresse aux partenaires et aux développeurs qui souhaitent y participer ou développer eux-mêmes une solution à partir de la REST API documentée de SkyPlanner (référence de l’API).
Les interfaces d’intégration d’Acumatica
L’intégration s’appuie sur les interfaces déjà fournies par Acumatica. Rien n’est installé dans l’instance.
- REST API basée sur des contrats. Les points de terminaison sont versionnés et suivent les versions du logiciel. Le point de terminaison Manufacturing (par exemple 26.200.001 pour 2026 R2) expose
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryetMaterialEntry. Le point de terminaison Default couvreStockItem,PurchaseOrderetSalesOrder. Les URL suivent le format{instance}/entity/{Endpoint}/{version}/{Entity}. - Actions sur le même point de terminaison.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryetReleaseMaterialEntryexécutent la même logique que les boutons des écrans. - OData. Toute Generic Inquiry (SM208000) peut être exposée via OData. Pour lire les données en masse le plus rapidement possible, utilisez une Generic Inquiry regroupant les opérations de production ouvertes et leurs dates.
- Notifications push (SM302000). À partir d’une Generic Inquiry ou d’une requête intégrée, elles envoient les lignes insérées et supprimées à une URL que vous configurez.
- Scénarios d’import et d’export avec des fournisseurs de données CSV et Excel pour les chargements en masse.
Les entités et les actions sont répertoriées dans Web Service Endpoints (SM207000) et dans le dépôt du client REST d’Acumatica.
Authentification et limites
Acumatica utilise OAuth 2.0 et OpenID Connect par l’intermédiaire d’applications clientes enregistrées dans Connected Applications (SM303010). Les flux documentés sont Authorization Code, Implicit, Resource Owner Password Credentials et Hybrid. Pour une intégration serveur, créez un utilisateur dédié à l’intégration avec des rôles limités aux droits strictement nécessaires. Utilisez Authorization Code avec un jeton de rafraîchissement, ou Resource Owner Password Credentials.
Votre licence fixe les limites : la License Monitoring Console (SM604000) affiche le nombre autorisé de requêtes API par minute et d’utilisateurs API.
Côté SkyPlanner, la REST API utilise un jeton API pour l’authentification (SkyPlanner Settings > API) et sa documentation est disponible dans Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Correspondance des données
| Objet Acumatica (point de terminaison / formulaire) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
StockItem (Default ; Stock Items IN202500) | Produits et matières | Acumatica → SkyPlanner | Chargement initial, puis mises à jour incrémentales |
BillOfMaterial (AM208000) : matières, opérations | Structure du produit, sous-produits, matières par produit | Acumatica → SkyPlanner | Chargement initial, puis à chaque modification |
| Opérations de la nomenclature : Setup, Run, Machine, Queue, Finish, Move Time | Étapes de fabrication avec leurs durées et leurs temps de préparation et de démontage | Acumatica → SkyPlanner | Chargement initial, puis à chaque modification |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Postes de travail, groupes de postes de travail, rendements, postes de travail de remplacement | Acumatica → SkyPlanner | Chargement initial, puis rarement |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Horaires d’équipe et capacité du personnel | Acumatica → SkyPlanner | Chaque jour, ou gestion des horaires d’équipe dans SkyPlanner |
Tool (AM205500) | Outils gérés comme des ressources à capacité limitée | Acumatica → SkyPlanner | Chargement initial |
ProductionOrder avec OrderOperationDetail (Planned, Released, In Process) | Ordres et tâches avec dates d’échéance, priorité de lancement et besoins en matières | Acumatica → SkyPlanner | Notification push ou interrogation toutes les quelques minutes |
Lignes de PurchaseOrder (Default) | Commandes fournisseurs avec date de livraison prévue | Acumatica → SkyPlanner | Interrogation toutes les heures ou à chaque calcul du planning |
| Quantités d’articles par entrepôt | Niveaux de stock | Acumatica → SkyPlanner | Interrogation toutes les heures ou à chaque calcul du planning |
OrderOperationDetail : StartDate, EndDate, WorkCenter | Début et fin planifiés, poste de travail affecté à chaque opération | SkyPlanner → Acumatica | À chaque modification du planning, via un webhook SkyPlanner |
Action FirmProductionOrder | Empêche Acumatica APS de modifier les dates inscrites | SkyPlanner → Acumatica | Après chaque écriture en retour |
LaborEntry, MoveEntry avec leurs actions de validation | Relevés de temps, quantités réalisées, confirmations des opérateurs | SkyPlanner → Acumatica | À chaque confirmation ou par période de travail |
| Absent d’Acumatica | Matrice des temps de préparation, opérateurs identifiés par leur nom, tâches à plusieurs opérateurs | Gérés dans SkyPlanner | Configurés lors de la mise en place |
Schémas d’intégration
1. Chargement initial des données de base. Lisez d’abord les postes de charge, les machines, les outils, les horaires d’équipe et les calendriers. Lisez ensuite les articles stockés et les nomenclatures. Déterminez comment représenter un poste de charge comprenant plusieurs machines : un groupe de postes de travail où chaque machine est un poste de travail, ou un seul poste de travail. Le paramètre Basis for Capacity d’Acumatica indique la logique retenue par l’usine.
2. Synchronisation des ordres. Lisez les ordres de fabrication et leurs opérations à partir de l’ordre, et non de la nomenclature. Les opérations sont copiées dans l’ordre, puis les planificateurs les modifient à cet endroit. Configurez une notification push sur une Generic Inquiry regroupant les ordres et les opérations ouverts, ou interrogez-la périodiquement. Lisez aussi les lignes de commandes fournisseurs ouvertes. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande fournisseur et met le stock à jour lorsque celle-ci passe au statut Delivered.
3. Écriture du planning en retour. Pour chaque opération placée ou déplacée par le moteur, SkyPlanner inscrit StartDate et EndDate dans OrderOperationDetail, ainsi que le poste de charge si le travail a été transféré vers un poste de remplacement. Il appelle ensuite FirmProductionOrder. Acumatica : « When you run finite scheduling of production orders, the system does not reschedule the firmed production orders. » (Lorsque vous lancez l’ordonnancement à capacité finie des ordres de fabrication, le système ne replanifie pas les ordres de fabrication affermis.) (source)
4. Confirmations en atelier. Les opérateurs enregistrent leur travail avec SkyPlanner Mobile Confirmations ou Production Timer. Les relevés de temps deviennent des documents LaborEntry (temps et quantité réalisée par opération) ou MoveEntry (quantité uniquement), validés par l’action correspondante. Si votre atelier déclare déjà sa production dans Acumatica, via Labor (AM301000) ou Shop Floor Kiosk, les données d’avancement circulent dans l’autre sens. Choisissez un seul canal, jamais les deux.
5. Responsabilité des données et règles de gestion des conflits. Consignez-les avant la mise en production :
| Données | Système responsable |
|---|---|
| Articles stockés, nomenclatures, quantités, statut des ordres, calcul des coûts | Acumatica |
| Séquence des opérations, heures de début et de fin, affectation aux postes de travail | SkyPlanner |
| Matrice des temps de préparation, outils, besoins en opérateurs, ressources de remplacement | SkyPlanner |
| Horaires d’équipe et absences | Un seul système, choisi lors du cadrage |
| Écritures de main-d’œuvre et de mouvements | Acumatica, à partir des pointages SkyPlanner ou des saisies en atelier |
La principale source de conflit est l’APS d’Acumatica lui-même. Rough Cut Planning ou APS Maintenance Process peuvent recalculer les dates des ordres ordonnancés par SkyPlanner. Le fait de rendre ferme chaque ordre après écriture empêche ce recalcul. Excluez également les ordres déjà ordonnancés des traitements APS.
Étapes habituelles du projet
La mise en œuvre s’achève normalement en quelques semaines après le début de l’accompagnement initial. Avant cela, l’essai gratuit de 30 jours vous permet de travailler avec vos propres données. Depuis une Generic Inquiry, exportez vers Excel les postes de charge et les ordres de fabrication ouverts avec leurs opérations, puis importez-les et validez l’ordonnancement.
- Correspondance des données. Définissez la table de correspondance, les règles de responsabilité sur les données, les fréquences de synchronisation et le canal de comptabilisation des temps de main-d’œuvre.
- Accès. Enregistrez l’application connectée, créez l’utilisateur et les rôles dédiés à l’intégration, puis confirmez la version du point de terminaison dans Web Service Endpoints. Commencez dans un environnement de test.
- Chargement initial. Postes de charge, machines, outils, équipes, articles stockés et nomenclatures.
- Synchronisation des ordres. Ordres de fabrication, opérations et commandes d’achat, par notification push ou interrogation périodique.
- Paramétrage des contraintes dans SkyPlanner. Matrice des temps de réglage, opérateurs nommément affectés, tâches nécessitant plusieurs opérateurs et solutions de remplacement.
- Écriture en retour. Dates des opérations, passage des ordres à l’état ferme et saisies de main-d’œuvre ou de transfert.
- Fonctionnement en parallèle. Comparez les dates de SkyPlanner au planning actuel et corrigez les données de base.
- Mise en production. Activez l’écriture en retour lorsque les données concordent.
Les points à prévoir pour une intégration Acumatica
- Identifiez le moteur APS actif. Classic et Optimized conservent leurs paramètres séparément, et un seul peut être activé. Vérifiez Enable/Disable Features (CS100000) avant la première écriture en retour.
- Fixez la version du point de terminaison. La version fait partie de l’URL. Une mise à niveau ajoute une nouvelle version : refaites donc les tests à chaque mise à niveau.
- Mise à jour des opérations. Certains champs des opérations sont en lecture seule via REST, et le statut de l’ordre entre en jeu. Testez la séquence d’écriture en retour dans un environnement de test pour les ordres aux statuts Released et In Process.
- Unités et champs de temps. Le temps d’exécution est rapporté à la quantité définie dans Run Units, et le temps machine à celle définie dans Machine Units. Les temps d’attente et de transfert « affect the calculated schedule but do not occupy work center capacity. » (influent sur l’ordonnancement calculé, mais ne mobilisent pas la capacité du poste de charge). Effectuez les conversions avec soin lors de l’import.
- Disponibilité des matières. Classic APS exige que toutes les matières soient disponibles dans leur intégralité. SkyPlanner ordonnance en fonction du stock et des commandes d’achat attendues, selon leurs dates. Convenez du résultat que les ordonnanceurs doivent suivre.
- Limites de l’API. Le nombre de requêtes par minute dépend de la licence. Utilisez des lectures incrémentales et des notifications push, plutôt que des rechargements complets.
Qui configure l’intégration Acumatica 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. Chaque usine utilise Acumatica à sa manière : ce savoir-faire est pris en compte à cette étape.
- Votre partenaire Acumatica peut participer. Il connaît vos personnalisations, vos Generic Inquiries et vos rôles. SkyPlanner fournit la REST API, la documentation Swagger/OpenAPI et les webhooks.
- Vos propres développeurs peuvent aussi réaliser l’intégration en s’appuyant sur la même REST API avec un jeton API. Un jeton API suffit pour commencer, et l’équipe SkyPlanner apporte son aide si nécessaire. Laboratory & Allied a choisi cette voie sur SAP Business One : son équipe informatique interne a réalisé l’intégration en grande partie elle-même, avec l’aide 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, présenté avec votre abonnement : vous connaissez ainsi le coût total avant de commencer. Comparez l’APS d’Acumatica dans la page Ordonnancement à capacité finie avec Acumatica, consultez la vue d’ensemble sur la page Acumatica et découvrez les autres systèmes dans 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 de tâches 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’élaboration d’un planning optimisé sur trois mois couvrant tous les postes de travail prend moins de 30 minutes.
1 000 et plusordres de fabrication ordonnancés automatiquement
« Nous maîtrisons la production d’une tout autre manière, et notre compréhension 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.
99,2 %de livraisons dans les délais
« SkyPlanner nous a donné la visibilité nécessaire pour repérer les goulets d’étranglement et a clarifié la gestion de la production. »
Toni Tuori, responsable de production
Piristeel · Équipements de sécurité pour toiture et systèmes 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.
FAQ
L’API Acumatica donne-t-elle accès aux ordres de fabrication ?
Oui. Le point de terminaison Manufacturing de la REST API basée sur des contrats expose ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool, ainsi que les saisies de main-d’œuvre et de transfert et des actions telles que FirmProductionOrder.
Qui réalise l’intégration Acumatica ?
L’équipe SkyPlanner configure l’intégration bidirectionnelle en fonction de votre paramétrage Acumatica pendant l’accompagnement initial et en assure le support après la mise en production. Votre partenaire Acumatica ou vos propres développeurs peuvent également s’appuyer sur la REST API documentée de SkyPlanner. Un jeton API suffit pour commencer.
Avons-nous besoin d’Acumatica APS pour cette intégration ?
Non. Dans Acumatica, le calcul à capacité finie s’effectue dans le formulaire Rough Cut Planning, et Classic APS planifie à capacité infinie les ordres dont la fin dépasse l’horizon de 120 jours (source). SkyPlanner établit lui-même un ordonnancement détaillé qui respecte la capacité disponible, à partir des ordres de fabrication, des opérations, des postes de charge, des machines et des outils. L’intégration fonctionne donc que l’APS soit activé ou non ; Acumatica précise que celui-ci « is subject to licensing » (est soumis à licence). Autopilot maintient l’ordonnancement à jour, et les opérateurs enregistrent leur travail avec Mobile Confirmations.
Comment empêcher Acumatica APS d’écraser les dates de SkyPlanner ?
SkyPlanner passe chaque ordre de fabrication au statut ferme après avoir enregistré les dates de ses opérations. L’ordonnancement d’Acumatica respecte la capacité disponible et ne replanifie pas les ordres fermes.
Acumatica peut-il transmettre les modifications en temps réel ?
Oui. Les notifications push (SM302000) configurées sur une Generic Inquiry envoient les lignes modifiées vers une URL au fil des changements. Les webhooks de SkyPlanner transmettent les modifications de l’ordonnancement dans l’autre sens.
Quelle authentification l’intégration doit-elle utiliser ?
OAuth 2.0, via un client enregistré dans Connected Applications (SM303010), avec un utilisateur dédié à l’intégration et des rôles limités aux droits strictement nécessaires. Le flux adapté à votre instance est confirmé lors du cadrage.
Pouvons-nous 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 issus d’une Generic Inquiry Acumatica, sans carte bancaire. Démarrez l’essai ou contactez notre équipe commerciale pour cadrer l’intégration.
