Integracije / ERP / Oracle NetSuite
Vodnik za integracijo NetSuite s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik partnerjem za NetSuite, skrbnikom in tehničnim kupcem pojasnjuje, kako se SkyPlanner APS poveže z Oracle NetSuite za terminiranje proizvodnje, ki upošteva dejanske zmogljivosti strojev in osebja. SkyPlanner se z NetSuite povezuje dvosmerno prek spletnih storitev REST in SuiteQL:
- V SkyPlanner se prenašajo delovni nalogi, tehnološki postopki, delovni centri, artikli in nabavna naročila.
- Planirani časi začetka in konca se zapisujejo v naloge proizvodnih operacij.
- Zabeležene ure in proizvedene količine se prenašajo nazaj kot Work Order Completions ali Assembly Builds.
- Spletni kavlji SkyPlanner pošiljajo spremembe terminskega plana takoj, ko se zgodijo.
NetSuite je matični sistem za artikle, kosovnice (BOM), tehnološke postopke, delovne naloge, zaloge in obračun stroškov. SkyPlanner s pogonom Arcturus izdela terminski plan proizvodnje, ki upošteva dejanske zmogljivosti strojev in osebja. Ekipa SkyPlanner med uvajanjem nastavi integracijo za vaš račun in jo podpira tudi po začetku produkcijske uporabe. Integracija uporablja standardne zapise NetSuite in ni odvisna od aplikacije Advanced Manufacturing SuiteApp.
SkyPlanner je že povezan z NetSuite v podjetju UTU, proizvajalcu razdelilnih omar in stikalnih naprav v finskem mestu Ulvila. UTU je SkyPlanner začel uporabljati v produkciji septembra 2025, pri čemer je bil SkyPlanner povezan z Oracle NetSuite in sistemom podjetja UTU za obračun plač. Za poslovno utemeljitev si najprej oglejte stran o terminiranju proizvodnje z NetSuite in članek Ali NetSuite omogoča terminiranje proizvodnje?.
Ključna odločitev za projekt: REST in OAuth 2.0
Oracle je določil smer. Od različice 2026.1 naj nove integracije temeljijo na spletnih storitvah SuiteTalk REST z OAuth 2.0. Od različice 2027.1 ne bo več novih integracij prek SOAP ali Token-Based Authentication (TBA). Končne točke SOAP bodo v različici 2028.2 onemogočene. Vsaka integracija za terminiranje, ki jo začnete razvijati danes, mora temeljiti na REST.
| Možnost v NetSuite | Opis | Vloga pri integraciji z APS |
|---|---|---|
| SuiteTalk REST record API | /services/rest/record/v1/<recordType>, različica je vezana na izdajo NetSuite; !transform za potrjevanje delovnih nalogov, izdajo materiala in izdelavo sestavov | Zapisovanje: datumi operacij in delovnih nalogov (PATCH), potrditve, izdaje materiala in izdelava sestavov (transform) |
| SuiteQL prek REST | POST /services/rest/query/v1/suiteql z Prefer: transient, do 100.000 rezultatov na poizvedbo, ostranjevanje z limit/offset | Množično branje: artikli, tehnološki postopki, delovni centri, odprti delovni nalogi, zaloge |
| SuiteScript 2.1 RESTlets | Prilagojene končne točke get/post/put/delete | Funkcije, ki jih REST ne pokriva, in združeni podatki, na primer delovni nalog z vsemi operacijami |
| SuiteScript User Event / Map-Reduce | Skripte, ki se izvajajo na strežniku v NetSuite | Pošiljanje obvestil o spremembah |
| CSV Import Assistant | Shranjene preslikave za uvoz | Enkratni uvozi; ni namenjeno sprotni sinhronizaciji |
| SuiteTalk SOAP | Starejša tehnologija, samo TBA | Ne uporabljajte za nove integracije |
Avtentikacija
Za sistem za terminiranje, ki komunicira neposredno med strežniki, uporabite OAuth 2.0 Client Credentials (machine-to-machine). Pot v skrbniškem vmesniku je Setup > Integration > Manage Authentication > OAuth 2.0 Client Credentials (M2M) Setup. Naložite javno potrdilo in ga povežite z entiteto, vlogo in integracijskim zapisom. Vsak integracijski zapis lahko vsebuje največ pet aktivnih potrdil.
Ustvarite namensko vlogo za integracijo: dovoljenje za ogled artiklov, revizij kosovnic, tehnoloških postopkov in delovnih centrov ter dovoljenje za urejanje delovnih nalogov, zaključitev in izdaj materiala. SkyPlanner REST API (referenčna dokumentacija API) uporablja JWT, zato vmesna programska oprema hrani poverilnice za oba sistema.
Dogodki: standardnega spletnega kavlja ni
Dokumentacija Oracle ne opisuje vgrajenega mehanizma za pošiljanje spletnih kavljev. V praksi se uporablja skripta SuiteScript User Event na zapisu Work Order (afterSubmit), ki prek N/task ali skripte Map/Reduce uvrsti odhodni klic v čakalno vrsto, nato pa ga izvede z N/https. V afterSubmit nikoli ne izvajajte sinhronih odhodnih klicev: klic se izvaja med uporabnikovim shranjevanjem, zato počasna končna točka upočasni ali prepreči shranjevanje.
Uporabniški dogodki ne zajamejo vseh načinov spreminjanja podatkov. Množične posodobitve in uvozi CSV jih lahko obidejo. Skripto dogodka dopolnite s periodičnim preverjanjem in usklajevanjem podatkov prek SuiteQL po polju lastmodifieddate, da ne izpustite nobene spremembe. V nasprotni smeri povratni zapis sprožajo spletni kavlji sistema SkyPlanner, zato NetSuite prejme nove datume takoj, ko se plan spremeni.
Preslikava podatkov iz NetSuite v SkyPlanner
| Zapis v NetSuite (REST id) | Objekt v SkyPlanner | Smer | Pogostost |
|---|---|---|---|
Assembly Item (assemblyItem), Inventory Item (inventoryItem) | Izdelek / material | NetSuite → SkyPlanner | Začetni uvoz, nato dnevno ali ob spremembi |
BOM Revision (bomRevision), komponente kosovnice | Večnivojska struktura izdelka, potrebe po materialu | NetSuite → SkyPlanner | Ob spremembi |
Manufacturing Routing (manufacturingRouting, podseznama routingStep, routingComponent) | Koraki postopka: zaporedje, delovni center, pripravljalni čas, čas izvajanja | NetSuite → SkyPlanner | Ob spremembi |
| Manufacturing Work Center (Group, označen kot delovni center): Machine Resources, Labor Resources, Work Calendar | Delovni centri, skupine delovnih centrov, izmene | NetSuite → SkyPlanner, nato vzdrževanje v SkyPlanner | Začetni uvoz |
Work Order (workOrder): artikel, količina, lokacija, Production Start/End Date, status; povezani Sales Order za rok dobave | Nalog / operacija z rokom in prioriteto | NetSuite → SkyPlanner | Skoraj v realnem času prek User Event, dodatno periodično preverjanje za uskladitev podatkov |
Manufacturing Operation Task (manufacturingOperationTask) | Terminirana operacija | NetSuite → SkyPlanner, datumi SkyPlanner → NetSuite | Skoraj v realnem času |
Zaloga na posamezni lokaciji (SuiteQL), Item Receipts (itemReceipt) | Stanje zalog za terminiranje glede na razpoložljivost materiala | NetSuite → SkyPlanner | Vsakih 15 do 60 minut ali ob prevzemu |
Postavke Purchase Order (purchaseOrder): artikel, količina, pričakovani datum prevzema, status | Nabavna naročila / pričakovani material (pričakovani datum dobave). Material se šteje za razpoložljiv na datum dobave; zaloga se posodobi, ko je nabavno naročilo označeno kot Delivered | NetSuite → SkyPlanner | Vsakih 15 do 60 minut ali ob spremembi |
| Planirani začetek in konec vsake operacije | PATCH manufacturingOperationTask/{id} (startDate, endDate) in PATCH workOrder/{id} (Production Start/End Date) | SkyPlanner → NetSuite | Ob spremembi terminskega plana prek spletnega kavlja sistema SkyPlanner |
| Mobile Confirmations, časovni zapisi, Production Timer | POST workOrder/{id}/!transform/workOrderCompletion: razpon startOperation/endOperation, izdelana količina, čas dela v postavkah operation, ID časovnega zapisa iz SkyPlanner kot zunanji ID | SkyPlanner → NetSuite | Ob vsaki potrditvi ali paketno |
| Poraba materiala | POST workOrder/{id}/!transform/workOrderIssue ali isBackflush ob potrditvi | SkyPlanner → NetSuite | Ob vsaki potrditvi |
| Dokončan nalog (v okoljih NetSuite brez WIP) | POST workOrder/{id}/!transform/assemblyBuild | SkyPlanner → NetSuite | Ob dokončanju naloga |
| Zaprt nalog | Work Order Close (workOrderClose) | V NetSuite, izvede finančna služba | Privzeto ni avtomatizirano |
Vzorci integracije
1. Začetni prenos matičnih podatkov. S SuiteQL najprej preberite delovne centre, nato artikle, revizije kosovnic in tehnološke postopke. Tehnološki postopki se sklicujejo na delovne centre, zato je vrstni red pomemben. Med preizkusom iste podatke izvozite v CSV in jih uvozite v SkyPlanner. Terminski plan preverite, še preden nastane kakršna koli koda.
2. Sinhronizacija nalogov. Pridobite delovne naloge s statusoma Released in In Process. Že na začetku se odločite, ali boste vključili tudi delovne naloge s statusom Planned. Če jih vključite, jih obravnavajte kot še nepotrjene potrebe. V istem ciklu sinhronizirajte odprta nabavna naročila, da se pri terminiranju vsake operacije upoštevata zaloga in pričakovani material, ne le zaloga.
3. Povratni zapis terminskega plana. Ko se terminski plan spremeni, spletni kavelj sistema SkyPlanner pošlje nove datume operacij vmesni programski opremi. Ta za vsako spremenjeno operacijo pošlje PATCH /services/rest/record/v1/manufacturingOperationTask/{id} (referenčna dokumentacija zapisov Oracle) s poljema startDate in endDate. Dodaten PATCH v glavi zapisa workOrder nastavi polji Production Start in End Date. Zapisujte samo datume in prilagojeno polje za zaporedje, če ga uporabljate. Nikoli ne zapisujte nazaj količin ali podatkov kosovnice. Za posodobitev več operacij v eni transakciji lahko manjši RESTlet shrani celoten seznam operacij z enim klicem. Privzeta izbira ostaja API za zapise.
4. Potrjevanje dela v proizvodnji. Operaterji beležijo delo v SkyPlanner Mobile Confirmations. Vmesna programska oprema vsako potrditev zapiše prek pretvorb Work Order s klicem POST /services/rest/record/v1/workOrder/{id}/!transform/workOrderCompletion, ki vsebuje startOperation, endOperation, izdelano količino in zabeleženi čas v postavkah operacij. Delovni nalogi brez WIP se namesto tega zaključijo z !transform/assemblyBuild. Work Order Completion prek REST zahteva funkcijo Manufacturing Work In Process. Knjiženje zalog in stroškov ostaja v NetSuite.
5. Idempotentnost in ponovni poskusi. Vsak zapis o zaključitvi kot zunanji ID v NetSuite uporablja ID časovnega zapisa iz SkyPlanner. Zunanji ID-ji so enolični za vsako vrsto zapisa, zato je ponovno poslani spletni kavelj zavrnjen kot dvojnik in ne povzroči dvojnega knjiženja količin in stroškov. Zahteve za zapisovanje se obdelujejo prek čakalne vrste. Neuspešen klic (omejitev sočasnih klicev, zaklenjen zapis, poteklo potrdilo) se ponovi in zabeleži v dnevnik. Vse, kar tudi po tem ne uspe, je vidno ekipi SkyPlanner, ki podpira integracijo.
6. Pravila pristojnosti za podatke. NetSuite določa, kaj se izdeluje: artikel, količino, kosovnico (BOM), tehnološki postopek in lokacijo. SkyPlanner določa, kdaj in kje: zaporedje operacij, delovni center, začetek in konec. Datumi, spremenjeni v NetSuite, se ob naslednjem povratnem zapisu prepišejo, zato s prilagoditvijo obrazca ali delovnim tokom zaklenite polji Production Start/End Date.
Običajni koraki projekta
Izvedba je običajno končana v nekaj tednih po začetku uvajanja, tudi pri velikih podjetjih. Projekt za NetSuite vključuje:
- Preizkus z lastnimi podatki: iz shranjenih iskanj izvozite delovne centre, tehnološke postopke in odprte delovne naloge v CSV ter jih med 30-dnevnim preizkusom uvozite v SkyPlanner.
- Preslikava matičnih podatkov: preslikajte zapise NetSuite v objekte SkyPlanner ter določite polja po meri, enote in model WIP ali model brez WIP za posamezen artikel.
- Začetni prenos: prek SuiteQL prenesite artikle, revizije kosovnic, tehnološke postopke in delovne centre, nato v SkyPlanner nastavite izmene, operaterje in alternativne delovne centre.
- Sinhronizacija delovnih nalogov in nabavnih naročil: sinhronizirajte delovne naloge s statusoma Released in In Process ter odprta nabavna naročila s pričakovanimi datumi prejema. Sinhronizacijo sprožajo skripte User Event in periodično preverjanje za uskladitev podatkov.
- Povratni zapis terminskega plana: planirane datume operacij zapisujte v delovne naloge in naloge operacij, pri čemer OAuth 2.0 M2M nastavite v preizkusnem in produkcijskem okolju.
- Potrjevanje v proizvodnji: iz podatkov Mobile Confirmations in časovnih zapisov ustvarjajte Work Order Completions, izdaje materiala ali Assembly Builds.
- Vzporedno testiranje z obstoječim planom: terminski plan SkyPlanner izvajajte vzporedno s trenutnim postopkom sproščanja nalogov in primerjajte rezultate.
- Začetek produkcijske uporabe: prenesite planiranje v SkyPlanner in zaklenite datumska polja v NetSuite.
Če so tehnološki postopki urejeni in je vključena le ena odvisna družba, je obseg projekta majhen. Več odvisnih družb, samodejno razknjiževanje materiala pri WIP in obrazci po meri zahtevajo dodatno delo pri preslikavi.
Pasti pri NetSuite
- Delovni nalogi brez tehnoloških postopkov. Delovni nalog brez Manufacturing Routing nima operacij, ki bi jih lahko terminirali. Enako navaja Oracle za svoj sistem za terminiranje proizvodnje, ki upošteva razpoložljive zmogljivosti: “Work orders not associated with a NetSuite routing should not be scheduled.” (Delovnih nalogov, ki niso povezani s tehnološkim postopkom NetSuite, ne bi smeli terminirati.) Pred začetkom produkcijske uporabe jih poiščite s SuiteQL.
- Delovni centri vsebujejo malo podatkov. Delovni center v NetSuite je objekt Group z dvema številčnima podatkoma, Machine Resources in Labor Resources (oba imata privzeto vrednost 0), ter enim Work Calendar, običajno “Default Work Calendar”. Delovne centre prenesite enkrat, nato pa posamezne delovne centre, izmene po osebah, orodja, matriko časov za pripravo in prehode ter alternativne delovne centre vzdržujte v SkyPlanner.
- Kakovost podatkov v poljih Setup Time in Run Rate. NetSuite ti polji uporablja pri terminiranju brez omejitev kapacitet, a ker kapacitet ne upošteva, napačne vrednosti ostanejo neopažene. Terminiranje proizvodnje, ki upošteva dejanske zmogljivosti, jih razkrije že prvi dan.
- WIP ali brez WIP. Pri uporabi Manufacturing WIP se proizvodnja knjiži prek Work Order Issue, Work Order Completion in Work Order Close. Brez WIP se uporablja Assembly Build. Integracija za artikle WIP knjiži transakcije Work Order Completion, za preostale pa transakcije Assembly Build, zato je model za posamezen artikel del preslikave.
- Advanced Manufacturing v istem računu. Če račun uporablja tudi Advanced Manufacturing SuiteApp, se morajo zapisi Manufacturing Work Bench natančno ujemati s tehnološkim postopkom: zaporedje operacij, ime operacije in delovni center. Določite, kateri sistem postavlja datume operacij. Dva sistema za terminiranje istih delovnih nalogov pomenita dva konkurenčna plana.
- Omejitve sočasnih klicev. Spletne storitve in klici RESTlet si delijo eno omejitev sočasnih klicev za račun, ki jo določa raven storitve, vsaka licenca SuiteCloud Plus pa jo poveča za 10. Z vzporednim preverjanjem posameznih zapisov jo hitro dosežete. Za branje uporabite SuiteQL z ostranjevanjem, zapise pa pošiljajte v čakalno vrsto.
- Osvežitev preizkusnega okolja izbriše nastavitve M2M. Preslikave OAuth 2.0 Client Credentials se ob osvežitvi preizkusnega okolja izbrišejo in se ne kopirajo med računi. Poteklo ali preklicano potrdilo ustavi sinhronizacijo, dokler ne ustvarite nove preslikave. Nastavite opozorila ob napakah avtentikacije.
Integracija z NetSuite: kdo jo nastavi in podpira
Delo zajema preslikavo vaših zapisov, tehnoloških postopkov in delovnih centrov ter omejitve, ki jih NetSuite ne hrani kot podatke za terminiranje: matriko časov za pripravo in prehode, orodja, število operaterjev in alternativne vire. Spletni kavlji SkyPlanner pošiljajo spremembe terminskega plana nazaj takoj, ko se zgodijo, tudi tiste, ki jih izvede Autopilot.
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in jo podpira po začetku produkcijske uporabe. Vsak obrat uporablja NetSuite drugače: WIP ali brez WIP, obrazce po meri, skripte, različna pravila za tehnološke postopke. Ekipa preslika vaše zapise ter poveže SkyPlanner REST API in spletne kavlje z NetSuite REST, SuiteQL in RESTlets. Podpora zajema skripto User Event in vmesno programsko opremo ter se prilagaja spremembam vaših nastavitev NetSuite.
- Sodeluje lahko tudi vaš partner za NetSuite. Partnerji poznajo vaše obrazce po meri, skripte in vloge. Pri delu uporabljajo SkyPlanner REST API, ki zajema naloge, izdelke, materiale, nabavna naročila, korake tehnološkega postopka in časovne zapise. Na voljo sta dokumentacija Swagger/OpenAPI in avtentikacija JWT. Javna dokumentacija: dokumentacija SkyPlanner.
- Na tej osnovi lahko razvijajo vaši razvijalci. Pogosta razdelitev je skripta User Event znotraj NetSuite in majhna vmesna storitev zunaj njega. Za začetek zadostuje ključ API (vodič za integracijo), ekipa SkyPlanner pa po potrebi pomaga.
Terminski plan najprej preverite v 30-dnevnem brezplačnem preizkusu s podatki CSV in do 20 delovnimi centri, brez kreditne kartice. Integracija tako izhaja iz terminskega plana, ki že ustreza obratu.
Po vzpostavitvi povezave pogon Arcturus terminira na podlagi aktualnih delovnih nalogov NetSuite in preverja material na zalogi ter na prihajajočih nabavnih naročilih. Operaterji beležijo delo s funkcijami Mobile Confirmations, Production Timer in Quick Log Mode, NetSuite pa odraža stanje v proizvodnji brez ročnega vnosa. SkyPlanner je na voljo od 199 € na mesec z vključenimi 5 delovnimi centri, mesečnim obračunom in možnostjo odpovedi kadar koli. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj z naročniškim paketom, zato celoten strošek poznate že pred začetkom. Obrnite se na prodajo za opredelitev obsega vaše integracije z NetSuite ali si oglejte funkcije in stranke.
Mnenja proizvodnih podjetij o SkyPlanner
2 hprihranka vsak teden
»S SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električne razdelilne omare in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, novo zaporedje operacij pa do proizvodne linije pride v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, izdelava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
99,2%zanesljivost dobav
»S SkyPlanner lažje prepoznamo ozka grla in imamo boljši pregled pri vodenju proizvodnje.«
Toni Tuori, vodja proizvodnje
Piristeel · Strešni varnostni sistemi in sistemi za odvajanje deževnice
Zanesljivost dobav je letos dosegla 99,2%, pri terminiranju pa prihranijo do štiri ure dela na dan.
6 mesecevvnaprej prodaja vidi proste kapacitete
»SkyPlanner zagotavlja zanesljivo osnovo za celotno planiranje proizvodnje.«
Anu Järvinen, vodja proizvodnje
Fredman Operations · Embalažni papirji za stik z živili
Prodaja vidi proste kapacitete za šest mesecev vnaprej. Na zahteve za spremembo terminskega plana, za katere so prej potrebovali uro ali več, zdaj odgovorijo v nekaj sekundah.
Pogosta vprašanja
Kako se SkyPlanner APS poveže z NetSuite?
Dvosmerno, prek API-ja NetSuite REST za zapise, SuiteQL in po potrebi RESTlets. Datumi operacij se zapisujejo s klicem PATCH na manufacturingOperationTask. Čas dela in izdelane količine se knjižijo prek pretvorbe workOrderCompletion ali assemblyBuild. Ekipa SkyPlanner integracijo nastavi med uvajanjem in jo podpira po zagonu, vaš partner za NetSuite ali vaši razvijalci pa jo lahko nadgradijo z dokumentiranim REST API-jem.
Ali za uporabo SkyPlanner potrebujemo Advanced Manufacturing SuiteApp?
Ne. SkyPlanner sam izvaja terminiranje proizvodnje ob upoštevanju dejanskih zmogljivosti strojev in osebja na podlagi standardnih objektov Work Orders, Manufacturing Routings in Work Centers. Če v računu uporabljate tudi Advanced Manufacturing, se pri opredelitvi obsega določi, kateri sistem nastavlja datume operacij.
Kako preprečimo podvojene knjižbe, če je dogodek poslan dvakrat?
Vsak zapis Work Order Completion ima za zunanji ID identifikator časovnega zapisa iz sistema SkyPlanner. NetSuite zagotavlja enoličnost zunanjih ID-jev za posamezno vrsto zapisa, zato ponovljeni dogodek zavrne, namesto da bi znova knjižil količino in stroške. Neuspeli poskusi zapisovanja se uvrstijo v čakalno vrsto, ponovijo in zabeležijo v dnevnik.
Ali lahko namesto REST in OAuth 2.0 uporabimo TBA ali SOAP?
Pri novih integracijah načrtujte uporabo REST z OAuth 2.0. Oracle od različice 2027.1 ne bo več omogočal novih integracij TBA in SOAP, v različici 2028.2 pa bo onemogočil vse končne točke SOAP. Integracija SkyPlanner, zgrajena na REST in OAuth 2.0, bo delovala tudi po obeh mejnikih.
Kako SkyPlanner izve za nove delovne naloge v NetSuite?
NetSuite nima dokumentiranega standardnega izhodnega webhooka. Skripta User Event na objektu Work Order ob shranjevanju doda obvestilo v čakalno vrsto. Periodično poizvedovanje s SuiteQL zajame spremembe, ki jih skripta ne zazna, denimo uvoze CSV in množične posodobitve.
Ali lahko SkyPlanner preizkusimo s podatki iz NetSuite, preden vzpostavimo integracijo?
Da. Izvozite delovne centre, tehnološke postopke in odprte delovne naloge v obliki CSV ter jih med 30-dnevnim preizkusom uvozite v SkyPlanner. Nato primerjajte terminski plan proizvodnje, ki upošteva dejanske zmogljivosti, s svojim trenutnim planom. Začnite brezplačni preizkus ali rezervirajte predstavitev.
Kako dolgo traja projekt integracije z NetSuite?
Implementacija je običajno končana v nekaj tednih po začetku uvajanja, tudi v velikih podjetjih. Terminiranje že med preizkusom deluje s podatki CSV, podjetje UTU pa SkyPlanner z NetSuite uporablja že danes (izkušnja podjetja UTU).
