はじめに
- 見積や受注、B2Bのアプリで、下書き注文に割引コードや自動割引を入れている
- 店から「アプリで下書き注文が保存されない」と言われたが、原因が分からない
userErrorsは空なのに、下書き注文ができていない
このような方のための記事です。
Shopifyは2026年11月18日、下書き注文に割引を足すAPIの決まりを変えました。スタッフとして動くアプリが割引を足そうとしたとき、そのスタッフに「割引を適用」の権限が無いと、下書き注文は保存されずにエラーが返ります。サポートされているすべてのAPIバージョンに、同じ日から効いています。
何が変わったのか
下書き注文は、電話やメールで受けた注文、B2Bの見積などを、店の人が管理画面で作る注文の下書きです。アプリからは draftOrderCreate と draftOrderUpdate で作ったり直したりします。
この2つのAPIで割引を足すとき、アプリを操作しているスタッフの権限が見られるようになりました。見られるのは、スタッフの権限の「下書き注文」の中にある「割引を適用」です。英語の管理画面では Draft orders の Apply discounts、APIの上では apply_discounts_to_draft_orders という名前です。
権限が無いスタッフで割引を足すと、次のようになります。
ACCESS_DENIEDのエラーが返ります- 下書き注文は保存されません。割引だけが外れて残りが保存される、という動きではありません
- 返ってくる結果の中身は
nullです


止められる操作と、今までどおり通る操作
止められるのは、割引を新しく足す操作だけです。
- 割引コードの追加:
discountCodesに、その下書き注文にまだ付いていないコードを入れる - 自動割引の受け入れ:自動割引を受け入れていない下書き注文で、
acceptAutomaticDiscountsをtrueにする
draftOrderCreate は新しく作るAPIなので、discountCodes に1つでもコードが入っているか、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つ目は、スタッフの画面には「保存しました」と出るのに、下書き注文はどこにも無い、という状態になります。

アプリの直し方
やることは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. スタッフに何をすればいいかを伝える
権限が無いのはアプリの不具合ではないので、スタッフが自分で解決できる文を出します。「保存に失敗しました」だけでは、店からの問い合わせがアプリの開発元に来ます。
- どの権限が足りないか:「下書き注文」の「割引を適用」
- 誰に頼めばいいか:ストアの管理者
- 割引を入れなければ保存できること
割引を入れない下書き注文は今までどおり作れるので、割引の欄を空にして保存し直す道を残しておくと、スタッフの作業が止まりません。

確かめるときは、開発ストアに「割引を適用」の権限を外したスタッフを作り、そのスタッフでアプリを開いて、割引を入れた下書き注文を保存します。
店の側でやること
下書き注文に割引を入れるアプリを使っていて、11月18日からスタッフが保存できなくなった店は、そのスタッフの権限を見てください。
Shopifyのヘルプによると、「割引を適用」の権限には前提があります。権限の名前は英語のヘルプの表記で書きます。
- 下書き注文の View と Create and edit の権限が要ります。見る権限と、作成や編集の権限です
- 割引コードを使うには、これとは別に Discounts の権限も要ります
権限はロールごとに決まっているので、そのスタッフのロールを直すと、同じロールのスタッフ全員に効きます。割引を入れてよいスタッフだけに付けたいときは、ロールを分けてください。
割引を入れる権限をスタッフに持たせたくない店は、権限はそのままにして、割引の入った下書き注文は権限のある人が作る、という運用になります。今回の変更は、権限の無いスタッフがアプリを通せば割引を入れられた、という抜け道をふさぐものです。
さいごに
2026年11月18日から、スタッフとして動くアプリが下書き注文に割引を足すと、スタッフに「割引を適用」の権限が無いときは ACCESS_DENIED で保存ごと失敗します。エラーは userErrors ではなく、いちばん上の errors に入ります。
オンラインのトークンで下書き注文に割引を入れているアプリは、errors を拾うことと、足りない権限をスタッフに伝えることの2つを直してください。店から「下書き注文が保存されない」と言われたら、最初にそのスタッフの権限を見るのが近道です。
アプリのセキュリティに関わる、開発者に求められている対応の全体はアプリのセキュリティ対応の記事にまとめています。
下書き注文や見積のアプリの改修については、お問い合わせからお気軽にご相談ください。

