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・開発者向け】POS UI extensions のカート操作、2026-10 で未確認の変更をエラーに

【Shopify最新ニュース2026・開発者向け】POS UI extensions のカート操作、2026-10 で未確認の変更をエラーに

2026 10/08
2026年10月8日
Shopify POSの開発者向けの変更を伝える記事のアイキャッチ:木の作業台で薄紙の入った段ボール箱を両手で持つ写真に、スマートフォンと紙テープ、「POSのカート変更 未確認ならエラーに」の見出し

開発者向けの変更です。

POS が確かめられないカートの変更は、エラーになります

対象は、POS UI extensions の API バージョン 2026-10。

Cart API のカート操作が、Shopify POS の確認を待つ形に変わります。

掲載は2026年10月7日、開発者向けの Changelog。

出典: Shopify developer changelog「Cart mutations reject unconfirmed writes in POS UI extensions 2026-10」2026年10月7日
https://shopify.dev/changelog/cart-mutations-reject-unconfirmed-writes-in-pos-ui-extensions-2026-10

  • Version: 2026-10
  • Flags: Breaking API Change / Action required
  • Surfaces: API
  • Affected APIs: POS Extensions

In POS UI extensions API version 2026-10, Cart API mutations reject when Shopify POS doesn’t confirm that the cart changed. In earlier versions these mutations resolve whether or not POS applied the write.
(POS UI extensions の API バージョン 2026-10 では、Shopify POS がカートの変更を確認しないとき、Cart API のミューテーションは reject します。これまでのバージョンでは、POS が書き込みを反映したかどうかに関係なく、これらのミューテーションは resolve していました)

これまでは、反映されてもされなくても「成功」で返っていました。

いまは、消えた変更に気づけません

公式は、いまの問題をこう書いています。

Earlier API versions resolve the mutation regardless of that result, so an app can’t tell an applied write from a dropped one, and an app can show a fee or a discount as applied when the cart never changed.
(これまでの API バージョンは、結果に関係なくミューテーションを resolve するので、アプリは反映された書き込みと落ちた書き込みを見分けられず、カートが変わっていないのに、手数料や割引を適用済みと表示することがあります)

A dropped cart write is silent today. Rejection turns that silent data loss into an error at the call site, where an app can retry, surface a message to the staff, or roll back its own state.
(いまは、落ちたカートの書き込みは何も知らせません。reject にすることで、その静かなデータの消失が呼び出した場所でのエラーになり、アプリはやり直す、スタッフにメッセージを出す、自分の状態を戻す、のいずれかができます)

アプリが打てる手は、3つ。

  1. やり直す
  2. スタッフにメッセージを出す
  3. アプリの側の状態を戻す

reject するカート操作は、次のとおりです

2026-10 で reject するのは、次のミューテーションです。

  • bulkCartUpdate
  • removeLineItem
  • applyCartDiscount
  • addCartCodeDiscount
  • removeAllDiscounts
  • setCustomer
  • removeCustomer
  • addLineItemProperties
  • bulkAddLineItemProperties
  • removeLineItemProperties
  • setLineItemDiscount
  • bulkSetLineItemDiscounts
  • removeLineItemDiscount
  • addLineItemSellingPlan
  • removeLineItemSellingPlan
  • updateLineItemQuantity — 2026-10 で新しく入り、最初から reject する

エラーの理由は2通りです

確認できなかった書き込みは、2つのメッセージのどちらかで返ります。

POS refused the cart update. The cart was not changed.
(POS がカートの更新を断りました。カートは変わっていません)

公式の例は、レジ担当が支払いの画面に進んだ後。カートの編集ができる状態に戻れば、やり直しで通ることがあります。

POS could not confirm the cart update. The outcome is unknown and a partial write is possible. Read the cart before you retry.
(POS はカートの更新を確認できませんでした。結果は不明で、一部だけ書き込まれた可能性があります。やり直す前にカートを読んでください)

ほかの理由でも reject は起きます。公式の例は、割引の値が正しくない場合と、顧客が無い場合です。

影響は、2026-10 に上げた拡張機能だけです

切り替えはストアごとではなく、拡張機能ごと。

The change applies per extension, based on the API version the extension declares, not per store.
(この変更は、ストアごとではなく、拡張機能が宣言する API バージョンに基づいて、拡張機能ごとに適用されます)

Apps on 2026-07 and earlier keep the current behavior with no changes.
(2026-07 以前のアプリは、何も変わらず今の動きのままです)

すでに try / catch や .catch() で囲んでいるアプリは、確認できなかった書き込みのときにその処理が走ります。

備えずに上げると、処理が途中で止まることがあります

公式の注意書きは、次のとおり。

Calls that previously resolved now reject. If a rejection isn’t caught, the rest of your handler doesn’t run, including any UI you render after the write and any cleanup such as clearing a loading state.
(これまで resolve していた呼び出しが reject するようになります。reject を受け止めないと、ハンドラの残りは実行されず、書き込みの後に描く UI や、読み込み中の表示を消すような後始末も走りません)

Apps that bump without handling rejection will see handlers stop at the first unconfirmed write, which can leave a spinner on screen or skip a confirmation step.
(reject に備えずに上げたアプリは、最初の確認できなかった書き込みでハンドラが止まり、画面に読み込み中の表示が残ったり、確認の手順が飛ばされたりすることがあります)

開発者がやることは、先に備えてから上げることです

公式の手順は2段。

  1. 拡張機能が呼ぶすべてのカート操作に、reject への備えを足す
  2. そのあとで api_version = "2026-10" にする

If you can’t migrate immediately, keep the extension on 2026-07 or earlier. Those versions aren’t affected, and you can bump after the handling is in place.
(すぐに移行できないなら、拡張機能を 2026-07 以前のままにしてください。それらのバージョンは影響を受けず、備えができてから上げられます)

2026-07 は、API のバージョン管理のサポート期間が終わるまで使えます。

🔴 公式に書かれていないこと

  • 2026-07 のサポートがいつ終わるかは、この Changelog には書かれていません。書かれているのは “until it reaches the end of its support window under API versioning” だけです
  • どの POS アプリ・拡張機能が影響を受けるかの一覧は書かれていません
  • 手数料や割引の表示のずれが、実際の店でどれだけ起きていたかは書かれていません
  • スタッフに見せるメッセージの文面や画面は書かれていません。コード例の中の文言はアプリ側の例です
  • 日本のストアで使えるか・使えるプランの条件は書かれていません
  • 関連ドキュメント(Cart API・2026-10 のリリースノート・API versioning)のリンクの先は、本記事では読んでいません
  • 🔴 本記事は日本のストアで確認していません。上の記載が無いことをもって「影響がある」とも「影響がない」とも書きません

POS のアプリを使う店がやること

  1. POS の画面で割引・顧客・数量を扱うアプリを使っている店は、提供元に 2026-10 への対応予定を聞く
  2. 自社で POS UI extensions を作っている場合は、カート操作の呼び出しに reject への備えがあるかを見直す
  3. 備えができるまでは、拡張機能を 2026-07 以前のままにしておける

🔵 上の手順はキクシル編集部の整理で、公式の記載ではありません。

出典

  • Shopify developer changelog「Cart mutations reject unconfirmed writes in POS UI extensions 2026-10」2026年10月7日
    https://shopify.dev/changelog/cart-mutations-reject-unconfirmed-writes-in-pos-ui-extensions-2026-10

上記の Shopify 公式の情報だけを一次情報として使っています。
次の事項は「未確認」として扱い、推測で補っていません。

  • 2026-07 のサポートの終わりの日付
  • 影響を受けるアプリの一覧
  • 表示のずれが実際に起きていた頻度
  • スタッフに見えるメッセージと画面
  • 日本のストアでの提供の有無とプランの条件
Shopifyニュース 機能解説・レビュー
API変更 POS shopify Shopifyアプリ
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • 【Shopify最新ニュース2026】Shopify Analytics で発注書を分析、レポートが3つ追加
  • 【Shopify最新ニュース2026】ストアのポリシーを自動生成、設定を変えると自動で更新

この記事を書いた人

テスタのアバター テスタ

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

関連記事

  • Shopifyニュースのアイキャッチ:紺色の台に敷いた灰色のフェルトの上で、テープで閉じた段ボール箱に両手を置く写真に「Rollouts の変更の適用結果を読める API 2027-01 から」の見出し
    【Shopify最新ニュース2026・開発者向け】API 2027-01 で、Rollouts の変更の適用結果を applyResult で読めるように
    2026年11月21日
  • Shopifyニュースのアイキャッチ:木の机の上で、クラフト紙に包んだ陶器のマグカップを両手で持つ写真に「サーバーピクセル更新 ユーザーアクセスが必要に」の見出し
    【Shopify最新ニュース2026・開発者向け】サーバーピクセルの更新2つにアプリへのユーザーアクセスが必要に
    2026年11月21日
  • Shopifyニュースのアイキャッチ:灰色の石の台の上で、白い箱にたたんだ麻の布を詰める両手の写真に「統合レシートエディタなら POS の送るレシートが印刷と同じ内容に」の見出し
    【Shopify最新ニュース2026】Shopify POS、統合されたレシートエディタを使っている場合はメールとテキストのレシートが印刷レシートと同じ内容に
    2026年11月21日
  • Shopifyニュースのアイキャッチ:傷のある木の机の上で、薄紙の入った小さな段ボール箱を両手で開ける写真に「Shopify Flow に8つの更新トリガー」の見出し
    【Shopify最新ニュース2026】Shopify Flow に注文や顧客など8つの「更新」トリガーが追加
    2026年11月21日
  • Shopifyニュースのアイキャッチ:竹のすだれの上で、クラフト紙の封筒と薄紙に並ぶ小さな丸い缶に手を添える写真に「定期購入の更新でストアクレジットが選べる」の見出し
    【Shopify最新ニュース2026・開発者向け】定期購入の更新にストアクレジットを使えるように、API に allowStoreCredit
    2026年11月20日
  • Shopifyニュースのアイキャッチ:段ボール箱の中のベージュのスニーカーに両手を添える写真に「カゴ落ちの回復URLに顧客データの承認が必要」の見出し
    【Shopify最新ニュース2026・開発者向け】abandonedCheckoutUrl を読むアプリに、顧客データ4項目の承認が必要に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:紺色の台の上で、灰色のニットを白い薄紙で包む両手と段ボール箱の写真に「12月1日以降の新しいカスタムアプリに期限付きトークンが必須」の見出し
    【Shopify最新ニュース2026・開発者向け】12月1日以降に作るカスタムアプリは期限付きのオフライントークンが必須に
    2026年11月20日
  • Shopifyニュースのアイキャッチ:木の机の上で、クラフト紙に包んだ陶器のマグカップを両手で持つ写真に「ストアで動くアプリに接続先の宣言が必須に」の見出し
    【Shopify最新ニュース2026・開発者向け】オンラインストアで動くアプリに network access の宣言が必須に
    2026年11月20日

最近の投稿

  • Shopify のスタッフのアカウントを見直す — 役割と許可、プランごとの人数の上限
  • お店の文字を整える — テーマのフォントを変える手順
  • 【Shopify最新ニュース2026・開発者向け】API 2027-01 で、Rollouts の変更の適用結果を applyResult で読めるように
  • 【Shopify最新ニュース2026・開発者向け】サーバーピクセルの更新2つにアプリへのユーザーアクセスが必要に
  • 【Shopify最新ニュース2026】Shopify POS、統合されたレシートエディタを使っている場合はメールとテキストのレシートが印刷レシートと同じ内容に

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

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

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

目次