Koppelingen / ERP / Visma L7
Visma L7 koppeling met APS: gids voor productieplanning
Deze gids laat partners en IT-teams zien hoe ze Visma L7 aan SkyPlanner APS koppelen. SkyPlanner wisselt via de Visma L7 REST API in beide richtingen gegevens uit met Visma L7:
- Werknummers (työnumero), bewerkingen (työnvaihe), productiemiddelen, productstructuren, onderdelen, materialen, voorraadstanden, verkoopregels en inkoopregels worden ingelezen.
- Voor elke werkkaart worden het productiemiddel, de startdatum, de prioriteit, de medewerker en de uren per dag teruggeschreven met
PUT /manufphases/. - De capaciteit in de kalender van de productiemiddelen wordt gesynchroniseerd met
POST /resourceupdates/. - Productiegebeurtenissen die in de werkwachtrijen van L7 zijn geboekt, worden teruggelezen met
GET /manufevents/. - Webhooks van SkyPlanner sturen wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de koppeling tijdens de onboarding af op uw L7-inrichting en biedt ook na de ingebruikname ondersteuning. Partners en ontwikkelaars kunnen daarnaast zelf oplossingen bouwen met de gedocumenteerde REST API van SkyPlanner (API-referentie).
De REST API van Visma L7
De API heet Visma L7 – REST API en is gedocumenteerd in OpenAPI 3.0.3, met een wijzigingslogboek (documentatie). De API draait op Visma LTR.
- Basispad. Dit is
/ltrws/REST/L7op uw eigen LTR-host, lokaal of in de gehoste applicatiedienst van Visma. - Licenties. Voor elk endpoint is een afzonderlijke licentie nodig. Voor het terugschrijven van het productieschema via
PUT /manufphases/is de licentie L7RMFPP vereist; voor capaciteitsupdates is dat L7RMCAP. Ook de leesendpoints hebben elk een eigen licentie. - Paginering. Lijsten worden in pagina’s opgedeeld met
pageSizeenrecAfteren gefilterd metqueryKey1,queryKey2enqueryString.
Authenticatie
Bij elke L7-aanroep worden twee tokens meegestuurd:
- hash bepaalt welke database en welk bedrijf worden gebruikt.
- token identificeert de API-gebruiker.
Uw LTR-beheerder maakt de API-gebruiker aan in Visma LTR, koppelt deze aan het L7-bedrijf, wijst profielen toe en maakt het gebruikerstoken aan (aan de slag). Gebruik een aparte integratiegebruiker met alleen de rechten die de koppeling nodig heeft.
Aan de kant van SkyPlanner verloopt de authenticatie voor de REST API met een API-token in de header Authorization-Token. U maakt dit aan onder Settings > API. De integratiehandleiding leidt u door de eerste aanroepen.
Wijzigingen detecteren: modifiedAfter
De L7 REST API heeft geen webhooks. Wijzigingen worden via polling uitgelezen:
- Schakel wijzigingsregistratie (DBLOG) in bij het bestandsonderhoud van L7 (Tiedostohuolto) voor de tabellen die de koppeling uitleest, zoals werkkaarten en onderdelen.
- Roep de leesendpoints aan met
modifiedAfteringesteld op het tijdstip van de laatste uitvoering. Verwijderde records worden als verwijderd gemarkeerd teruggegeven, zodat geannuleerd werk uit het productieschema verdwijnt. - Voer de polling om de paar minuten uit. SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven wordt dus door gebeurtenissen aangestuurd.
Datamapping
| Visma L7-object (endpoint) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
Tuote (GET /products/) | Producten en materialen | L7 → SkyPlanner | Eerste import, daarna bij wijzigingen |
Onderdelen van een werknummer (GET /manufcomponents/) | Subproducten | L7 → SkyPlanner | Polling met modifiedAfter |
Materiaalbehoeften (GET /manufmaterials/) | Materiaalbehoeften per taak | L7 → SkyPlanner | Polling met modifiedAfter |
Hiërarchie van productiemiddelen (KRYH) met aantal machines (GET /manufresources/) | Werkcentra en werkcentrumgroepen | L7 → SkyPlanner | Eerste import, daarna zelden |
Werkkaart (TSUUNR) per bewerking (GET /manufphases/) | Taken (processtappen) per werkcentrum | L7 → SkyPlanner | Polling om de paar minuten |
Voorraadstanden (GET /stockbalances/) | Voorraad | L7 → SkyPlanner | Polling |
Inkoopregels (GET /purchaserows/) | Inkooporders met leverdatums | L7 → SkyPlanner | Polling |
Verkooporders en -regels (GET /salesorders/, GET /salesrows/) | Uiterste leverdatums, klantprioriteit | L7 → SkyPlanner | Polling |
Productiegebeurtenissen (GET /manufevents/) | Voortgang per taak | L7 → SkyPlanner | Polling |
Werkkaartvelden resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Gepland werkcentrum, start, volgorde en uren per dag | SkyPlanner → L7 | Bij wijzigingen in het productieschema, via een SkyPlanner-webhook |
Capaciteit in de kalender van de productiemiddelen (POST /resourceupdates/) | Capaciteit per ploegendienst | SkyPlanner → L7 | Bij wijzigingen in ploegendiensten |
| Planningsregels die in SkyPlanner zijn ingesteld | Toegestane werkcentra, omsteltijdenmatrix, gereedschappen, medewerkers | Beheerd in SkyPlanner | Ingesteld tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees de hiërarchie van productiemiddelen in en koppel elke machine aan een eigen werkcentrum in SkyPlanner. Als één L7-productiemiddel meerdere machines omvat, maakt u voor elke machine een werkcentrum aan en voor het productiemiddel een werkcentrumgroep. Lees de producten en productstructuren met de bijbehorende bewerkingen in.
2. Werknummers synchroniseren. Lees openstaande werkkaarten in met GET /manufphases/ en houd ze daarna actueel met modifiedAfter. Lees de onderdelen en materiaalbehoeften per werknummer in, evenals voorraadstanden en inkoopregels, zodat een bewerking wacht tot de leverdatum van de bijbehorende inkoopregel.
3. Productieschema terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, roept SkyPlanner PUT /manufphases/ aan. De body bevat per werkkaart één workSheet-item met:
numbervoor de werkkaart enresourcevoor het gekozen productiemiddelstartDateenpriority, zodat de werkwachtrijen van L7 de volgorde van SkyPlanner weergevenperson, wanneer een specifieke operator is ingeplandschedulingDaysvoor de geplande uren per datum
L7 laat een door een extern systeem ingestelde prioriteit ongewijzigd (bron), zodat de volgorde in de werkwachtrijen behouden blijft.
4. Capaciteit synchroniseren. Wanneer ploegendiensten, vrije dagen of overuren in SkyPlanner veranderen, schrijft POST /resourceupdates/ de nieuwe capaciteit naar de kalender van de productiemiddelen in L7. De bezettingsoverzichten in L7 komen dan overeen met het plan.
5. Voortgang op de werkvloer. Operators blijven registraties invoeren in de werkwachtrijen van L7 en in Visma LTR. SkyPlanner leest deze gebeurtenissen uit met GET /manufevents/. Operators kunnen werk ook gereedmelden in SkyPlanner Mobile Confirmations. Autopilot past de planning aan op basis van gegevens uit elk van beide bronnen. Bij de volgende terugschrijfactie worden de nieuwe tijden doorgegeven.
6. Eigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Producten, structuren, bewerkingen, aantallen, status van het werknummer | Visma L7 |
| Volgorde van bewerkingen, startdatums, uren per dag, keuze van productiemiddel | SkyPlanner |
| Toegestane werkcentra, omsteltijdenmatrix, gereedschappen, medewerkers | SkyPlanner |
| Ploegendiensten en afwezigheden | SkyPlanner, teruggeschreven naar de kalender van de productiemiddelen in L7 |
| Productiegebeurtenissen en voorraadboekingen | Werkwachtrijen van Visma L7 en LTR |
De eigen planning van L7 is de belangrijkste bron van conflicten. De behoefteberekening en detailplanning kunnen niet-vergrendelde bewerkingen opnieuw inplannen. Voer deze alleen uit voor materialen en reserveringen, en plan de bewerkingen waarvoor SkyPlanner verantwoordelijk is niet opnieuw in.
Gebruikelijke projectstappen
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Daarvóór gebruikt u de gratis proefperiode van 30 dagen met uw eigen gegevens uit een Excel-export van werknummers, bewerkingen en productiemiddelen.
- Scopebepaling. Leg de mappingtabel, de regels voor eigenaarschap en het pollinginterval vast.
- Toegang en licenties. Regel licenties voor de REST-endpoints die binnen de scope vallen. De LTR-beheerder maakt de API-gebruiker, hash en token aan, bij voorkeur eerst in een testbedrijf.
- Wijzigingsregistratie. Schakel DBLOG in voor de tabellen die u uitleest.
- Eerste import. Productiemiddelen, producten, structuren en bewerkingen.
- Werknummers synchroniseren. Polling met modifiedAfter, verwijderingen en paginering.
- Randvoorwaarden instellen in SkyPlanner. Toegestane werkcentra, de omsteltijdenmatrix, gereedschappen en medewerkers.
- Terugschrijven.
PUT /manufphases/enPOST /resourceupdates/, getest in het testbedrijf. - Parallel draaien en ingebruikname. Vergelijk met de huidige planning, corrigeer de stamgegevens en schakel daarna het terugschrijven in de productieomgeving in.
Aandachtspunten voor een Visma L7-koppeling
- Licenties per endpoint. Breng alle endpoints vroeg in kaart en regel de licenties voordat u gaat testen.
- Aantal machines. Een productiemiddel met meerdere machines verdeelt het werk in L7 (bron). Splits het in SkyPlanner op in werkcentra en schrijf het productiemiddel terug dat L7 verwacht.
- Uren per dag. L7 slaat de planning op als uren per datum. SkyPlanner verstuurt
schedulingDaysdie samen de duur van de bewerking vormen. - Fabriekskalender. Zorg dat deze volledig is, want door hiaten worden bewerkingen in het verleden gepland (bron).
- Voorraadorders.
mainNumber,subNumber,rowNumberennewQuantityworden alleen gebruikt om de hoeveelheid van een voorraadorder te wijzigen. Laat ze weg bij werk voor klanten. - Het volgende ERP-systeem. Visma heeft de verdere ontwikkeling van L7 beëindigd en het gebruik van het product stopt eind 2028 (bericht van Visma). Bewaar planningsregels in SkyPlanner, niet in L7-velden, zodat ze behouden blijven wanneer u van ERP-systeem wisselt.
De Visma L7-koppeling: wie richt deze in en biedt ondersteuning?
Bij de inrichting stemmen we de gegevens af op uw productiemiddelen, bewerkingen en L7-configuratie. Ook de planningsregels die u in SkyPlanner beheert, horen daarbij: toegestane werkcentra, de omsteltijdenmatrix, gereedschappen en medewerkers.
- Het SkyPlanner-team richt de koppeling tijdens de onboarding in en biedt ondersteuning na ingebruikname. Elke fabriek gebruikt L7 anders. Die praktijkkennis komt bij de inrichting van pas.
- Uw Visma-partner kan meewerken. Uw partner kent uw L7- en LTR-configuratie en kan de API-gebruiker, licenties en testadministratie regelen. SkyPlanner levert de REST API, Swagger/OpenAPI-documentatie en webhooks.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via dezelfde gedocumenteerde REST API met een API-token. Een API-token volstaat om te beginnen. Het SkyPlanner-team helpt waar nodig.
Wanneer u L7 vervangt, sluit u dezelfde SkyPlanner-configuratie aan op het nieuwe ERP-systeem. Bekijk de pagina’s voor Business Central, Visma Net, Lemonsoft, Monitor ERP en Odoo.
SkyPlanner is er vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften, samen met uw abonnement. Zo kent u de totale kosten voordat u begint.
Lees hoe de eigen planning van L7 zich verhoudt tot SkyPlanner in Biedt Visma L7 capaciteitsplanning? Het overzicht vindt u op de Visma L7-pagina. Andere systemen staan in het overzicht van ERP-koppelingen.
Ervaringen van maakbedrijven met SkyPlanner
1.000’enwerkorders automatisch ingepland
“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit ligt op een heel ander niveau.”
Hannu Ryynänen, CEO
Mamec · Industriële mengers, pompen en hightech productie in opdracht
Duizenden werkorders worden automatisch ingepland en de hele organisatie heeft realtime inzicht in de productie.
98%leverbetrouwbaarheid, gestegen van circa 50%
“SkyPlanner speelt een doorslaggevende rol bij het op peil houden van onze leverbetrouwbaarheid.”
Hannu Lahtinen, algemeen directeur
KJH-Comp · Plaatbewerking en productie in opdracht
De leverbetrouwbaarheid steeg van ongeveer 50% naar wel 98%. Voor de planning is nu één leidinggevende nodig in plaats van twee.
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime optimalisatie van de productie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning kost elke week 2 uur minder werktijd. Een nieuwe werklijst is binnen enkele seconden beschikbaar aan de productielijn.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
Veelgestelde vragen
Heeft Visma L7 een API voor productiegegevens?
Ja. De Visma L7 REST API op Visma LTR ontsluit bewerkingen, productiemiddelen, onderdelen, materialen, productiegebeurtenissen, producten, voorraadstanden, verkoopregels en inkoopregels. Voor elk endpoint is een aparte licentie nodig. De LTR-beheerder maakt de API-gebruiker en tokens aan.
Hoe wordt de productieplanning teruggeschreven naar Visma L7?
Via PUT /manufphases/. Dit werkt voor elke werkkaart het productiemiddel, de startdatum, prioriteit, persoon en geplande uren per datum bij. POST /resourceupdates/ schrijft de capaciteit in de kalender van het productiemiddel. L7 behoudt de externe prioriteit, zodat de werklijsten de volgorde van SkyPlanner volgen.
Ondersteunt Visma L7 webhooks?
Er zijn geen webhooks gedocumenteerd. Schakel wijzigingsregistratie in voor de tabellen binnen de scope en vraag wijzigingen periodiek op met modifiedAfter. De eigen webhooks van SkyPlanner sturen planningswijzigingen direct door zodra ze plaatsvinden.
Welke software voor productieplanning kan met Visma L7 worden gekoppeld?
SkyPlanner APS wisselt via de L7 REST API gegevens in beide richtingen uit met Visma L7. Visma vermeldt Skycode met SkyPlanner op de pagina met L7-koppelingen. Het SkyPlanner-team richt de koppeling tijdens de implementatie in.
Wie bouwt de Visma L7-koppeling?
Het SkyPlanner-team stemt de tweerichtingskoppeling tijdens de implementatie af op uw L7-configuratie en biedt ondersteuning na ingebruikname. Uw Visma-partner of uw eigen ontwikkelaars kunnen ook bouwen op de gedocumenteerde REST API van SkyPlanner. Een API-token volstaat om te beginnen.
Kunnen we SkyPlanner testen voordat we de koppeling bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken met Excel- of CSV-imports uit L7. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de koppeling.
