MENU
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
ECサイトshopifyならキクシル
  • TOP
  • ECサイト
  • shopify
  • – ECサイト制作
  1. ホーム
  2. Shopifyニュース
  3. 【Shopify最新ニュース2026・開発者向け】下書き注文の API で割引を足すには、スタッフの権限が必要に

【Shopify最新ニュース2026・開発者向け】下書き注文の API で割引を足すには、スタッフの権限が必要に

2026 11/19
2026年11月19日
Shopifyニュースのアイキャッチ:灰色の台の上で、段ボール箱の中のニットを包む薄紙を整える両手の写真に「下書き注文APIの割引にスタッフ権限が必要に」の見出し

開発者向けの変更です。

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つです。

  1. draftOrderCreate と draftOrderUpdate の結果で、userErrors だけでなく最上位の errors の ACCESS_DENIED も見る
  2. エラーのとき、下書き注文が保存されていない前提で処理を組む
  3. 割引を足す機能があるなら、店にスタッフの Apply discounts の権限を案内する

店がやることは次の1つです。

  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 公式の情報だけを一次情報として使っています。

Shopifyニュース
API変更 shopify 割引 注文管理
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • 【Shopify最新ニュース2026・開発者向け】App Events を管理画面の拡張と埋め込みアプリから送れるように

この記事を書いた人

テスタのアバター テスタ

さっぱりした性格で、率直。テンションは一定で、感情に流されない。褒めるときは短く的確、厳しいこともちゃんと言うが、人格否定はしないフェアさがある。遠回りが嫌いで、結論までの道筋をシンプルにしたがる。

関連記事

  • Shopifyニュースのアイキャッチ:木の机の上で、小箱に詰めたジャムの瓶2つに手を添える写真に「App Eventsを管理画面から送れるように」の見出し
    【Shopify最新ニュース2026・開発者向け】App Events を管理画面の拡張と埋め込みアプリから送れるように
    2026年11月19日
  • Shopifyニュースのアイキャッチ:開いた段ボール箱の上で、白いカードを持ちペンで書こうとする両手の写真に「管理画面のカスタムアプリがDev Dashboardに」の見出し
    【Shopify最新ニュース2026】管理画面で作ったカスタムアプリが Dev Dashboard に
    2026年11月19日
  • Shopifyニュースのアイキャッチ:灰色の台の上で、白い箱に畳んだ麻の布を収める両手の写真に「B2Bの拠点と注文の見え方を絞る」の見出し
    【Shopify最新ニュース2026・開発者向け】Customer Account API で B2B の拠点と注文の見え方を絞る
    2026年11月18日
  • Shopifyニュースのアイキャッチ:大理石の台の上で、段ボール箱に白いふたのボトルを詰める両手の写真に「EventBridgeの上限が1MBに」の見出し
    【Shopify最新ニュース2026・開発者向け】Amazon EventBridge の webhook の上限が1MBに
    2026年11月18日
  • Shopifyニュースのアイキャッチ:木の机の上で、麻ひもを掛けたクラフト紙の小箱のひもを結ぶ両手とドライフラワーの写真に「Sidekickが独自項目で売上を分析」の見出し
    【Shopify最新ニュース2026】Sidekick がメタフィールドとメタオブジェクトで売上を分析
    2026年11月18日
  • Shopifyニュースのアイキャッチ:「ストアフロントのscript tag警告バナー、当面は表示しない」の見出しと、紺の地の上で段ボール箱に両手を置く写真
    【Shopify最新ニュース2026】ストアフロントの script tag のインストール時バナー、Shopify が「当面は表示しない」と記載
    2026年11月18日
  • Shopifyニュースのアイキャッチ:木の床の上で、段ボール箱に入ったベージュのスニーカーを両手で整える写真に「トークン期限を先に試せる設定」の見出し
    【Shopify最新ニュース2026・開発者向け】Admin API のトークン期限を Dev Dashboard で先に試せるように
    2026年11月18日
  • Shopifyニュースのアイキャッチ:紺の机の上で、白い薄紙に灰色のニットを包む両手と段ボール箱の写真に「カートと購入手続きのボット検知を改善」の見出し
    【Shopify最新ニュース2026】Shopify アナリティクス、カートと購入手続きのボット検知を改善
    2026年11月18日

最近の投稿

  • 【Shopify最新ニュース2026・開発者向け】下書き注文の API で割引を足すには、スタッフの権限が必要に
  • 【Shopify最新ニュース2026・開発者向け】App Events を管理画面の拡張と埋め込みアプリから送れるように
  • 【Shopify最新ニュース2026】管理画面で作ったカスタムアプリが Dev Dashboard に
  • 【EC最新ニュース2026】消費者庁、UNI SOUND株式会社に景品表示法に基づく措置命令 買取サービスの自社ウェブサイトの表示が対象
  • 【Shopify最新ニュース2026・開発者向け】Customer Account API で B2B の拠点と注文の見え方を絞る

運営: 株式会社ギャザリング

  • プライバシーポリシー
  • 運営者情報
  • お問い合わせ

© ECサイトshopifyならキクシル.

目次