Panduan Integrasi Fulcrum untuk Penjadwalan Produksi dengan SkyPlanner APS

Fulcrum merupakan satu produk cloud multitenant, sehingga semua pelanggan menggunakan API yang sama. Portal pengembang menjelaskannya sebagai API publik untuk “REST API calls directly into your Fulcrum site.” (panggilan REST API langsung ke situs Fulcrum Anda).

• Spesifikasi. OpenAPI “Fulcrum PublicAPI” v1, dapat diunduh di https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum menyarankan untuk menghasilkan kode klien dengan tipe data yang terdefinisi dari spesifikasi ini. Halaman History mencantumkan setiap perubahan beserta tanggalnya.
• Host. https://api.fulcrumpro.com untuk situs standar. Situs ITAR menggunakan api.fulcrumpro.us, dan token ITAR akan menerima respons 401 pada host .com.
• Pola permintaan. Daftar diambil melalui POST .../list dengan filter dalam body, paginasi menggunakan Skip dan Take, serta pengurutan menggunakan Sort.Field / Sort.Dir. Banyak objek menerima PUT, dan job juga menerima JSON Patch.

Endpoint yang digunakan untuk integrasi penjadwalan:

Halaman integrasi Fulcrum sendiri menjelaskan pekerjaan yang diperlukan secara lugas: “Every system is a little bit different and requires some configuration.” (Setiap sistem sedikit berbeda dan memerlukan penyesuaian konfigurasi.) Konfigurasi inilah yang ditangani tim SkyPlanner selama onboarding.

Fulcrum mendukung webhook yang dikonfigurasi oleh admin. Sejak September 2026, webhook yang gagal dijeda dan diuji ulang setiap hari, bukan terus dicoba tanpa henti. API History mencantumkan event seperti PurchaseOrderUpdated dan ItemUpdated.

Integrasi membaca data Fulcrum dengan cara berikut:

• Job terbuka difilter berdasarkan status scheduled dan inProgress dengan hasIncompleteOperations: true, lalu dibaca melalui polling setiap beberapa menit. Filter ini disediakan oleh Fulcrum sendiri agar hasilnya sesuai dengan halaman jadwalnya.
• Pesanan pembelian dan persediaan dibaca sebelum setiap proses penjadwalan, atau saat webhook PurchaseOrderUpdated diterima jika webhook tersebut telah dikonfigurasi.
• Item, routing, peralatan, dan shift dibaca saat ada perubahan, atau setiap malam.

Untuk arah sebaliknya, webhook SkyPlanner mengirimkan perubahan jadwal begitu terjadi, sehingga penulisan balik dipicu oleh event.

1. Pemuatan awal master data. Ambil data item, material, routing, work center, dan peralatan, lalu shift departemen dan waktu henti. Setiap work center Fulcrum menjadi grup stasiun kerja SkyPlanner dengan peralatannya sebagai anggota. Peralatan yang dipilih pada setiap operasi routing menjadi stasiun kerja yang diizinkan untuk operasi tersebut. Peralatan Unlimited Capacity seperti oven dan bilik pengecatan menjadi job batch.

2. Sinkronisasi pesanan. Baca job terbuka beserta item yang akan diproduksi dan operasinya, serta pesanan pembelian terbuka dan persediaan. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered. Setiap kali jadwal disusun ulang, stok dan material dari pembelian yang akan diterima diperiksa.

3. Penulisan balik jadwal. Fulcrum menghitung sendiri scheduledStartUtc, scheduledEndUtc, dan scheduledEquipmentId, lalu mengembalikannya sebagai data yang hanya dapat dibaca. Pembaruan operasi menerima customFields. SkyPlanner menulis waktu mulai dan selesai yang direncanakan serta stasiun kerja ke field kustom pada setiap operasi job, dan waktu selesai yang direncanakan ke field kustom pada job. Tim penjualan dan pembelian dapat melihat tanggal dari SkyPlanner pada job di Fulcrum.

4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan di SkyPlanner menggunakan Mobile Confirmations, Production Timer, atau Quick Log Mode. SkyPlanner mengirimkan waktu kerja ke Fulcrum melalui /api/job-tracking-timers/start dan /stop, atau sebagai blok waktu yang sudah selesai melalui /api/timers. Jumlah hasil produksi dikirim melalui add-quantity-completed, sedangkan jumlah akhir beserta scrap dikirim melalui complete. Perhitungan biaya job di Fulcrum tetap diperbarui secara langsung.

5. Aturan kepemilikan data dan penanganan konflik. Penjadwal Fulcrum “dictates the order of operations in Job Tracking.” (menentukan urutan operasi di Job Tracking). Karena itu, pilih satu saluran penugasan untuk setiap operasi: antrean operator SkyPlanner atau Fulcrum Job Tracking. Dokumentasikan aturannya sebelum mulai digunakan:

• Tenaga kerja tercermin dalam jumlah per shift. Max Equipment per shift di Fulcrum “is usually determined by how many people you have working in a certain area at that time.” (biasanya ditentukan oleh jumlah orang yang bekerja di area tertentu pada saat itu). Setiap operator beserta namanya dan shift kerjanya diatur di SkyPlanner. Nama operator diperoleh dari data pengguna di /api/users.
• Penjadwalan dilakukan pada peralatan. Work center di Fulcrum merupakan kelompok peralatan yang dapat saling menggantikan. Pastikan pilihan peralatan pada routing akurat, karena pilihan tersebut menjadi alternatif yang akan dipilih oleh mesin penjadwalan.
• Work order mengelompokkan job. Sebuah work order mengelompokkan operasi dari beberapa job, misalnya dalam satu nest. Saat timer dijalankan pada operasi yang dikelompokkan, yang dimulai adalah timer work order, dan timer ini mencakup setiap operasi job dalam kelompok tersebut.
• Batasan timer. Blok waktu yang dicatat secara retroaktif melalui /api/timers “may not be in the future, older than 30 days, or longer than 7 days.” (tidak boleh bertanggal di masa depan atau melampaui batas usia maupun durasi yang disebutkan). Kirim catatan waktu kerja saat operator mencatatnya.
• Format waktu berbeda. Shift menggunakan waktu lokal dalam format HHmm, waktu henti dan tanggal terjadwal menggunakan UTC, sedangkan estimasi operasi dinyatakan dalam detik.
• Pembaruan peralatan mengganti seluruh rekaman data. Permintaan PUT untuk peralatan akan mengosongkan setiap field yang tidak disertakan. SkyPlanner membaca data peralatan dan tidak pernah menulisnya.
• Instalasi ITAR. Gunakan host .us dan token ITAR.