1月 03, 2026

税金計算リクエストに、事業者のビジネスエンティティ情報が含まれるようになりました

1月 03, 2026

税金計算リクエストに商人のビジネスエンティティ情報が含まれるようになりました

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

これまでのShopify APIでは、税金計算リクエストにおいて取引を行う法人エンティティの詳細情報が提供されていませんでした。これにより、パートナーアプリは特定のビジネスエンティティに基づいた正確な税金ルールを適用することが難しかったのです。

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

しかし、APIバージョン2026-01から、商人のビジネスエンティティ情報が税金計算リクエストに含まれるようになりました。これにより、取引を担当する法人エンティティに関する詳細情報が提供され、税金パートナーアプリは特定のビジネスエンティティに基づいた正確な税金ルールを適用することが可能になります。

実装手順とコード例

具体的には、税金計算リクエストのペイロードに新たなmerchant_business_entityフィールドがルートレベルで追加されました。以下の詳細が含まれます：

id: ビジネスエンティティのグローバルID（形式: gid://shopify/BusinessEntity/{id}）
company_name: ビジネスエンティティの法的名前
display_name: ビジネスエンティティの表示名
address: ビジネスエンティティの住所、以下を含む：
- 国
- 州
- 住所行（address1, address2）
- 市
- 郵便番号

以下に、変更前後のペイロード構造を示します。

変更前（2026-01）:

{
  "shop": { ... },
  "cart": { ... },
  "currency_code": "USD",
  "session_id": "session_123"
}

変更後（2026-01）:

{
  "shop": { ... },
  "cart": { ... },
  "currency_code": "USD",
  "session_id": "session_123",
  "merchant_business_entity": {
    "id": "gid://shopify/BusinessEntity/456",
    "company_name": "Test Company",
    "display_name": "Test Display",
    "address": {
      "country": "US",
      "province": "CA",
      "address1": "123 Main St",
      "address2": "Suite 100",
      "city": "San Francisco",
      "zip": "94102"
    }
  }
}