Sprievodca integráciou NetSuite so SkyPlanner APS na rozvrhovanie výroby

Oracle určil smer. Od verzie 2026.1 by nové integrácie mali využívať webové služby SuiteTalk REST s OAuth 2.0. Od verzie 2027.1 už nebudú možné nové integrácie cez SOAP ani Token-Based Authentication (TBA). Vo verzii 2028.2 sa koncové body SOAP vypnú. Každá integrácia rozvrhovania, ktorej vývoj sa začína dnes, má využívať REST.

Autentifikácia

Pre rozvrhovací systém, ktorý komunikuje medzi servermi, použite OAuth 2.0 Client Credentials (machine-to-machine). Cesta v správe systému je Setup > Integration > Manage Authentication > OAuth 2.0 Client Credentials (M2M) Setup. Nahrajte verejný certifikát a priraďte ho k entite, role a záznamu integrácie. Každý záznam integrácie môže obsahovať najviac päť aktívnych certifikátov.

Vytvorte samostatnú integračnú rolu: s právom na prezeranie položiek, revízií kusovníkov, technologických postupov a pracovísk a s právom na úpravu výrobných príkazov, hlásení dokončenia a výdajov. SkyPlanner REST API (referenčná dokumentácia API) používa JWT, takže middleware uchováva prihlasovacie údaje pre oba systémy.

Udalosti: štandardný webhook neexistuje

Dokumentácia Oracle neuvádza žiadny natívny webhook na odosielanie udalostí. Osvedčeným postupom je skript SuiteScript User Event na objekte Work Order (afterSubmit), ktorý zaradí odchádzajúce volanie do frontu cez N/task alebo skript Map/Reduce. Samotné volanie sa vykoná cez N/https. V afterSubmit nikdy nevolajte externé služby synchrónne: volanie prebieha počas ukladania používateľom, takže pomalý koncový bod ukladanie spomalí alebo spôsobí jeho zlyhanie.

Udalosti User Event nepokrývajú všetky spôsoby zmien. Hromadné aktualizácie a importy CSV ich môžu obísť. Skript preto doplňte o pravidelné kontrolné dopyty SuiteQL podľa lastmodifieddate, aby sa žiadna zmena nevynechala. V opačnom smere spúšťajú spätný zápis vlastné webhooky SkyPlanner, takže NetSuite dostane nové termíny hneď po zmene plánu.

1. Úvodné načítanie kmeňových dát. Pomocou SuiteQL načítajte najprv pracoviská, potom položky, revízie kusovníkov a technologické postupy. Technologické postupy odkazujú na pracoviská, preto na poradí záleží. Počas skúšobného obdobia exportujte tie isté dáta do CSV a importujte ich do SkyPlanner. Rozvrh sa tak overí ešte pred napísaním akéhokoľvek kódu.

2. Synchronizácia príkazov. Načítavajte výrobné príkazy v stavoch Released a In Process. Už na začiatku rozhodnite, či zahrniete aj výrobné príkazy v stave Planned. Ak áno, považujte ich za predbežný dopyt. V tom istom cykle synchronizujte aj otvorené nákupné objednávky, aby rozvrh pri každej operácii overoval dostupnosť materiálu podľa zásob aj očakávaných dodávok, nielen podľa zásob.

3. Spätný zápis rozvrhu. Keď sa rozvrh zmení, webhook SkyPlanner odošle nové termíny operácií do middlewaru. Middleware pre každú zmenenú operáciu odošle PATCH /services/rest/record/v1/manufacturingOperationTask/{id} (Referenčná dokumentácia záznamov Oracle) s poľami startDate a endDate. Ďalší PATCH v hlavičke workOrder nastaví polia Production Start Date a Production End Date. Zapisujte iba termíny a prípadne vlastné pole poradia, ak ho používate. Nikdy spätne nezapisujte množstvá ani údaje kusovníka. Ak potrebujete aktualizovať viacero operácií v jednej transakcii, malý RESTlet uloží celý zoznam operácií jediným volaním. Predvolenou voľbou zostáva record API.

4. Potvrdenia z dielne. Operátori zaznamenávajú prácu v SkyPlanner Mobile Confirmations. Middleware odošle každé potvrdenie cez transformácie objektu Work Order volaním POST /services/rest/record/v1/workOrder/{id}/!transform/workOrderCompletion. Prenáša pritom startOperation, endOperation, dokončené množstvo a zaznamenaný čas na riadkoch operácií. Výrobné príkazy bez WIP sa namiesto toho uzatvárajú cez !transform/assemblyBuild. Work Order Completion cez REST vyžaduje funkciu Manufacturing Work In Process. Účtovanie zásob a nákladov zostáva v NetSuite.

5. Idempotencia a opakovanie volaní. Každé hlásenie dokončenia používa ID časového záznamu zo SkyPlanner ako externé ID v NetSuite. Externé ID sú jedinečné v rámci typu záznamu, takže opätovne doručený webhook sa odmietne ako duplicita namiesto toho, aby sa množstvá a náklady zaúčtovali dvakrát. Zápisy prechádzajú cez front. Neúspešné volanie (limit súbežných volaní, zamknutý záznam, certifikát po platnosti) sa zopakuje a zaznamená do protokolu. Všetky pretrvávajúce zlyhania vidí tím SkyPlanner, ktorý poskytuje podporu integrácie.

6. Zodpovednosť za dáta. NetSuite určuje, čo sa vyrába: položku, množstvo, kusovník, technologický postup a lokalitu. SkyPlanner určuje, kedy a kde: poradie operácií, pracovisko, začiatok a koniec. Termíny upravené v NetSuite sa pri ďalšom spätnom zápise prepíšu, preto polia Production Start/End Date uzamknite úpravou formulára alebo pomocou workflow.

• Výrobné príkazy bez technologického postupu. Výrobný príkaz bez Manufacturing Routing nemá operácie, ktoré by sa dali rozvrhnúť. Oracle uvádza to isté aj o svojom vlastnom nástroji na plánovanie výroby: „Work orders not associated with a NetSuite routing should not be scheduled.“ (Výrobné príkazy, ktoré nie sú priradené k technologickému postupu v NetSuite, by sa nemali rozvrhovať.) Vyhľadajte ich pomocou SuiteQL ešte pred spustením ostrej prevádzky.
• Pracoviská obsahujú málo údajov. Pracovisko v NetSuite je objekt Group s dvoma údajmi o počte zdrojov, Machine Resources a Labor Resources (oba majú predvolenú hodnotu 0), a jedným kalendárom Work Calendar, zvyčajne „Default Work Calendar“. Pracoviská načítajte jednorazovo a potom v SkyPlanner spravujte jednotlivé pracoviská, zmeny pre každého pracovníka, nástroje, maticu časov prestavenia a alternatívne pracoviská.
• Kvalita údajov v poliach Setup Time a Run Rate. NetSuite tieto polia používa pri rozvrhovaní bez zohľadnenia kapacít, preto nesprávne hodnoty zostávajú nepovšimnuté. Plánovanie výroby, ktoré rešpektuje skutočné kapacity strojov a pracovníkov, ich odhalí hneď v prvý deň.
• S WIP alebo bez WIP. Pri použití Manufacturing WIP sa výstup účtuje cez Work Order Issue, Work Order Completion a Work Order Close. Bez WIP sa používa Assembly Build. Integrácia zapisuje pre položky s WIP hlásenia dokončenia a pre ostatné položky Assembly Builds, takže model pre každú položku je súčasťou mapovania.
• Advanced Manufacturing v tom istom účte. Ak sa v účte používa aj Advanced Manufacturing SuiteApp, jeho záznamy Manufacturing Work Bench sa musia presne zhodovať s technologickým postupom: poradím operácií, názvom operácie aj pracoviskom. Rozhodnite, ktorý systém bude určovať termíny operácií. Dva rozvrhovacie systémy nad tými istými výrobnými príkazmi znamenajú dva navzájom si konkurujúce plány.
• Limity súbežných volaní. Volania webových služieb a RESTlet zdieľajú jeden limit súbežných volaní účtu, ktorý určuje úroveň služby a zvyšuje sa o 10 za každú licenciu SuiteCloud Plus. Paralelné dopytovanie jednotlivých záznamov ho rýchlo vyčerpá. Na čítanie používajte SuiteQL so stránkovaním a zápisy zaraďujte do frontu.
• Obnovenie testovacieho prostredia vymaže nastavenia M2M. Pri obnovení testovacieho prostredia sa vymažú mapovania OAuth 2.0 Client Credentials a medzi účtami sa nekopírujú. Certifikát po platnosti alebo odvolaný certifikát zastaví synchronizáciu, kým sa nevytvorí nové mapovanie. Nastavte upozornenia na zlyhania autentifikácie.