Di sini kita akan membahas secara rinci tentang mengambil, membuat, memperbarui, dan menghapus item pesanan.
Item pesanan dapat diakses dari titik akhir /phaser-order-rows.
Mengambil barang pesanan #
Anda mengambil item pesanan dengan mengirimkan permintaan GET ke titik akhir /phaser-order-rows:
Anda dapat mencari item pesanan dengan berbagai parameter yang berbeda:
- phaser_order_id
- id pesanan Skyplanner internal, dapat ditemukan dari titik akhir /phaser-orders
- external_id
- Pengidentifikasi eksternal dari item pesanan
- Misalnya, pengenal unik dari sistem eksternal Anda (ERP, dll)
- perencanaan_produksi_produk_id
- Id produk Skyplanner internal
- Dapat ditemukan dari titik akhir /products
- parent_id
- Jika item pesanan memiliki subitem (mis. sub produk), subitem memiliki id item pesanan induknya di bidang parent_id
- row_index
- Nomor indeks item pesanan
- nomor kerja
- Nilai nomor kerja dari item pesanan
- status
- Status barang pesanan
- Nilai yang diizinkan: baru, mulai atau selesai
- posisi
- Nilai posisi item pesanan
- tanggal_pengiriman
- Tanggal pengiriman barang pesanan
- Format: 2025-06-05T22:00:00+00:00
- kondisi_tanggal_pengiriman
- Kondisi opsional pencarian tanggal pengiriman
- Opsi: >, =, <=, =, !=
- Jika tidak ada nilai yang diberikan, >= kondisi akan digunakan
- is_prospect
- Kembalikan hanya barang pesanan yang memiliki prospek
- include_archived
- Menyertakan item pesanan yang diarsipkan (dihapus secara perlahan) dalam pengambilan
- Dilambangkan dengan nilai is_archive
- dimodifikasi
- Pengembalian barang pesanan yang telah dimodifikasi setelah tanggal tertentu
- Format: 2025-06-05T22:00:00+00:00
- kondisi yang dimodifikasi
- Kondisi opsional pencarian nilai yang dimodifikasi
- Opsi: >, =, <=, =, !=
- Jika tidak ada nilai yang diberikan, >= kondisi akan digunakan
Anda juga bisa mencampur dan mencocokkan parameter pencarian seperti ini:
Untuk mengambil item pesanan tertentu dengan id Skyplanner internal, Anda dapat melakukan permintaan seperti ini:
Membuat item pesanan #
Perhatikan bahwa Anda harus membuat pesanan sebelum membuat item pesanan!
Untuk membuat item pesanan, kirimkan permintaan POST ke titik akhir /phaser-order-rows:
Berikut ini adalah gambaran umum tentang bidang yang dapat Anda gunakan saat membuat item pesanan:
- phaser_order_id
- Id Skyplanner internal untuk Pesanan yang dilampirkan pada item pesanan
- Bidang yang dibutuhkan
- production_planning_order_order_row_id
- Setelah pesanan diekspor ke modul penjadwalan produksi Skyplanner, entitas terpisah yang disebut baris pesanan perencanaan produksi dibuat dan id-nya diatur ke dalam bidang ini
- Tidak disarankan untuk digunakan (biarkan kosong atau jangan kirimkan bidang ini sama sekali pada bidang permintaan)
- perencanaan_produksi_produk_id
- Id produk Skyplanner untuk produk yang diproduksi oleh item pesanan
- Diperlukan jika Anda ingin membawa langkah-langkah proses default dari suatu produk
- external_id
- Pengidentifikasi unik dari item pesanan
- Gunakan ini untuk menautkan item pesanan Skyplanner ke item pesanan Anda dari sistem eksternal (ERP, dll.)
- Harus unik
- parent_id
- Jika item pesanan adalah subitem untuk item pesanan lain, berikan nilai id induknya di sini
- row_index
- Di mana dalam daftar item pesanan dalam urutan item ini berada
- nomor kerja
- Hanya digunakan sebagai nilai nomor kerja informatif untuk item pesanan
- Tidak terlihat di UI Skyplanner
- status
- Status barang pesanan
- Nilai yang diizinkan: baru, mulai, siap, bertahap
- is_archive
- Apakah item pesanan diarsipkan (dihapus secara lunak)
- posisi
- Nilai pengenal item pesanan (lihat Gbr 3.)
- jumlah
- Jumlah total produk yang diproduksi
- jumlah_pesanan
- Jumlah produk yang dipesan
- harga
- Harga satuan produk
- gunakan_bahan_khusus
- Jika Anda tidak ingin menggunakan pengaturan material default dari data produk, setel nilai ini ke true
- Default: salah
- penggunaan_bahan_khusus_yang_diperhitungkan
- Jumlah bahan khusus dihitung berdasarkan jumlah produk yang diproduksi
- Jika diatur ke false, jumlah material tetap
- Default: salah
- get_default_steps
- Buat langkah-langkah proses untuk memesan item berdasarkan langkah-langkah proses default produk
- Default: salah
- gunakan_perhitungan_durasi_pekerjaan
- Menghitung durasi langkah proses berdasarkan data catatan waktu sebelumnya
- Jika tidak cukup data yang tersedia untuk dihitung, durasi default digunakan
- Default: salah
- sub_item
- Buat juga sub item produk jika tersedia
- Default: salah
- tanggal_pengiriman
- Format: 2022-01-01 10:30:11
- tanggal_mulai_kelayakan
- Format: 2022-01-01 10:30:11
- pengenal_gambar
- Pengenal gambar/cetakan biru/petunjuk
- Deskripsi
- Deskripsi barang pesanan
- tambahan_deskripsi
- Deskripsi tambahan untuk item pesanan
- is_prospect
- Apakah item pesanan merupakan prospek
- Default: salah
Memperbarui item pesanan #
Untuk memperbarui data item pesanan, Anda dapat mengirimkan permintaan PUT ke titik akhir /phaser-order-rows:
Menghapus item pesanan #
Menghapus item pesanan dilakukan dengan metode “hapus lunak”. Pada dasarnya, menghapus item pesanan akan mengubah nilai is_archive menjadi true. Ini berarti Anda dapat mengembalikan item pesanan yang dihapus dengan memperbarui nilai is_archive menjadi false.
Ketika menghapus item pesanan, sistem juga akan menghapus langkah-langkah proses yang terkait.
Anda menghapus item pesanan dengan mengirimkan permintaan hapus ke titik akhir /phaser-order-rows:
Anda dapat menghapus item pesanan dengan memberikan id internal Skyplanner di larik “ids” atau id eksternal di larik “external_ids”.