Panduan Integrasi Senior ERP untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Senior ERP ini menjelaskan kepada mitra dan tim TI cara menghubungkan Senior ERP dari Senior Sistemas (Gestão Empresarial | ERP XT dengan Senior X) ke SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan Senior ERP melalui antarmuka milik Senior:
- Data yang masuk mencakup perintah produksi (OP) beserta tahapannya, rute produksi (roteiros), sumber daya produksi dan pusat sumber daya produksi, SKU, struktur produk, stok, serta pesanan pembelian.
- Rencana waktu mulai dan selesai untuk setiap tahap OP, beserta sumber daya produksi yang dipilih untuk tiap tahap, dikirim kembali ke OP.
- Jika Anda memilihnya, catatan waktu operator dikirim kembali sebagai apontamentos de produção.
- Senior X Events Hub memberi tahu SkyPlanner saat status suatu tahap OP berubah, dan webhook SkyPlanner mengirim perubahan jadwal saat perubahan terjadi.
Tim SkyPlanner mengonfigurasi integrasi sesuai konfigurasi Senior ERP 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 Senior ERP
ERP XT merupakan sistem hibrida. Menurut dokumentasi Senior, Gestão Empresarial XT “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (menjadi sistem hibrida: sistem lokal yang terintegrasi dengan solusi cloud) (dokumentasi Senior, diterjemahkan). Sistem penjadwalan menggunakan tiga antarmuka Senior:
- Layanan web G5 (SOAP). Layanan di server Senior Anda diberi nama berdasarkan modul (com.senior.g5.co.<module>…). Setiap layanan diterbitkan dalam tiga varian WSDL: sapiens_Sync, sapiens_Async, dan sapiens_Scheduled. Layanan produksi mencakup com.senior.g5.co.mpr.pcp.ordemproducao, yang “calls the same production order generation routine” (memanggil rutin pembuatan perintah produksi yang sama) seperti pada layar ERP (dokumentasi Senior, diterjemahkan), serta layanan untuk produk (com.senior.g5.co.ger.cad.produto) dan pelaporan produksi.
- REST API Senior X Platform di api.senior.com.br, untuk domain ERP yang disediakan Senior di Senior X, seperti produk dan pesanan penjualan (dokumentasi Senior).
- Webhook Events Hub. Dibuat di Senior X melalui Tecnologia > Customização > Events Hub > Webhooks. Manufacturing menerbitkan peristiwa erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus saat status suatu tahap OP berubah (dokumentasi Senior).
Autentikasi dan akses
- Senior X Platform. Integrasi masuk dengan mengirim POST ke platform.senior.com.br pada /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, dengan pengguna dalam format user@tenant. Responsnya berisi token akses Bearer dan token penyegaran. Kunci aplikasi dapat digunakan untuk masuk melalui loginWithKey (access key, secret, tenant). Panggilan REST menyertakan header authorization dan header client_id yang mengidentifikasi aplikasi penghubung. Aplikasi tersebut didaftarkan di portal API Senior dan dikaitkan dengan peran di ERP.
- Layanan web G5. Panggilan menyertakan parameter user, password, dan encryption. Jika menggunakan token Senior X, token tersebut menggantikan password (dokumentasi Senior).
- Hak akses. Buat pengguna Senior khusus untuk integrasi, dengan akses ke data PCP, rekayasa, stok, dan pembelian yang dibaca dan ditulis oleh integrasi.
Di sisi SkyPlanner, REST API menggunakan token API pada header Authorization-Token untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan awal.
Peristiwa dan polling
Events Hub menangani peristiwa di lantai produksi: saat status suatu tahap OP berubah, webhook dikirim ke SkyPlanner dan jadwal diperbarui. Data lainnya diambil melalui polling. Untuk mendeteksi pekerjaan baru, pembacaan data dibatasi pada OP yang sudah ditetapkan dan dirilis serta perubahan terbaru. Frekuensinya ditentukan per pabrik, mulai dari setiap beberapa menit untuk OP hingga setiap jam untuk stok.
SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan balik dipicu oleh peristiwa.
Pemetaan data
| Objek Senior ERP (antarmuka) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
| SKU: produto dan derivação, satuan ukur (layanan web G5 atau entitas Senior X) | Produk dan material | Senior → SkyPlanner | Pemuatan awal, lalu polling |
| Struktur produk (engenharia do SKU) | Struktur produk, subproduk, material per produk | Senior → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Roteiro dengan estágios: urutan, ketergantungan pada tahap sebelumnya | Langkah proses sesuai urutan | Senior → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Stasiun kerja, durasi, waktu persiapan dan pembongkaran, efisiensi | Senior → SkyPlanner | Pemuatan awal, jarang dilakukan setelahnya |
| Centro de recurso | Kelompok stasiun kerja | Senior → SkyPlanner | Pemuatan awal, lalu jarang diperbarui |
| Calendário: Feriados, kalender produksi per sif | Sif dan hari nonkerja | Senior → SkyPlanner | Setiap hari, atau kelola sif sendiri di SkyPlanner |
| Ordens de produção (Firme, Liberada) beserta tahap dan material | Perintah dan job beserta tenggat serta kebutuhan material | Senior → SkyPlanner | Polling setiap beberapa menit |
| Status tahap OP (Events Hub orderProductionStageChangeStatus) | Progres job | Senior → SkyPlanner | Langsung melalui webhook |
| Estoque per SKU | Saldo stok | Senior → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Ordens de compra beserta tanggal pengiriman | Pesanan pembelian, material masuk berdasarkan tanggal pengiriman | Senior → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Tahap OP: rencana waktu mulai dan selesai, sumber daya produksi | Rencana waktu mulai dan selesai per job, stasiun kerja yang ditetapkan | SkyPlanner → Senior | Saat jadwal berubah, melalui webhook SkyPlanner |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, tanggal dan waktu mulai serta selesai | Catatan waktu dan konfirmasi operator | SkyPlanner → Senior | Per konfirmasi atau per sif, jika dipilih |
| Tidak ada di Senior ERP | Matriks waktu persiapan, alat sebagai sumber daya produksi berkapasitas terbatas, job dengan beberapa operator, serta mesin dan personel alternatif | Dikelola di SkyPlanner | Disiapkan selama proses orientasi |
Pola integrasi
1. Pemuatan awal master data. Baca SKU, struktur, roteiros, recursos, centros de recurso, dan kalender produksi. Tentukan pemetaan pusat sumber daya produksi dengan cermat: centro de recurso dengan empat mesin menjadi satu kelompok stasiun kerja atau empat stasiun kerja. Konversikan Fator de carga menjadi efisiensi stasiun kerja SkyPlanner atau menjadi sif, bukan keduanya.
2. Sinkronisasi OP. Baca OP berstatus Firme dan Liberada beserta tahap dan materialnya, serta pesanan pembelian yang masih terbuka. OP berstatus Planejada masih dapat diubah atau dihapus oleh MRP, jadi jadwalkan hanya jika Anda menginginkan gambaran produksi ke depan. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered.
3. Penulisan balik jadwal. Saat mesin penjadwalan menempatkan atau memindahkan suatu tahap, webhook SkyPlanner memicu penulisan balik. Proses ini menetapkan rencana waktu mulai dan selesai setiap tahap OP beserta sumber daya produksi yang dipilih, yaitu kolom yang sama dengan yang diedit perencana di Programação de produção. Tim SkyPlanner menyepakati layanan web yang akan digunakan bersama Anda dan mitra Senior Anda saat penentuan lingkup.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktunya menjaga jadwal tetap mutakhir. Anda menentukan apakah waktu aktual dikirim kembali ke Senior. Jika ya, setiap konfirmasi menjadi apontamento de produção pada tahap OP, dengan jumlah yang diproduksi, jumlah produk afkir, serta waktu mulai dan selesai. Senior hanya menerima laporan produksi untuk OP berstatus Liberada atau Andamento. Jika pelaporan dilakukan melalui Fábrica ao Vivo, SkyPlanner membaca progres melalui Events Hub sebagai gantinya.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| SKU, struktur, roteiros, jumlah dan status OP | Senior ERP |
| Urutan tahap, waktu mulai dan selesai, penetapan sumber daya produksi | SkyPlanner |
| Matriks waktu persiapan, kebutuhan alat dan operator, sumber daya produksi alternatif | SkyPlanner |
| Kalender produksi dan sif | Satu sistem, dipilih saat penentuan lingkup |
| Apontamentos, pergerakan stok, perhitungan biaya | Senior ERP, dimasukkan langsung atau dikirim dari catatan waktu SkyPlanner |
Tentukan satu sistem yang berwenang memperbarui tanggal tiap tahap. Jika perencana masih mengurutkan OP yang sama di Programação de produção atau diagram Gantt, sepakati OP mana yang dikelola SkyPlanner.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu setelah proses orientasi dimulai. Sebelumnya, validasi jadwal selama uji coba gratis 30 hari menggunakan sumber daya produksi, roteiros, dan OP terbuka yang diekspor dari Senior dalam format CSV atau Excel.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, dan apakah apontamentos dikirim kembali.
- Akses Senior. Buat pengguna integrasi, daftarkan aplikasi di portal API Senior, lalu aktifkan layanan web G5 dan webhook Events Hub. Lakukan pengujian di lingkungan uji terlebih dahulu.
- Pemuatan awal. SKU, struktur, roteiros, recursos, centros de recurso, kalender.
- Sinkronisasi OP dan pesanan pembelian. Polling dengan filter dan mekanisme percobaan ulang, serta webhook status tahap.
- Pengaturan batasan di SkyPlanner. Matriks waktu penyiapan, perkakas, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan balik jadwal. Tanggal tahap dan sumber daya produksi dari webhook SkyPlanner, serta apontamentos jika dipilih.
- Pengujian paralel. Jalankan SkyPlanner bersamaan dengan rencana yang digunakan saat ini, bandingkan tanggalnya, lalu perbaiki master data.
- Mulai digunakan. Aktifkan penulisan balik setelah data cocok.
Hal yang perlu direncanakan dalam integrasi Senior ERP
- Empat jenis waktu sumber daya produksi. Recurso menyimpan waktu proses, persiapan, muat dan bongkar, serta pemindahan. Waktu muat dan pemindahan bisa merupakan waktu penanganan material, bukan waktu mesin. Tentukan pemetaan setiap jenis waktu untuk tiap sumber daya produksi; jika tidak, semua durasi akan keliru.
- Satu waktu persiapan per sumber daya produksi. Tempo setup di Senior berupa satu nilai. Susun matriks waktu persiapan di SkyPlanner berdasarkan pergantian produksi yang sebenarnya selama proses orientasi.
- Varian produk. SKU di Senior merupakan gabungan produk dan derivação, dan roteiros dapat berbeda untuk setiap varian. Sertakan kode derivação dalam kunci produk SkyPlanner.
- Status OP. Hanya OP berstatus Liberada dan Andamento yang dapat menerima laporan produksi. Tetap lakukan perubahan status di Senior dan biarkan SkyPlanner mengikutinya melalui Events Hub.
- Penerapan hibrida. Layanan web G5 berjalan di server Senior Anda, sedangkan Events Hub berjalan di Senior X. Rencanakan akses jaringan untuk keduanya.
- Format angka. Layanan web Senior menolak angka dengan pemisah ribuan dan mengharuskan penggunaan koma desimal. Kirim angka dalam format tersebut.
Siapa yang mengonfigurasi dan mendukung integrasi Senior ERP
- Tim SkyPlanner mengonfigurasinya selama onboarding dan memberikan dukungan setelah mulai digunakan, mencakup layanan web, API Senior X, dan webhook Events Hub yang telah disepakati. Setiap pabrik menggunakan Senior ERP dengan cara berbeda, dan di sinilah keahlian tersebut diterapkan.
- Mitra Senior Anda dapat ikut terlibat. Mitra memahami konfigurasi, kustomisasi, dan lisensi Anda, serta dapat menyiapkan pengguna integrasi, pendaftaran di portal API, dan layanan web bersama tim SkyPlanner.
- Pengembang internal Anda dapat mengembangkannya lebih lanjut melalui REST API SkyPlanner dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu saat diperlukan. Dokumentasinya tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, sudah termasuk 5 stasiun kerja, dengan tagihan bulanan. Penawaran biaya integrasi diberikan di awal sesuai proses dan kebutuhan Anda, bersamaan dengan paket langganan Anda. Lihat harga, penjadwalan produksi sesuai kapasitas mesin dan tenaga kerja di Senior ERP, halaman Senior ERP, dan pusat informasi integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“Dengan SkyPlanner, kami beralih dari perencanaan produksi menggunakan spreadsheet 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 tiga bulan di seluruh stasiun kerja membutuhkan waktu kurang dari 30 menit.
1.000-anperintah kerja dijadwalkan secara otomatis
“Kini kami mengendalikan produksi dengan cara yang berbeda, dan kami memahami kapasitas dengan jauh lebih baik.”
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.
Lebih sedikitpenghentian produksi akibat kekurangan material
“Manfaat SkyPlanner bagi kami adalah alat ini benar-benar membantu pekerjaan sehari-hari, terutama dalam menetapkan tanggal pengiriman.”
Tommi Männistö, Manajer Perencanaan Produksi
Eskomatic · Jasa pemesinan berdasarkan kontrak
Penjadwalan beban kerja secara otomatis menghasilkan tanggal pengiriman yang lebih akurat, dan penghentian produksi akibat kekurangan material telah berkurang drastis.
Pertanyaan umum
Apakah Senior ERP memiliki API untuk perintah produksi?
Ya. Layanan web G5 com.senior.g5.co.mpr.pcp.ordemproducao membuat OP dengan prosedur yang sama seperti yang digunakan pada layar ERP, sementara layanan G5 lainnya menangani produk dan pelaporan produksi. Senior X Platform menambahkan REST API dengan login menggunakan token Bearer serta webhook Events Hub.
Apakah Senior ERP mendukung webhook?
Ya. Senior X Events Hub mengirim webhook, termasuk orderProductionStageChangeStatus saat status suatu tahap OP berubah. SkyPlanner menggunakannya untuk memantau progres di lantai produksi secara real-time, dan webhook SkyPlanner sendiri mengirimkan kembali perubahan jadwal.
Bagaimana tanggal yang direncanakan ditulis kembali ke Senior ERP?
SkyPlanner menetapkan rencana waktu mulai dan selesai setiap tahap OP beserta sumber daya produksi yang dipilih untuk tahap tersebut. Data ini mengisi kolom yang sama dengan yang diedit perencana di Programação de produção. Setiap kali jadwal berubah, webhook SkyPlanner memicu penulisan kembali melalui jalur yang ditetapkan tim SkyPlanner untuk instalasi Senior Anda saat penentuan lingkup dalam proses onboarding.
Apakah integrasi ini dapat digunakan dengan Senior X dan ERP XT?
Ya. ERP XT berjalan di server Anda dengan layanan cloud di Senior X. Integrasi ini menggunakan layanan web G5 di server serta API Senior X dan Events Hub di cloud.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor CSV atau Excel dari Senior, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
