Koppelingen / ERP / Divalto infinity
Handleiding voor de Divalto koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze Divalto infinity aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met Divalto via de eigen REST-services van Divalto:
- OF en séquences OF, gammes, nomenclatures, articles, centres de charge, postes de travail, ressources, opérateurs, outillages, voorraden en inkooporders worden ingelezen.
- De geplande begin- en einddatums worden teruggeschreven naar elke OF en séquence, met een nieuw centre of poste wanneer het werk naar een alternatief wordt verplaatst.
- Desgewenst kunnen ook de gewerkte uren van operators en voltooide cycli worden teruggeschreven.
De integratie-interfaces van Divalto
Het API-platform van Divalto infinity biedt drie bouwstenen voor externe planningssoftware:
- RecordSql (native REST). Leest Divalto-tabellen via gedeclareerde querybestanden (DHOQ). Via deze route worden OF, séquences, gammes, articles, postes en voorraden uitgelezen. Het kan tot tien minuten duren voordat een nieuwe querydeclaratie actief wordt (Divalto RecordSql-instellingen).
- WEBSERVICE_INFINITY (REST). Webservices voor bedrijfsprocessen in Divalto. Elke aanroep bestaat uit een JSON-body met de actie WEB_SERVICE_INFINITY, het toegangstoken en een parameterstring met de bedrijfsactie, het dossier en de gegevens (aanroepformaat). Acties voor productie zijn onder meer create_dataxml (bestanden aanleveren aan de scrutateur voor productie), integration_dt (technische gegevens aanmaken: componenten, séquences, ressources, outillages), voorraadquery’s en het aanmaken van artikelen (productieacties).
- De scrutateur voor productie. Een proces in de productieomgeving van Divalto dat bestanden bewaakt en XML-bestanden importeert. create_dataxml levert hiervoor een base64-bestand aan. Importtypen zijn onder meer GG_DATES_ORDO voor geplande datums, GG_TEMPS_IMPORT voor uren, GG_FIN_DE_CYCLE voor voltooide cycli, CO_MES_IMPORT voor MES-gegevens en GG_COMPOSANT_OM voor componentverbruik (create_dataxml).
De SOAP-service van Divalto wordt niet meer ondersteund op het platform. Bouw de koppeling daarom uitsluitend met REST.
Authenticatie
- Aan de Divalto-kant. De koppeling verstuurt een gebruikersnaam en wachtwoord via een POST-verzoek naar het Authent/Auth-endpoint van de Divalto API-gateway, met een account dat in DLMT is aangemaakt. Ze ontvangt een toegangstoken dat volgens Divalto vijfenveertig minuten geldig is. De connector vernieuwt het daarom op vaste tijdstippen. Het token wordt meegestuurd in de JSON-body van elke aanroep voor een bedrijfsactie, niet in een HTTP-header (Divalto-authenticatie).
- Aan de SkyPlanner-kant. De REST API gebruikt voor authenticatie een API-token in de Authorization-Token-header (SkyPlanner Settings > API) en is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste aanroepen.
Events en polling
De webhooks van Divalto zijn inkomend: een extern systeem roept een Divalto-webhook aan om een proces te starten. Volgens Divalto is een webhook niet bedoeld om gegevens terug te sturen (Divalto WebHooks). Divalto verstuurt geen uitgaande events.
Gegevens uit Divalto worden daarom via polling opgehaald. RecordSql-query’s die filteren op openstaande OF en recente wijzigingen halen nieuw werk op. De frequentie wordt per fabriek ingesteld: van om de paar minuten voor OF tot elk uur voor voorraden.
SkyPlanner verstuurt webhooks wanneer de status of de planning verandert. Het terugschrijven is dus eventgestuurd.
Datamapping
| Divalto-object (interface) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| Artikelen, artikelkenmerken (RecordSql) | Producten en materialen, producteigenschappen | Divalto → SkyPlanner | Eerste import, daarna via polling |
| Nomenclatures (componenten) | Productstructuur, subproducten, materialen per product | Divalto → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Gammes: séquences, opérations standard, tijden, ressources, outillages | Processtappen met bewerkingsduur, instel- en afbouwtijden, gereedschappen | Divalto → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Ateliers, centres de charge, postes de travail | Werkcentra, werkcentrumgroepen, efficiënties | Divalto → SkyPlanner | Eerste import, daarna zelden |
| Opérateurs en habilitations | Personeel en werkcentra waar zij mogen werken | Divalto → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Kalenders voor postes | Diensten en niet-werkdagen | Divalto → SkyPlanner | Dagelijks, of diensten in SkyPlanner beheren |
| OF (BF) en séquences OF (BH) met leverdatums en componenten | Orders en taken met leverdatums en materiaalbehoeften | Divalto → SkyPlanner | Polling om de paar minuten |
| Voorraad per artikel en magazijn | Voorraadsaldi | Divalto → SkyPlanner | Polling, elk uur of bij een planningsrun |
| Inkooporders met leverdatums | Inkooporders, inkomend materiaal per leverdatum | Divalto → SkyPlanner | Polling, elk uur of bij een planningsrun |
| GG_DATES_ORDO: begin en einde van OF (BF.PLANDEBDH, BF.PLANFINDH), begin en einde van séquence (BH.PLANDEBDH, BH.PLANFINDH), CENTRE en POSTE | Gepland begin en einde per taak en stap, toegewezen werkcentrum | SkyPlanner → Divalto | Bij planningswijzigingen, via een SkyPlanner-webhook |
| GG_TEMPS_IMPORT: uren per séquence | Urenregistraties en terugmeldingen van operators | SkyPlanner → Divalto | Per terugmelding of per dienst, indien gekozen |
| GG_FIN_DE_CYCLE: voltooide cycli | Gereedgemelde aantallen | SkyPlanner → Divalto | Per terugmelding, indien gekozen |
| Niet in Divalto | Omsteltijdmatrix, gereedschappen met beperkte capaciteit, alternatieve machines en personeel | Beheerd in SkyPlanner | Ingericht tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Declareer de RecordSql-query’s en lees articles, nomenclatures, gammes, centres de charge, postes, opérateurs, outillages en kalenders uit. Bepaal zorgvuldig hoe u centres aan SkyPlanner koppelt: een centre de charge met vier postes wordt één werkcentrumgroep met vier werkcentra.
2. OF synchroniseren. Lees openstaande OF met hun séquences en componenten uit, 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. Lees de hoofd-OF en de bijbehorende sub-OF samen uit, omdat Divalto alleen de hoofd-OF opnieuw inplant.
3. Planning terugschrijven. Wanneer de planningsengine een taak inplant of verplaatst, activeert een SkyPlanner-webhook een create_dataxml-aanroep. Het bestand is een GG_DATES_ORDO-document met per OF het dossier, de vestiging, het OF-nummer en de geplande begin- en einddatum. Per séquence bevat het document het nummer, het geplande begin en einde en, als het werk naar een alternatief is verplaatst, het centre en de poste (GG_DATES_ORDO-formaat). De scrutateur van Divalto importeert deze gegevens in de OF-kop en de séquence-regels.
4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De urenregistraties houden de planning actueel. U kiest of de uren worden teruggeschreven naar Divalto. Zo ja, dan worden uren verstuurd als GG_TEMPS_IMPORT-bestanden en voltooide cycli als GG_FIN_DE_CYCLE-bestanden. Zo nee, dan worden de uren zoals voorheen ingevoerd in het MES van Divalto.
5. Afspraken over gegevensbeheer en conflicten. Leg deze vast vóór de ingebruikname:
| Gegevens | Leidend systeem |
|---|---|
| Articles, nomenclatures, gammes, aantallen en status van OF | Divalto |
| Volgorde van séquences, begin- en eindtijden, toewijzing aan postes | SkyPlanner |
| Omsteltijdmatrix, eisen aan gereedschappen en operators, alternatieve resources | SkyPlanner |
| Diensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Uren, verbruik en gereedmeldingen | Divalto, daar ingevoerd of doorgestuurd vanuit de urenregistraties in SkyPlanner |
Kies één systeem dat de OF-datums schrijft. Voortaan legt SkyPlanner de geplande datums vast, in plaats van Opcenter APS of via handmatige herplanning. Als Opcenter APS in gebruik is, schakelt u de import daarvan uit voor OF die SkyPlanner plant. Beide gebruiken namelijk GG_DATES_ORDO.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Valideer de planning vooraf tijdens de gratis proefperiode van 30 dagen, met postes, gammes en openstaande OF die u vanuit Divalto als CSV of Excel exporteert.
- Mapping. Leg de mappingtabel, de regels voor gegevensbeheer en de synchronisatiefrequenties vast. Bepaal ook of tijdregistraties worden teruggeschreven.
- Toegang tot Divalto. Maak het integratieaccount aan in DLMT, registreer de RecordSql-query’s en activeer de scrutateur voor productie. Test eerst in een testomgeving.
- Eerste gegevensimport. Articles, nomenclatures, gammes, centres, postes, opérateurs, outillages en kalenders.
- Synchronisatie van OF en inkooporders. Periodiek ophalen met filters, paginering en herhaalpogingen.
- Randvoorwaarden instellen in SkyPlanner. Matrix voor omsteltijden, gereedschappen, het aantal operators per taak en alternatieve postes of medewerkers.
- Planning terugschrijven. GG_DATES_ORDO via create_dataxml vanuit SkyPlanner-webhooks, plus tijdregistraties als daarvoor is gekozen.
- Parallel testen. Laat SkyPlanner naast de huidige planning draaien, vergelijk datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een Divalto-koppeling
- Instellingen van de scrutateur. create_dataxml-bestanden komen alleen binnen als de scrutateur voor productie actief is, het selectievakje MES is aangevinkt en een pad voor “Interfaces” is ingesteld in het Production-dossier.
- Token vernieuwen. Het toegangstoken van Divalto verloopt na korte tijd (zie Authenticatie). Vernieuw het vóór elke reeks aanroepen.
- Query’s registreren. Het duurt enkele minuten voordat nieuwe of gewijzigde RecordSql-query’s actief zijn. Registreer ze vóór de eerste gegevensimport.
- Hoofd-OF en sub-OF. Divalto herplant alleen de hoofd-OF. Plan sub-OF als deelproducten, zodat de bovenliggende order op de componenten wacht.
- Artikelkenmerken. Divalto bewaart de planningseigenschappen van een artikel in tien kenmerkvelden. Deze zijn goed te koppelen aan de producteigenschappen in SkyPlanner voor de matrix voor omsteltijden en “Allow similarity”.
Wie richt de Divalto-koppeling in en biedt ondersteuning?
- Het SkyPlanner-team richt de koppeling in tijdens de onboarding en biedt ondersteuning na ingebruikname. Dit omvat de afgesproken RecordSql-query’s en webserviceacties. Elke fabriek gebruikt Divalto anders; die praktijkkennis wordt in de inrichting verwerkt.
- Uw Divalto-partner kan meewerken. De partner kent uw dossier, maatwerkaanpassingen en instellingen en kan samen met het SkyPlanner-team het DLMT-account, de query’s en de scrutateur instellen.
- Uw eigen ontwikkelaars kunnen de koppeling uitbreiden via de REST API van SkyPlanner met een API-token. Een API-token volstaat om te beginnen en het SkyPlanner-team helpt waar nodig. De documentatie vindt u in de integratiedocumentatie van SkyPlanner.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra en met maandelijkse facturatie. Samen met uw abonnement ontvangt u vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften. Bekijk de prijzen, capaciteitsplanning voor Divalto, de Divalto-pagina en het overzicht van ERP-koppelingen.
Ervaringen van productiebedrijven met SkyPlanner
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 schakelpanelen en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst 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 voor alle werkcentra is in minder dan 30 minuten klaar.
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
De leverbetrouwbaarheid is 100% gedurende de hele periode dat SkyPlanner in gebruik is, sinds 2021.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner is voor ons dat het een hulpmiddel is dat in het dagelijks gebruik werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Door de bezetting automatisch in te plannen worden leverdatums nauwkeuriger. Ook is de productiestilstand door materiaaltekorten sterk afgenomen.
Veelgestelde vragen
Heeft Divalto een API voor productieorders?
Ja. RecordSql leest OF, séquences en andere tabellen via REST. De service WEBSERVICE_INFINITY voert bedrijfsacties uit, zoals create_dataxml en integration_dt voor productie.
Ondersteunt Divalto webhooks?
De webhooks van Divalto werken alleen inkomend en geven geen gegevens terug. De koppeling vraagt Divalto periodiek uit via RecordSql, met een frequentie die per fabriek wordt ingesteld. De eigen webhooks van SkyPlanner sturen planningswijzigingen direct door zodra ze plaatsvinden.
Hoe worden geplande datums teruggeschreven naar Divalto?
Via een GG_DATES_ORDO XML-bestand dat met de actie create_dataxml wordt verstuurd. Het bevat de geplande begin- en einddatums voor elke OF en elke séquence, en een vervangend centre of poste als het werk wordt verplaatst. De scrutateur voor productie van Divalto importeert het bestand.
Is Opcenter APS nodig voor de koppeling?
Nee. SkyPlanner verzorgt de capaciteitsplanning op basis van de beschikbare capaciteit en schrijft de geplande datums zelf terug. Als u nu Opcenter APS gebruikt, neemt SkyPlanner het over als enige systeem dat OF-datums schrijft.
Kan een Divalto-partner beter Opcenter APS of SkyPlanner voorstellen?
SkyPlanner, als de klant binnen enkele weken een werkende productieplanning wil die rekening houdt met de beschikbare capaciteit en zichzelf actueel houdt. Opcenter APS in Divalto draait wanneer de planner het start en wisselt bestanden uit via een Windows-map (Divalto-documentatie). SkyPlanner maakt verbinding via de REST-services van Divalto, herplant automatisch en plant omstellingen, gereedschappen, ploegen en materiaal. Het aantal gebruikers is onbeperkt, vanaf 199 € per maand.
Kunnen we SkyPlanner testen voordat we de koppeling bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en CSV- of Excel-bestanden uit Divalto importeren. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de koppeling.
