draftOrderCreate / draftOrderUpdate をスタッフとして実行するアプリが、apply_discounts_to_draft_orders 権限の無いスタッフで割引を追加しようとすると ACCESS_DENIED。下書き注文は保存されず、エラーは userErrors ではなく トップレベル errors に返る。全サポート対象 API バージョンで適用。
apply_discounts_to_draft_orders 権限を持っていなければ、ミューテーション全体が ACCESS_DENIED で拒否される。null。エラーは userErrors には出ない。
トップレベル errors に ACCESS_DENIED。data.draftOrderUpdate(または draftOrderCreate)は null。変更は一切保存されない。
下書き注文の既存割引をそのまま残す、または外す操作はこれまで通り動く。拒否されるのは「追加」だけ。
| 操作(DraftOrderInput) | draftOrderUpdate | draftOrderCreate |
|---|---|---|
discountCodes にコードを入れる |
追加扱い 下書き注文にまだ無いコードを含む場合 | 追加扱い 空でなければ常に(下書き注文がまだ存在しないため) |
acceptAutomaticDiscounts: true |
追加扱い まだ自動割引を受け付けていない下書き注文で true にする場合 | 追加扱い true なら常に |
| 既存の割引を維持する | 従来通り | — |
| 既存の割引を外す | 従来通り | — |
mutation draftOrderUpdate($id: ID!, $input: DraftOrderInput!) {
draftOrderUpdate(id: $id, input: $input) {
draftOrder {
id
discountCodes
acceptAutomaticDiscounts
}
userErrors {
field
message
}
}
}
{
"id": "gid://shopify/DraftOrder/276395349",
"input": {
"discountCodes": ["SUMMER10"],
"acceptAutomaticDiscounts": true
}
}
{
"errors": [
{
"message": "Access denied for draftOrderUpdate field. Required access: `write_draft_orders` access scope. Also: The user must have access to manage draft orders.",
"locations": [{ "line": 2, "column": 3 }],
"path": ["draftOrderUpdate"],
"extensions": {
"code": "ACCESS_DENIED",
"documentation": "https://shopify.dev/api/usage/access-scopes",
"requiredAccess": "`write_draft_orders` access scope. Also: The user must have access to manage draft orders."
}
}
],
"data": {
"draftOrderUpdate": null
}
}
ペイロード自体が null なので、data.draftOrderUpdate.userErrors を読む実装はそこで止まる。
エラーの種別は extensions.code = "ACCESS_DENIED"、対象は path で判別できる。
draftOrderCreate も同じエラー。message と path が draftOrderCreate になり、data.draftOrderCreate が null。
draftOrderCreate または draftOrderUpdate をスタッフとして実行している。
割引コードの追加、または自動割引の有効化を前提にしている。
スタッフが apply_discounts_to_draft_orders 権限を持っていることを担保していない。
offline アクセストークンでのリクエストなど。
既存割引の維持・削除のみを行うリクエスト。
スタッフとして draftOrderCreate / draftOrderUpdate を呼び、discountCodes や acceptAutomaticDiscounts を渡している箇所を特定。
userErrors だけでなく、トップレベルの errors 配列で ACCESS_DENIED を検知する処理を入れる。
割引の追加が必要なら、スタッフに「下書き注文」配下の Apply discounts 権限を付けてもらう。
draftOrderCreate / draftOrderUpdate / DraftOrderInput / Store permissions(いずれも shopify.dev)。失敗判定を userErrors.length だけで行うと、ペイロード null で例外になるか「成功」と誤判定する恐れがある。記事は エラー処理の更新が必要と明記。
特定 API バージョンからの変更ではなく、サポートされている全バージョンが対象。バージョンを据え置いても挙動は変わる。
例のレスポンスの message / requiredAccess には write_draft_orders スコープの文言が出ている。原因が割引権限であることは文面からは読み取りにくいため、extensions.code と path で分岐するのが安全。
Update は既存に無いコードの追加/自動割引の新規 ON だけが対象。Create は空でない discountCodes や acceptAutomaticDiscounts: true が常に追加扱い。既存値をそのまま送り直すだけなら Update では引っかからない。
影響を受けるのはスタッフとして動くリクエストのみ。offline アクセストークンなどスタッフとして動かないリクエストは対象外。自社アプリがどちらのトークンで下書き注文 API を叩いているかの棚卸しが、影響調査の最短ルート。
userErrors だけで判定しており、今回の ACCESS_DENIED を取りこぼす可能性がある。draftOrderCreate / draftOrderUpdate を呼ぶ箇所を棚卸しし、トップレベル errors の ACCESS_DENIED を検知する共通処理を追加。extensions.code と path(draftOrderCreate / draftOrderUpdate)で。ペイロードが null になる前提で null 安全に書く。draftOrderUpdate で明細変更と割引追加をまとめて送っているため、権限不足だと明細の変更まで保存されない。discountCodes の新規コード、acceptAutomaticDiscounts: true)を含むかどうかを送信前に判定し、必要に応じて割引以外の更新を先に送るよう設計を見直す。discountCodes が常に追加扱いなので、権限が無いスタッフでは割引なしで作成する分岐が必要。apply_discounts_to_draft_orders 権限が必須に。