DOCS

Update orders

/

Buat pesanan

Pelajari cara memperbarui item dalam pesanan.

GraphQL

SEGERA HADIR

Jika Anda telah membuat pesanan tetapi menyadari bahwa tidak semua item dapat dipenuhi karena pengiriman yang kurang atau keadaan tak terduga lainnya, Anda dapat menggunakan mutasi orderItemUpdate untuk menghapus item dari pesanan. Setelah item dihapus, kami akan menjalankan perhitungan landedCost baru dan memperbarui faktur untuk pesanan ini agar mencerminkan jumlah baru yang akan Anda bayar. Jika Anda sudah dikenakan biaya, kami akan menambahkan jumlah tersebut sebagai kredit pada faktur Anda yang akan datang.

Siapkan input mutasi 

Mutasi orderCreate memerlukan data input tertentu. Meskipun ada bidang tambahan yang tersedia, bidang berikut ini adalah yang wajib:

  • productId atau sku: ID produk atau SKU yang Anda gunakan untuk mengidentifikasi item dalam pesanan (Nilai yang Anda gunakan untuk mengidentifikasi produk dalam sistem Anda).
  • accountOrderNumber: Nomor pesanan yang Anda tetapkan untuk pesanan (sering kali nomor pesanan dari platform).

Anda hanya dapat menghapus item dari pesanan jika item tersebut belum dikirim.

Kirim mutasi 

Setelah Anda memiliki data input yang diperlukan, kirim mutasi GraphQL ke endpoint API menggunakan pustaka atau alat klien pilihan Anda. Berikut adalah contoh cara Anda dapat menyusun mutasi:

Mutasi

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
mutation {
  orderItemUpdate(
    orderId: "order_4f52ec0e-3467-11ed-b878-0242ac120002"
    accountOrderNumber: "AO-67890"
    itemId: "item_8659ec0e-3467-11ed-b878-0242ac120002"
    itemSku: "T123-BLUE"
    quantity: 1
  ) {
    order {
      accountOrderNumber
      createdAt
      createdBy
      currencyCode
      id
      items {
        id
        name
        quantity
        amount
        currencyCode
      }
      status
      updatedAt
      updatedBy
    }
  }
}

Respon

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "data": {
    "orderItemUpdate": {
      "order": {
        "accountOrderNumber": "AO-67890",
        "createdAt": "2024-06-01T12:00:00Z",
        "createdBy": "user_3258ec0e-3467-11ed-b878-0242ac120002",
        "currencyCode": "USD",
        "id": "order_4f52ec0e-3467-11ed-b878-0242ac120002",
        "items": [
          {
            "id": "item_8659ec0e-3467-11ed-b878-0242ac120002",
            "name": "T-Shirt",
            "quantity": 0,
            "amount": 19.99,
            "currencyCode": "USD"
          }
        ],
        "status": "OPEN",
        "updatedAt": "2024-07-09T12:20:00Z",
        "updatedBy": "user_4258ec0e-3467-11ed-b878-0242ac120002"
      }
    }
  }
}

Apakah halaman ini membantu?