開発者向けの変更です。
draftOrderCreate と draftOrderUpdate で、スタッフとして動くアプリが下書き注文に割引を足すときの話です。そのスタッフの権限が問われるようになりました。
権限の無いスタッフとして割引を足すと、エラーになります
発表は2026年11月18日の developer changelog です。
出典: Shopify developer changelog「draftOrderCreate and draftOrderUpdate require the apply_discounts_to_draft_orders permission to add discounts」2026年11月18日
https://shopify.dev/changelog/posts/draft-order-discount-permission
フラグは「Breaking API Change」と「Action required」。
タグは「Security」と「GraphQL Admin API」です。
対象は、サポート中の全ての API バージョン。
条件は、アプリがスタッフとして動いていること。
要る権限は apply_discounts_to_draft_orders。そのスタッフにこの権限が無いと、割引を足す要求は ACCESS_DENIED で止まります。
The mutations don’t save the draft order and return null for the mutation payload. Apps that rely only on userErrors for failure handling need to update their error handling.
(ミューテーションは下書き注文を保存せず、ペイロードに null を返します。失敗の扱いを userErrors だけに頼るアプリは、エラーの扱いを直す必要があります)
下書き注文そのものが保存されない点に注意が要ります。
新しい割引コードと自動割引の有効化が対象です
止まるのは、割引を「足す」変更の2つです。
- 下書き注文にまだ無い割引コードを
discountCodesに加える変更 - 自動割引を受けていない下書き注文で
acceptAutomaticDiscountsを true にする変更
draftOrderCreate では、割引コードが1つでもあるか、自動割引を true にすれば、足す扱いになります。
まだ下書き注文が無いので、全てが新しい割引という扱い。
Keeping or removing a draft order’s existing discounts still works.
(下書き注文にすでにある割引を残すことと、外すことは、これまでどおりできます)
エラーは userErrors ではなく、上の階層に返ります
このエラーは、GraphQL の一番上の errors に返ります。
In these cases, the mutation returns a top-level GraphQL error with the code ACCESS_DENIED and null for the mutation’s payload. The error doesn’t appear in userErrors.
(この場合、ミューテーションはコード ACCESS_DENIED の最上位の GraphQL エラーを返し、ペイロードは null です。エラーは userErrors には出ません)
userErrors だけを見ているアプリは、エラーの扱いを直す必要があります。
公式の例では、エラーの文に write_draft_orders のアクセススコープと、下書き注文を管理する権限が並びます。
スタッフとして動かない要求は対象外です
影響を受けるのは、3つの条件が重なるアプリです。
- スタッフとして
draftOrderCreateかdraftOrderUpdateを呼ぶこと - 割引コードを足すか、自動割引を有効にするつもりであること
- そのスタッフが権限を持つように手当てしていないこと
Requests that don’t act as a staff member, such as requests made with an offline access token, aren’t affected.
(オフラインのアクセストークンでの要求など、スタッフとして動かない要求は対象外です)
店の側では、スタッフの Apply discounts の権限が関わります
公式は、開発者がやることとして2つを挙げています。
1つ目は、userErrors だけでなく、最上位の errors の配列で ACCESS_DENIED を見ること。
2つ目は、店とのやりとりです。
If your app needs to add discounts, ask the merchant to give the staff member the Apply discounts permission under Draft orders.
(アプリが割引を足す必要があるなら、店に頼んで、スタッフに Draft orders の下の Apply discounts の権限を渡してもらいます)
権限を渡すのは、店の側の作業です。
場所は、スタッフの権限の Draft orders の下にある Apply discounts。
🔴 公式に書かれていないこと
次の点は、一次ソースにありません。
- この挙動がいつから始まったか、または始まるかは書かれていません。書かれているのは「In all supported API versions」と、Version の 2026-01 です
- 管理画面で人が下書き注文に割引を足すときにも、同じ権限が問われるかは書かれていません。書かれているのはアプリの API の要求です
- 店が、どのアプリがスタッフとして下書き注文を操作しているかを知る方法は書かれていません
- Apply discounts の権限を持たないスタッフが、今どれだけいるかを店が一覧で見る方法は書かれていません
- 🔴 本記事は Related docs の4本を読んでいません。開発ストアでも試していません。記載が無いことをもって「できる」とも「できない」とも書きません
開発者と店がやることを整理します
開発者がやることは次の3つです。
draftOrderCreateとdraftOrderUpdateの結果で、userErrors だけでなく最上位の errors のACCESS_DENIEDも見る- エラーのとき、下書き注文が保存されていない前提で処理を組む
- 割引を足す機能があるなら、店にスタッフの Apply discounts の権限を案内する
店がやることは次の1つです。
- 下書き注文に割引を足すアプリを使っていて、エラーが出るようになったら、使っているスタッフの Draft orders の Apply discounts の権限を見直す
🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。
出典
- Shopify developer changelog「draftOrderCreate and draftOrderUpdate require the apply_discounts_to_draft_orders permission to add discounts」2026年11月18日
https://shopify.dev/changelog/posts/draft-order-discount-permission
上記の Shopify 公式の情報だけを一次情報として使っています。

