2月 21, 2026

`orders/edited` webhook payloadに新たに`committed_at`タイムスタンプが追加されました

2月 21, 2026

`orders/edited`ウェブフックペイロードに`committed_at`タイムスタンプが追加

Shopify Storesで頻繁に遭遇する課題の一つが、オーダー編集のタイミングを特定することです。これまで、オーダー編集の作成時刻を示す`created_at`は利用できましたが、実際に編集がオーダーに反映された時刻を知る手段はありませんでした。

しかし、2024年7月のAPIバージョンから、`orders/edited`ウェブフックペイロードに新たに`committed_at`タイムスタンプが追加され、オーダー編集が確定した瞬間を正確に把握することが可能になります。

実装手順

この新しい属性をウェブフックペイロードで受け取るには、ウェブフックAPIのバージョンに2024-07またはそれ以降を指定します。その際のコードは以下の通りです。

{
  "webhook": {
    "topic": "orders/edited",
    "address": "https://example.com/webhook",
    "format": "json",
    "fields": ["id", "created_at", "committed_at"],
    "api_version": "2024-07"
  }
}

これで、ウェブフックペイロードに`committed_at`が含まれ、オーダー編集が確定した時刻を取得することができます。詳細はOrders Edited Webhook Documentationを参照してください。

パフォーマンス・コスト分析

`committed_at`の追加により、オーダー編集のタイムスタンプを監視し、詳細な分析やレポートを作成することが容易になります。これにより、オーダーの編集履歴を追跡し、ビジネスの意思決定に役立てることが可能になります。また、開発者はこの情報を使用して、特定のオーダー変更がシステムに与える影響をより詳細に把握することができます。

実装時の注意点・ベストプラクティス

ただし、この新機能を利用する際には、ウェブフックペイロードのバージョン管理を適切に行うことが重要です。APIバージョン2024-07以前を使用している場合、`committed_at`属性はウェブフックペイロードに含まれません。したがって、この属性を利用する場合は、APIバージョンを更新する必要があります。