ミューテーション入力の準備
orderCreate
ミューテーションには特定の入力データが必要です。追加のフィールドも利用可能ですが、以下のフィールドは必須です:
productId
またはsku
:注文のアイテムを識別するために使用する製品IDまたはSKU(システム内で製品を識別するために使用する値)。accountOrderNumber
:注文に割り当てた注文番号(通常はプラットフォームの注文番号)。
アイテムが出荷されていない場合にのみ、注文からアイテムを削除できます。
ミューテーションの送信
必要な入力データが揃ったら、選択したクライアントライブラリまたはツールを使用してAPIエンドポイントにGraphQLミューテーションを送信します。以下は、ミューテーションを構造化する方法の例です:
ミューテーション
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
}
}
}
応答
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"
}
}
}
}
注文の作成
注文のアイテムを更新する方法を学びましょう。GraphQL
近日公開
注文を作成したが、短納品やその他の予期しない状況によりすべてのアイテムを履行できないことに気付いた場合、
orderItemUpdate
ミューテーションを使用して注文からアイテムを削除できます。アイテムが削除されると、新しいlandedCost
計算が実行され、この注文の請求書が新しい金額を反映するように更新されます。すでに請求されている場合、その金額は次回の請求書にクレジットとして追加されます。