2月 21, 2026

FulfillmentOrder APIを強化：追加の注文詳細と、financialSummariesを備えたFulfillmentOrderLineItemの導入

2月 21, 2026

ShopifyのFulfillmentOrder APIとFulfillmentOrderLineItemがオーダー詳細とfinancialSummariesで強化されました

1. 技術的課題の定義

ShopifyのAPIを使ってショッピングサイトを運営している中で、注文情報の取得、特に注文完了後の情報取得や購入明細の取得に手間がかかっていました。また、これらの情報を取得するためには、別途複数のアクセススコープが必要であり、APIの利用が複雑で時間がかかるという問題がありました。

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

注文情報や購入明細を取得するために利用していたREST APIやGraphQL APIは、必要な情報を一度に取得するためには、複数のAPIを組み合わせる必要がありました。また、それぞれのAPIには異なるアクセススコープが必要であり、情報の取得に手間がかかっていました。これは、開発者が効率的にシステムを開発する上での障害となっていました。

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

2024年1月バージョンのREST APIとGraphQL APIでは、FulfillmentOrderとFulfillmentOrderLineItemオブジェクトに注文情報と購入明細を取得するための新たなフィールドが追加されました。これにより、注文情報や購入明細を一度に取得することが可能になり、APIの利用が効率化されます。

4. 実装手順とコード例

FulfillmentOrderオブジェクトには、orderId、orderName、orderProcessedAt、channelIdが追加されました。これらのフィールドを使用することで、注文情報の取得が可能になります。


query {
  fulfillmentOrder(id: "gid://shopify/FulfillmentOrder/1") {
    id
    orderId
    orderName
    orderProcessedAt
    channelId
  }
}

また、FulfillmentOrderLineItemオブジェクトには、financialSummariesフィールドが追加されました。これを利用すると、購入明細の取得が可能になります。


query {
  fulfillmentOrder(id: "gid://shopify/FulfillmentOrder/1") {
    id
    lineItems(first: 5) {
      edges {
        node {
          financialSummaries {
            approximateDiscountedUnitPriceSet
            discountAllocations
            originalUnitPriceSet
            quantity
          }
        }
      }
    }
  }
}