2月 21, 2026

最新の注文編集APIで割引を追加、削除、更新しよう

2月 21, 2026

最新のOrder編集APIを使用してディスカウントの追加・削除・更新を行う

Shopifyの技術開発者やエンジニアの皆さま、新たなAPIが公開され、既存の注文の編集時に新規商品や既存の商品にディスカウントを追加、削除、更新することが可能となりました。

技術的課題と現状分析

これまで、注文編集時にディスカウントを適用する場合、新規に追加された商品やカスタムアイテムに限定されていました。既存の商品に対してはディスカウントの追加や更新ができず、その制限により、フレキシブルな注文編集が難しかった状況です。

具体的な技術的ソリューションの提案

この問題を解決するため、新たに提供されたAPIは以下の3つのmutationを提供します。

orderEditAddLineItemDiscount
orderEditRemoveDiscount
orderEditUpdateDiscount

これらのmutationを使用することで、注文編集時に既存の商品に対してもディスカウントの追加、削除、更新が可能となります。

実装手順とコード例

具体的な実装手順とコード例を以下に示します。

```graphql
# ディスカウントの追加
mutation {
  orderEditAddLineItemDiscount(id: "gid://shopify/Order/1982555558209", lineItemId: "gid://shopify/LineItem/6692562149377", discount: {amount: 5, description: "5 dollar discount", type: FIXED_AMOUNT}){
    calculatedOrder{
      totalTaxSet {
        shopMoney {
          amount
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}

# ディスカウントの削除
mutation {
  orderEditRemoveDiscount(id: "gid://shopify/Order/1982555558209", lineItemId: "gid://shopify/LineItem/6692562149377"){
    calculatedOrder{
      totalTaxSet {
        shopMoney {
          amount
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}

# ディスカウントの更新
mutation {
  orderEditUpdateDiscount(id: "gid://shopify/Order/1982555558209", lineItemId: "gid://shopify/LineItem/6692562149377", discount: {amount: 10, description: "10 dollar discount", type: FIXED_AMOUNT}){
    calculatedOrder{
      totalTaxSet {
        shopMoney {
          amount
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}
```