priceAfterAllDiscountsBeforeTaxesSetREST API の current_subtotal_price_set に相当するフィールドが LineItem に追加。全割引適用後・返品/削除済み数量を除いた・税抜きの明細小計を、ショップ通貨と表示通貨の両方で返す。注文エクスポート用途に効く。
priceAfterAllDiscountsBeforeTaxesSet フィールドが追加された。current_subtotal_price_set(明細行レベル)に 相当する。これまで GraphQL 側で素直に取れなかった「割引後・税抜きの明細小計」を、移行せずに取得できるようになった。
明細行の「現在の割引後・税抜き小計」は REST の current_subtotal_price_set で取得していた。GraphQL に移行したいワークフローでは対応物がなく障壁になっていた。
LineItem.priceAfterAllDiscountsBeforeTaxesSet で同じ値が取れる。ショップ通貨・表示通貨の両方を返す。注文エクスポートなどを GraphQL に寄せられる。
priceAfterAllDiscounts(全割引の後)+ BeforeTaxes(税の前)+ Set(通貨ペア=ショップ通貨と表示通貨の両方)。current_subtotal が持つ「current(=返品・削除済みを除いた現在値)」のニュアンスも、このフィールドは引き継いでいる。
適用後 すべての割引(discount)を適用した後の金額
現在数量 返品・削除済みを除いた「現在の」数量分
2通貨 ショップ通貨(shopMoney)と表示通貨(presentmentMoney)の両方
除外 税(taxes)— 値に税は含まれない
除外 返品済み数量(refunded quantities)
除外 削除済み数量(removed quantities)
| 観点 | REST Admin API | GraphQL Admin API(新) |
|---|---|---|
| フィールド名 | current_subtotal_price_set(line item 上) |
priceAfterAllDiscountsBeforeTaxesSet(LineItem 上) |
| 意味 | 等価 全割引後・税抜き・返品/削除済みを除いた明細小計 | |
| 通貨 | shop / presentment の両方(_set) |
shop / presentment の両方(Set = MoneyBag) |
| 税 | 含まない | 含まない |
| 主用途 | 注文エクスポート等、明細レベルの「割引後・税前」小計が必要な処理 | |
明細行ごとに、ショップ通貨と表示通貨の両方で割引後・税抜き小計を取得する例。
...Set 型は shopMoney / presentmentMoney を持つ MoneyBag。多通貨ストアでは「会計はショップ通貨、顧客向け表示は presentment」と使い分けられる。具体的なサブフィールド名は GraphQL スキーマ(2026-07)で確認すること。REST ではなく GraphQL Admin API の LineItem オブジェクトに追加される。
ドキュメントは 2026-07 版を参照。利用前にアプリの API バージョンを確認する。
Bulk Operations・Webhook ペイロード・対象プラン等への適用可否は告知に記載なし。
...Set サフィックスは MoneyBag を意味し、shopMoney と presentmentMoney を持つ。単一の金額ではないので取り出し方に注意。
返品済み・削除済みの数量を除外した現在値を返す。注文後に部分返品が起きた明細では、元の小計と値がずれる点を前提に設計する。
値に税は含まれない。税込み総額が要るレポートでは、別途税フィールドと合算するロジックが必要(合算方法は本告知に記載なし)。
current_subtotal_price_set に依存していた REST 実装を、対応物のなかった GraphQL へ移植しやすくなった。REST 卒業ロードマップの 1 ピース。
フィールドのドキュメントは 2026-07 版で公開。アプリの利用バージョンが古い場合はスキーマに存在しない可能性があるため、クエリ導入前にバージョンを揃える。Bulk Operations や Webhook での扱いは本告知では言及なしのため、自動化前にサンドボックスで挙動を確認すること。
current_subtotal_price_set を使い続けており、REST に縛られている。priceAfterAllDiscountsBeforeTaxesSet を含む GraphQL クエリへ置換。ショップ通貨を会計用、presentment を顧客向け明細用にマッピング。priceAfterAllDiscountsBeforeTaxesSet ベースに切り替える。shopMoney(ショップ通貨)で利益分析、presentmentMoney(表示通貨)で顧客向け明細を生成。1 フィールドで両軸を取得。shopMoney/presentmentMoney を用途で使い分け。税込みが必要な指標は別フィールドと合算。current_subtotal_price_set 相当)が GraphQL Admin API(2026-07)で取れるように。