Panduan Integrasi monday.com untuk Penjadwalan Produksi dengan SkyPlanner APS

monday.com menyediakan satu GraphQL API di POST https://api.monday.com/v2. Versi baru dirilis setiap triwulan, dan Anda menetapkan versi yang digunakan melalui header API-Version. Penghentian dukungan diumumkan setidaknya enam bulan sebelumnya. (Pengelolaan versi API)

Objek yang digunakan dalam integrasi penjadwalan:

• Boards dan groups, yang sering digunakan untuk mewakili tahap atau minggu.
• Items dan subitems. Item biasanya mewakili pesanan atau job, sedangkan subitem memuat operasi.
• Column values: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards, dan Mirror.
• Webhook untuk peristiwa perubahan.

Pembacaan menggunakan items_page di dalam board atau group. Secara default, setiap halaman berisi 25 item dan “the maximum is 500.” (itulah jumlah maksimum item). Pembacaan dilanjutkan dengan next_items_page, dan “each cursor will expire 60 minutes after the first request.” (setiap kursor kedaluwarsa setelah durasi tersebut, dihitung sejak permintaan pertama). Gunakan filter query_params untuk membaca hanya pesanan yang masih terbuka. (items_page)

Penulisan menggunakan create_item, create_subitem, change_column_value, dan change_multiple_column_values. Fungsi terakhir memperbarui beberapa kolom pada satu item dalam sekali pemanggilan, sesuai kebutuhan penulisan balik jadwal.

Untuk pemuatan data dalam jumlah besar, API versi 2026-07 dan setelahnya menambahkan ingest_items dan backfill_items. Anda mengunggah CSV ke URL yang telah ditandatangani, lalu memeriksa status proses secara berkala. (Impor massal)

Buat langganan dengan create_webhook(board_id, url, event, config). Berikut peristiwa yang dibutuhkan dalam integrasi penjadwalan:

• create_item dan create_subitem untuk pesanan dan operasi baru.
• change_column_value atau change_specific_column_value untuk perubahan tenggat, jumlah, atau prioritas.
• change_status_column_value untuk perubahan status yang dilakukan pengguna.
• item_archived, item_deleted, dan item_moved_to_specific_group untuk pesanan yang dibatalkan atau diselesaikan.

URL penerima harus merespons token verifikasi saat webhook dibuat. Pengiriman yang gagal mengikuti ketentuan “retry once a minute for 30 minutes,” (percobaan diulang setiap menit selama jangka waktu tersebut), lalu percobaan dihentikan. Karena itu, integrasi juga membaca data secara berkala untuk rekonsiliasi menggunakan items_page dengan filter pada item yang baru diperbarui. (Webhook)

Untuk arah sebaliknya, SkyPlanner mengirim webhook ketika status atau jadwal berubah. Layanan integrasi menerimanya dan menulis tanggal baru ke monday.com, sehingga penulisan balik dipicu oleh peristiwa.

1. Pemuatan awal master data. Baca produk, material, dan pesanan yang masih terbuka dengan items_page. Buat stasiun kerja, sif, dan batasan di SkyPlanner, atau impor dari Excel. Tentukan sejak awal apakah operasi akan disimpan sebagai subitem atau di board yang ditautkan.

2. Sinkronisasi pesanan. Webhook di board produksi mengirim item baru dan item yang berubah ke SkyPlanner sebagai pesanan. Jika Anda melacak pesanan pembelian di board, SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman dan memperbarui stok saat PO ditandai Delivered.

3. Penulisan balik jadwal. Untuk setiap pesanan yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, integrasi memanggil change_multiple_column_values. Integrasi mengisi kolom Timeline dengan waktu mulai dan selesai yang direncanakan serta mengisi kolom stasiun kerja. Satu pemanggilan per item menjaga jumlah permintaan tetap rendah.

4. Progres di lantai produksi. Operator mencatat pekerjaan melalui Mobile Confirmations, Production Timer, atau Quick Log Mode. Catatan waktu menjaga jadwal tetap mutakhir, dan label Status yang sesuai dikirim kembali ke board, sehingga tim penjualan dapat melihat progres tanpa perlu bertanya.

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

Sumber konflik utama adalah pengguna yang mengedit kolom Timeline secara manual. Sepakati bahwa hanya SkyPlanner yang boleh menulis ke kolom tersebut, atau perlakukan edit manual sebagai permintaan dan biarkan SkyPlanner menjadwalkan ulang. Autopilot menjadwalkan ulang secara otomatis ketika terjadi perubahan dalam produksi.

• Setiap akun memodelkan pesanan dengan cara berbeda. Ada yang memakai satu board per pelanggan, operasi sebagai item atau subitem, dan mesin sebagai kolom People atau Status. Petakan ID kolom untuk setiap akun, jangan pernah berdasarkan judul kolom.
• Batas paket. Free, Basic, dan Standard mengizinkan 1.000 panggilan API per hari, Pro 10.000, dan Enterprise 25.000. Gunakan webhook untuk perubahan dan lakukan penulisan balik secara batch dengan change_multiple_column_values. (batas laju permintaan)
• Jumlah board yang terhubung dibatasi. Basic mengizinkan satu koneksi board dan Standard lima, sehingga jumlah board operasi atau produk yang dapat ditautkan terbatas. (batas Connect Boards)
• Kunci versi API. Versi diperbarui setiap triwulan. Sebelum versi 2026-04, board bertingkat tidak disertakan dalam kueri boards secara default.
• Masa berlaku kursor. Kursor items_page berlaku selama 60 menit. Proses rekonsiliasi yang lama harus dapat dimulai ulang dari awal tanpa masalah.
• Batas webhook. Panjang URL maksimal 255 karakter, dan percobaan ulang berhenti setelah 30 menit. Penerima harus bersifat idempoten.
• Satuan dan durasi. Kolom Numbers tidak memiliki satuan. Sepakati apakah durasi dinyatakan dalam menit atau jam sebelum impor pertama.