Integrasi / ERP / SAP Business ByDesign
Panduan Integrasi SAP Business ByDesign untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi SAP Business ByDesign ini menjelaskan cara menghubungkan ByDesign ke SkyPlanner APS bagi mitra dan tim TI. SkyPlanner terintegrasi dua arah dengan ByDesign melalui layanan web yang telah dirilis SAP:
- Data yang masuk mencakup perintah produksi yang telah dirilis beserta operasinya, Production Models, Bills of Material dan Bills of Operations, sumber daya peralatan dan tenaga kerja, material, stok, serta pesanan pembelian.
- Rencana waktu mulai setiap perintah produksi dan sumber daya produksi utama untuk setiap operasi dikirim kembali ke ByDesign.
- Jumlah yang dikonfirmasi, scrap, dan tugas yang telah selesai dapat dicatat kembali pada lot produksi.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Tim SkyPlanner mengonfigurasi integrasi dengan tenant ByDesign Anda melalui REST API selama proses onboarding dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin terlibat atau membangun integrasi sendiri menggunakan REST API SkyPlanner yang terdokumentasi (referensi API).
Antarmuka integrasi SAP ByDesign
Untuk setiap rilis, ByDesign memublikasikan layanan web A2X SOAP yang telah dirilis dalam daftar API layanan web. Integrasi penjadwalan menggunakan layanan berikut:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER mengembalikan waktu mulai dan selesai yang diminta, paling awal, dan paling akhir; sumber daya produksi beserta durasi yang direncanakan dan yang telah terealisasi; prioritas; status pelaksanaan; serta status penjadwalan. MAINTAIN_BUNDLE_V2 memperbarui EarliestStartPeriod atau LatestEndPeriod, serta MainResourceID pada operasi (bantuan SAP).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle membuat atau memperbarui tugas produksi: jumlah yang dikonfirmasi, scrap, dan indikator selesainya konfirmasi pada setiap titik pelaporan; penyelesaian tugas beserta karyawan pelaksana dan waktu pelaksanaannya; serta pemanfaatan sumber daya produksi (bantuan SAP).
- Layanan Query. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (juga berdasarkan sumber daya produksi), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks, dan Determine Availability of Products.
- OData. Layanan OData kustom untuk objek bisnis, serta OData untuk sumber data dan laporan analitis. SAP menyatakan “companies are fully empowered to decide which business objects” (perusahaan berwenang penuh menentukan objek bisnis mana) yang akan diekspos (skenario integrasi SAP).
Gunakan layanan Query atau OData untuk membaca data, dan kedua layanan Manage untuk setiap penulisan data.
Autentikasi dan lisensi
Di sisi ByDesign, buat sistem komunikasi untuk SkyPlanner dan pengaturan komunikasi untuk layanan yang Anda gunakan. Setiap pengaturan memiliki pengguna teknis tersendiri. Panduan keamanan SAP menyebutkan autentikasi integrasi aplikasi dengan “user ID plus password, and the X.509 client certificate” (ID pengguna beserta kata sandi, dan sertifikat klien tersebut) (Panduan Keamanan). OAuth 2.0 dapat dikonfigurasi untuk OData. Unduh WSDL setiap layanan dari pengaturan komunikasi atau Service Explorer.
Di sisi SkyPlanner, setiap panggilan menyertakan token API pada header Authorization-Token. Buat token di SkyPlanner melalui Settings > API. Token API saja sudah cukup untuk mulai mengembangkan integrasi.
Event dan polling
SkyPlanner mengirim webhook setiap kali jadwal berubah, sehingga data ditulis kembali ke ByDesign seiring perubahan rencana.
Untuk mengambil perubahan di ByDesign, lakukan polling pada layanan Query. Baca perintah produksi yang telah dirilis dan lot produksi setiap beberapa menit, sedangkan material, stok, dan pesanan pembelian dibaca dengan interval yang lebih panjang. Hasil kueri dibagi ke dalam halaman menggunakan QueryHitsMaximumNumberValue dan LastReturnedObjectID; SAP mendokumentasikan ukuran halaman default di halaman layanan web.
Pemetaan data
| Objek ByDesign (antarmuka) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
| Material (Query Materials) | Produk dan material | ByDesign → SkyPlanner | Pemuatan awal, lalu polling |
| Production Bill of Material (Query Production Bill of Materials) | Struktur produk, material per produk | ByDesign → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Production Bill of Operations: operasi, aktivitas Setup, Produce, dan Tear down (Query Production Bill of Operations) | Tahapan proses beserta durasi, waktu persiapan, dan waktu pembongkaran | ByDesign → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Production Model (Query Production Model) | Routing produk per lokasi | ByDesign → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Sumber daya peralatan dan kelompok sumber daya produksi (Read Equipment Resources) | Stasiun kerja, kelompok stasiun kerja, alat | ByDesign → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
| Sumber daya tenaga kerja, waktu kerja (Query Labour Resource) | Personel dan sif | ByDesign → SkyPlanner | Setiap hari, atau kelola sif tersendiri di SkyPlanner |
| Perintah produksi yang telah dirilis beserta operasinya (Query Production Orders, READ_PROD_ORDER) | Pesanan dan job beserta tenggat dan kebutuhan material | ByDesign → SkyPlanner | Polling setiap beberapa menit |
| Lot dan tugas produksi (Query Production Lots) | Progres job | ByDesign → SkyPlanner | Polling setiap beberapa menit |
| Stok teridentifikasi, ketersediaan produk (Query Identified Stocks, Determine Availability of Products) | Saldo stok | ByDesign → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Pesanan pembelian (Query Purchase Orders) | Pesanan pembelian, material masuk menurut tanggal pengiriman | ByDesign → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| EarliestStartPeriod, MainResourceID pada operasi (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Rencana waktu mulai, stasiun kerja yang ditetapkan | SkyPlanner → ByDesign | Saat jadwal berubah, melalui webhook SkyPlanner |
| Jumlah yang dikonfirmasi, scrap, penyelesaian tugas (Manage Production Lots, MaintainBundle) | Catatan waktu kerja dan konfirmasi operator | SkyPlanner → ByDesign | Per konfirmasi atau per sif, jika dipilih |
| Tidak ada di ByDesign | Matriks waktu persiapan, kebutuhan beberapa operator, mesin dan personel alternatif | Dikelola di SkyPlanner | Disiapkan selama onboarding |
Pola integrasi
1. Pemuatan awal master data. Baca material, Production Models, Bills of Material dan Bills of Operations, serta sumber daya peralatan dan tenaga kerja. Tentukan pemetaan sumber daya produksi dengan cermat: kelompok yang berisi empat mesin dapat menjadi satu kelompok stasiun kerja atau empat stasiun kerja. Sumber daya peralatan yang berupa alat menjadi alat dengan jumlah terbatas di SkyPlanner.
2. Sinkronisasi perintah produksi. Baca perintah produksi yang telah 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. Usulan produksi tetap berada di ByDesign Supply Planning hingga menjadi perintah produksi.
3. Penulisan balik jadwal. Saat mesin penjadwalan menempatkan atau memindahkan pesanan, webhook SkyPlanner memicu MAINTAIN_BUNDLE_V2 pada Manage Production Orders. Panggilan ini menetapkan EarliestStartPeriod dan MainResourceID pada operasi yang dipilih SkyPlanner.
4. Konfirmasi di lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu kerja menjaga jadwal tetap mutakhir. Anda menentukan apakah data aktual akan ditulis kembali. Jika ya, MaintainBundle pada Manage Production Lots mencatat jumlah yang dikonfirmasi, scrap, serta tugas yang telah selesai beserta karyawan pelaksananya. Jika tidak, konfirmasi tetap dimasukkan di ByDesign seperti sebelumnya.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Material, Production Models, jumlah, status perintah produksi dan lot | ByDesign |
| Urutan operasi, waktu mulai dan selesai, penetapan sumber daya produksi | SkyPlanner |
| Matriks waktu persiapan dan pergantian, kebutuhan perkakas dan operator, sumber daya alternatif | SkyPlanner |
| Shift dan hari nonkerja | Satu sistem, dipilih saat penentuan lingkup |
| Konfirmasi, pergerakan barang, perhitungan biaya | ByDesign, dimasukkan langsung di sana atau dikirim dari catatan waktu kerja SkyPlanner |
Tetapkan hanya satu sistem yang menulis tanggal perintah produksi. Jangan jalankan Load Leveling pada sumber daya produksi yang dijadwalkan oleh SkyPlanner, dan pastikan proses perencanaan tidak menggeser perintah produksi yang telah dirilis dan menjadi tanggung jawab SkyPlanner.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam beberapa minggu sejak onboarding dimulai. Sebelum itu, validasi jadwal selama uji coba gratis 30 hari menggunakan sumber daya produksi, Bills of Operations, dan perintah produksi terbuka yang diekspor dari ByDesign dalam format CSV atau Excel.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, serta apakah konfirmasi akan ditulis kembali.
- Akses ByDesign. Buat sistem komunikasi dan pengaturan komunikasinya, lalu unduh WSDL. Lakukan pengujian terlebih dahulu di tenant uji ByDesign Anda.
- Pemuatan awal. Material, Production Models, Bills of Material dan Operations, sumber daya produksi, serta waktu kerja.
- Sinkronisasi perintah produksi dan pesanan pembelian. Polling dengan paginasi, filter, dan percobaan ulang.
- Pengaturan batasan di SkyPlanner. Matriks waktu penyiapan dan pergantian, perkakas, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan balik jadwal. Panggilan MAINTAIN_BUNDLE_V2 dari webhook SkyPlanner, beserta konfirmasi lot jika dipilih.
- Pengujian paralel. Jalankan SkyPlanner berdampingan dengan rencana saat ini, bandingkan tanggalnya, lalu perbaiki master data.
- Mulai operasional. Aktifkan penulisan kembali setelah datanya sesuai.
Hal yang perlu direncanakan untuk integrasi SAP ByDesign
- Satu tanggal per panggilan. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod dan LatestEndPeriod tidak dapat diperbarui bersamaan.) Gunakan tanggal mulai sebagai acuan penulisan kembali.
- Tanpa penguncian. Layanan A2X bersifat stateless, sehingga menurut SAP, penguncian transaksional maupun logis tidak dapat diterapkan. Baca ulang pesanan sebelum setiap penulisan dan tangani konflik yang terjadi.
- Status selesai bersifat final. “Confirmation Finished Indicator cannot be unchecked once it is set.” (Centang pada Confirmation Finished Indicator tidak dapat dihapus setelah diaktifkan.) Kirim status selesai hanya setelah operator menutup tugas.
- Sumber daya produksi utama dan tambahan. Penjadwalan ByDesign memperhitungkan sumber daya produksi utama. Modelkan operator dan alat yang termasuk sumber daya produksi tambahan di SkyPlanner dengan kapasitas terbatas, agar ketersediaannya diperiksa saat penjadwalan.
- Persiapan dan pembongkaran. Bills of Operations mencatat persiapan dan pembongkaran sebagai aktivitas. Pindahkan waktu changeover yang bergantung pada urutan pengerjaan ke matriks waktu persiapan.
Siapa yang mengonfigurasi dan mendukung integrasi SAP ByDesign
- Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah sistem mulai digunakan, mencakup layanan web dan kueri OData yang disepakati. Setiap perusahaan menggunakan ByDesign dengan cara berbeda, dan pemahaman tentang perbedaan itulah yang diterapkan di sini.
- Mitra SAP ByDesign Anda dapat ikut terlibat. Mitra memahami tenant, penentuan lingkup, dan ekstensi Anda, serta dapat menyiapkan pengaturan komunikasi bersama tim SkyPlanner.
- Pengembang internal Anda dapat mengembangkan integrasi ini lebih lanjut melalui REST API SkyPlanner dengan token API pada header
Authorization-Token. Tim SkyPlanner siap membantu bila diperlukan. Panduannya tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, sudah termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi diberikan di awal sesuai proses dan kebutuhan Anda, bersama penawaran paket langganan. Lihat harga, penjadwalan produksi SAP ByDesign sesuai kapasitas, halaman SAP Business ByDesign, dan pusat informasi integrasi ERP. Sistem SAP lainnya memiliki panduan tersendiri: SAP Business One dan SAP S/4HANA.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“SkyPlanner telah mengubah perencanaan produksi kami dari penggunaan lembar kerja Excel menjadi 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 optimal untuk tiga bulan di seluruh stasiun kerja memerlukan waktu kurang dari 30 menit.
100%keandalan pengiriman sejak 2021
“SkyPlanner memberi kami gambaran jelas tentang kapasitas dan membuat perencanaan lebih dapat diprediksi.”
Dan Berglund, COO/CFO
Opes Corporation · Manufaktur kimia dan makanan
Keandalan pengiriman mencapai 100% sepanjang penggunaan SkyPlanner, sejak 2021.
Lebih sedikitpenghentian produksi akibat kekurangan material
“Manfaat SkyPlanner bagi kami adalah kegunaannya dalam pekerjaan sehari-hari, terutama untuk menetapkan tanggal pengiriman.”
Tommi Männistö, Manajer Perencanaan Produksi
Eskomatic · Jasa pemesinan berdasarkan kontrak
Penjadwalan beban kerja secara otomatis menghasilkan tanggal pengiriman yang lebih akurat, dan penghentian produksi akibat kekurangan material telah berkurang tajam.
Pertanyaan umum
API SAP ByDesign mana yang digunakan SkyPlanner?
Layanan web A2X yang telah dirilis SAP. Pembacaan data menggunakan layanan Query, seperti Query Production Orders dan Query Purchase Orders, atau OData khusus. Penulisan data menggunakan Manage Production Orders dan Manage Production Lots.
Data apa yang ditulis kembali oleh SkyPlanner ke ByDesign?
EarliestStartPeriod dan MainResourceID untuk operasi pada setiap pesanan produksi. Jika Anda memilihnya, jumlah yang dikonfirmasi, scrap, dan tugas yang telah selesai akan dicatat pada lot produksi.
Apakah ByDesign mengirim event ke SkyPlanner?
SkyPlanner memeriksa layanan Query ByDesign setiap beberapa menit untuk mengambil data pesanan dan lot. SkyPlanner sendiri mengirim webhook setiap kali jadwal berubah, yang memicu penulisan kembali.
Bagaimana SkyPlanner melakukan autentikasi ke ByDesign?
Melalui sistem komunikasi dan pengaturan komunikasi dengan pengguna teknis, seperti yang dijelaskan dalam panduan keamanan SAP. API SkyPlanner sendiri menggunakan token API pada header Authorization-Token.
Apakah usulan produksi dikirim ke SkyPlanner?
SkyPlanner menjadwalkan pesanan produksi yang telah dirilis. Usulan tetap berada di ByDesign Supply Planning hingga menjadi pesanan produksi.
Siapa yang membangun integrasinya?
Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah sistem mulai digunakan. Mitra SAP ByDesign atau pengembang internal Anda juga dapat mengembangkan integrasi melalui REST API SkyPlanner dengan token API.
