Panduan Integrasi SAP S/4HANA untuk Penjadwalan Produksi dengan SkyPlanner APS

S/4HANA menyediakan antarmuka integrasi melalui layanan OData yang telah dirilis dan tercantum di SAP Business Accelerator Hub (api.sap.com). Integrasi penjadwalan menggunakan layanan OData V2. IDoc dan BAPI masih tersedia, tetapi panduan ini menggunakan API OData yang telah dirilis.

Autentikasi menurut edisi

• On-premise dan Private Edition. Layanan diaktifkan di SAP Gateway melalui transaksi /IWFND/MAINT_SERVICE. Pengguna integrasi memerlukan objek otorisasi yang sesuai, misalnya C_AFRU_AWK untuk konfirmasi, C_AFKO_AWK untuk item pergerakan barang yang dibukukan bersama konfirmasi tersebut, dan M_PLAF_ORG untuk order terencana.
• Public Edition. Layanan hanya dapat diakses melalui communication arrangement. Dengan mengikuti panduan SAP untuk menyiapkan komunikasi masuk, Anda membuat pengguna komunikasi, sistem komunikasi, dan communication arrangement di aplikasi Communication Arrangements, berdasarkan skenario komunikasi SAP (SAP_COM_xxxx). Skenario ini menentukan layanan yang dapat diakses dan metode autentikasi yang tersedia:

– berbasis token: alur bearer OAuth, SAML, atau OpenID Connect, dengan penerusan identitas ke pengguna bisnis – sertifikat klien – autentikasi dasar dengan pengguna komunikasi teknis

SAP merekomendasikan autentikasi dengan token atau sertifikat.

Di sisi SkyPlanner, tersedia REST API dengan autentikasi JWT yang didokumentasikan dalam Swagger/OpenAPI (referensi API). Dengan demikian, middleware menangani autentikasi SAP di satu sisi dan JWT di sisi lainnya.

API untuk penjadwalan produksi

Layanan	Entitas dan tindakan yang digunakan	Kegunaan
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2, A_ProductionOrderItem_2, A_ProductionOrderOperation_2, A_ProductionOrderComponent_2, A_ProductionOrderStatus_2, A_ProductionRsceTools_2; tindakan ReleaseOrder, ReleaseOperation, ScheduleProductionOrderOperation	Order, operasi, komponen, PRT, status, penulisan kembali jadwal
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	Work center, kategori kapasitas, interval, dan sif
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	Routing standar untuk perencanaan sebelum order dibuat
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	Struktur produk bertingkat
API_PRODUCT_SRV (Product Master A2X)	A_Product	Material (disebut Product dalam API). SAP kini merekomendasikan API Product (Version 2) untuk sebagian besar entitas produk
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	Hasil MRP Live sebelum konversi
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	Stok per pabrik dan lokasi penyimpanan untuk mengetahui ketersediaan material
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	Order pembelian yang belum tuntas untuk material yang akan datang
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2, ProdnOrdConfMatlDocItm; tindakan GetConfProposal, GetGdsMvtProposal, CancelProdnOrdConf	Konfirmasi dan pergerakan barang dari lantai produksi

Dalam API order produksi, operasi diidentifikasi dengan gabungan kunci OrderInternalBillOfOperations dan OrderIntBillOfOperationsItem, bukan nomor operasi yang dilihat perencana. Sementara itu, GetConfProposal pada API konfirmasi merujuk operasi yang sama menggunakan OrderID dan OrderOperation. Simpan kunci internal dan nomor operasi di SkyPlanner sejak pemuatan data pertama.

Peristiwa

S/4HANA memicu peristiwa bisnis Production Order Created dan Production Order Changed dengan ManufacturingOrder, ProductionOrder, ProductionOrderType, dan ProductionPlant di dalam payload. Payload hanya memuat kunci, sehingga integrasi membaca ulang order beserta operasinya. Peristiwa Changed dipicu setiap kali order berubah, jadi terapkan debounce. Untuk arah sebaliknya, webhook SkyPlanner mengirimkan pembaruan secara real time saat jadwal atau status job berubah.

Memulai dengan berkas

Untuk uji coba, ekspor perintah produksi dan work center dari laporan daftar S/4HANA ke Excel atau CSV, lalu impor ke SkyPlanner. Dengan cara ini, hasil penjadwalan dapat dibuktikan sebelum siapa pun mengubah konfigurasi Gateway atau communication arrangements.

1. Pemuatan master data. Muat material, BOM, work center beserta interval kapasitas dan sifnya, serta routing. Pada tahap ini, tentukan sistem yang mengelola sif. Pembagian yang efektif: kalender pabrik tetap di S/4HANA, sedangkan rincian pola sif, ketidakhadiran, dan lembur dikelola di SkyPlanner, tempat perencana mengubahnya setiap hari.

2. Sinkronisasi order. Berlangganan peristiwa Production Order Created/Changed, atau lakukan polling A_ProductionOrder_2 berdasarkan stempel waktu perubahan jika peristiwa bisnis belum disiapkan. Filter berdasarkan pabrik, jenis order, dan status. Kirim order saat dibuat agar SkyPlanner dapat merencanakannya lebih awal, lalu rilis order di S/4HANA (ReleaseOrder atau ReleaseOperation) setelah SkyPlanner menjadwalkannya.

3. Penulisan kembali jadwal. Saat webhook SkyPlanner melaporkan perubahan jadwal, integrasi memanggil ScheduleProductionOrderOperation di API_PRODUCTION_ORDER_2_SRV untuk setiap operasi yang berubah. Data yang dikirim:

• ManufacturingOrder, OrderInternalBillOfOperations, dan OrderIntBillOfOperationsItem sebagai kunci
• OpSchedulingMode F (maju), dengan tanggal dan waktu mulai dari SkyPlanner dalam OpSchedldStartDate dan OpSchedldStartTime
• OpSchedulingStatus DISP (dispatch) dan OpSchedulingStrategy M yang wajib disertakan
• ETag dalam if-match

Semua operasi dalam satu perintah dimasukkan ke satu change set sesuai urutan di SkyPlanner, sehingga S/4HANA menetapkan seluruh rencana perintah tersebut dalam satu panggilan. Mode K tidak pernah digunakan karena mempertahankan tanggal operasi semula dan mengabaikan tanggal yang dikirim.

SkyPlanner menghitung durasi operasi dari nilai standar routing dan rumus kapasitas work center yang sama dengan yang digunakan S/4HANA. Karena itu, tanggal selesai yang dihitung S/4HANA dari tanggal mulai yang dikirim akan sesuai dengan rencana SkyPlanner. Setelah setiap change set, integrasi membaca ulang operasi dan menandai tanggal yang berbeda agar perencana dapat melihatnya sebelum sif berikutnya.

4. Konfirmasi dari lantai produksi. Setiap catatan waktu dari Mobile Confirmations atau Production Timer menjadi konfirmasi di S/4HANA. Webhook SkyPlanner memicu pengiriman ProdnOrdConf2 yang memuat kuantitas hasil baik, scrap, dan waktu aktivitas. Integrasi terlebih dahulu memanggil GetConfProposal agar S/4HANA mengusulkan kuantitas, aktivitas, tanggal, dan data personel. GetGdsMvtProposal mengusulkan pergerakan barang.

Material yang akan datang. Pesanan pembelian yang masih terbuka termasuk dalam sinkronisasi masuk. SkyPlanner menganggap material yang dipesan tersedia pada perkiraan tanggal pengiriman yang tercantum di PO. Pekerjaan yang menunggu komponen yang dibeli dijadwalkan pada hari kedatangan material, tanpa terhambat oleh jumlah stok hari ini.

S/4HANA tetap menjadi sumber data acuan untuk penerimaan: saat penerimaan barang dibukukan, stok bertambah dan jumlah yang belum diterima pada item PO berkurang. Sinkronisasi berikutnya memperbarui stok di SkyPlanner dan memberi status Delivered pada PO yang telah diterima seluruhnya. Setelah penerimaan sebagian, sisa jumlah yang belum diterima tetap tercatat akan datang pada tanggal di baris jadwalnya. Penanganan pesanan pembelian di SkyPlanner dijelaskan dalam dokumentasi SkyPlanner.

5. Aturan tanggung jawab data. S/4HANA mengelola kuantitas, BOM, routing, perhitungan biaya, dan status. SkyPlanner mengelola urutan, penetapan stasiun kerja, dan tanggal operasi. Jangan pernah membiarkan kedua sistem menulis ke kolom yang sama. Jika perencana masih memindahkan operasi di Capacity Scheduling Board, tentukan perubahan mana yang diutamakan. Pilihannya: sinkronisasi perintah berikutnya membawa perubahan tersebut ke SkyPlanner, atau work center itu tetap berada di luar lingkup SkyPlanner.

• Penulisan kembali dilakukan melalui pemanggilan tindakan dengan ETag. Cara yang didokumentasikan untuk menjadwalkan operasi adalah ScheduleProductionOrderOperation, bukan PATCH pada A_ProductionOrderOperation_2. Mode F menjadwalkan maju dari waktu mulai dan B menjadwalkan mundur dari waktu selesai, sedangkan K dan S mempertahankan tanggal yang ada dan mengabaikan tanggal yang Anda kirim. ETag dalam if-match dibentuk dari LastChangeDateTime order (YYYYMMDDHHMMSS), sehingga setiap perubahan pada order membuat ETag tersebut tidak lagi berlaku. Terapkan pembacaan sebelum penulisan dan antrean percobaan ulang.
• Kapasitas tidak tersimpan di header work center. Kapasitas tersedia ditentukan oleh kategori kapasitas (001 mesin, 002 tenaga kerja), kalender pabrik, serta interval dan sif yang menggantikan ketentuan kalender tersebut. Rumus kapasitas mengubah nilai standar routing menjadi kebutuhan penyiapan, pemrosesan, dan pembongkaran. Baca A_WorkCenterCapacityInterval_2 dan entitas sif, lalu sepakati cara mengonversi rumus menjadi durasi di SkyPlanner.
• Nilai standar perlu dibenahi. Routing yang dipelihara untuk perhitungan biaya sering memuat waktu persiapan rata-rata atau mencatat persiapan pada kategori kapasitas yang salah.
• Aturan konfirmasi bersifat ketat. SAP merekomendasikan pemanggilan batch untuk pembukuan massal. Satu change set harus berhasil seluruhnya atau gagal seluruhnya, sehingga satu catatan waktu yang tidak valid akan memblokir seluruh catatan lain dalam set tersebut. Pembatalan dalam batch harus dijalankan dengan urutan ConfirmationCount terbalik. Anda tidak dapat mencampur jenis konfirmasi pada satu order, membukukan pergerakan barang tanpa konfirmasi, atau mengonfirmasi operasi yang titik pemicunya memerlukan kotak dialog.
• Periksa apakah PP/DS aktif. PP/DS terintegrasi memerlukan aktivitas Customizing Activate Advanced Planning and Scheduling dan SAP HANA integrated liveCache. SAP menjualnya sebagai produk terpisah, yaitu SAP S/4HANA Manufacturing for planning and scheduling. Jika fitur ini aktif, tentukan sistem penjadwal untuk setiap material: material yang ditandai untuk perencanaan lanjutan menjadi tanggung jawab PP/DS. Untuk API planned order, SAP juga menyatakan: “Automatic integration to PP/DS is not enabled from this API.” (Integrasi otomatis ke sistem tersebut tidak diaktifkan melalui API ini.)
• Satuan ukur. Kuantitas operasi, kuantitas dasar routing, dan satuan konfirmasi bisa berbeda. Lakukan konversi secara eksplisit menggunakan satuan operasi, bukan satuan dasar material.
• Perbedaan antaredisi. SAP Learning menunjukkan bahwa tabel perencanaan klasik CM21/CM22 digantikan oleh Manage Work Center Capacity, Capacity Scheduling Table, dan Capacity Scheduling Board. Public Edition hanya menyediakan API melalui communication scenarios, dan versi layanan yang tersedia dapat berbeda dari versi on-premise. API routing tidak dapat menghapus routing atau memperbarui penetapan material. Saat penentuan lingkup, tim SkyPlanner menetapkan versi layanan untuk setiap sistem pelanggan dengan merujuk pada entri API Business Accelerator Hub untuk rilis tersebut.
• Batasan yang tidak tercakup dalam routing. Kelola changeover yang bergantung pada urutan, benturan penggunaan alat, dan operasi dengan beberapa operator di SkyPlanner, bukan dalam nilai standar routing. Matriks waktu persiapan menyimpan waktu changeover untuk setiap pasangan produk. Ketersediaan alat dari PRT perintah terbatas: alat hanya dapat digunakan di satu stasiun kerja pada satu waktu, sementara satu operasi dapat memerlukan beberapa orang sekaligus.