Integrasi / ERP / Acumatica Cloud ERP
Panduan Integrasi Acumatica untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Acumatica ini menjelaskan kepada mitra dan tim TI cara menghubungkan Acumatica Cloud ERP (Manufacturing Edition) dengan SkyPlanner APS. Integrasi SkyPlanner dengan Acumatica berjalan dua arah:
- Perintah produksi beserta operasinya, work center, mesin, alat, shift, item stok, dan pesanan pembelian dikirim ke SkyPlanner.
- Tanggal mulai dan selesai yang direncanakan ditulis ke operasi perintah produksi, lalu perintah tersebut dikunci.
- Catatan waktu kerja operator dikirim kembali sebagai entri tenaga kerja dan perpindahan.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Tim SkyPlanner mengonfigurasi integrasi sesuai pengaturan Acumatica Anda selama proses orientasi 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 Acumatica
Integrasi berjalan melalui antarmuka yang sudah disediakan Acumatica. Tidak ada komponen yang dipasang pada instans.
- REST API berbasis kontrak. Endpoint memiliki versi yang mengikuti rilis. Endpoint Manufacturing (misalnya 26.200.001 untuk 2026 R2) menyediakan
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntry, danMaterialEntry. Endpoint Default mencakupStockItem,PurchaseOrder, danSalesOrder. URL mengikuti pola{instance}/entity/{Endpoint}/{version}/{Entity}. - Aksi pada endpoint yang sama.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntry, danReleaseMaterialEntrymenjalankan logika yang sama dengan tombol pada layar aplikasi. - OData. Setiap Generic Inquiry (SM208000) dapat diakses melalui OData. Generic Inquiry yang memuat operasi produksi yang masih terbuka beserta tanggalnya merupakan cara tercepat untuk membaca data secara massal.
- Notifikasi push (SM302000). Berdasarkan Generic Inquiry atau kueri bawaan, notifikasi ini mengirim baris yang ditambahkan dan dihapus ke URL yang Anda konfigurasikan.
- Skenario impor dan ekspor dengan penyedia CSV dan Excel untuk pemuatan data secara massal.
Daftar entitas dan aksi tersedia di Web Service Endpoints (SM207000) serta repositori klien REST Acumatica.
Autentikasi dan batas penggunaan
Acumatica menggunakan OAuth 2.0 dan OpenID Connect melalui aplikasi klien yang terdaftar di Connected Applications (SM303010). Alur yang terdokumentasi adalah Authorization Code, Implicit, Resource Owner Password Credentials, dan Hybrid. Untuk integrasi server, daftarkan pengguna khusus integrasi dengan peran yang hanya memberikan hak akses minimum. Gunakan Authorization Code dengan refresh token, atau Resource Owner Password Credentials.
Batas penggunaan ditentukan oleh lisensi Anda: License Monitoring Console (SM604000) menampilkan jumlah permintaan API per menit dan pengguna API yang diizinkan.
Di sisi SkyPlanner, REST API menggunakan token API untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan API pertama.
Pemetaan data
| Objek Acumatica (endpoint / formulir) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produk dan material | Acumatica → SkyPlanner | Pemuatan awal, lalu hanya perubahan data |
BillOfMaterial (AM208000): material, operasi | Struktur produk, subproduk, material per produk | Acumatica → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Operasi BOM: Setup, Run, Machine, Queue, Finish, Move Time | Tahapan proses beserta durasi, waktu persiapan, dan waktu pembongkaran | Acumatica → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Stasiun kerja, kelompok stasiun kerja, efisiensi, stasiun kerja alternatif | Acumatica → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Shift dan kapasitas tenaga kerja | Acumatica → SkyPlanner | Setiap hari, atau shift dikelola di SkyPlanner |
Tool (AM205500) | Alat sebagai sumber daya produksi dengan ketersediaan terbatas | Acumatica → SkyPlanner | Pemuatan awal |
ProductionOrder beserta OrderOperationDetail (Planned, Released, In Process) | Perintah dan pekerjaan beserta tenggat, prioritas pelaksanaan, serta kebutuhan material | Acumatica → SkyPlanner | Notifikasi push atau polling setiap beberapa menit |
Baris PurchaseOrder (Default) | Pesanan pembelian beserta perkiraan tanggal pengiriman | Acumatica → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Jumlah item di gudang | Saldo stok | Acumatica → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Rencana waktu mulai, waktu selesai, dan stasiun kerja untuk setiap operasi | SkyPlanner → Acumatica | Saat jadwal berubah, melalui webhook SkyPlanner |
Aksi FirmProductionOrder | Mengunci tanggal yang telah ditulis agar tidak diubah oleh Acumatica APS | SkyPlanner → Acumatica | Setelah setiap penulisan balik |
LaborEntry, MoveEntry beserta aksi rilis | Catatan waktu kerja, jumlah yang selesai, konfirmasi operator | SkyPlanner → Acumatica | Setiap konfirmasi atau setiap shift |
| Tidak tersedia di Acumatica | Matriks waktu persiapan, operator berdasarkan nama, pekerjaan dengan beberapa operator | Dikelola di SkyPlanner | Dikonfigurasi selama proses orientasi |
Pola integrasi
1. Pemuatan awal master data. Baca data work center, mesin, alat, shift, dan kalender terlebih dahulu. Kemudian baca item stok dan BOM. Tentukan cara memetakan work center yang memiliki beberapa mesin: sebagai satu kelompok stasiun kerja dengan setiap mesin sebagai stasiun kerja, atau sebagai satu stasiun kerja saja. Basis for Capacity di Acumatica menunjukkan pendekatan yang digunakan pabrik.
2. Sinkronisasi perintah. Baca perintah produksi beserta operasinya dari perintah tersebut, bukan dari BOM. Operasi disalin ke perintah, dan perencana mengubahnya di sana. Aktifkan notifikasi push untuk Generic Inquiry yang memuat perintah dan operasi yang masih terbuka, atau lakukan polling terhadapnya. Baca juga baris pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered.
3. Penulisan balik jadwal. Untuk setiap operasi yang ditempatkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner menulis StartDate dan EndDate ke OrderOperationDetail, serta work center jika pekerjaan dipindahkan ke alternatif. Kemudian SkyPlanner memanggil FirmProductionOrder. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Saat penjadwalan produksi dijalankan dengan memperhitungkan kapasitas yang tersedia, sistem tidak menjadwalkan ulang perintah produksi yang sudah dikunci.) (sumber)
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer. Catatan waktu kerja menjadi dokumen LaborEntry (waktu dan jumlah yang selesai per operasi) atau dokumen MoveEntry (hanya jumlah), lalu dirilis dengan aksi yang sesuai. Jika pekerjaan di lantai produksi Anda sudah dilaporkan melalui Labor (AM301000) atau Shop Floor Kiosk di Acumatica, data kemajuan mengalir ke arah sebaliknya. Pilih satu saluran, jangan gunakan keduanya.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Item stok, BOM, jumlah, status perintah, perhitungan biaya | Acumatica |
| Urutan operasi, waktu mulai dan selesai, penetapan stasiun kerja | SkyPlanner |
| Matriks waktu persiapan, alat, kebutuhan operator, alternatif | SkyPlanner |
| Shift dan ketidakhadiran | Satu sistem, dipilih saat penentuan lingkup |
| Transaksi tenaga kerja dan perpindahan | Acumatica, dibukukan dari catatan waktu kerja SkyPlanner atau dimasukkan di lantai produksi |
Sumber konflik utama adalah APS bawaan Acumatica. Rough Cut Planning atau APS Maintenance Process dapat menghitung ulang tanggal pada perintah produksi yang sudah dijadwalkan SkyPlanner. Menetapkan status firm pada setiap perintah produksi setelah tanggalnya ditulis kembali mencegah hal ini. Kecualikan juga perintah produksi yang sudah dijadwalkan dari proses APS.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam beberapa minggu setelah proses orientasi dimulai. Sebelumnya, Anda dapat menjalankan uji coba gratis selama 30 hari dengan data Anda sendiri. Ekspor work center dan pesanan produksi yang masih terbuka beserta operasinya dari Generic Inquiry ke Excel, lalu impor data tersebut dan validasi jadwalnya.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, dan saluran pencatatan tenaga kerja.
- Akses. Daftarkan aplikasi yang terhubung, buat pengguna dan peran untuk integrasi, lalu pastikan versi endpoint di Web Service Endpoints. Mulai di lingkungan sandbox.
- Pemuatan data awal. Work center, mesin, alat, sif, item persediaan, dan BOM.
- Sinkronisasi pesanan. Pesanan produksi, operasi, dan pesanan pembelian melalui notifikasi push atau polling.
- Pengaturan batasan di SkyPlanner. Matriks waktu penyiapan, penetapan operator tertentu, pekerjaan dengan beberapa operator, dan alternatifnya.
- Penulisan balik. Tanggal operasi, penetapan status firm, serta pencatatan tenaga kerja atau perpindahan.
- Pengoperasian paralel. Bandingkan tanggal dari SkyPlanner dengan rencana saat ini, lalu perbaiki master data.
- Mulai beroperasi. Aktifkan penulisan balik setelah datanya sesuai.
Hal yang perlu diperhitungkan dalam integrasi Acumatica
- Pastikan mesin APS yang aktif. Classic dan Optimized menyimpan pengaturan secara terpisah, dan hanya salah satunya yang dapat diaktifkan. Periksa Enable/Disable Features (CS100000) sebelum penulisan balik pertama.
- Kunci versi endpoint. Versi merupakan bagian dari URL. Pembaruan rilis menambahkan versi baru, jadi lakukan pengujian ulang setiap kali ada pembaruan.
- Pembaruan operasi. Beberapa bidang operasi hanya dapat dibaca melalui REST, dan status pesanan juga berpengaruh. Uji urutan penulisan balik untuk pesanan berstatus Released dan In Process di lingkungan sandbox.
- Satuan dan bidang waktu. Waktu proses dihitung per Run Units, sedangkan waktu mesin per Machine Units. Waktu antre dan waktu perpindahan “affect the calculated schedule but do not occupy work center capacity.” (memengaruhi jadwal yang dihitung, tetapi tidak memakai kapasitas work center). Lakukan konversi dengan cermat saat mengimpor.
- Acuan ketersediaan material. Classic APS mengharuskan seluruh material tersedia dalam jumlah lengkap. SkyPlanner menyusun rencana berdasarkan stok dan pesanan pembelian yang akan datang sesuai tanggalnya. Sepakati hasil mana yang menjadi acuan perencana.
- Batas API. Jumlah permintaan per menit ditentukan oleh lisensi. Baca hanya data yang berubah dan gunakan notifikasi push, bukan memuat ulang seluruh data.
Siapa yang mengonfigurasi dan mendukung integrasi Acumatica
- Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah mulai beroperasi. Setiap pabrik menggunakan Acumatica dengan cara berbeda, dan pengetahuan tentang cara kerja tersebut diterapkan di sini.
- Mitra Acumatica Anda dapat ikut terlibat. Mitra Anda memahami penyesuaian, Generic Inquiries, dan peran yang Anda gunakan. SkyPlanner menyediakan REST API, dokumentasi Swagger/OpenAPI, dan webhook.
- Pengembang internal Anda juga dapat membangun integrasi melalui REST API yang sama dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan. Laboratory & Allied memilih cara ini untuk SAP Business One: sebagian besar integrasi dibangun sendiri oleh tim TI internal mereka, dengan bantuan SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, termasuk 5 stasiun kerja, dengan tagihan bulanan. Penawaran biaya integrasi disusun di awal sesuai proses dan kebutuhan Anda, bersamaan dengan paket langganan, sehingga Anda mengetahui seluruh biayanya sebelum memulai. Lihat perbandingan dengan APS bawaan Acumatica di penjadwalan produksi Acumatica sesuai kapasitas, gambaran umumnya di halaman Acumatica, serta sistem lainnya di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“Dengan SkyPlanner, kami beralih dari perencanaan produksi menggunakan lembar kerja Excel ke optimalisasi produksi secara real time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam 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 yang dioptimalkan untuk periode tiga bulan di seluruh stasiun kerja membutuhkan waktu kurang dari 30 menit.
1.000-anperintah kerja dijadwalkan otomatis
“Kini kami mengendalikan produksi dengan cara yang berbeda, dan pemahaman kami tentang kapasitas berada pada tingkat yang sama sekali berbeda.”
Hannu Ryynänen, CEO
Mamec · Mesin pencampur industri, pompa, dan manufaktur kontrak berteknologi tinggi
Ribuan perintah kerja dijadwalkan secara otomatis, dan seluruh organisasi dapat memantau produksi secara real time.
99,2%keandalan pengiriman
“SkyPlanner membuat hambatan produksi lebih mudah terlihat 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 kerja per hari.
Pertanyaan umum
Apakah API Acumatica mencakup pesanan produksi?
Ya. Endpoint Manufacturing pada REST API berbasis kontrak menyediakan akses ke ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool, serta pencatatan tenaga kerja dan perpindahan, berikut tindakan seperti FirmProductionOrder.
Siapa yang membangun integrasi Acumatica?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai pengaturan Acumatica Anda selama proses orientasi dan memberikan dukungan setelah mulai beroperasi. Mitra Acumatica atau pengembang internal Anda juga dapat membangun integrasi melalui REST API SkyPlanner yang terdokumentasi, dan token API sudah cukup untuk memulai.
Apakah kami memerlukan Acumatica APS untuk integrasi ini?
Tidak. Penjadwalan sesuai kapasitas bawaan Acumatica dijalankan melalui formulir Rough Cut Planning, sedangkan Classic APS merencanakan pesanan yang selesai setelah 120 hari dengan asumsi kapasitas tak terbatas (sumber). SkyPlanner menyusun sendiri jadwal terperinci yang memperhitungkan kapasitas berdasarkan pesanan produksi, operasi, work center, mesin, dan alat. Karena itu, integrasi tetap berjalan baik APS diaktifkan maupun tidak; menurut Acumatica, APS “is subject to licensing” (memerlukan lisensi). Autopilot menjaga jadwal tetap mutakhir, dan operator mencatat pekerjaan melalui Mobile Confirmations.
Bagaimana cara mencegah Acumatica APS menimpa tanggal dari SkyPlanner?
SkyPlanner menetapkan setiap pesanan produksi sebagai firm setelah menulis tanggal operasinya. Penjadwalan produksi Acumatica yang memperhitungkan kapasitas tidak menjadwalkan ulang pesanan berstatus firm.
Apakah Acumatica dapat mengirim perubahan secara real time?
Ya. Push notifications (SM302000) pada Generic Inquiry mengirim baris yang berubah ke suatu URL begitu perubahan terjadi. Webhook bawaan SkyPlanner mengirim perubahan jadwal ke arah sebaliknya.
Autentikasi apa yang sebaiknya digunakan untuk integrasi ini?
OAuth 2.0 melalui klien yang terdaftar di Connected Applications (SM303010), dengan pengguna khusus integrasi dan peran yang hanya memiliki hak akses minimum yang diperlukan. Alurnya dipastikan sesuai instans Anda saat penentuan lingkup.
Apakah kami dapat menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor Excel atau CSV dari Generic Inquiry Acumatica, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
