Shopifyの下書き注文に割引を入れるアプリは要確認|スタッフに「割引を適用」の権限が無いとACCESS_DENIEDで保存されない【2026年11月】

開発 — 2026.11.19

← 読み物の一覧に戻る

はじめに

  • 見積や受注、B2Bのアプリで、下書き注文に割引コードや自動割引を入れている
  • 店から「アプリで下書き注文が保存されない」と言われたが、原因が分からない
  • userErrors は空なのに、下書き注文ができていない

このような方のための記事です。

Shopifyは2026年11月18日、下書き注文に割引を足すAPIの決まりを変えました。スタッフとして動くアプリが割引を足そうとしたとき、そのスタッフに「割引を適用」の権限が無いと、下書き注文は保存されずにエラーが返ります。サポートされているすべてのAPIバージョンに、同じ日から効いています。

外部記事draftOrderCreate and draftOrderUpdate require the apply_discounts_to_draft_orders permissi...Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.shopify.devdraftOrderCreate and draftOrderUpdate require the apply_discounts_to_draft_orders permissi...

何が変わったのか

下書き注文は、電話やメールで受けた注文、B2Bの見積などを、店の人が管理画面で作る注文の下書きです。アプリからは draftOrderCreate と draftOrderUpdate で作ったり直したりします。

この2つのAPIで割引を足すとき、アプリを操作しているスタッフの権限が見られるようになりました。見られるのは、スタッフの権限の「下書き注文」の中にある「割引を適用」です。英語の管理画面では Draft orders の Apply discounts、APIの上では apply_discounts_to_draft_orders という名前です。

権限が無いスタッフで割引を足すと、次のようになります。

  • ACCESS_DENIED のエラーが返ります
  • 下書き注文は保存されません。割引だけが外れて残りが保存される、という動きではありません
  • 返ってくる結果の中身は null です
2026年11月18日からの変更。スタッフとして動くアプリが下書き注文に割引を足すとき、スタッフに割引を適用の権限があれば今までどおり保存される。権限が無ければACCESS_DENIEDが返り、下書き注文は保存されないPR・RYX のアプリ。RYX Wishlist(お気に入り・ほしい物リスト)。気になる商品をハートで保存できます。ゲストも保存・登録者数を表示・ノーコード。7日間の無料体験。App Store で見る

止められる操作と、今までどおり通る操作

止められるのは、割引を新しく足す操作だけです。

  • 割引コードの追加:discountCodes に、その下書き注文にまだ付いていないコードを入れる
  • 自動割引の受け入れ:自動割引を受け入れていない下書き注文で、acceptAutomaticDiscounts を true にする

draftOrderCreate は新しく作るAPIなので、discountCodes に1つでもコードが入っているか、acceptAutomaticDiscounts が true なら対象になります。

次の操作は、権限が無いスタッフでも今までどおり通ります。

  • すでに付いている割引コードを、そのまま残して保存する
  • 付いている割引コードを外す
  • 割引に触らない更新
止められる操作と通る操作。止められるのは、まだ付いていない割引コードをdiscountCodesに入れることと、acceptAutomaticDiscountsをtrueにすること。通るのは、付いている割引を残す、外す、割引に触らない更新

対象になるアプリ、ならないアプリ

対象は「スタッフとして動く」アプリです。Shopifyのアプリが使うアクセストークンには2種類あり、どちらでAPIを呼んでいるかで決まります。

  • オンラインのトークン:アプリを開いているスタッフに結びついたトークンです。スタッフの権限の範囲でしか動けません。今回の対象です
  • オフラインのトークン:店に結びついたトークンです。スタッフとは関係なく動きます。今回の対象外です

Shopifyの告知にも、オフラインのアクセストークンでのリクエストは影響を受けないと書かれています。Webhookを受けたときの処理や定期の処理はオフラインのトークンで動くので、そこから下書き注文を作っているアプリは変わりません。

Shopifyのテンプレートで作ったアプリは、shopifyApp() の設定で useOnlineTokens: true にしていると、管理画面からの操作がオンラインのトークンで動きます。この設定にしていて、画面から下書き注文に割引を入れているアプリは対象です。

エラーは userErrors には入らない

特に重要なのが、エラーの入る場所です。

GraphQLの更新系のAPIは、入力に誤りがあるとき、結果の中の userErrors に理由を入れて返します。多くのアプリは、userErrors が空なら成功として扱っています。

今回の ACCESS_DENIED は userErrors には入りません。レスポンスのいちばん上の errors に入り、data の中の draftOrderCreate は null になります。

{
  "data": { "draftOrderCreate": null },
  "errors": [
    {
      "message": "Access denied for draftOrderCreate field.",
      "extensions": { "code": "ACCESS_DENIED" },
      "path": ["draftOrderCreate"]
    }
  ]
}

これは形を示すための例で、message の文は実際と違うことがあります。見分けるときは extensions.code の ACCESS_DENIED を使ってください。

userErrors だけを見ているアプリでは、次のどちらかが起きます。

  • data.draftOrderCreate.userErrors を読もうとして、null を読むエラーで画面が落ちる
  • data?.draftOrderCreate?.userErrors ?? [] のように書いていて、空の配列になり、保存できたと扱ってしまう

2つ目は、スタッフの画面には「保存しました」と出るのに、下書き注文はどこにも無い、という状態になります。

エラーの入る場所。入力の誤りは結果の中のuserErrorsに入る。権限が無いときのACCESS_DENIEDはレスポンスのいちばん上のerrorsに入り、dataの中身はnullになる

アプリの直し方

やることは2つです。

1. いちばん上の errors を拾う

自分で fetch を書いているアプリは、userErrors を見る前に errors を見ます。

const { data, errors } = await response.json();

const denied = errors?.some(
  (e) => e.extensions?.code === "ACCESS_DENIED",
);
if (denied) {
  return {
    ok: false,
    message:
      "下書き注文に割引を入れる権限がありません。ストアの管理者に「下書き注文」の「割引を適用」の権限を付けてもらってください。",
  };
}
if (errors?.length) throw new Error(errors[0].message);

const userErrors = data.draftOrderCreate.userErrors;

Shopifyのテンプレートのアプリは、動きが少し違います。admin.graphql() は、いちばん上の errors があるとレスポンスを返さずに例外を投げます。@shopify/shopify-api の15.1.1で確かめたところ、投げられるのは GraphqlQueryError で、body.errors.graphQLErrors にエラーの配列が入っています。受け止めていないアプリは、エラーの画面になります。

try {
  const response = await admin.graphql(DRAFT_ORDER_CREATE, { variables });
  const { data } = await response.json();
  // data.draftOrderCreate.userErrors を見る
} catch (error) {
  const list = error?.body?.errors?.graphQLErrors ?? [];
  if (list.some((e) => e.extensions?.code === "ACCESS_DENIED")) {
    return { ok: false, reason: "no-discount-permission" };
  }
  throw error;
}

2. スタッフに何をすればいいかを伝える

権限が無いのはアプリの不具合ではないので、スタッフが自分で解決できる文を出します。「保存に失敗しました」だけでは、店からの問い合わせがアプリの開発元に来ます。

  • どの権限が足りないか:「下書き注文」の「割引を適用」
  • 誰に頼めばいいか:ストアの管理者
  • 割引を入れなければ保存できること

割引を入れない下書き注文は今までどおり作れるので、割引の欄を空にして保存し直す道を残しておくと、スタッフの作業が止まりません。

アプリの直し方。1 下書き注文に割引を足している箇所を探す、2 その処理がオンラインのトークンで動いているか確かめる、3 いちばん上のerrorsのACCESS_DENIEDを拾う、4 スタッフに足りない権限と頼む相手を出す、5 権限の無いスタッフで動かして確かめる

確かめるときは、開発ストアに「割引を適用」の権限を外したスタッフを作り、そのスタッフでアプリを開いて、割引を入れた下書き注文を保存します。

店の側でやること

下書き注文に割引を入れるアプリを使っていて、11月18日からスタッフが保存できなくなった店は、そのスタッフの権限を見てください。

Shopifyのヘルプによると、「割引を適用」の権限には前提があります。権限の名前は英語のヘルプの表記で書きます。

  • 下書き注文の View と Create and edit の権限が要ります。見る権限と、作成や編集の権限です
  • 割引コードを使うには、これとは別に Discounts の権限も要ります

外部記事Store permissionsYou can assign store permissions to store roles to allow users to view and manage different areas of the Shopify admin for your store.help.shopify.comStore permissions

権限はロールごとに決まっているので、そのスタッフのロールを直すと、同じロールのスタッフ全員に効きます。割引を入れてよいスタッフだけに付けたいときは、ロールを分けてください。

割引を入れる権限をスタッフに持たせたくない店は、権限はそのままにして、割引の入った下書き注文は権限のある人が作る、という運用になります。今回の変更は、権限の無いスタッフがアプリを通せば割引を入れられた、という抜け道をふさぐものです。

さいごに

2026年11月18日から、スタッフとして動くアプリが下書き注文に割引を足すと、スタッフに「割引を適用」の権限が無いときは ACCESS_DENIED で保存ごと失敗します。エラーは userErrors ではなく、いちばん上の errors に入ります。

オンラインのトークンで下書き注文に割引を入れているアプリは、errors を拾うことと、足りない権限をスタッフに伝えることの2つを直してください。店から「下書き注文が保存されない」と言われたら、最初にそのスタッフの権限を見るのが近道です。

アプリのセキュリティに関わる、開発者に求められている対応の全体はアプリのセキュリティ対応の記事にまとめています。

下書き注文や見積のアプリの改修については、お問い合わせからお気軽にご相談ください。

シェアXFacebookLINEはてブ

Shopify のアプリ・テーマの開発を頼みたい方へ

記事のような開発(カスタムアプリ・テーマの改修・管理画面の拡張・外部のシステムとの連携)を引き受けます。仕様が固まっていなくても、やりたいことから一緒に整理して見積もります。

費用の目安はカスタムアプリの開発の費用にまとめています。

相談・見積もりは無料 / 通常24時間以内に返信