Monitor ERP-integratiegids voor productieschema’s met SkyPlanner APS

De gedocumenteerde integratie-interface van Monitor G5 is de Monitor ERP API v1. Deze combineert CQRS en REST en gebruikt JSON via HTTPS. (Monitor ERP API)

• Queries lezen gegevens met GET. Ze ondersteunen opties in OData-stijl: $filter, $select, $expand, $orderby, $top en $skip.
• Commands schrijven gegevens met POST, bijvoorbeeld Manufacturing/ManufacturingOrderOperations/Update.
• Batch voert via POST /api/v1/Batch meerdere commands uit in één transactie: alles wordt uitgevoerd of niets. Voeg /Simulate of /Validate toe om een batch te testen en terug te draaien. Zo schrijft u een volledig productieschema veilig weg. (Batch)

De basis-URL is https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Het bedrijfsnummer combineert het databasenummer en de bedrijfs-ID, bijvoorbeeld 004.1.

Over licenties zegt Monitor: “It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.” (Alle klanten kunnen gratis gegevens opvragen en uitlezen via de API. Voor commands en het schrijven van gegevens naar het ERP-systeem is aanschaf van Monitor ERP API nodig.) Neem de licentie voor schrijftoegang vanaf dag één mee in het project. (api.monitor.se)

De Monitor ERP API-referentie documenteert geen webhooks of eventabonnementen. Wijzigingen worden via polling opgehaald:

• Common/EntityChangeLogs (vanaf 2.33) retourneert ChangeType (Update, Create, Delete), EntityTypeId, EntityId en ModifiedTimestamp. Vraag dit endpoint om de paar minuten op en haal alleen de gewijzigde records op. (EntityChangeLog)
• Filter queries voor productieorders op openstaande orders en gebruik $top en $skip voor paginering.

SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven is dus eventgestuurd.

1. Eerste import van stamgegevens. Lees werkcentra, bewerkingsregels, alternatieve bewerkingsregels, materiaalregels, artikelen en dienstroosters in. Koppel elk werkcentrum bewust aan een werkcentrum in SkyPlanner. Een Pool-werkcentrum wordt een werkcentrumgroep. De werkcentra die daarvan deel uitmaken, worden de werkcentra waaruit de engine kiest.

2. Ordersynchronisatie. Lees openstaande productieorders met hun knooppunten, bewerkingen en materialen in, evenals de voorraad en openstaande inkooporders. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt. Na de eerste import bepaalt Common/EntityChangeLogs welke wijzigingen worden opgehaald.

3. Het productieschema terugschrijven. Voor elke bewerking die de engine heeft ingepland of verplaatst, verstuurt SkyPlanner ManufacturingOrderOperations/Update met PlannedStartDate en PlannedFinishDate. Als de engine een bewerking naar een andere machine in een pool heeft verplaatst, wordt eerst SetWorkCenter uitgevoerd. De commands voor één order gaan in één Batch, zodat Monitor ze allemaal accepteert of geen enkele. Voer de batch tijdens het testen uit via /Validate.

In Monitor-versies vóór 24.5 kunnen de geplande datums niet via Update worden geschreven. Gebruik in plaats daarvan ManufacturingOrders/ReplanOperation (vanaf 2.40) met StartDate en FinishDate, en stel RestrictToOrderBounds in volgens uw regels.

4. Terugmeldingen vanaf de werkvloer. Gebruik één registratiekanaal:

• Monitor blijft het kanaal. Operators registreren hun werk zoals nu via de Recording terminal of via machine-integratie. SkyPlanner leest de voortgang uit ManufacturingOrderOperationReportings en plant opnieuw.
• SkyPlanner wordt het kanaal. Operators registreren hun werk met Mobile Confirmations of de Production Timer. SkyPlanner verstuurt vervolgens ReportManufacturingOrderOperation naar Monitor.

Registratie in beide systemen leidt tot dubbele tijden en aantallen.

5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:

Conflicten ontstaan vooral doordat planners de prioriteitenplanning blijven aanpassen. Rescheduling according to New finish en het verslepen van rijen in Priority planning overschrijven de datums die SkyPlanner heeft vastgelegd. Zodra SkyPlanner de volgorde bepaalt, dient Priority planning alleen nog als weergave. Met Autopilot past SkyPlanner de planning automatisch aan wanneer de productie verandert.

• Beschikbaarheidsfactor. Monitor rekent de brutocapaciteit om naar nettocapaciteit met de beschikbaarheidsfactor. Die staat bij een nieuw werkcentrum standaard op 80 %. Pas deze factor één keer toe: als efficiëntie in SkyPlanner óf als kortere ploegendiensten, nooit allebei.
• Tijdsnauwkeurigheid. Bij werkcentra die Day planning gebruiken, is de capaciteit vastgelegd als basistijd per dag, zonder tijden voor ploegendiensten. Leg de werkelijke ploegendiensten op basis van de productieroosters vast in SkyPlanner, zodat opdrachten binnen de werktijden worden ingepland.
• Wachttijd en overlap. Bewerkingsregels bevatten wachttijd en overlap in %. Bepaal tijdens de scopebepaling hoe beide naar SkyPlanner worden vertaald. Anders veranderen de doorlooptijden na ingebruikname.
• Pools. Werkcentra in een pool worden gepland in Pool planning, niet in Priority planning. Lees de onderliggende werkcentra uit, niet alleen de poolregel.
• Versievereisten. Voor geplande datums via Update is 24.5 nodig. Capaciteitsvelden van werkcentra in de API vereisen 24.3 en OIDC vereist 25.8. Controleer de build vóór de scopebepaling.
• Netwerk en certificaat. Bij een lokale installatie biedt Monitor de API aan op poort 8001 met een zelfondertekend certificaat. SkyPlanner draait in de cloud. Voorzie daarom in een firewallregel of een relay en stel het certificaat expliciet als vertrouwd in.
• Licenties. Elke externe applicatie die gegevens schrijft, heeft eigen gebruikers met een API-licentie nodig. Elk systeem wordt geleverd met één API-gebruiker met alleen leesrechten.