Integraties / ERP / Sage 200
Sage 200-integratiegids voor het opstellen van productieschema’s met SkyPlanner APS
Deze Sage 200-integratiegids laat partners en IT-teams zien hoe ze Sage 200 Professional en de bijbehorende productie-add-on koppelen aan SkyPlanner APS. De integratie tussen SkyPlanner en Sage 200 werkt in beide richtingen:
- Producten, magazijnvoorraden, inkooporders en verkooporders worden via de Sage 200 REST API ingelezen.
- Productieorders, bewerkingen, medewerkers en machines worden uit uw productie-add-on ingelezen.
- Geplande bewerkingsdatums worden teruggeschreven naar de productieorders.
- Tijdregistraties van operators worden teruggestuurd om de uren per bewerking te boeken.
Het SkyPlanner-team stemt de integratie tijdens de onboarding af op uw Sage 200-inrichting en biedt ook na de ingebruikname ondersteuning. Deze gids is bedoeld voor partners en ontwikkelaars die daaraan willen meewerken of zelf willen voortbouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
Twee bronnen binnen één Sage 200-systeem
Een Sage 200-omgeving voor productiebedrijven bestaat uit twee lagen. De integratie leest beide uit.
1. De Sage 200 REST API voor commerciële gegevens en voorraadgegevens. Volgens Sage kan de API het volgende: “lets your application read and modify data in a Sage 200 site” (laat uw applicatie gegevens in die omgeving lezen en wijzigen). Dit omvat klanten, leveranciers, producten, verkoop- en inkooporders en grootboekrekeningen. De referentiedocumentatie van Sage 200 Professional (2025.02) groepeert de resources onder Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP en Stock. De volgende resources zijn van belang voor het productieschema:
| API-resource | Inhoud |
|---|---|
products | Code, naam, voorraadeenheid, BOM-artikeltype, standaardkostprijs |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Openstaande inkooporders, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Klantvraag, requested_delivery_date, promised_delivery_date |
warehouses, units | Vestigingen en maateenheden |
2. De productie-add-on voor productieorders. De Sage 200 API heeft geen endpoints voor productieorders, bewerkingen of productiemiddelen. Productieorders staan in Sicon Works Order Processing, Cim200 of de oudere module Sage 200 Manufacturing. De integratie leest productieorders, bewerkingen en productiemiddelen uit via de route die de add-on ondersteunt. Die route spreken we tijdens de scopebepaling af met u en uw Sage 200-partner.
Authenticatie en toegang
De Sage 200 API “uses OAuth 2.0 with OpenID Connect” (gebruikt OAuth met OpenID Connect), met de authorization code grant flow. Aanmelden verloopt via Sage ID.
- Meld u aan voor het Sage 200 API Developer Programme en vraag toegangsgegevens aan.
- Koppel een Sage ID aan een Sage 200-gebruiker met toegang tot de bedrijven en functies die nodig zijn voor de endpoints die u gebruikt.
- Vraag de scope
offline_accessaan, anders wordt er geen refresh token uitgegeven. - Stuur bij elk databaseverzoek
Authorization: Bearer <access_token>,X-SiteenX-Companymee. Beide ID’s zijn afkomstig uit/sites.
Basis-URL voor Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Verzoeken gebruiken GET, POST, PUT en DELETE, en de OData-queryopties $filter, $select, $top, $skip, $orderby en $expand.
Voor Sage 200 Professional schakelt de supportleverancier van de klant de API in. In de checklist van Sage bevestigt deze dat “the API is enabled” (de API is ingeschakeld) en dat “each required user has a Sage ID assigned.” (elke benodigde gebruiker een Sage ID toegewezen heeft gekregen). Bij Sage 200 Standard is de API standaard ingeschakeld.
Houd bij het ontwerp rekening met de geldigheidsduur van tokens. Access tokens zijn 8 uur geldig. Refresh tokens zijn tussen 1 en 90 dagen geldig, en “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (De verversingsperiode wordt gemeten vanaf de eerste aanmelding van de gebruiker, niet vanaf de meest recente verversing.) Volgens Sage geldt voor opnieuw authenticeren: “is unavoidable” (is onvermijdelijk). Zorg voor een melding om opnieuw toestemming te geven voordat die periode afloopt.
Aan de kant van SkyPlanner gebruikt de REST API een API-token voor authenticatie (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding begeleidt u bij de eerste aanroepen.
Wijzigingen detecteren
De Sage 200 API-referentie bevat geen resource voor webhooks of abonnementen. Wijzigingen worden via polling opgehaald. Records bevatten date_time_created en date_time_updated. Bij elke pollingronde wordt daarom met $filter op date_time_updated gefilterd en met $top en $skip gepagineerd.
Haal productieorders om de paar minuten op, en voorraden en inkooporderregels elk uur. SkyPlanner verstuurt webhooks wanneer het productieschema verandert, zodat wijzigingen gebeurtenisgestuurd worden teruggeschreven.
Gegevensmapping
| Sage 200-object (bron) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
products, units (API) | Producten en materialen | Sage 200 → SkyPlanner | Inladen, daarna polling |
| BOM-componenten (add-on of BOM-module) | Productstructuur, deelproducten, materialen per product | Sage 200 → SkyPlanner | Bij wijzigingen |
| Medewerkers, machines en groepen productiemiddelen (add-on) | Werkcentra, werkcentrumgroepen, personeel | Sage 200 → SkyPlanner | Eerste inlading |
| Beschikbaarheid van productiemiddelen: stilstand, onderhoud, vakantie (add-on) | Ploegendiensten, afwezigheden | Sage 200 → SkyPlanner | Dagelijks |
| Productieorders met hun bewerkingen, tijden per bewerking (add-on) | Orders en taken met stappen, doorlooptijden en uiterste opleverdatums | Sage 200 → SkyPlanner | Om de paar minuten |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Leverdatums voor klanten | Sage 200 → SkyPlanner | Polling |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Voorraadstanden | Sage 200 → SkyPlanner | Elk uur |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Inkooporders met verwachte leverdatum | Sage 200 → SkyPlanner | Elk uur |
| Geplande start, gepland einde en productiemiddel voor de bewerking op de productieorder | Geplande start, gepland einde en werkcentrum per bewerking | SkyPlanner → Sage 200 | Bij wijzigingen, via webhook |
| Urenboeking per bewerking (add-on) | Tijdregistraties en bevestigingen van operators | SkyPlanner → Sage 200 | Per bevestiging of per ploegendienst |
| Gegevens over planningsbeperkingen in SkyPlanner | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, alternatieve machines en medewerkers | Beheerd in SkyPlanner | Onboarding |
Integratiepatronen
1. Stamgegevens voor het eerst inladen. Haal producten en eenheden op via de API, en vervolgens productiemiddelen, groepen productiemiddelen en BOM-bewerkingen uit de add-on. Een groep van drie identieke machines kan worden ingericht als één werkcentrumgroep of als drie werkcentra.
2. Orders synchroniseren. Lees openstaande productieorders met hun bewerkingen uit de add-on, plus openstaande pop_order_lines en warehouse_holdings via de API. Het productieschema houdt rekening met zowel de voorraad als de verwachte inkoopleveringen. MRP blijft productieorders voorstellen in Sage 200; SkyPlanner plant de orders die u aanmaakt.
3. Het productieschema terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, stuurt SkyPlanner de geplande start, het geplande einde en het productiemiddel terug naar de productieorder. De add-on blijft de eigen hoeveelheden, reserveringen en kostprijsberekening beheren.
4. Bevestigingen vanaf de productievloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Deze tijdregistraties houden het productieschema actueel. De geregistreerde tijd wordt teruggestuurd als urenboeking op de bewerking van de productieorder, zodat de kostprijsberekening in Sage 200 de werkelijke uren gebruikt.
Als uw fabriek al uren boekt in Sicon Shop Floor Data Capture of Cim200 Shop Floor Data Capture, kies dan één kanaal voor de urenboeking.
5. Gegevenseigenaarschap en conflictregels. Leg deze vast vóór de ingebruikname:
| Gegevens | Eigenaar |
|---|---|
| Producten, stuklijsten, productieorderaantallen, reserveringen, kosten | Sage 200 en de add-on |
| Volgorde van bewerkingen, start- en eindtijden, toewijzing aan werkcentra | SkyPlanner |
| Omsteltijdenmatrix, eisen aan gereedschappen en operators, alternatieve productiemiddelen | SkyPlanner |
| Urenregistratie | Sage 200, gevoed door tijdregistraties uit SkyPlanner |
De capaciteitsgrafiek is de belangrijkste bron van conflicten. Als planners productieorders of bewerkingen blijven verslepen in Sicon Rough Cut Capacity Planning of de Cim200 Graphical Scheduler, bepalen twee systemen de datums. Laat SkyPlanner de datums van bewerkingen bepalen. Met Autopilot plant SkyPlanner automatisch opnieuw wanneer de productie verandert.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Valideer het productieschema vooraf tijdens de gratis proefperiode van 30 dagen met een CSV- of Excel-export van openstaande productieorders. Daarna verloopt het project als volgt:
- Scopebepaling. Bevestig de add-on en versie, de route voor het uitlezen van productieorders, de route voor het terugschrijven, de synchronisatiefrequenties en het kanaal voor urenregistratie.
- API-toegang. De supportleverancier schakelt de Sage 200 API in, koppelt een Sage ID aan een Sage 200-gebruiker en stelt de toegang tot bedrijven en functies in.
- Eerste gegevensimport. Producten, eenheden, productiemiddelen, groepen productiemiddelen, stuklijstbewerkingen en beschikbaarheid.
- Ordersynchronisatie. Productieorders, inkooporderregels en voorraad via polling, met een melding wanneer opnieuw toestemming nodig is.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantal operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. Geplande bewerkingsdatums naar de productieorders terugschrijven; in deze stap wordt ook de urenregistratie toegevoegd.
- Parallel testen en ingebruikname. Vergelijk de datums met de huidige planning, corrigeer stamgegevens en schakel daarna het terugschrijven in.
Aandachtspunten bij een Sage 200-integratie
- Uitgefaseerde module in een nieuwe versie. De oude Sage 200 Manufacturing-module kan vanaf Sage 200 Professional 2025 R2 niet meer worden gebruikt. Bevestig welke productieoplossing bij de ingebruikname actief zal zijn voordat u gegevens gaat koppelen.
- Bewerkingstijden op basis van kostengegevens. Sicon MRP schat arbeids- en machinetijden op basis van kostenposten in Sage 200 BOM. Toets deze eerst aan de werkelijke bewerkingstijden.
- Afwijkende kostencategorieën. Sage waarschuwt dat Nominal, Overhead Nominal en Overhead Recovery % bij stuklijstbewerkingen en kostencategorieën moeten overeenkomen, anders “there will be cost discrepancies.” (ontstaan er kostenverschillen).
- Vernieuwingstermijn. De maximale termijn van 90 dagen begint bij de eerste aanmelding. Een integratie waarvoor nooit opnieuw toestemming wordt gegeven, stopt elk kwartaal op dezelfde dag.
- Sites met meerdere bedrijven. Eén site kan meerdere bedrijven bevatten. Stuur daarom bij elk verzoek de juiste
X-Companymee.
De Sage 200-integratie: wie richt deze in en biedt ondersteuning?
- Het SkyPlanner-team richt de integratie tijdens de onboarding in en biedt na de ingebruikname ondersteuning.
- Uw Sage 200-partner kan meewerken. De partner kent uw add-on en schakelt de API in Sage 200 Professional in.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen met dezelfde gedocumenteerde REST API en een API-token. Een API-token is voldoende om te beginnen. Het SkyPlanner-team helpt waar nodig.
Zodra de koppeling actief is, maakt de Arcturus-engine het productieschema op basis van actuele Sage 200-productieorders. De geplande datums worden naar de bewerkingen op de productieorders geschreven. SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. U ontvangt vooraf een offerte voor de integratie en uw abonnement, afgestemd op uw proces en behoeften. Zo kent u de totale kosten voordat u begint. Bekijk de prijzen en functies, en lees hoe de eigen planning van Sage 200 zich verhoudt tot SkyPlanner op de pagina Capaciteitsplanning in Sage 200, over plannen binnen de beschikbare machine- en personeelscapaciteit. Het overzicht vindt u op de Sage 200-pagina. Andere ERP-systemen staan in het overzicht van ERP-integraties.
Ervaringen van productiebedrijven met SkyPlanner
2 uurbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd, en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
1.000’enwerkorders automatisch ingepland
“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit ligt op een compleet ander niveau.”
Hannu Ryynänen, algemeen directeur
Mamec · Industriële mengers, pompen en hightech productie in opdracht
Duizenden werkorders worden automatisch ingepland, met realtime inzicht in de productie voor de hele organisatie.
Veelgestelde vragen
Ondersteunt de Sage 200 API productieorders?
Nee. De Sage 200 Professional API biedt toegang tot producten, voorraad, verkoop- en inkooporders, financiële gegevens en meer, maar heeft geen API-resources voor productieorders of bewerkingen. Productieorders komen uit uw productie-add-on, zoals Sicon Works Order Processing of Cim200, via de route die tijdens de scopebepaling is afgesproken.
Wie bouwt de Sage 200-integratie?
Het SkyPlanner-team richt tijdens de onboarding de tweerichtingsintegratie in voor uw Sage 200-omgeving en biedt na de ingebruikname ondersteuning. Uw Sage 200-partner schakelt de API in en kan meewerken. Uw eigen ontwikkelaars kunnen ook voortbouwen op de gedocumenteerde REST API van SkyPlanner. Een API-token is voldoende om te beginnen.
Kan Sage 200 wijzigingen realtime doorsturen?
De Sage 200 API heeft geen webhooks. Voorraad en inkooporders worden via polling op date_time_updated opgehaald. Productieorders worden om de paar minuten uit uw add-on uitgelezen. In de andere richting sturen de eigen webhooks van SkyPlanner wijzigingen in het productieschema direct door.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u maximaal 20 werkcentra gebruiken en uw productieorders via CSV of Excel importeren. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales om de scope van de integratie te bepalen.
