Integraties / ERP / Lemonsoft
Lemonsoft-integratiegids voor productieschema’s met SkyPlanner APS
Deze Lemonsoft-integratiegids laat partners en IT-teams zien hoe ze Lemonsoft ERP met SkyPlanner APS koppelen. SkyPlanner wisselt via de REST API van Lemonsoft gegevens in beide richtingen uit:
- Ordernummers (työnumero), bewerkingen (työvaihe), machines, productstructuren, materialen en geplande diensten worden ingelezen.
- Geplande begin- en eindtijden en de gekozen machine worden teruggeschreven naar de bewerkingen.
- Terugmeldingen van operators worden als gereedmeldingen teruggestuurd.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Kaskea Group gebruikt SkyPlanner met een tweerichtingskoppeling met Lemonsoft. Het SkyPlanner-team stemt de integratie tijdens de onboarding af op uw Lemonsoft-inrichting en biedt ook na ingebruikname ondersteuning. Partners en ontwikkelaars kunnen daarnaast zelf koppelingen bouwen via de gedocumenteerde REST API van SkyPlanner (API-referentie).
De REST API van Lemonsoft
De integratie-API van Lemonsoft heet LemonRest en is gedocumenteerd in Swagger 2.0, versie v1. Build “LemonRest 2026.10 release-2026.10.2” bevat 422 paden. (Swagger)
- Basis-URL. Deze verschilt per omgeving. U vindt de URL in het gebruikersbeheer, onder omgevingsbeheer en serviceadressen, in het veld Rest API. Op het Azure-platform van Lemonsoft is de basis-URL
https://rest.lemon.fi. - Beschikbaarheid. Voor klanten van de Lemonsoft-platformdienst (Alustapalvelu) zijn de REST API’s al geïnstalleerd. Alleen de gebruikersrechten moeten nog worden toegekend. (bron)
- Testomgeving. De eindklant bestelt deze bij Lemonsoft Service Desk.
De aparte API voor tijdregistratie van Kellokortti is niet nodig voor het opstellen van het productieschema.
Authenticatie
LemonRest werkt met een sessie:
POST /api/auth/loginmet UserName, Password, Database en ApiKey retourneert eensession_id.- Stuur deze bij elke aanroep mee in de
Session-Id-header. - Vernieuw de sessie met
POST /api/auth/renew. Controleer de status metGET /api/auth/alive.
POST /api/auth/login/token accepteert een Token in plaats van een gebruikersnaam en wachtwoord. Maak een aparte integratiegebruiker aan met een API-sleutel en alleen de rechten die de integratie nodig heeft. (bron)
De REST API van SkyPlanner gebruikt een API-token voor authenticatie (SkyPlanner Settings > API) en is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste aanroepen.
Wijzigingen detecteren met deltaquery’s
LemonRest heeft geen endpoints voor webhooks of het abonneren op gebeurtenissen. Wijzigingen worden opgehaald met een deltaquery:
GET /api/production/main_ws/changed?updated_after=...retourneert taken die sinds de vorige uitvoering zijn gewijzigd.- Voeg
optimization=truetoe. Deze optie is in release 2026.6.3 toegevoegd om de afhankelijkheid van het logboek weg te nemen en de query te versnellen. (releaseopmerkingen) GET /api/log/deletion_eventshaalt verwijderde taken op, zodat geannuleerd werk uit het productieschema verdwijnt.
Vraag wijzigingen om de paar minuten op. SkyPlanner verstuurt webhooks zodra de status of het productieschema verandert. Het terugschrijven wordt dus door gebeurtenissen aangestuurd.
Gegevensmapping
| Lemonsoft-object (endpoint) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
Tuote, product_code (/api/products) | Producten en materialen | Lemonsoft → SkyPlanner | Bij de eerste import, daarna bij wijzigingen |
Tuoterakenne met Työvaiheet-regels (/api/products/structure, all_levels) | Productstructuur, deelproducten, processtappen met insteltijden | Lemonsoft → SkyPlanner | Bij de eerste import, daarna bij wijzigingen |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Werkcentra, werkcentrumgroepen | Lemonsoft → SkyPlanner | Bij de eerste import, daarna zelden |
Työnumero als ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Orders met leverdatums en prioriteit | Lemonsoft → SkyPlanner | Om de paar minuten wijzigingen opvragen |
Työvaihe als ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Taken (processtappen) per werkcentrum | Lemonsoft → SkyPlanner | Om de paar minuten wijzigingen opvragen |
Componentbehoefte (main_ws/{worknumber}/materials) | Materiaalbehoefte per taak | Lemonsoft → SkyPlanner | Bij elke taak |
Geplande diensten (/api/persons/plannedshifts) | Diensten, personeel | Lemonsoft → SkyPlanner | Dagelijks, of diensten beheren in SkyPlanner |
Verkooporder bij een ordernummer (/api/orders/work/{work_number}) | Informatie over klant en prioriteit | Lemonsoft → SkyPlanner | Bij elke taak |
Työvaihe: start_time, end_time, machine_id (PUT /api/production/workstage) | Geplande begin- en eindtijd en werkcentrum | SkyPlanner → Lemonsoft | Bij wijziging van het productieschema, via een SkyPlanner-webhook |
Gereedmelding (POST main_ws/sub_ws/completion_entry) | Terugmeldingen: gereedgemelde en afgekeurde aantallen, uren, medewerker | SkyPlanner → Lemonsoft | Per terugmelding |
| Planningsregels ingesteld in SkyPlanner | Toegestane werkcentra per taak, insteltijdenmatrix, gereedschappen | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees machines en machinegroepen, productstructuren met hun bewerkingen en standaardbewerkingen in. Koppel elke fysieke machine aan een werkcentrum in SkyPlanner. Gebruik bovenliggende machines (Isäkone) alleen voor groepering: ze tellen de capaciteit van hun onderliggende machines bij elkaar op.
2. Ordernummers synchroniseren. Lees openstaande ordernummers met hun bewerkingen uit /api/production/workstage of main_ws/sub_ws, gefilterd op status en verdeeld over pagina’s. Houd ze vervolgens actueel met main_ws/changed. Koppel work_amount_left, niet work_amount, want Lemonsoft plant op basis van de resterende hoeveelheid. Inkooporders vormen de basis voor de materiaalgestuurde planning van SkyPlanner. Een bewerking wacht dus op de leverdatum van de inkooporder.
3. Het productieschema terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, verstuurt SkyPlanner PUT /api/production/workstage met de taak en de bijbehorende sub_workstages. Elke bewerking bevat start_time en end_time, en ook machine_id als deze naar een alternatieve machine is verplaatst.
4. Terugmeldingen van de werkvloer. Operators melden werk terug met SkyPlanner Mobile Confirmations of de Production Timer. Elke terugmelding wordt naar completion_entry verstuurd met sub_workstage_id, person_number, done_amount, hours, failed_amount en job_done. Stuur material_consumptions mee als de bewerking materiaal verbruikt. Lemonsoft verwerkt dit als een normale gereedmeldingsboeking (valmistuskirjaus).
5. Gegevenseigenaarschap en conflictregels. Leg deze vóór ingebruikname vast:
| Gegevens | Eigenaar |
|---|---|
| Producten, structuren, bewerkingen, hoeveelheden, taakstatus | Lemonsoft |
| Bewerkingsvolgorde, begin- en eindtijden, machinekeuze | SkyPlanner |
| Toegestane werkcentra per taak, insteltijdenmatrix, gereedschappen | SkyPlanner |
| Diensten en afwezigheden | Eén systeem, gekozen tijdens de scopebepaling |
| Gereedmeldingen en voorraadboekingen | Lemonsoft, geboekt op basis van terugmeldingen uit SkyPlanner |
De voornaamste bron van conflicten is de automatische planning van Lemonsoft zelf en de vernieuwactie: beide plannen niet-vergrendelde bewerkingen opnieuw in. Houd AUTOTIMING op 0 zolang SkyPlanner het productieschema beheert. Laat u deze optie toch aanstaan, vergrendel dan het productieschema voor elk teruggeschreven ordernummer. Daarmee zet u alle bewerkingen van dat ordernummer vast. Alleen Koneiden kapasiteetin lukitus is niet voldoende, omdat de automatische planning niet-vergrendelde taken van een vergrendelde dag afhaalt en elders inplant. (bron)
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Daarvóór gebruikt u tijdens de gratis proefperiode van 30 dagen uw eigen gegevens uit een Excel-export van ordernummers, bewerkingen en machines.
- Scopebepaling. Leg de mappingtabel, de regels voor gegevenseigenaarschap en het pollinginterval vast.
- Toegang. De eindklant bestelt een testomgeving bij Lemonsoft Service Desk en maakt de integratiegebruiker en API-sleutel aan.
- Eerste import. Machines, groepen, productstructuren en bewerkingen.
- Ordernummers synchroniseren. Wijzigingen periodiek opvragen, verwijderingen verwerken en sessies vernieuwen.
- Beperkingen instellen in SkyPlanner. Toegestane werkcentra per taak, de omsteltijdenmatrix en gereedschappen.
- Terugschrijven. Tijden van bewerkingen en gereedmeldingen, getest in de testomgeving.
- Parallel draaien en in gebruik nemen. Vergelijk met het huidige Gantt-diagram, corrigeer de stamgegevens en schakel daarna het terugschrijven in de productieomgeving in.
Aandachtspunten voor een Lemonsoft-integratie
- Eén machine per bewerking. Aan een bewerking in Lemonsoft is één machine gekoppeld. Tijdens de implementatie wordt op basis van een lijst of producteigenschappen vastgelegd welke machines voor elk product geschikt zijn. SkyPlanner kiest vervolgens uit die alternatieven.
- Dagcapaciteit. De vaste capaciteit is een hoeveelheid per dag; afwijkingen hebben geen tijdstip. Leg de werkelijke ploegendiensten vast in SkyPlanner of lees de geplande diensten in.
- Resterende hoeveelheid. Koppel
work_amount_left. De instellingen STARTJOB_AUTOTIMENOW en JOBDONE_AUTOTIMENOW verschuiven ook de belasting in Lemonsoft zelf. - Sessies verlopen. Vernieuw de sessie vóór langdurige synchronisaties en zorg dat de integratie een verplichte nieuwe aanmelding afhandelt.
- Regels voor terugmeldingen. Controleer elke terugmelding vóór het boeken aan de hand van de status van de bewerking en spreid pieken in API-aanroepen.
- Twee clients. LemonOnline en de Windows-versie delen één database, dus de integratie werkt voor beide.
- Grote structuren. Gebruik
/api/async/product/structuresamen met/api/async/status/{jobId}voor grote imports.
De Lemonsoft-integratie: wie richt deze in en biedt ondersteuning?
Bij de inrichting stemmen we de gegevenskoppeling af op uw machines, bewerkingen en Lemonsoft-configuratie. Ook de planningsregels die u in SkyPlanner beheert vallen hieronder: toegestane werkcentra per taak, de omsteltijdenmatrix en gereedschappen.
- Het SkyPlanner-team richt de integratie tijdens de implementatie in en biedt ondersteuning na ingebruikname. Elke fabriek gebruikt Lemonsoft anders. Die praktijkkennis wordt in de inrichting verwerkt.
- Uw Lemonsoft-partner kan meewerken. De partner kent uw inrichting en kan de API-gebruiker, rechten en testomgeving verzorgen. 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.
Zodra de koppeling actief is, plant de Arcturus-engine op basis van actuele werknummers uit Lemonsoft en worden de geplande tijden bij de bewerkingen vastgelegd. SkyPlanner is er 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 hoe de eigen planning van Lemonsoft zich verhoudt tot SkyPlanner in Capaciteitsplanning met Lemonsoft, over plannen binnen de beschikbare capaciteit. Het overzicht vindt u op de Lemonsoft-pagina. Andere systemen staan in het overzicht van ERP-integraties.
Ervaringen van productiebedrijven met SkyPlanner
Lemonsofttweerichtingsintegratie met SkyPlanner
Kaskea Group
Productie in opdracht: CNC-bewerking, staalconstructies en assemblage
De productie wordt gepland in SkyPlanner, met een tweerichtingsintegratie met Lemonsoft.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner voor ons is dat het een hulpmiddel is dat in de dagelijkse praktijk werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Automatische capaciteitsplanning levert nauwkeurigere leverdatums op. Ook is de productiestilstand door materiaaltekorten sterk afgenomen.
2 hbespaard 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 takenlijst bereikt de productielijn binnen enkele seconden.
+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 over alle werkcentra is in minder dan 30 minuten klaar.
Veelgestelde vragen
Heeft Lemonsoft een API voor productiegegevens?
Ja. LemonRest ontsluit productietaken en bewerkingen, machines, productstructuren, materialen en ploegendiensten, en ondersteunt het boeken van gereedmeldingen. Voor Alustapalvelu-klanten is LemonRest vooraf geïnstalleerd. Een API-sleutel en gebruikersrechten zijn vereist.
Ondersteunt Lemonsoft webhooks?
In LemonRest staan geen webhook-endpoints vermeld. Wijzigingen worden om de paar minuten opgehaald via de deltaquery main_ws/changed en verwijderingsgebeurtenissen. De eigen webhooks van SkyPlanner sturen wijzigingen in de planning direct door zodra ze plaatsvinden.
Hoe worden geplande tijden teruggeschreven naar Lemonsoft?
Via PUT /api/production/workstage. Daarmee worden de starttijd, eindtijd en machine van een taak en de bijbehorende bewerkingen bijgewerkt. Laat de automatische planning van Lemonsoft uitgeschakeld zolang SkyPlanner de planning beheert, of vergrendel de planning voor elk werknummer waarnaar wordt geschreven. Zo blijven de tijden staan zoals SkyPlanner ze heeft ingepland.
Kunnen operatormeldingen vanuit SkyPlanner in Lemonsoft worden geboekt?
Ja. Elke melding wordt als gereedmelding geboekt, met de gereedgemelde en afgekeurde hoeveelheid, uren en persoon. Dit wordt dagelijks gebruikt in klantprojecten.
Wie bouwt de Lemonsoft-integratie?
Het SkyPlanner-team stemt de tweerichtingsintegratie tijdens de implementatie af op uw Lemonsoft-inrichting en biedt ondersteuning na ingebruikname. Uw Lemonsoft-partner of eigen ontwikkelaars kunnen ook voortbouwen op de gedocumenteerde REST API van SkyPlanner. Een API-token volstaat om te beginnen.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en gegevens uit Lemonsoft importeren via Excel of CSV. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de integratie.
