2月 21, 2026

Return.suggestedRefundとReturnRefundが交換と手数料を考慮する方法

2月 21, 2026

Return.suggestedRefundとReturnRefundが交換と手数料を考慮するようになりました

ShopifyのGraphQL Admin APIにおいて、2024年7月以降のバージョンより、返品に対する返金額の提案が、返品品目だけでなく、交換品目や手数料も考慮した形になりました。これにより、返品に関する取扱いや、それに伴う返金額の計算がより正確に行えるようになります。

1. 技術的課題の定義と現状分析

以前のGraphQL Admin APIでは、Return.suggestedRefundクエリとReturnRefundミューテーションAPIは返品品目のみを考慮した返金額を提案していました。これは、交換品目や手数料が考慮されず、返品に伴う全体的なコストを正確に反映できないという問題がありました。

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

新バージョンでは、Return.suggestedRefundクエリとReturnRefundミューテーションAPIは、返品に関わる交換品目や手数料、さらに購入者が注文に対して未払いの残金も考慮した返金額を提案します。これにより、より正確な返金額の計算と、それに伴うコストの管理が可能になります。

3. 実装手順とコード例

以下に、新バージョンでのReturn.suggestedRefundクエリの使用例を示します。この例では、返品品目が50.99カナダドル、返品手数料が5カナダドルであるとします。

query {
  return(id: "exampleReturn/1") {
    suggestedRefund(
      returnRefundLineItem: [
        {
          returnLineItemId: "exampleReturnLineItem/1"
          quantity: 1
        }
      ]
    ) {
      amount {
        shopMoney {
          amount
          currencyCode
        }
      }
    }
  }
}

以前のバージョンでの結果は以下のようになります。

{
  "data": {
    "return": {
      "suggestedRefund": {
        "amount": {
          "shopMoney": {
            "amount": "50.99",
            "currencyCode": "CAD"
          }
        }
      }  
    }
  }
}

新バージョンでの結果は以下のようになります。

{
  "data": {
    "return": {
      "suggestedRefund": {
        "amount": {
          "shopMoney": {
            "amount": "45.99",
            "currencyCode": "CAD"
          }
        }
      }  
    }
  }
}