1月 16, 2026

税金計算と割引配分のWebhookが、ショップ通貨額を含むようになりました

1月 16, 2026

税金ラインと割引割当てのウェブフックが店舗通貨額を含むようになりました

1. 技術的課題の定義

ShopifyのTax Partner Appsにおける税金ラインと割引割当てのウェブフックが、店舗通貨と表示通貨の両方の通貨フィールドを含むようになりました。これにより、税金パートナーは、マーチャントの会計通貨での計算とレポーティングを行いつつ、顧客向けの通貨表示を維持することが可能になります。

2. 現状の技術スタックと問題分析

これまでのAPIバージョンでは、税金ラインと割引割当てのウェブフックには単一の通貨フィールドしか含まれておらず、店舗通貨と表示通貨の両方を扱うことが困難でした。これにより、税金パートナーやマーチャントが複数の通貨を扱う場合には計算や表示が複雑化するという課題がありました。

3. 技術的ソリューションの提案

APIバージョン2026-04から、税金ライン（agreements[].sales[].tax_lines[]）と割引割当て（delivery_groups[].cart_lines[].discount_allocations[]）のウェブフックに新たにMoneyBagフィールドが追加されました。これにより、店舗通貨と表示通貨の両方の金額を扱うことが可能になります。

4. 実装手順とコード例

以下に、新たに追加されたMoneyBagフィールドの具体的な使用例を示します。

税金ライン

Before (2026-01 and earlier):

  {
  "id": "gid://shopify/TaxLine/1",
  "name": "GST",
  "rate": "0.05",
  "amount": {
    "currency_code": "CAD",
    "amount": "5.00"
  },
  "liability": "merchant",
  "jurisdiction_id": "CA",
  "jurisdiction_type": "country"
}

After (2026-04):

  {
  "id": "gid://shopify/TaxLine/1",
  "name": "GST",
  "rate": "0.05",
  "amount": {
    "currency_code": "CAD",
    "amount": "5.00"
  },
  "amount_set": {
    "shop_money": {
      "currency_code": "USD",
      "amount": "3.70"
    },
    "presentment_money": {
      "currency_code": "CAD",
      "amount": "5.00"
    }
  },
  "liability": "merchant",
  "jurisdiction_id": "CA",
  "jurisdiction_type": "country"
}

割引割当て

Before (2026-01 and earlier):

  {
  "discount_amount": {
    "currency_code": "CAD",
    "amount": "10.00"
  }
}

After (2026-04):

  {
  "discount_amount": {
    "currency_code": "CAD",
    "amount": "10.00"
  },
  "discount_amount_set": {
    "shop_money": {
      "currency_code": "USD",
      "amount": "7.41"
    },
    "presentment_money": {
      "currency_code": "CAD",
      "amount": "10.00"
    }
  }
}