受注キャンセル時の在庫復元動作とwarningsやstock_quantityの変更

カラーミーショップ2026年8月19日破壊的変更

単一オプション商品の受注キャンセル時に在庫が戻るようになり、レスポンスにwarningsが含まれるほかstock_quantityの値が変わりました。

必要な対応

受注キャンセルのレスポンスを厳密なスキーマで検証している場合は、warningsの追加に対応してください。

変更点

オプションが1つで在庫を設定している商品で、restockにtrueを指定してキャンセルした際に購入分の在庫数が戻るようになりました。
受注キャンセルのレスポンスにwarningsが含まれるようになり、通知事項がある場合に返り、何もない場合は空配列が返ります。
warningsには警告の種類を表すcode、対象の受注明細IDを示すdetail_id、警告文のmessageが含まれます。
カート（購入完了後）のColorme.sale.itemsのstock_quantityが、オプションが1つの商品で購入されたオプションの在庫数を返すようになりました。

影響範囲

PUT /v1/sales/{sale_id}/cancelrestockwarningscodedetail_idmessageColorme.sale.itemsstock_quantity

公式ページを開く

この記事は Release Radar が独自に要約したもので、各社の公式発表ではありません。正確な内容は公式ページをお読みください。