Di sini Anda dapat menemukan panduan komprehensif tentang cara membuat pesanan ke Skyplanner dengan semua data terkait. Sebagian dari hal ini telah dibahas dalam tutorial integrasi, tetapi di sini kita akan membahas struktur data Skyplanner dan proses integrasi secara lebih rinci.
Struktur data #
Pertama, kita akan membahas bagaimana pesanan Skyplanner disusun. Titik akhir API untuk entitas data yang disebutkan di sini disorot seperti ini: /phaser-orders
Pada tingkat teratas, kami memiliki urutan(/phaser-orders)
Setiap pesanan harus memiliki pelanggan(/pelanggan).
Setiap pesanan dapat memiliki beberapa item pesanan(/phaser-order-rows)
Setiap item pesanan dapat memiliki produk(/products) yang dilampirkan padanya, tetapi tidak wajib. Setiap produk memiliki satu stok(/saldos). Perhatikan bahwa entitas stok dibuat secara otomatis ketika produk dibuat dengan API.
Setiap item pesanan dapat memiliki beberapa pekerjaan (alias langkah proses)(/phaser-jobs).
Setiap pekerjaan harus memiliki tahapan kerja(/tahapan kerja).
Alur kerja integrasi #
Berikut ini adalah contoh langkah demi langkah tentang bagaimana Anda dapat menyusun integrasi Anda dari sistem ERP ke Skyplanner.
- Mengambil pesanan penjualan/kerja dari ERP
- Buat pelanggan (dapatkan id pelanggan sebagai tanggapan)
- Buat pesanan dengan id pelanggan (dapatkan id pesanan sebagai tanggapan)
- Mengambil data item pesanan penjualan/kerja dari ERP
- Buat produk (dapatkan id produk sebagai tanggapan)
- Buat item pesanan dengan id pesanan & data lainnya (dapatkan id item pesanan sebagai respons)
- Mengambil data langkah proses dari ERP
- Buat panggung kerja (dapatkan id panggung kerja sebagai tanggapan)
- Membuat pekerjaan dengan id tahap kerja dan data lainnya
Kiat tambahan #
Saat menghapus #
Menghapus phaser-order, phaser-order-item atau phaser-job melalui API (dan dari UI) dilakukan dengan cara hapus lunak. Ini berarti bahwa data tidak benar-benar dihapus dari database, tetapi ditandai sebagai diarsipkan. Akibatnya, atribut is_archive dari entitas diatur ke nilai true ketika dihapus. Entitas yang diarsipkan/dihapus masih dapat diakses dengan API menggunakan parameter include_archived. Ketika include_archived = true, permintaan GET akan mengambil entitas meskipun entitas tersebut diarsipkan.
Perhatikan bahwa penghapusan lunak tidak tersedia di setiap titik akhir API! Jadi, Anda harus berhati-hati karena menghapus misalnya pelanggan, orang, dll. bersifat permanen!
Menggunakan langkah-langkah proses default untuk item pesanan Anda #
Jika Anda telah membuat beberapa langkah proses default untuk produk yang diproduksi item pesanan Anda, Anda dapat memberi tahu sistem untuk membawa default ke item pesanan dengan API menggunakan atribut get_default_steps.
Menambahkan bahan ke item pesanan #
Jika Anda telah melampirkan bahan ke produk yang diproduksi, bahan tersebut secara otomatis dilampirkan ke baris pesanan.
Namun, jika Anda tidak ingin menggunakan bahan yang dilampirkan pada produk (misalnya, jika item adalah pesanan khusus dan Anda ingin menggunakan bahan yang berbeda, dll.) Anda dapat menggunakan atribut use_custom_materials.
