GraphQL Admin APIでグローバルHSコードがサポートされるようになりました

GraphQL Admin APIでグローバルHSコードがサポートされるようになりました

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

2025年10月以降、CountryHarmonizedSystemCodeInput内のcountryCodeフィールドがnull設定可能となりました。これにより、HSコード(調和システムコード)エントリーは国別ではなく、グローバルなHSコードを表すことが可能になりました。これまで、国別のHSコードを設定するためには、特定の国の情報が必要であったため、グローバルな規模での取引を行う際に冗長性が生じていました。

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

この改良により、以下のような機能が可能となります：

• 特定の国の情報がなくてもグローバルHSコードを保存する
• 同一の基本HSコードが複数の国で適用される場合の冗長性を減らす
• グローバルコードが基盤となる国際取引の慣行により適合する

3. 実装手順とコード例

この変更は既存の実装に影響を与えず、countryCodeに対してnullを渡すことでグローバルHSコードエントリーを作成することが可能となります。具体的なコード例は以下のようになります。

mutation {
  productCreate(input: {
    title: "Global HS Code Product",
    harmonizedSystemCode: {
      countryCode: null,
      harmonizedSystemCode: "123456"
    }
  }) {
    product {
      id
      harmonizedSystemCode {
        countryCode
        harmonizedSystemCode
      }
    }
  }
}

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

この変更により、国別のHSコードを管理する必要が減少し、グローバルHSコードの管理が容易になります。これにより、データ管理の冗長性が減少し、システムのパフォーマンスが向上する可能性があります。また、特定の国の情報を入力する手間が省けるため、コスト削減にもつながります。

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

既存の実装がcountryCodeを提供している場合でも、これらは変更なく引き続き動作します。ただし、グローバルなHSコードエントリーを作成するには、countryCodeにnullを渡す必要があります。

6. 次のステップ・発展案

HSコードと原産地国または地域を商品に追加する方法については、以下のリソースを参照してください。国際取引の書類作成についてはこちらをご覧ください。

参考記事: Global HS code is now supported in GraphQL Admin API