Panduan Integrasi Sylob ERP untuk Penjadwalan Produksi dengan SkyPlanner APS

Sylob mendokumentasikan dua REST API publik: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (Sylob ERP menyediakan dua jenis REST API publik, yang juga disebut webservices, untuk membaca dan menulis data.) (Basis pengetahuan Forterro)

1. API REST Système d’information (baca). API ini menjalankan kueri tersimpan (requête) yang dibuat dalam aktivitas “Interroger le système d’information”. URL untuk memanggil kueri tersebut diperoleh dari “Autres actions” > “Afficher le web service”, dengan format /rest/query/{identifiantQuery}/resultat. Parameter mengatur batas hasil, format angka, variabel kueri, dan struktur hasil. Secara default, hasil dikembalikan dalam format XML, atau dalam JSON jika menggunakan header Accept: application/json. API ini sudah termasuk dalam ERP.
2. API REST Action (baca dan tulis). API ini menjalankan tindakan yang ditentukan dalam aktivitas “Gérer les actions web service”, yaitu katalog tindakan Sylob. Tersedia dua operasi: GET /rest/v2/action/{code}/describe mengembalikan skema data suatu tindakan, sedangkan POST /rest/v2/action/{code}/execute menjalankannya dengan body JSON. Jenis tindakannya meliputi:

– Modification de données: mengubah satu atau beberapa kolom pada rekaman melalui mekanisme edit cepat Sylob. Describe mencantumkan kolom yang dapat diedit. – Message EDI: membuat, mengubah, atau menghapus rekaman melalui pesan EDI. – Scénario de saisie: menjalankan skenario entri dengan memproses pertanyaan satu per satu. Contoh dari Sylob adalah “Déclarer un début ou une fin”, untuk melaporkan awal atau akhir suatu operasi (Sylob_Action_006). – Publikasi, unggah, dan unduh dokumen.

1. Pesan EDI. Mesin EDI Sylob menangani ekspor dan impor. Pesan standar Sylob_Recup_Decl_Pro mengambil laporan produksi. (Forterro)
2. File dan ETL. Sylob ERP Cloud menawarkan “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Integrasi file melalui SFTP untuk memudahkan migrasi integrasi yang sudah ada.) (Sylob) Hasil kueri juga dapat diekspor ke Excel, yang menjadi cara cepat untuk mencoba SkyPlanner.

Basis pengetahuan publik Sylob tidak mendokumentasikan mekanisme berlangganan webhook keluar. Perubahan diteruskan ke SkyPlanner melalui polling kueri tersimpan yang memfilter OF terbuka dan perubahan terbaru, sesuai jadwal yang Anda tetapkan.

Sylob melindungi ERP dari beban kueri yang berat. Sejak rilis 2025.Q2, parameter perusahaan “Protection des API” mengaktifkan pembatasan laju per pengguna dan pembagian hasil berukuran besar ke dalam halaman. Sylob menyatakan bahwa mekanisme ini berlaku secara menyeluruh mulai rilis 2026.Q2. Respons menyertakan header RateLimit, dan panggilan yang melampaui kuota mengembalikan HTTP 429 Too Many Requests beserta nilai Retry-After. (Forterro) Rancang sinkronisasi dengan memperhitungkan hal ini: gunakan kueri inkremental, pembagian hasil ke dalam halaman, dan jeda sebelum mencoba kembali saat menerima 429.

Sebaliknya, SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan balik ke Sylob dipicu oleh event.

1. Pemuatan awal master data. Buat satu kueri tersimpan untuk setiap objek (Article, Nomenclature, Gamme, work center, karyawan), lalu baca melalui API Système d’information, atau muat sekali dari hasil ekspor Excel. Petakan work center dengan cermat. Centre de charge di Sylob merupakan kelompok sumber daya, sehingga pusat kerja dengan tiga mesin biasanya dipetakan menjadi kelompok stasiun kerja dengan tiga stasiun kerja di SkyPlanner.

2. Sinkronisasi pesanan. Baca OF yang sudah dikonfirmasi beserta operasinya, serta stok dan pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO diberi status Delivered. Dengan demikian, penjadwalan memperhitungkan stok maupun pembelian yang akan masuk.

Jadwalkan OF yang sudah dikonfirmasi, bukan usulan CBN. Usulan akan berubah saat perhitungan kebutuhan bersih dijalankan kembali.

3. Penulisan balik jadwal. Untuk setiap operasi yang ditempatkan atau dipindahkan oleh mesin penjadwalan, integrasi memanggil tindakan Modification de données pada operasi OF (Opération d’ordre de fabrication) dengan mengirimkan rencana waktu mulai, waktu selesai, dan work center. Tindakan ini menggunakan logika edit cepat Sylob, sama seperti saat perencana mengedit operasi tersebut. Describe mengembalikan daftar kolom yang dapat diedit, sehingga integrasi memvalidasi payload sebelum panggilan pertama. Jika rekaman sedang diedit oleh pengguna, panggilan akan mengembalikan kegagalan yang sudah diantisipasi; coba kembali pada perubahan berikutnya.

4. Pelaporan dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer. Waktu mulai dan selesai dikirim kembali melalui skenario “Déclarer un début ou une fin”. Catatan waktu kerja dan jumlah diubah menjadi laporan produksi pada operasi OF yang sama: waktu setup, waktu proses, jumlah yang diproduksi, produk afkir, dan status operasi selesai. Jika pabrik Anda sudah melaporkan melalui Sylob Apps atau terminal di lantai produksi, gunakan satu saluran pelaporan saja agar tidak terjadi pencatatan ganda.

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

SkyPlanner tidak memerlukan CADPLAN atau aktivitas penjadwalan produksi di Sylob yang memperhitungkan kapasitas mesin dan tenaga kerja. Tetapkan SkyPlanner sebagai pengelola tanggal operasi, karena dua sistem penjadwalan yang menulis tanggal yang sama akan saling menimpa. Setelah SkyPlanner mengelolanya, Autopilot menjadwalkan ulang secara otomatis setiap kali ada perubahan penting, lalu tanggal baru dikirim kembali ke Sylob.

• Lisensi Action API. Pembacaan melalui kueri tersimpan sudah termasuk. Penulisan melalui katalog aksi memerlukan modul “Webservice” Sylob atau lisensi API di MyForterro. Rencanakan hal ini bersama kontak Sylob Anda sebelum tahap penulisan kembali.
• Kueri menjadi kontrak integrasi Anda. Proses pembacaan bergantung pada kueri tersimpan. Beri nama yang jelas, teruskan filter sebagai atribut variabel saat kueri dijalankan, dan kelola versi kueri bersama versi integrasi.
• Kelompok work center. Satu work center Sylob dapat mencakup beberapa mesin. Tentukan untuk setiap work center apakah SkyPlanner akan melihatnya sebagai satu kelompok stasiun kerja atau sebagai mesin-mesin terpisah.
• Penjadwalan mundur dan perhitungan beban. Sylob menjadwalkan mundur dari tanggal kebutuhan, dan perhitungan beban terjadwal dapat merencanakan ulang OF yang terlambat. Sepakati aktivitas mana, jika ada, yang masih boleh menulis tanggal operasi setelah SkyPlanner mengelolanya.
• Satuan waktu setup dan waktu proses. Sebelum mengimpor, periksa satuan dan pastikan apakah setup dihitung per OF atau per unit produk. Satuan yang salah membuat semua durasi keliru.
• Kalender. Pola mingguan work center beserta pengecualiannya harus mencakup seluruh rentang penjadwalan. Jika tidak, kapasitas akan hilang dari rencana.
• Pembatasan laju permintaan. Sylob membatasi panggilan per pengguna dan membagi hasil yang besar ke dalam beberapa halaman. Polling inkremental menjaga penggunaan tetap jauh di bawah kuota.
• CORS dan peramban. Panggilan antarpeladen tidak terkendala CORS. Untuk klien peramban, origin yang diizinkan harus dikonfigurasi di sisi Sylob.