12月 17, 2025

`refundCreate`ミューテーションで`processedAt`を設定し、取得する方法

12月 17, 2025

`refundCreate`ミューテーションで`processedAt`を設定・取得する

Shopifyの`refundCreate`ミューテーションに新たに`processedAt`フィールドが追加されました。これにより、返金のタイムスタンプをより効果的に管理することが可能になります。

技術的課題と現状分析

これまでのShopifyでは、返金処理のタイムスタンプを自動的に現在時刻で設定するしかありませんでした。しかし、オフラインで行われた返金処理や特定の日付を反映させる必要のある会計目的の処理など、現実のビジネスオペレーションと報告期間とを正確に一致させるためには、返金が実際に処理された正確な時間を指定することが求められます。

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

この新機能の導入により、`refundCreate`ミューテーションに含まれるオプショナルな`processedAt`フィールドを使用して、返金が処理された正確な時間を指定することが可能になります。`processedAt`フィールドが提供されない場合、現在のタイムスタンプがデフォルトで使用され、既存の統合が変更なしで機能し続けることを保証します。

実装手順とコード例

この機能を利用するには、返金を作成する際に`processedAt`フィールドを含めます：

<pre><code class="language-graphql">mutation refundCreate($input: RefundInput!) {
  refundCreate(input: $input) {
    refund {
      id
      processedAt
      createdAt
    }
    userErrors {
      field
      message
    }
  }
}
</code></pre>

次に、入力値として以下のようにします：

<pre><code class="language-json">{
  "input": {
    "orderId": "gid://shopify/Order/123",
    "processedAt": "2024-12-01T10:30:00Z",
    "refundLineItems": [...]
  }
}
</code></pre>

このように`processedAt`フィールドに値を設定することで、返金が処理された正確な時間を指定することができます。