Koppelingen / ERP / Sage 100
Handleiding voor de Sage 100 koppeling voor productieplanning met SkyPlanner APS
Deze handleiding voor de Sage 100 koppeling laat Sage-partners en IT-teams zien hoe ze Sage 100 aan SkyPlanner APS koppelen. Beide producten met deze naam komen aan bod: Sage 100 met Production Management in de VS en Canada, en Sage 100 met Sage 100 Produktion in Duitsland en Oostenrijk. SkyPlanner wisselt in beide richtingen gegevens uit met Sage 100:
- Werkbonnen of Fertigungsaufträge worden ingelezen met hun stappen of Arbeitsgänge, samen met werkcentra, artikelen, voorraad en inkooporders.
- Geplande datums worden teruggeschreven naar elke stap of Arbeitsgang.
- Tijdregistraties van operators worden teruggeschreven als urenboekingen (US) of Rückmeldungen (DE).
Het SkyPlanner-team stemt de koppeling tijdens de onboarding af op uw Sage 100-omgeving en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor partners en ontwikkelaars die hieraan willen meewerken of zelf een koppeling willen bouwen met de gedocumenteerde REST API van SkyPlanner (API-referentie).
Amerikaanse Sage 100: interfaces voor de koppeling
De Amerikaanse Sage 100 draait on-premises als Standard-, Advanced- of Premium-installatie. De interfaces voor de koppeling bevinden zich op de Sage 100-server.
Business Object Interface (BOI).
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).” (Via de Business Objects Interface hebben externe ontwikkelaars met de juiste kennis met behulp van Component Object Model (COM) toegang tot de programma’s en applicaties.) (Sage 100-help) Het ontwikkelaarsportaal van Sage noemt dit “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.” (De interne API-laag, die toegang biedt tot dezelfde logica als de applicatie zelf gebruikt.) (developer.sage.com) BOI is de route voor het schrijven van gegevens: bij elke aanmaak of wijziging vindt dezelfde validatie plaats als wanneer een gebruiker dit in Sage 100 doet.
ODBC.
De ProvideX ODBC-driver leest Sage 100-tabellen voor rapportages en het in bulk uitlezen van gegevens. Voor Advanced is een client/server-ODBC-driver beschikbaar. De koppeling gebruikt ODBC om werkbonnen, artikelen en inkooporders in bulk uit te lezen, en BOI om gegevens te schrijven.
Visual Integrator (VI).
Import- en exporttaken in VI wisselen gegevens uit tussen Sage 100 en bestanden of ODBC-bronnen. Sage: “One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.” (Een van de krachtigste functies van de Visual Integrator-module is het rechtstreeks importeren uit en exporteren naar een ODBC-gegevensbron.) (bron) VI maakt deel uit van het Essentials-pakket en is geschikt voor gegevensuitwisseling via bestanden.
eBusiness Web Services gebruikt SOAP en ondersteunt “the Sage 100 sales order, customer, and customer contact entities.” (De entiteiten voor verkooporders, klanten en klantcontactpersonen.) (bron) Hiermee kunnen verkooporders worden uitgewisseld; productiegegevens lopen via BOI en ODBC.
De koppeling draait naast Sage 100, onder een Sage 100-gebruiker met rechten voor de gebruikte taken in Production Management, Inventory en Purchase Order. Uitgaand verkeer loopt via HTTPS naar de REST API van SkyPlanner.
Duitse Sage 100: interfaces voor de koppeling
De Duitse Sage 100 draait op Microsoft SQL Server, lokaal geïnstalleerd of in de cloudvariant. Volgens Sage kunt u “Partnerlösungen via API-Schnittstelle ergänzen” (partneroplossingen toevoegen via een API-interface) (Sage 100). De productie-add-ons die Sage vermeldt, bouwen voort op Sage AppDesigner en de business objects van Sage 100.
De koppeling volgt dezelfde route als oplossingen van Sage-partners. Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel en Bestellungen worden uit de SQL Server-database van Sage 100 gelezen. De datums van Arbeitsgänge en de Rückmeldungen worden teruggeschreven via de route die uw Sage-partner en het SkyPlanner-team tijdens de scopebepaling vastleggen. Zo volgen de boekingen de eigen logica van Sage 100. Uw Sage-partner bevestigt de versie (bijvoorbeeld 9.0) en de inrichting van de toegang.
Authenticatie en toegang
| Systeem | Authenticatiemethode |
|---|---|
| Amerikaanse Sage 100, BOI | Een Sage 100-gebruikerssessie op de Sage 100-server, met rolrechten voor elke gebruikte taak |
| Amerikaanse Sage 100, ODBC | DSN op de Sage 100-installatie, met leestoegang |
| Duitse Sage 100 | Een Sage 100-gebruiker voor het terugschrijven en leestoegang tot SQL Server, afgestemd met uw Sage-partner |
| SkyPlanner | API-token in de Authorization-Token-header, aangemaakt in SkyPlanner onder Settings > API |
De REST API van SkyPlanner is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding neemt u mee door de eerste API-aanroepen.
Wijzigingen detecteren
Wijzigingen in Sage 100 worden opgehaald door gegevens periodiek uit te lezen. Lees openstaande werkbonnen of Fertigungsaufträge met korte tussenpozen uit, en voorraad en inkooporders elk uur. Filter op status en wijzigingsdatum, zodat bij elke uitleesronde alleen gewijzigde gegevens worden opgehaald.
SkyPlanner verstuurt webhooks wanneer de planning verandert. Het terugschrijven naar Sage 100 is daardoor gebeurtenisgestuurd.
Datamapping
| Sage 100 (US) | Sage 100 (DE) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|---|
| Item | Artikel | Producten en materialen | Sage 100 → SkyPlanner | Eerste import, daarna dagelijks |
| Bill of Materials, materialen in sjablonen | Stückliste in de Ressourcenliste | Productstructuur, subproducten, materialen per product | Sage 100 → SkyPlanner | Bij wijzigingen |
| Werkcentrum: medewerkers of machines, uren per weekdag, sluitingsperiodes | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Werkcentra, werkcentrumgroepen, personeel, diensten | Sage 100 → SkyPlanner | Eerste import |
| Stappen in werkbonsjablonen, activiteitcodes | Arbeitsplan, Arbeitsgänge met Rüst- en Stückzeiten | Processtappen met instel- en bewerkingstijden | Sage 100 → SkyPlanner | Bij wijzigingen |
| Werkbon met stappen en uiterste datum | Fertigungsauftrag met Arbeitsgänge, Liefertermin | Orders en taken met uiterste datums | Sage 100 → SkyPlanner | Uitlezen met korte tussenpozen |
| Voorraadaantallen per magazijn | Lagerbestand | Voorraadstanden | Sage 100 → SkyPlanner | Elk uur |
| Inkooporderregels, gewenste leverdatums | Bestellungen, Liefertermine | Inkooporders met verwachte leverdatum | Sage 100 → SkyPlanner | Elk uur |
| Verkooporderregels, toegezegde leverdatums | Kundenaufträge | Leverdatums voor klanten, klantprioriteit | Sage 100 → SkyPlanner | Uitlezen met korte tussenpozen |
| Datums van werkbonstappen (BOI) | Arbeitsgang-Termine | Geplande start- en eindtijd en werkcentrum per stap | SkyPlanner → Sage 100 | Bij wijzigingen, via webhook |
| Labor Entry, gereedmelding van werkbonnen (BOI) | Rückmeldung: Zeiten, Mengen | Tijdregistraties en bevestigingen van operators | SkyPlanner → Sage 100 | Per bevestiging of per dienst |
| Niet vastgelegd in Sage 100 | Niet vastgelegd in Sage 100 | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, operators per taak, alternatieve werkcentra | Beheerd in SkyPlanner | Onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Importeer eerst artikelen en werkcentra, daarna sjablonen of Arbeitspläne met hun stappen. Een werkcentrum in de Amerikaanse versie met drie machines en twee operators wordt in SkyPlanner omgezet naar drie werkcentra, een werkcentrumgroep en twee personen. Elk krijgt vervolgens een eigen tijdlijn.
2. Ordersynchronisatie. Lees openstaande werkbonnen of Fertigungsaufträge met hun stappen in, samen met de voorraad en openstaande inkooporders. SkyPlanner controleert zowel de voorraad als de verwachte leveringen voordat het een taak inplant. Sage 100 blijft werk voorstellen en SkyPlanner plant de orders die u vrijgeeft.
3. Planning terugschrijven. Voor elke stap die de planningsengine heeft ingepland of verplaatst, verstuurt SkyPlanner de geplande start, het einde en het werkcentrum. In de Amerikaanse Sage 100 werkt de koppeling de datums van werkbonstappen bij via BOI. In de Duitse Sage 100 werkt de koppeling de datums van Arbeitsgänge bij via de route die tijdens de scopebepaling is vastgelegd. Hoeveelheden, toewijzingen en kostencalculatie blijven in Sage 100.
4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Die tijdregistraties houden de planning actueel. In de Amerikaanse Sage 100 wordt de geregistreerde tijd als Labor Entry op de betreffende work ticket-stap geboekt. De laatste terugmelding sluit het ticket af. In de Duitse Sage 100 wordt dit een Rückmeldung met tijden en aantallen. Registreert uw fabriek al tijd via Betriebsdatenerfassung of een barcode-app? Kies dan één registratiekanaal.
5. Afspraken over beheer en conflicten. Leg deze vóór de ingebruikname vast:
| Gegevens | Beheerd door |
|---|---|
| Artikelen, stuklijsten, sjablonen, orderaantallen, kosten | Sage 100 |
| Volgorde van bewerkingen, start- en eindtijden, toewijzing aan werkcentra | SkyPlanner |
| Omsteltijdenmatrix, gereedschappen, operators per taak, alternatieve resources | SkyPlanner |
| Arbeidsuren en Rückmeldungen | Sage 100, op basis van tijdregistraties uit SkyPlanner |
Een tweede planningssysteem is de belangrijkste bron van conflicten. Als planners Enhanced Scheduling in de Amerikaanse Sage 100 blijven gebruiken of taken op de Plantafel in de Duitse Sage 100 blijven verslepen, bepalen twee systemen de datums. Laat SkyPlanner de datums van bewerkingen beheren. 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. Toets de planning daarvoor tijdens de gratis proefperiode van 30 dagen met een CSV- of Excel-export van openstaande work tickets of Fertigungsaufträge. Het project verloopt daarna als volgt:
- Scopebepaling. Leg het product (Amerikaanse of Duitse Sage 100), de versie en de installatie vast, evenals de lees- en schrijfroute, de synchronisatiefrequenties en het kanaal voor tijdregistratie.
- Toegang. Uw Sage-partner stelt de Sage 100-gebruiker, de bijbehorende rechten en de databasetoegang in.
- Eerste gegevensimport. Artikelen, werkcentra, sjablonen of Arbeitspläne, stuklijsten en diensten.
- Ordersynchronisatie. Work tickets of Fertigungsaufträge, inkooporders en voorraad worden op vaste momenten gesynchroniseerd.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantallen operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. Eerst de geplande datums van bewerkingen naar Sage 100, daarna arbeidsuren en Rückmeldungen.
- Parallel testen en ingebruikname. Vergelijk de datums met de huidige planning, corrigeer de stamgegevens en schakel daarna het terugschrijven in.
Aandachtspunten bij een Sage 100-koppeling
- Weet welke Sage 100 u gebruikt. De Amerikaanse en Duitse Sage 100 hebben verschillende datamodellen en interfaces. Noem het product en de versie tijdens het eerste gesprek over de scopebepaling.
- Werkcentra met meerdere machines. In de Amerikaanse versie vormt een werkcentrum één capaciteitseenheid van “one or more persons or machines” (een of meer personen of machines). Bepaal per werkcentrum of dit in SkyPlanner één werkcentrum, meerdere werkcentra of een groep wordt.
- Instel- en bewerkingstijden. Sjablonen en Arbeitspläne bevatten de tijden waarmee SkyPlanner plant. Toets deze vóór de ingebruikname aan de werkelijke bewerkingstijden.
- Kalenders. Werkcentra in de Amerikaanse versie bevatten werkuren per weekdag en sluitingsdagen. Importeer deze als diensten in SkyPlanner en voeg vervolgens de diensten en afwezigheden van elke operator toe in SkyPlanner.
- Meeteenheden. Bewerkingen kunnen per stuk, per batch of per uur worden uitgevoerd. Leg de eenheid per bewerking vast.
- BOI-rechten. BOI volgt de rolgebaseerde beveiliging van Sage 100. Als een taakrecht ontbreekt, wordt de schrijfactie geblokkeerd. Test elke schrijfactie met de integratiegebruiker.
- Eén systeem beheert de datums. Schakel parallelle planningsruns of verschuivingen op de Plantafel uit zodra SkyPlanner de datums beheert.
De Sage 100-koppeling: wie richt deze in en biedt ondersteuning?
- Het SkyPlanner-team richt de koppeling in tijdens de onboarding en biedt ondersteuning na de ingebruikname.
- Uw Sage-partner kan meewerken. De partner kent uw Sage 100-versie, stelt gebruikers en rechten in en bevestigt de databasetoegang.
- Uw eigen ontwikkelaars kunnen de koppeling uitbreiden via de gedocumenteerde REST API van SkyPlanner. Een API-token volstaat om te beginnen. Het SkyPlanner-team helpt waar nodig.
Zodra de koppeling actief is, plant de Arcturus-engine op basis van actuele Sage 100-orders en krijgt elke bewerking geplande datums. SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. U ontvangt vooraf een offerte voor de koppeling en uw abonnement. De offerte voor de koppeling is afgestemd op uw proces en behoeften. Zo kent u de totale kosten voordat u begint. Bekijk de prijzen en functies, en lees in Capaciteitsplanning in Sage 100 hoe de eigen planning van Sage 100 zich tot die van SkyPlanner verhoudt. Het overzicht vindt u op de Sage 100-pagina. Sage 200 en Sage X3 hebben eigen handleidingen op de pagina’s voor Sage 200 en Sage X3. Andere ERP-systemen vindt u in het overzicht van ERP-koppelingen.
Ervaringen van productiebedrijven met SkyPlanner
6 maandenvooruit zicht op vrije capaciteit voor de verkoopafdeling
“SkyPlanner legt een betrouwbare basis voor de hele productieplanning.”
Anu Järvinen, productiemanager
Fredman Operations · Voedselveilig verpakkingspapier
De verkoopafdeling ziet de vrije capaciteit zes maanden vooruit. Verzoeken om de planning te wijzigen die voorheen een uur of langer kostten, worden nu binnen enkele seconden beantwoord.
100%leverbetrouwbaarheid sinds 2021
“SkyPlanner geeft ons inzicht in de capaciteit en maakt de planning voorspelbaar.”
Dan Berglund, COO/CFO
Opes Corporation · Chemische productie en voedingsmiddelenproductie
Sinds de ingebruikname van SkyPlanner in 2021 is de leverbetrouwbaarheid onafgebroken 100%.
Veelgestelde vragen
Heeft Sage 100 een REST API voor work tickets?
De Amerikaanse Sage 100 stelt de bedrijfslogica beschikbaar via de Business Object Interface, met ODBC voor het uitlezen en Visual Integrator voor bestandsverwerking. SkyPlanner leest work tickets via ODBC en BOI en schrijft datums van bewerkingen en arbeidsuren via BOI. De Duitse Sage 100 wordt uitgelezen via de SQL Server-database. De route voor het terugschrijven wordt tijdens de scopebepaling samen met uw Sage-partner vastgelegd.
Wie bouwt de Sage 100-koppeling?
Het SkyPlanner-team richt tijdens de onboarding de tweerichtingskoppeling in voor uw Sage 100-omgeving en biedt ondersteuning na de ingebruikname. Uw Sage-partner stelt gebruikers, rechten en databasetoegang in en kan meewerken. Uw eigen ontwikkelaars kunnen ook verder bouwen op de gedocumenteerde REST API van SkyPlanner. Een API-token volstaat om te beginnen.
Hoe worden geplande datums teruggeschreven naar Sage 100?
In de Amerikaanse Sage 100 werkt de koppeling via BOI de geplande datums van elke work ticket-stap bij en boekt zij Labor Entry op basis van de tijdregistraties van operators. In de Duitse Sage 100 werkt de koppeling de Arbeitsgang-datums van elke Fertigungsauftrag bij en boekt zij Rückmeldungen via de schrijfroute die uw Sage-partner en het SkyPlanner-team tijdens de scopebepaling vastleggen.
Kan Sage 100 wijzigingen in realtime doorgeven?
SkyPlanner haalt wijzigingen uit Sage 100 op door de gegevens op vaste momenten uit te lezen: openstaande orders met korte tussenpozen, voorraad en inkooporders elk uur. In de andere richting geven de webhooks van SkyPlanner wijzigingen in de planning direct door zodra ze plaatsvinden.
Kunnen we SkyPlanner testen voordat we de koppeling bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en uw work tickets of Fertigungsaufträge via CSV of Excel importeren. Een creditcard is niet nodig. Start uw proefperiode of neem contact op met ons verkoopteam om de scope van de koppeling te bepalen.
