Integrasi / ERP / Oracle Fusion Cloud
Panduan Integrasi Oracle Fusion Cloud untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Oracle Fusion Cloud ini menjelaskan kepada mitra dan tim TI cara menghubungkan Oracle Fusion Cloud Manufacturing dengan SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan Oracle Fusion Cloud melalui resource REST milik Oracle:
- Data yang masuk mencakup work order beserta operasinya, definisi kerja, work center, sumber daya produksi, kalender, item, struktur item, saldo persediaan yang tersedia, dan pesanan pembelian.
- Tanggal mulai dan selesai yang direncanakan dikirim kembali ke setiap operasi work order.
- Konfirmasi operator dikirim kembali sebagai transaksi operasi dan transaksi sumber daya produksi.
- Webhook SkyPlanner langsung mengirim perubahan jadwal saat terjadi.
Tim SkyPlanner mengonfigurasi integrasi sesuai konfigurasi Oracle Fusion Cloud Anda selama proses penyiapan awal dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin berpartisipasi atau membangun integrasi sendiri menggunakan REST API SkyPlanner yang terdokumentasi (referensi API).
Antarmuka integrasi Oracle Fusion Cloud
Oracle Fusion Cloud menyediakan tiga jalur data bagi sistem penjadwalan eksternal:
- REST API untuk Oracle Fusion Cloud SCM. Jalur dasarnya adalah
/fscmRestApi/resources/11.13.18.05/. Resource yang digunakan sistem penjadwalan adalahworkOrders(beserta resource turunannya, yaituWorkOrderOperation,WorkOrderOperationResource, danWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructures, daninventoryOnhandBalances. Progres dikirim keoperationTransactions,resourceTransactions, danmaterialTransactions. Pesanan pembelian diambil daripurchaseOrdersdi Procurement REST API. (Endpoint REST) - File-Based Data Import (FBDI). Proses Import Work Orders membuat atau memperbarui work order beserta operasi dan sumber daya produksi untuk operasi tersebut dari templat, sedangkan Import Work Order Resource Transactions memuat catatan transaksi sumber daya produksi. Oracle menyatakan dengan jelas batasan waktunya: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Opsi ini tidak cocok untuk mengimpor data manufaktur secara waktu nyata.) (sumber)
- Oracle Integration (OIC). Platform integrasi Oracle menangani aliran data antara Fusion dan sistem lain. Salah satu resep Oracle Integration memantau event Work Order Status Change di Oracle Fusion Cloud Manufacturing (sumber). Gunakan jalur ini jika perusahaan Anda sudah menggunakan OIC.
REST menjadi jalur utama untuk penjadwalan waktu nyata. FBDI cocok untuk pemuatan awal master data.
Autentikasi dan akses
- Keamanan REST Oracle. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (REST API Fusion Applications menggunakan kebijakan keamanan global Oracle Web Services Manager (OWSM) bernama Multi Token Over SSL RESTful Service Policy.) Kebijakan ini menerima autentikasi Basic melalui SSL dan autentikasi berbasis token, seperti bearer token SAML 2.0. (Panduan mulai cepat)
- Pengguna integrasi. Buat pengguna Oracle khusus untuk integrasi. Berikan peran jabatan yang menyediakan hak akses yang diperlukan untuk work order, definisi kerja, persediaan, dan transaksi, dengan akses terbatas pada organisasi manufaktur yang termasuk dalam lingkup integrasi.
- Paginasi. Oracle membatasi jumlah rekaman yang dikembalikan oleh satu panggilan SCM REST. Karena itu, baca data dengan
limitdanoffset, lalu filter berdasarkan organisasi dan status (sumber)
Di sisi SkyPlanner, REST API menggunakan token API pada header Authorization-Token untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan awal.
Event dan polling
Data di sisi Oracle diambil melalui polling. Kueri REST dengan filter mengambil work order baru dan yang berubah, perubahan status rilis, saldo persediaan yang tersedia, serta pesanan pembelian. Frekuensinya diatur per pabrik, mulai dari setiap beberapa menit untuk work order hingga setiap jam untuk stok. Jika Anda menggunakan Oracle Integration, event Work Order Status Change dapat memicu pembacaan langsung.
SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga pengiriman data kembali ke Oracle dipicu oleh event.
Pemetaan data
| Objek Oracle Fusion Cloud (resource REST) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Item (itemsV2), satuan ukur | Produk dan material | Oracle → SkyPlanner | Pemuatan awal, lalu polling |
Struktur item (itemStructures) | Struktur produk, subproduk, material per produk | Oracle → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
Definisi kerja (workDefinitions): operasi, sumber daya produksi untuk operasi, penggunaan, Basis Type | Langkah proses beserta durasi, waktu penyiapan, dan waktu pembongkaran | Oracle → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
Work center (workCenters), sumber daya produksi (productionResources) untuk peralatan dan tenaga kerja | Stasiun kerja, kelompok stasiun kerja, personel, tingkat efisiensi | Oracle → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
Kalender dan sif (calendars, pengecualian sif) | Sif dan hari libur kerja | Oracle → SkyPlanner | Setiap hari, atau kelola sif sendiri di SkyPlanner |
| Organisasi manufaktur | Kelompok stasiun kerja per pabrik | Oracle → SkyPlanner | Pemuatan awal |
Work order (workOrders, processWorkOrders) beserta WorkOrderOperation dan WorkOrderOperationMaterial | Pesanan dan job beserta tenggat waktu dan kebutuhan material | Oracle → SkyPlanner | Polling setiap beberapa menit |
Saldo persediaan yang tersedia (inventoryOnhandBalances) | Saldo stok | Oracle → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
Pesanan pembelian (purchaseOrders) beserta tanggal yang dijanjikan | Pesanan pembelian, material masuk berdasarkan tanggal pengiriman | Oracle → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Waktu mulai dan selesai yang direncanakan per job | SkyPlanner → Oracle | Saat jadwal berubah, melalui webhook SkyPlanner |
Tanggal WorkOrderOperationResource (PATCH) | Alokasi sumber daya produksi per job | SkyPlanner → Oracle | Saat jadwal berubah, jika opsi ini dipilih |
operationTransactions (POST) | Jumlah yang selesai per operasi | SkyPlanner → Oracle | Setiap konfirmasi |
resourceTransactions (POST) | Catatan waktu: waktu tenaga kerja dan mesin | SkyPlanner → Oracle | Setiap konfirmasi atau setiap sif, jika opsi ini dipilih |
| Tidak ada di Oracle Fusion Cloud | Matriks waktu penyiapan, perkakas sebagai sumber daya produksi dengan kapasitas terbatas, mesin dan personel alternatif | Dikelola di SkyPlanner | Dikonfigurasi selama penyiapan awal |
Pola integrasi
1. Pemuatan awal master data. Baca item, struktur item, definisi kerja, work center, sumber daya produksi, dan kalender melalui REST, atau muat satu kali dari hasil ekstraksi FBDI. Tentukan pemetaan work center dengan cermat: work center dengan empat mesin yang tercatat sebagai sumber daya produksi yang sama dipetakan menjadi satu kelompok stasiun kerja atau empat stasiun kerja. Setiap organisasi manufaktur menjadi satu kelompok stasiun kerja, sehingga semua pabrik tercakup dalam satu rencana.
2. Sinkronisasi work order. Baca work order yang sudah maupun belum dirilis beserta operasi dan materialnya, serta pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered.
Jadwalkan work order, bukan pesanan terencana dari Supply Planning. Pesanan terencana harus diubah menjadi work order di Oracle terlebih dahulu.
3. Penulisan kembali jadwal. Saat mesin penjadwalan menempatkan atau memindahkan job, webhook SkyPlanner memicu PATCH pada workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} dengan PlannedStartDate dan PlannedCompletionDate. Aturan Oracle berlaku: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (Tanggal mulai yang direncanakan tidak boleh mendahului tanggal mulai work order atau melewati tanggal selesainya.) (sumber) Karena itu, jika jadwal baru berada di luar rentang tanggal tersebut, integrasi memperbarui tanggal pada header work order melalui PATCH terlebih dahulu, lalu memperbarui operasinya.
4. Konfirmasi di lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktunya menjaga jadwal tetap mutakhir. Jumlah yang selesai dikirim ke operationTransactions, sedangkan waktu tenaga kerja dan mesin dikirim ke resourceTransactions. Jika pabrik Anda sudah melaporkan progres di Oracle, SkyPlanner membaca progres tersebut sebagai gantinya.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Item, struktur item, definisi kerja, jumlah, status work order | Oracle Fusion Cloud |
| Urutan operasi, waktu mulai dan selesai, alokasi sumber daya produksi | SkyPlanner |
| Matriks waktu persiapan, kebutuhan alat dan operator, sumber daya produksi alternatif | SkyPlanner |
| Shift dan hari nonkerja | Satu sistem, dipilih saat penentuan lingkup |
| Transaksi sumber daya produksi, operasi, dan material | Oracle, dengan data yang dimasukkan langsung di sana atau dikirim dari catatan waktu SkyPlanner |
Tentukan satu sistem yang menulis tanggal operasi. SkyPlanner tidak memerlukan area kerja penjadwalan Oracle, sehingga menggantikan Production Scheduling sebagai sistem yang menulis tanggal rencana. Jika Production Scheduling masih merilis jadwal, pisahkan organisasi yang ditanganinya dari organisasi yang dijadwalkan oleh SkyPlanner.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu setelah proses orientasi dimulai, bahkan untuk perusahaan besar. Sebelum itu, validasi jadwal selama uji coba gratis 30 hari menggunakan work center, definisi kerja, dan work order terbuka yang diekspor dari Oracle dalam format CSV atau Excel.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, organisasi yang tercakup, frekuensi sinkronisasi, serta apakah transaksi akan dikirim kembali.
- Akses Oracle. Buat akun pengguna integrasi dan perannya. Lakukan pengujian terlebih dahulu di lingkungan Oracle nonproduksi.
- Pemuatan awal. Muat item, struktur item, definisi kerja, work center, sumber daya produksi, dan kalender.
- Sinkronisasi work order dan pesanan pembelian. Lakukan polling dengan filter, paginasi, dan percobaan ulang.
- Pengaturan batasan di SkyPlanner. Atur matriks waktu persiapan, alat, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan kembali jadwal. Jalankan PATCH yang dipicu webhook SkyPlanner, beserta pengiriman transaksi jika dipilih.
- Pengujian paralel. Jalankan SkyPlanner berdampingan dengan rencana saat ini, bandingkan tanggalnya, lalu perbaiki master data.
- Mulai penggunaan operasional. Aktifkan penulisan kembali data secara bertahap per pabrik setelah datanya cocok.
Hal yang perlu diantisipasi dalam integrasi Oracle Fusion Cloud
- Perilaku bawaan penjadwal. Mesin Oracle yang tidak memperhitungkan batasan berjalan saat pembuatan dan pada “certain update actions.” (tindakan pembaruan tertentu) Uji di lingkungan Anda untuk mengetahui pembaruan mana yang menghitung ulang tanggal, dan pastikan SkyPlanner menjadi sistem terakhir yang menulis tanggal operasi.
- Rentang waktu work order. Tanggal operasi harus berada dalam rentang tanggal mulai hingga selesai work order. Perbarui header melalui PATCH terlebih dahulu.
- Basis Type. Penggunaan sumber daya produksi dihitung per unit hanya jika Basis Type bernilai Variable. Nilai Fixed berarti waktu tetap per operasi. Lakukan konversi saat impor; jika tidak, semua durasi akan salah.
- Manufaktur diskret dan proses. Pabrik diskret menggunakan
workOrders, sedangkan pabrik proses menggunakanprocessWorkOrders. Petakan keduanya jika Anda menjalankan kedua jenis manufaktur tersebut. - Paginasi. Oracle membatasi jumlah rekaman per panggilan REST. Terapkan paginasi pada setiap kueri dan filter berdasarkan organisasi serta status.
- Pembaruan triwulanan. Oracle memperbarui Fusion setiap triwulan. Tetapkan versi REST yang digunakan dalam path dan uji ulang setelah setiap pembaruan.
- Aturan status. Work order berstatus Pending Approval atau yang sudah ditutup tidak boleh diberi tanggal baru. Kecualikan keduanya dengan filter saat membaca data.
Siapa yang mengonfigurasi dan mendukung integrasi Oracle Fusion Cloud
- Tim SkyPlanner mengonfigurasinya selama proses orientasi dan memberikan dukungan setelah sistem mulai digunakan, untuk resource REST dan organisasi yang telah disepakati. Setiap pabrik menggunakan Oracle Fusion Cloud dengan cara berbeda, dan pemahaman tentang perbedaan itulah yang diterapkan di sini.
- Mitra Oracle Anda dapat ikut terlibat. Mitra memahami organisasi, peran, dan ekstensi Anda, serta dapat menyiapkan akun pengguna integrasi, peran, dan alur Oracle Integration yang diperlukan bersama tim SkyPlanner.
- Pengembang internal Anda dapat mengembangkannya lebih lanjut melalui REST API SkyPlanner dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner membantu bila diperlukan. Dokumentasi tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran harga integrasi diberikan di awal bersama paket Anda, sesuai proses dan kebutuhan Anda. Lihat harga, penjadwalan produksi dengan kapasitas mesin dan tenaga kerja yang tersedia untuk Oracle Fusion Cloud, halaman Oracle Fusion Cloud, dan pusat integrasi ERP. Menggunakan NetSuite? Lihat panduan integrasi NetSuite.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“SkyPlanner telah membawa perencanaan produksi kami dari lembar kerja Excel ke optimasi produksi secara real-time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam waktu kerja setiap minggu, dan antrean kerja baru sampai ke lini produksi dalam hitungan detik.
+90%efisiensi produksi
“Efisiensi produksi meningkat 90%.”
Abdul Rucyinga, Kepala TI
Laboratory & Allied · Manufaktur farmasi
Efisiensi produksi meningkat 90%, dan penyusunan rencana tiga bulan yang dioptimalkan untuk seluruh stasiun kerja memerlukan waktu kurang dari 30 menit.
99,2%keandalan pengiriman
“SkyPlanner membuat hambatan produksi lebih mudah diidentifikasi dan pengelolaan produksi menjadi lebih jelas.”
Toni Tuori, Manajer Produksi
Piristeel · Perlengkapan keselamatan atap dan sistem air hujan
Keandalan pengiriman mencapai 99,2% tahun ini, dan penjadwalan menghemat hingga empat jam waktu kerja per hari.
1.000-anwork order dijadwalkan otomatis
“Kini kami mengendalikan produksi dengan cara yang berbeda, dan pemahaman kami tentang kapasitas sudah berada di tingkat yang sama sekali berbeda.”
Hannu Ryynänen, CEO
Mamec · Mixer industri, pompa, dan manufaktur kontrak berteknologi tinggi
Ribuan work order dijadwalkan secara otomatis, dan seluruh organisasi dapat memantau produksi secara real-time.
Pertanyaan umum
Apakah Oracle Fusion Cloud memiliki API untuk work order?
Ya. REST API untuk Oracle Fusion Cloud SCM menyediakan workOrders dengan objek anak untuk operasi, sumber daya produksi, dan material, serta processWorkOrders untuk manufaktur proses. API ini mendukung GET, POST, dan PATCH.
Bagaimana tanggal rencana ditulis kembali ke Oracle Fusion Cloud?
Melalui PATCH pada objek anak WorkOrderOperation dari work order, dengan menetapkan PlannedStartDate dan PlannedCompletionDate. Tanggal operasi harus tetap berada dalam rentang tanggal work order, sehingga header diperbarui melalui PATCH terlebih dahulu bila diperlukan.
Bagaimana konfirmasi operator dikirim ke Oracle?
Jumlah yang selesai dikirim ke operationTransactions, sedangkan waktu tenaga kerja dan mesin dikirim ke resourceTransactions. Keduanya merupakan resource REST yang menerima POST di Fusion Manufacturing.
Apakah Oracle Fusion Cloud mendukung webhook?
Fusion menerbitkan peristiwa bisnis seperti Work Order Status Change, dan Oracle Integration dapat berlangganan peristiwa tersebut. Tanpa Oracle Integration, integrasi memeriksa REST API secara berkala sesuai jadwal yang ditetapkan untuk tiap pabrik. Webhook SkyPlanner sendiri mengirimkan perubahan jadwal begitu perubahan terjadi.
Sebaiknya mitra Oracle menawarkan Oracle Production Scheduling atau SkyPlanner?
SkyPlanner, jika pelanggan menginginkan satu jadwal lintas pabrik yang memperhitungkan kapasitas nyata mesin dan tenaga kerja serta selalu diperbarui secara otomatis. Production Scheduling diaktifkan dalam penawaran Supply Chain Planning, menyusun jadwal per organisasi penjadwalan, dan menerapkan aturan changeover hanya pada peralatan satu unit (dokumentasi Oracle). SkyPlanner terhubung melalui SCM REST API, menyusun ulang rencana secara otomatis, serta merencanakan changeover, perkakas, tim kerja, dan material. Jumlah penggunanya tidak dibatasi, dengan harga mulai dari 199 € per bulan.
Bisakah kami mencoba SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor CSV atau Excel dari Oracle, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.