ProShop ERP-integratiegids voor uw productieschema met SkyPlanner APS

ProShop biedt twee mogelijkheden om een externe planningstool aan te sluiten. Deze staan beschreven in de ProShop API Developer Documents:

1. ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (ProShop biedt een GraphQL API die via HTTP(S) beschikbaar is.) Er is één endpoint: elke aanroep is een HTTP POST naar <proshop root>/api/graphql met query, variables en operationName in een JSON-body. Elke module heeft een query in het enkelvoud voor één record en een query in het meervoud voor lijsten. Lijsten worden gepagineerd met pageSize (standaard 20) en pageStart en geven records en totalRecords terug. Ze accepteren de argumenten filter en query, die aansluiten op Advanced Search van de betreffende module. Het schema is via introspectie op te vragen. (Inleiding tot de ProShop API)
2. Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Via een eenvoudige REST-interface kunnen externe integraties informatie opvragen over een vrij te kiezen tijdvak.) Roep <proshop root>/recentlyupdatedrecords aan met start (ISO 8601) en optioneel end en filterby, bijvoorbeeld workorders,workcells,purchaseorders,timetracking,deletions. Het ProShop-team moet de index eerst inschakelen. (Recently Updated Records API)

Gegevens worden geschreven via GraphQL-mutaties. Time Tracking Login is het gedocumenteerde voorbeeld. Schrijfrechten worden per module toegekend via scopes.

De ontwikkelaarsdocumentatie van ProShop beschrijft geen uitgaande webhooks of GraphQL-subscriptions. Gegevens uit ProShop worden via polling opgehaald. Met de Recently Updated Records API blijft de belasting beperkt: vraag alles op wat sinds de vorige uitvoering is aangemaakt, gewijzigd of verwijderd, gefilterd op de recordtypen die nodig zijn voor het productieschema. Haal vervolgens de gewijzigde productieorders op nummer op via GraphQL. Volgens ProShop is dat sneller dan zoeken op lastModifiedTime.

Een gebruikelijke keuze is om productieorders en tijdregistraties elke vijf minuten op te halen en artikelen en inkooporders elk uur. SkyPlanner verstuurt webhooks zodra de status of het productieschema verandert. Het terugschrijven wordt dus door gebeurtenissen aangestuurd.

1. Eerste import van stamgegevens. Haal Parts, Work Cells, Users, Tools en Fixtures pagina voor pagina op met GraphQL-query’s in het meervoud. Stel voor de eerste import een hoge pageSize in en herhaal de aanroepen op basis van totalRecords. Bepaal hoe werkcellen worden gekoppeld: werkcellen voor machines worden werkcentra, en werkcellen voor personen worden medewerkers. Zo kan dezelfde bewerking een machine en de bijbehorende operator tegelijk reserveren.

2. Productieorders synchroniseren. Lees actieve productieorders in met hun bewerkingen, normtijden en BOM-records, samen met 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. Wijzigingen worden gedetecteerd via Recently Updated Records met filterby=workorders,purchaseorders,deletions.

3. Het productieschema terugschrijven. Wanneer de planningsengine een taak inplant of verplaatst, activeert een SkyPlanner-webhook een GraphQL-mutatie die de geplande datums van de productieorder instelt. Dit gebeurt onder een Authorization met workorders:w. De prognose van ProShop voor tijdige levering en de datums waarop ingekochte materialen nodig zijn, worden dan gebaseerd op de datums van SkyPlanner.

4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden het productieschema actueel. U kiest of de werkelijk bestede tijd wordt teruggeschreven naar ProShop Time Tracking op de betreffende bewerking van de productieorder. Zo niet, dan registreren operators hun tijd zoals voorheen in ProShop en leest SkyPlanner die in via timetracking.

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

Laat de datums van productieorders door slechts één systeem schrijven. Zodra SkyPlanner een werkcel inplant, wijzigen planners de volgorde van de lijst voor die werkcel niet meer in ProShop. Zo spreken de twee planningen elkaar nooit tegen.

• Normtijden bepalen alles. ProShop berekent de duur op basis van geschatte instel- en cyclustijden. Haal de actuele normtijden op, niet de oorspronkelijke schatting. Houd insteltijd en bewerkingstijd gescheiden, zodat de insteltijdenmatrix de vaste instelwaarde kan vervangen.
• Personen als werkcel. Een werkcel kan een persoon zijn. Koppel deze werkcellen aan personeel in SkyPlanner, niet aan machines. Anders wordt elke operator een parallelle machine.
• Time Tracking vereist een gebruiker. Sinds april 2026 geldt voor de Time Tracking Login-mutatie “requires user context” (gebruikerscontext vereist). Deze mutatie is niet toegestaan via Client Credentials. Verstuur de gewerkte tijd van operators via de OAuth 2.0 Authorization Flow, of blijf de tijd in ProShop registreren en lees die uit.
• Laat de wijzigingsindex activeren. Recently Updated Records werkt pas nadat het ProShop-team deze functie heeft ingeschakeld. Vraag dit in week één aan.
• ITAR-records. ProShop filtert records waarvoor ITAR-beperkingen gelden per verbinding. Een optie in Developer System Config bepaalt of deze als null-waarden worden teruggegeven of worden weggelaten. Spreek af welke productieorders de integratie mag zien en houd bij elke leesactie rekening met null-waarden.
• Uitbestede bewerkingen. Bewerkingen bij leveranciers tellen als doorlooptijd, niet als belasting van uw eigen capaciteit. Modelleer ze als stappen waaraan alleen een tijdsduur is gekoppeld.