Panduan Integrasi Business Central untuk Penjadwalan Produksi dengan SkyPlanner APS

Integrasi ini menggunakan dua antarmuka yang sudah tersedia di Business Central:

1. API v2.0 untuk data komersial dan persediaan. API ini menyediakan akses ke items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers, dan employees. API ini tidak menyediakan entitas manufaktur, sehingga data produksi diakses melalui antarmuka kedua.
2. Layanan web OData v4 untuk manufaktur. Setiap halaman Business Central dapat dipublikasikan sebagai layanan web OData v4 melalui halaman Web Services. Pilih jenis objek Page, ID halaman, dan nama layanan, lalu pilih Published. Endpoint langsung aktif, tanpa perlu kode AL atau menerapkan ekstensi. Integrasi ini memublikasikan halaman standar untuk perintah produksi yang telah dirilis, Prod. Order Routing Lines, work center, machine center, dan routing, yang dapat diakses melalui /ODataV4/Company('{name}')/{ServiceName}.

Halaman yang dipublikasikan mendukung pembacaan dan penulisan data. Menurut Microsoft: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (Jika halaman yang dapat diedit diekspos sebagai layanan web, data pada tabel yang mendasarinya dapat diakses dan diubah melalui panggilan OData), dengan PATCH untuk pembaruan. Dengan cara inilah tanggal yang direncanakan dikirim kembali ke Business Central, melalui halaman dan validasi yang sama dengan yang digunakan perencana.

Jangan gunakan SOAP. Microsoft tidak lagi menyarankan penggunaan layanan web SOAP, dan kemampuan memublikasikan halaman UI Microsoft sebagai SOAP dihapus pada 2026 release wave 2 (v29).

Business Central mendukung langganan webhook melalui POST /api/v2.0/subscriptions untuk entitas API v2.0 seperti items dan salesOrders. Berikut ketentuannya:

• Pembuatan langganan memerlukan handshake: endpoint Anda harus mengembalikan validationToken dengan status 200 OK.
• Langganan kedaluwarsa setelah tiga hari. Perpanjang dengan PATCH, dan proses handshake akan dijalankan kembali.
• Notifikasi berisi path sumber daya, changeType, dan clientState Anda, bukan seluruh rekaman data. Rekaman tersebut dibaca setelahnya.
• Notifikasi dikirim dengan jeda: Business Central online menunggu 30 detik setelah perubahan pertama. Jika lebih dari 1.000 rekaman berubah dalam rentang waktu tersebut, semuanya dikirim sebagai satu notifikasi collection.
• Maksimum 200 langganan webhook per lingkungan online.

Polling perintah produksi, baris routing, dan pesanan pembelian dilakukan setiap beberapa menit melalui halaman yang dipublikasikan dan purchaseOrders. Dengan memfilter hanya pesanan terbuka dan menggunakan paginasi, jumlah permintaan tetap jauh di bawah batas Business Central.

SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan kembali data dipicu oleh event.

1. Pemuatan awal master data. Ambil routing dan BOM produksi berstatus Certified, work center, serta machine center dari halaman yang dipublikasikan. Ambil item dan satuan ukur dari API v2.0. Tentukan dengan cermat pemetaan setiap work center atau machine center ke stasiun kerja SkyPlanner: putuskan apakah work center dengan tiga machine center akan menjadi satu kelompok stasiun kerja atau tiga stasiun kerja.

2. Sinkronisasi order. Baca order produksi berstatus Released (dan Firm Planned jika Anda menjadwalkannya), beserta baris routing dan komponennya, dari halaman yang dipublikasikan. Ambil juga baris order pembelian yang masih terbuka dari API v2.0. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered. Dengan demikian, penjadwalan memperhitungkan stok maupun pembelian yang akan datang.

Jangan pernah menjadwalkan order produksi berstatus Planned. Menurut Microsoft, Business Central “deletes them the next time you run planning.” (menghapusnya saat Anda menjalankan perencanaan berikutnya). Planning Worksheet tetap mengusulkan pasokan, sedangkan SkyPlanner menjadwalkan order yang sudah pasti berdasarkan kapasitas nyata.

3. Penulisan kembali jadwal. Halaman standar Prod. Order Routing dipublikasikan sebagai layanan web OData v4. Untuk setiap operasi yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner mengirim PATCH ke baris routing tersebut dengan ETag If-Match. PATCH menetapkan Starting Date-Time dan Ending Date-Time, serta Type dan No. jika operasi dipindahkan ke mesin alternatif.

PATCH menjalankan trigger halaman dan tabel, sehingga Business Central memvalidasi field dengan logikanya sendiri, persis seperti saat perencana mengedit halaman Prod. Order Routing. Starting dan Ending Date-Time pada baris order produksi ikut diperbarui. Kuantitas, status, dan biaya tetap dikelola oleh Business Central.

4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer. Catatan waktu kerja ini menjaga jadwal tetap mutakhir. Hasil produksi tetap dapat dilaporkan di Business Central seperti sebelumnya, melalui Production Journal atau Output Journal.

Jika Anda ingin hasil produksi dan konsumsi material dibukukan sepenuhnya secara otomatis, sebuah halaman API standar Business Central ditambahkan untuk pembukuan jurnal hasil produksi. SkyPlanner kemudian membukukan waktu setup, waktu proses, dan kuantitas hasil produksi per operasi. Pembukuan memperbarui Capacity Ledger Entries, dan hasil produksi pada operasi routing terakhir menambahkan item ke persediaan.

Pilih satu saluran untuk pembukuan hasil produksi. Pembukuan dari SkyPlanner sekaligus dari Production Journal di Business Central akan menghasilkan entri ganda.

5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:

Sumber konflik utama adalah tindakan Refresh dan Replan pada order produksi. Menurut Microsoft: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Jika Anda menggunakan tindakan Refresh untuk menghitung ulang baris order produksi, Business Central menghapus baris yang ada dan menghitung baris baru.) Replan juga dapat mengubah kebutuhan kapasitas, dan penghitungan ulang komponen “deletes previous changes in the components.” (menghapus perubahan sebelumnya pada komponen).

Perlakukan order yang telah di-refresh sebagai versi baru, sinkronkan ulang, lalu biarkan SkyPlanner menjadwalkannya kembali. Dengan Autopilot, SkyPlanner menjadwalkan ulang secara otomatis saat terjadi perubahan produksi.

• Satuan dalam routing. Setup Time berlaku per order produksi, sedangkan Run Time berlaku per item yang diproduksi. Masing-masing memiliki Unit of Measure Code sendiri. Wait Time dan Move Time tidak memakai kapasitas work center. Jika satuan work center adalah Days, satu hari berarti 24 jam, bukan shift delapan jam. Konversikan satuan saat impor; jika tidak, semua durasi akan salah.
• Kalender yang tidak mutakhir. Kapasitas baru tersedia setelah Calculate Work Center Calendar dijalankan untuk rentang waktu perencanaan. Periksa field Calendar Entries Available Until sebelum pemuatan awal.
• Kapasitas machine center tersembunyi. Saat Consolidated Calendar dinonaktifkan, hanya kapasitas work center itu sendiri yang direncanakan: “The machine center capacity is excluded.” (Kapasitas machine center tidak disertakan.) Baca kapasitas machine center secara langsung, jangan hanya mengandalkan total kapasitas work center.
• Capacity dan Efficiency. Business Central menghitung durasi dengan rumus Run Time / Efficiency / Capacity, dan entri kalender hasil perhitungan sudah memperhitungkan keduanya. Petakan Efficiency ke efisiensi stasiun kerja SkyPlanner satu kali saja, bukan dua kali.
• Alternate Work Center hanya sebagai informasi. Menurut Microsoft, field ini “isn’t automatically included in planning processes.” (tidak otomatis disertakan dalam proses perencanaan). Modelkan alternatif tersebut secara eksplisit sebagai stasiun kerja alternatif di SkyPlanner.
• Pembatasan laju permintaan. Batas layanan online berlaku per pengguna, dan satu service principal dihitung sebagai satu pengguna: 6.000 permintaan OData dalam jendela bergulir 5 menit dan 5 permintaan bersamaan. Ukuran halaman dibatasi hingga 20.000, satu $batch hingga 100 operasi, dan operasi mengalami timeout setelah 8 menit. Jika batas laju terlampaui, responsnya adalah 429. Gunakan batch, paginasi, dan polling perubahan, bukan memuat ulang seluruh data.
• Lisensi. Fitur manufaktur hanya tersedia dalam mode Premium. Pengguna Essentials tidak dapat masuk ke perusahaan yang diatur ke Premium.