---
title: Membuat pesanan
description: "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](https://skyplanner.ai/id/docs/tutorial-integrasi/) integrasi, tetapi di sini kita akan membahas struktur data Skyplanner dan proses integrasi secara lebih…"
url: "https://skyplanner.ai/id/docs/membuat-pesanan/"
updated: "2025-10-07"
category: Integrasi
tags:
  - API
  - Integrasi
---

# Membuat pesanan

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](https://skyplanner.ai/id/docs/tutorial-integrasi/) 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](https://integration.skyplanner.app/api/swagger) 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).

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**Gbr. 1** Struktur pesanan dan data terkait

#### Alur kerja integrasi

Berikut ini adalah contoh langkah demi langkah tentang bagaimana Anda dapat menyusun integrasi Anda dari sistem ERP ke Skyplanner.

1. Mengambil pesanan penjualan/kerja dari ERP
2. Buat **pelanggan**(dapatkan id pelanggan sebagai tanggapan)
3. Buat **pesanan** dengan id pelanggan (dapatkan id pesanan sebagai tanggapan)
4. Mengambil data item pesanan penjualan/kerja dari ERP
5. Buat **produk** (dapatkan id produk sebagai tanggapan)
6. Buat **item pesanan** dengan id pesanan & data lainnya (dapatkan id item pesanan sebagai respons)
7. Mengambil data langkah proses dari ERP
8. Buat **panggung kerja** (dapatkan id panggung kerja sebagai tanggapan)
9. 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**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**Gbr 2.** Membuat item pesanan baru dengan langkah-langkah proses default

##### 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**.

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**Gbr 3.** Membuat item pesanan tanpa menggunakan bahan default