---
title: Pesan barang
description: "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: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)…"
url: "https://skyplanner.ai/id/docs/pesan-barang/"
updated: "2025-10-08"
category: Integrasi
tags:
  - API
  - Integrasi
---

# Pesan barang

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**Gbr 1.** Mengambil barang pesanan

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

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**Gbr 2.** Memesan indeks baris item

- **nomor kerja**
  - Nilai nomor kerja dari item pesanan
- **status**
  - Status barang pesanan
  - Nilai yang diizinkan: **baru**, **mulai** atau **selesai**
- **posisi**
  - Nilai posisi item pesanan

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
Gbr 3. 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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**Gambar 4.**Mengambil item pesanan berdasarkan **phaser_order_id**dan **row_index**

Untuk mengambil item pesanan tertentu dengan id Skyplanner internal, Anda dapat melakukan permintaan seperti ini:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**Gbr 5.** Mengambil item pesanan dengan id Skyplanner 4

#### 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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**Gambar** **6.** Membuat item pesanan

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**Gbr 7.** Item pesanan yang dibuat

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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**Gbr 8.**Memperbarui item pesanan

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**Gbr 9.**Item pesanan yang diperbarui

#### 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:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**Gbr 10.**Menghapus item pesanan

Anda dapat menghapus item pesanan dengan memberikan id internal Skyplanner di larik **"ids"** atau id eksternal di larik **"external_ids"**.