Guide til integrasjon av Monitor ERP for produksjonsplanlegging med SkyPlanner APS

Det dokumenterte integrasjonsgrensesnittet i Monitor G5 er Monitor ERP API v1. Det er en hybrid av CQRS og REST med JSON over HTTPS. (Monitor ERP API)

• Spørringer leser data med GET. De støtter parametere i OData-stil: $filter, $select, $expand, $orderby, $top og $skip.
• Kommandoer skriver data med POST, for eksempel Manufacturing/ManufacturingOrderOperations/Update.
• Batch kjører flere kommandoer i én transaksjon via POST /api/v1/Batch, der enten alt eller ingenting gjennomføres. Legg til /Simulate eller /Validate for å teste en batch og rulle den tilbake. Dette er den sikre måten å skrive en hel produksjonsplan på. (Batch)

Basis-URL-en er https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Selskapsnummeret kombinerer databasenummeret og selskaps-ID-en, for eksempel 004.1.

Om lisensiering sier 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 kunder kan gratis spørre etter og hente ut informasjon fra API-et. For å bruke kommandoer og skrive data til ERP-systemet må dere kjøpe Monitor ERP API.) Ta med lisensen for skrivetilgang i prosjektplanen fra første dag. (api.monitor.se)

Referansedokumentasjonen for Monitor ERP API beskriver ingen webhooks eller hendelsesabonnementer. Endringer fanges opp ved polling:

• Common/EntityChangeLogs (fra 2.33) returnerer ChangeType (Update, Create, Delete), EntityTypeId, EntityId og ModifiedTimestamp. Kjør polling med noen minutters mellomrom, og hent bare postene som er endret. (EntityChangeLog)
• Filtrer spørringer etter produksjonsordrer slik at de bare henter åpne ordrer, og bruk $top og $skip til paginering.

SkyPlanner sender webhooks når tilstanden eller produksjonsplanen endres. Tilbakeskrivingen er dermed hendelsesstyrt.

1. Førstegangsimport av grunndata. Les inn arbeidssentre, operasjonsrader, alternative operasjonsrader, materialrader, artikler og arbeidsplaner. Vurder nøye hvordan hvert arbeidssenter skal kobles til en arbeidsstasjon i SkyPlanner. Et arbeidssenter av typen Pool blir en arbeidsstasjonsgruppe. Arbeidssentrene som inngår i gruppen, blir arbeidsstasjonene planleggingsmotoren velger mellom.

2. Ordresynkronisering. Les inn åpne produksjonsordrer med tilhørende noder, operasjoner og materialer, samt lagerbeholdning og åpne innkjøpsordrer. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Etter førstegangsimporten styres endringsoppdateringene av Common/EntityChangeLogs.

3. Tilbakeskriving av produksjonsplanen. For hver operasjon planleggingsmotoren har plassert eller flyttet, sender SkyPlanner ManufacturingOrderOperations/Update med PlannedStartDate og PlannedFinishDate. Når motoren har flyttet en operasjon til en annen maskin i en pool, kommer SetWorkCenter først. Kommandoene for én ordre samles i én Batch, slik at Monitor godtar enten alle eller ingen. Kjør batchen gjennom /Validate under testing.

I Monitor-versjoner før 24.5 kan de planlagte datoene ikke skrives via Update. Bruk i stedet ManufacturingOrders/ReplanOperation (fra 2.40) med StartDate og FinishDate, og sett RestrictToOrderBounds i tråd med reglene deres.

4. Tilbakemeldinger fra produksjonen. Bruk én rapporteringskanal:

• Monitor beholdes som rapporteringskanal. Operatørene rapporterer via Recording terminal eller maskinintegrasjon som i dag. SkyPlanner leser ManufacturingOrderOperationReportings for å følge fremdriften og planlegger på nytt.
• SkyPlanner blir rapporteringskanalen. Operatørene registrerer arbeid med Mobile Confirmations eller Production Timer, og SkyPlanner sender ReportManufacturingOrderOperation til Monitor.

Rapportering fra begge systemene fører til dobbeltregistrering av tid og mengder.

5. Dataeierskap og regler for konflikthåndtering. Dokumenter dette før produksjonssetting:

Den vanligste kilden til konflikt er at planleggerne fortsetter å endre prioritetsplanen. Omplanlegging med Rescheduling according to New finish og flytting av rader i Priority planning overskriver datoene SkyPlanner har skrevet. Når SkyPlanner styrer rekkefølgen, brukes Priority planning bare som visning. Med Autopilot planlegger SkyPlanner automatisk på nytt når produksjonen endrer seg.

• Tilgjengelighetsfaktor. Monitor bruker tilgjengelighetsfaktoren til å redusere bruttokapasitet til nettokapasitet. Standardverdien for et nytt arbeidssenter er 80 %. Bruk faktoren én gang, enten som effektivitet i SkyPlanner eller som kortere skift, aldri begge deler.
• Tidsoppløsning. Arbeidssentre med Day planning har kapasitet angitt som grunntid per dag, uten skifttider. Legg inn de faktiske skiftene fra produksjonskalenderne i SkyPlanner, slik at jobbene planlegges innenfor arbeidstiden.
• Køtid og overlapping. Operasjonsradene inneholder køtid og overlapping i %. Bestem under avklaringen hvordan hver av dem skal overføres til SkyPlanner. Ellers endres gjennomløpstidene etter produksjonssetting.
• Pooler. Arbeidssentre av typen pool planlegges i Pool planning, ikke i Priority planning. Les inn arbeidssentrene som inngår, ikke bare poolraden.
• Versjonskrav. Planlagte datoer via Update krever 24.5. Kapasitetsfeltene for arbeidssentre i API-et krever 24.3, og OIDC krever 25.8. Sjekk build-versjonen før avklaringen.
• Nettverk og sertifikat. Ved lokal installasjon av Monitor er API-et tilgjengelig på port 8001 med et selvsignert sertifikat. SkyPlanner kjører i skyen, så planlegg en brannmurregel eller et relé, og legg eksplisitt inn tillit til sertifikatet.
• Lisenser. Hver tredjepartsapplikasjon som skriver data, trenger egne brukere med API-lisens. Én API-bruker med kun lesetilgang følger med hvert system.