DOCS

Update orders

/

注文の作成

注文のアイテムを更新する方法を学びましょう。

GraphQL

近日公開

注文を作成したが、短納品やその他の予期しない状況によりすべてのアイテムを履行できないことに気付いた場合、orderItemUpdateミューテーションを使用して注文からアイテムを削除できます。アイテムが削除されると、新しいlandedCost計算が実行され、この注文の請求書が新しい金額を反映するように更新されます。すでに請求されている場合、その金額は次回の請求書にクレジットとして追加されます。

ミューテーション入力の準備 

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"
      }
    }
  }
}

このページは役に立ちましたか?


このページには: