Intégrations / ERP / Visma Net ERP
Guide d’intégration de Visma Net pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de Visma Net explique aux partenaires et aux équipes informatiques comment relier Visma Net (Visma.net ERP) à SkyPlanner APS. L’intégration entre SkyPlanner et Visma Net fonctionne dans les deux sens via Visma Net API :
- Les articles stockés, les Kit specifications, les commandes clients, les niveaux de stock et les commandes fournisseurs sont importés dans SkyPlanner.
- Les opérations ordonnancées deviennent des Kit assemblies, qui sont validés une fois le travail terminé.
- Les heures des opérateurs sont renvoyées sous forme d’Employee time cards.
- Les webhooks SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
L’équipe SkyPlanner adapte l’intégration à votre configuration Visma Net lors de la mise en place, 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 (documentation de l’API).
Les interfaces d’intégration de Visma Net
- Visma Net ERP API. Une API REST dont la spécification OpenAPI porte toujours le titre « Visma.net ERP API v1 », avec des chemins v1 et v2. L’URL de base est
https://api.finance.visma.net. Le débit de l’ancien domaineintegration.visma.netest limité à partir du 1 février 2026, et sa fermeture est en cours (avis). - SalesOrder service v3, à l’adresse
https://salesorder.visma.net. Les points de terminaison v1 et v2 des commandes clients sont en fin de vie. - Webhooks via le Visma Developer Portal.
- Background API. L’en-tête
erp-api-backgroundmet les appels longs en file d’attente, renvoie le code 202 avec un identifiant de tâche et vous avertit lorsque le résultat est prêt. - Scénarios d’import et d’export dans Visma Net, avec des fournisseurs de données CSV, Excel ou SQL, pour les chargements ponctuels de données de base.
L’API ne propose aucun point de terminaison pour les ordres de fabrication, les gammes de fabrication ou les postes de charge, car ces objets n’existent pas dans Visma Net. Les données nécessaires à l’ordonnancement proviennent des articles, des kits, des commandes et des stocks :
GET /v1/inventory: articles stockés et non stockés, avec l’indicateur de kit et la classe d’articleGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: lignes de composants par révisionGET /v1/kitassembly: assemblages existants, filtrables par type et par statut- SalesOrder service v3 : demande avec les dates souhaitées et les lignes de commande
GET /v1/inventorysummary/{inventoryNumber}: quantités en stock et disponibles par entrepôtGET /v1/purchaseorderetGET /v2/PurchaseReceipt: matières attendues et réceptions
Tous les points de terminaison de liste acceptent lastModifiedDateTime avec lastModifiedDateTimeCondition, ainsi que pageNumber et pageSize. Chaque synchronisation peut donc être incrémentale.
Authentification et limites
Visma Net utilise Visma Connect (OpenID Connect et OAuth 2.0) :
- Enregistrez une Service Integration dans le Visma Developer Portal.
- L’administrateur du tenant Visma Net du client approuve l’intégration.
- Demandez les jetons via le flux client credentials à l’adresse
https://connect.visma.com/connect/token, en transmettant letenant_idet les portées d’API telles quevisma_api:read. Les jetons sont valides pendant 3 600 secondes.
Les limites de débit s’appliquent par société et par client, sur une fenêtre horaire fixe. Les réponses contiennent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. En cas de dépassement, l’API renvoie le code 429 avec Retry-After (limites de débit). Les en-têtes ETag et If-Match protègent les mises à jour.
Les partenaires effectuent leurs tests sur une société de démonstration dans le cadre de l’Integrator Programme gratuit de Visma. Côté SkyPlanner, l’accès à la REST API nécessite une authentification par jeton d’API (SkyPlanner Settings > API). La documentation est disponible au format Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Événements, webhooks et interrogation périodique
Les webhooks du Visma Developer Portal couvrent les événements utiles à l’ordonnancement :
- Inventory Item Created, Updated and Changed
- Purchase Order Changed and Status Changed
- Sales Order Changed and Status Changed, en cours de migration vers le service de publication SalesOrderService
Aucun événement n’est disponible pour les objets Kit assembly ou Kit specifications. SkyPlanner les interroge périodiquement avec des filtres lastModifiedDateTime. Les niveaux de stock sont interrogés à chaque calcul de l’ordonnancement. Dans l’autre sens, SkyPlanner envoie des webhooks lorsque l’état ou le planning change.
Correspondance des données
| Objet Visma Net (point de terminaison) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
Articles stockés et non stockés (/v1/inventory) | Produits et matières | Visma Net → SkyPlanner | Chargement initial, puis webhook |
Kit specifications (/v1/KitSpecifications) | Structure des produits, matières par produit | Visma Net → SkyPlanner | Chargement initial, puis interrogation périodique |
| Commandes clients (SalesOrder service v3) | Commandes avec dates d’échéance et priorité du client | Visma Net → SkyPlanner | Webhook |
Kit assembly, statut On hold (/v1/kitassembly), si les assemblages sont créés dans Visma Net | Opérations | Visma Net → SkyPlanner | Interrogation périodique |
Récapitulatif des stocks (/v1/inventorysummary) | Niveaux de stock par entrepôt | Visma Net → SkyPlanner | Interrogation à chaque calcul de l’ordonnancement |
Commandes fournisseurs, réceptions d’achats (/v1/purchaseorder, /v2/PurchaseReceipt) | Matières attendues avec leur date de livraison ; mise à jour du stock à la livraison de la commande fournisseur | Visma Net → SkyPlanner | Webhook, puis lecture |
| Absent de Visma Net | Étapes de fabrication, postes de travail, horaires d’équipe, matrice des temps de préparation, outils, ressources alternatives | Gérés dans SkyPlanner | Configurés lors de la mise en place |
Création et mise à jour d’un Kit assembly (POST/PUT /v1/kitassembly) | Opération ordonnancée : article kit, quantité, date de fin prévue | SkyPlanner → Visma Net | À chaque modification du planning, via un webhook SkyPlanner |
Validation d’un Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Opération terminée : production réalisée et consommation de composants | SkyPlanner → Visma Net | À la fin de l’opération |
Entrée en stock, sortie de stock (/v1/inventoryReceipt, /v1/inventoryissue, validation) | Production réalisée et consommation de matières lorsque les kits ne sont pas utilisés | SkyPlanner → Visma Net | À la fin de l’opération |
Employee time card (/v1/timeCard) | Heures enregistrées par opérateur | SkyPlanner → Visma Net | Chaque semaine |
Schémas d’intégration
1. Chargement initial des données de base. Récupérez les articles stockés, les classes d’articles et la dernière révision de Kit specification pour chaque kit. Associez chaque ligne de composant à une matière dans SkyPlanner. Créez ensuite les données que Visma Net ne contient pas : postes de travail, horaires d’équipe, étapes de fabrication avec leurs temps de préparation et d’exécution, matrice des temps de préparation et besoins en outils. Importez ces données au format CSV ou Excel. C’est la partie la plus importante du projet.
2. Synchronisation des commandes. Choisissez un modèle de demande :
- Pilotage par les commandes clients. Les lignes ouvertes des commandes clients portant sur des articles kits deviennent des commandes SkyPlanner, avec la date souhaitée comme date d’échéance.
- Pilotage par les assemblages. Les Kit assemblies créés dans Visma Net au statut On hold deviennent des opérations SkyPlanner.
Les commandes fournisseurs ouvertes sont importées avec leurs dates. 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. Grâce à ces données et au récapitulatif des stocks, l’ordonnancement tient compte à la fois des stocks et des achats attendus.
3. Retour des données d’ordonnancement. Dans une configuration pilotée par les commandes clients, SkyPlanner crée un Kit assembly de type Production pour chaque opération ordonnancée. Il renseigne l’article kit, la révision, l’entrepôt, la quantité et les composants, puis relie l’assemblage à la ligne de commande client. La date de l’assemblage correspond à la date de fin prévue. Lorsqu’Autopilot déplace l’opération, un appel PUT met cette date à jour avant la validation.
L’objet Kit assembly ne possède qu’un seul champ Date. Les horaires détaillés des opérations restent donc dans SkyPlanner, tandis que Visma Net reçoit la date utile aux ventes et à la gestion des stocks.
4. Déclarations en atelier. Les opérateurs enregistrent leur travail avec Mobile Confirmations ou Production Timer, et les relevés de temps maintiennent le planning à jour. Une fois la dernière étape terminée, SkyPlanner appelle l’action release sur le Kit assembly. Cette validation comptabilise la production réalisée et la consommation des composants, puis génère le lot d’écritures du grand livre. Les heures sont regroupées dans les Employee time cards hebdomadaires ou dans les transactions de projet pour les travaux gérés par projet.
5. Responsabilité des données et règles de gestion des conflits. Consignez-les avant la mise en service :
| Données | Système responsable |
|---|---|
| Articles, Kit specifications, commandes clients, commandes fournisseurs, stocks, coûts | Visma Net |
| Étapes de fabrication, postes de travail, horaires d’équipe, réglages, outils | SkyPlanner |
| Séquencement des opérations, heures de début et de fin, affectation aux postes de travail | SkyPlanner |
| Date du Kit assembly avant validation | SkyPlanner |
| Kit assemblies validés et feuilles de temps | Visma Net, avec comptabilisation depuis SkyPlanner |
Toute modification d’une Kit specification crée une nouvelle révision. Relisez la dernière révision et mettez à jour les correspondances, car seule cette révision peut servir à la fabrication. Les modifications manuelles des composants d’un assemblage restent valables dans Visma Net. SkyPlanner relit donc l’assemblage avant de le valider.
Étapes types du projet
La mise en œuvre s’achève normalement en quelques semaines après le début de l’accompagnement. Au préalable, l’essai gratuit de 30 jours utilise vos propres données, issues d’un scénario d’export Visma Net et importées au format CSV ou Excel.
- Cadrage. Définissez le modèle de demande, la table de correspondance, les règles de responsabilité des données et les objets destinataires des données renvoyées à Visma Net (Kit assembly ou entrées en stock).
- Configuration de Visma Connect. Enregistrez la Service Integration et obtenez l’approbation de l’administrateur du tenant. Effectuez d’abord les tests dans une société de démonstration.
- Modèle de production. Configurez les postes de travail, les horaires d’équipe, les étapes de fabrication, les réglages et les outils dans SkyPlanner.
- Chargement initial. Importez les articles stockés, les classes d’articles, les Kit specifications, les entrepôts et les stocks.
- Synchronisation des commandes clients et fournisseurs. Utilisez des webhooks pour les commandes clients, les commandes fournisseurs et les articles, et une interrogation périodique pour les kits et les stocks. Prévoyez à cette étape le renouvellement des jetons et la gestion des réponses 429.
- Retour des données vers Visma Net. Mettez en place la création, la mise à jour et la validation des Kit assemblies, ainsi que la transmission des feuilles de temps.
- Tests en parallèle. Faites fonctionner SkyPlanner en parallèle du planning actuel et comparez les dates.
- Mise en service. Activez le retour des données vers Visma Net une fois que les données concordent.
Les points à prévoir pour une intégration Visma Net
- Aucune gamme de fabrication à importer. Toutes les étapes de fabrication et tous les temps de réglage et d’exécution sont définis dans SkyPlanner. Prévoyez la charge de travail et désignez un responsable.
- Advanced logistics. Kit assembly nécessite le groupe Advanced logistics. Avec Standard logistics, comptabilisez la production réalisée à l’aide d’Inventory receipt et d’Inventory issue.
- Révisions verrouillées. Une révision de Kit specification déjà utilisée ne peut plus être modifiée, et seule la dernière révision peut servir à la fabrication.
- Unités de mesure. Le Kit assembly possède sa propre unité de mesure. À l’import, assurez sa cohérence avec les quantités dans SkyPlanner.
- Interrogation périodique en l’absence d’événements. Les kits ne disposent pas de webhooks. Récupérez uniquement les modifications à l’aide de
lastModifiedDateTime, plutôt que de tout recharger, pour respecter la limite horaire d’appels. - Points de terminaison actuels. Développez uniquement sur
api.finance.visma.netet SalesOrder service v3. - Approbation du tenant. L’authentification par identifiants client échoue tant que l’administrateur du tenant n’a pas approuvé l’application. Planifiez cette étape dès le début.
- Feuilles de temps hebdomadaires. Les feuilles de temps nécessitent Advanced financials et couvrent une semaine. Regroupez les heures des opérateurs par semaine ou comptabilisez-les dans les transactions de projet.
Qui configure l’intégration Visma Net et en assure le support ?
- L’équipe SkyPlanner la configure pendant l’accompagnement initial et en assure le support après la mise en service. Cela couvre la partie SkyPlanner, le modèle de production absent de Visma Net et les appels à l’API Visma Net convenus ensemble. Chaque usine utilise Visma Net différemment : cette connaissance du terrain intervient à cette étape.
- Votre partenaire Visma Net peut participer. Visma déploie Visma Net avec des partenaires certifiés Visma. Ils connaissent votre configuration et peuvent vérifier les correspondances et l’application Visma Connect. SkyPlanner fournit la REST API, la documentation Swagger/OpenAPI et les webhooks.
- Vos propres développeurs peuvent réaliser l’intégration à partir de la même REST API documentée, avec un jeton API. Un jeton API suffit pour commencer, et l’équipe SkyPlanner vous aide au besoin. Consultez la documentation publique sur SkyPlanner docs.
Une fois la connexion établie, le moteur Arcturus ordonnance la production à partir des commandes Visma Net à jour. Le travail terminé est renvoyé dans Visma Net sous forme de Kit assemblies validés. Les tarifs commencent à 199 € par mois, avec 5 postes de travail inclus et une facturation mensuelle. Un devis pour l’intégration, adapté à vos processus et à vos besoins, vous est remis en amont avec votre abonnement. Vous connaissez ainsi le coût total avant de commencer.
Consultez les tarifs, découvrez pourquoi Visma Net a besoin d’un outil d’ordonnancement dans l’ordonnancement à capacité finie avec Visma Net, retrouvez la vue d’ensemble sur la page Visma Net et explorez les autres ERP 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 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 il faut moins de 30 minutes pour établir un planning optimisé sur trois mois couvrant tous les postes de travail.
98 %de livraisons dans les délais, contre environ 50 % auparavant
« SkyPlanner joue un rôle décisif pour que nous continuions à respecter nos délais de livraison. »
Hannu Lahtinen, directeur général
KJH-Comp · Tôlerie et sous-traitance industrielle
Le taux de respect des délais de livraison est passé d’environ 50 % à un niveau pouvant atteindre 98 %, et l’ordonnancement ne mobilise plus qu’un seul responsable au lieu de deux.
6 moisde visibilité sur la capacité disponible pour les commerciaux
« SkyPlanner apporte une base solide et fiable à l’ensemble de la planification de la production. »
Anu Järvinen, responsable de production
Fredman Operations · Papiers d’emballage aptes au contact alimentaire
Les commerciaux disposent d’une visibilité sur la capacité disponible à six mois. Les demandes de modification du planning, qui nécessitaient une heure ou plus, reçoivent désormais une réponse en quelques secondes.
FAQ
L’API Visma Net propose-t-elle des ordres de fabrication ?
Non. Visma Net ne possède aucun objet pour les ordres de fabrication, les gammes de fabrication ou les postes de charge. L’API n’en propose donc pas non plus. Le document de production est le Kit assembly, accessible via /v1/kitassembly. Les gammes de fabrication et les postes de travail sont gérés dans SkyPlanner.
Quel mode d’authentification l’intégration utilise-t-elle ?
L’intégration utilise Visma Connect avec le flux client credentials d’OAuth 2.0. Elle est enregistrée comme Service Integration dans le Visma Developer Portal. L’administrateur du tenant approuve l’intégration, et les jetons sont valables une heure.
Visma Net peut-il transmettre les modifications en temps réel ?
Oui, pour les articles, les commandes clients et les commandes fournisseurs, grâce aux webhooks du Visma Developer Portal. Les Kit assemblies et les Kit specifications ne génèrent pas d’événements : leurs modifications sont récupérées par interrogation incrémentale. Les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
Comment la production terminée est-elle renvoyée dans Visma Net ?
SkyPlanner crée un Kit assembly pour chaque opération ordonnancée, maintient sa date à jour et appelle l’action release lorsque l’opération est terminée. Cette validation comptabilise la production réalisée et la consommation des composants. Sans kits, Inventory receipt et Inventory issue remplissent le même rôle.
Peut-on tester SkyPlanner avant de développer 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 Visma Net, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
