3月 05, 2026

PurchasingEntityInputを利用してB2Bのドラフトオーダーを作成しよう

3月 05, 2026

「PurchasingEntityInput」を使用したB2Bドラフトオーダーの生成

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

ShopifyのB2B向けドラフトオーダーの生成と更新において、会社、ロケーション、コンタクト情報の紐付けが必要となります。しかし、これらの情報を効率的に紐付けるための手段が不足しており、その結果、業務効率が低下していました。

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

2022年10月バージョンのGraphQL Admin APIから、新たに「PurchasingEntityInput」フィールドが利用可能となりました。このフィールドを使用することで、B2Bドラフトオーダーの生成と更新時に、会社、ロケーション、コンタクト情報を効率的に紐付けることが可能となります。

3. 実装手順とコード例

まず、GraphQL Admin APIの最新バージョンを使用していることを確認してください。その上で、「PurchasingEntityInput」フィールドを使用して、以下のようにドラフトオーダーの生成と更新を行います。

mutation {
  draftOrderCreate(input: {
    lineItems: [{
      customDiscount: {
        amount: "10.0",
        description: "Custom Discount"
      },
      customTaxLines: [{
        rate: "0.07",
        title: "State Tax"
      }],
      variantId: "gid://shopify/ProductVariant/1",
      quantity: 1
    }],
    purchasingEntity: {
      company: {
        name: "Company Name"
      },
      location: {
        address1: "Address1"
      },
      contact: {
        email: "contact@example.com"
      }
    }
  }) {
    draftOrder {
      id
      ...
    }
  }
}

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

「PurchasingEntityInput」フィールドの導入により、ドラフトオーダーの生成と更新の効率が大幅に向上します。これにより、開発者は他の業務に集中することが可能となり、結果として全体の開発コストを削減することが期待できます。

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

「PurchasingEntityInput」フィールドは、GraphQL Admin APIの2022年10月バージョンから利用可能となっています。そのため、古いバージョンを使用している場合は、バージョンアップが必要です。また、フィールドの使用には適切な権限が必要となりますので、その点もご注意ください。

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

次のステップとしては、この新機能を活用して、より使いやすいユーザインターフェースを開発することが考えられます。また、「PurchasingEntityInput」フィールドの他にも、GraphQL Admin APIには様々な機能が用意されていますので、それらを活用することも一つの発展案と言えるでしょう。

参考記事: Create B2B Draft Orders via PurchasingEntityInput