[{"id":"d4ac365f6dd3","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/fix_v1_sales_cancel_restock_20260813","publishedAt":"2026-08-19","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"breaking","importance":3,"actionRequired":true,"deadline":null,"title":{"ja":"受注キャンセル時の在庫復元動作とwarningsやstock_quantityの変更","en":"Restock behavior on cancel sale, warnings field, and stock_quantity changed"},"summary":{"ja":"単一オプション商品の受注キャンセル時に在庫が戻るようになり、レスポンスにwarningsが含まれるほかstock_quantityの値が変わりました。","en":"Stock now restores when canceling single-option items, cancel responses include warnings, and stock_quantity values have changed."},"points":{"ja":["オプションが1つで在庫を設定している商品で、restockにtrueを指定してキャンセルした際に購入分の在庫数が戻るようになりました。","受注キャンセルのレスポンスにwarningsが含まれるようになり、通知事項がある場合に返り、何もない場合は空配列が返ります。","warningsには警告の種類を表すcode、対象の受注明細IDを示すdetail_id、警告文のmessageが含まれます。","カート（購入完了後）のColorme.sale.itemsのstock_quantityが、オプションが1つの商品で購入されたオプションの在庫数を返すようになりました。"],"en":["Purchased stock is now restored when canceling orders with restock set to true for single-option products with per-option inventory.","Cancel sale responses now include warnings, returning notices when applicable or an empty array when there are none.","The warnings array includes code for the warning type, detail_id for the sales detail ID, and message for the warning text.","Colorme.sale.items stock_quantity on the post-purchase cart now returns the purchased option stock for single-option products."]},"targets":["PUT /v1/sales/{sale_id}/cancel","restock","warnings","code","detail_id","message","Colorme.sale.items","stock_quantity"],"action":{"ja":"受注キャンセルのレスポンスを厳密なスキーマで検証している場合は、warningsの追加に対応してください。","en":"Update your integration to handle warnings if you validate cancel sale responses against a strict schema."},"images":[]},{"id":"d9d1bf94a3b9","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/fix_soldout_display_20260814","publishedAt":"2026-08-19","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"breaking","importance":4,"actionRequired":true,"deadline":null,"title":{"ja":"商品や在庫情報APIの soldout_display が管理画面の設定どおりの値を返すようになりました","en":"soldout_display in product and stock APIs now returns values matching shop settings"},"summary":{"ja":"カラーミーショップ APIの商品や在庫情報で反転していた soldout_display の真偽値が実際の設定に沿った値に変わりました。","en":"The soldout_display boolean in Colorme Shop API now reflects actual store settings instead of returning inverted values."},"points":{"ja":["「売り切れ時の商品表示」で「商品を表示する」設定時は true、「商品を表示しない」設定時は false が返ります。","商品ごとの「売り切れ時の商品表示」が未設定の場合は「在庫表示設定」の「売り切れ時」の設定値に従って返ります。","商品ごとの設定は在庫表示設定よりも優先して適用されます。","商品データの追加や更新のリクエストでは soldout_display を指定できないため、書き込み処理には影響しません。"],"en":["When out-of-stock display is set to display products, true is returned, and when set to not display products, false is returned.","If the per-product out-of-stock display setting is unconfigured, the value follows the out-of-stock setting in stock display settings.","Per-product settings take priority over stock display settings.","Write operations are unaffected because soldout_display cannot be specified in product creation or update requests."]},"targets":["soldout_display","GET /v1/products","GET /v1/products/{id}","POST /v1/products","PUT /v1/products/{id}","GET /v1/stocks"],"action":{"ja":"soldout_display の値を反転して解釈する処理を実装している場合は、その処理を外してください。","en":"If you implemented logic to invert the value of soldout_display, remove that processing."},"images":[]},{"id":"4217767da965","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_webhook_sale_created_20260806","publishedAt":"2026-08-06","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで受注作成時に通知するWebhookを利用できるようになりました","en":"You can now receive Webhook notifications when an order is created"},"summary":{"ja":"管理画面から通知先を登録すると受注作成時に外部サービスでWebhook通知を受信できます。","en":"By configuring an endpoint URL in the admin settings, you can now receive automated notifications whenever an order is created."},"points":{"ja":["初回に対応するイベントは sale.created のみです","ペイロードの data に含まれる情報は sales_id と account_id のみです","Standard Webhooks 準拠の署名ヘッダが付与され、whsec_ で始まるシークレットで検証できます","通知先URLは1ショップにつき3件まで登録でき、255文字以内の https のみでプライベートネットワークは登録できません","フリープランおよび for ロリポップ・for ヘテムル・for グーペでは利用できません"],"en":["The only supported event at launch is sale.created.","Payload data contains only sales_id and account_id.","Standard Webhooks signature headers are attached and can be verified with secrets starting with whsec_.","Up to 3 endpoint URLs per shop can be registered, requiring HTTPS within 255 characters and excluding private networks.","The feature is unavailable on the Free plan, for Lolipop, for heteml, and for Goope."]},"targets":["sale.created","GET /v1/sales/:id","webhook-id","webhook-timestamp","webhook-signature","sales_id","account_id"],"action":null,"images":[]},{"id":"6e0a203a7f96","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_delete_v1_products_id_images_position_20260701","publishedAt":"2026-07-01","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで商品画像を削除できるようになりました","en":"You can now delete product images using the Colorme Shop API"},"summary":{"ja":"商品IDと表示位置を指定して特定の商品画像を個別に削除できます。","en":"By specifying the product ID and image position, you can now remove individual product images."},"points":{"ja":["position は 0 でメイン画像とサムネイル、1から3でサブ画像、4から49で追加画像が削除されます。","削除した画像以外の position はそのまま維持されます。","リクエスト成功時は 204 No Content が返り、レスポンスボディはありません。","APIの実行には write_products スコープが必要です。"],"en":["For position, 0 deletes the main image and thumbnail, 1 to 3 deletes sub-images, and 4 to 49 deletes additional images.","The positions of images other than the deleted one are preserved.","A 204 No Content response is returned with no response body upon successful request.","The write_products scope is required to execute the API."]},"targets":["DELETE /v1/products/{product_id}/images/10","position","write_products"],"action":null,"images":[]},{"id":"5fedfae77693","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_analytics_v1_20260617","publishedAt":"2026-06-17","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ アナリティクス APIで分析データを取得できるようになりました","en":"You can now retrieve analytics data using Color Me Shop Analytics API"},"summary":{"ja":"店舗や商品ごとのアクセス状況や売上の集計データをAPI経由で取得できます。","en":"You can now retrieve aggregated metrics for store and product traffic and sales through the API."},"points":{"ja":["利用には認可スコープ read_analytics の指定と対象ショップへのカラーミーアナリティクスの導入が必要です","時系列型エンドポイントは期間内の各日を1件とする日次バケットの並びを返しデータがない日も0埋めされます","スナップショット型エンドポイントは指定日または指定月の集計値を返します","アクセス可能な期間は最新集計日（GET /analytics/v1/last_aggregated_date）から18か月以内です","日付と時間帯は日本時間（JST、Asia/Tokyo）基準でエラーは errors 配列形式（code・message・status）で返されます"],"en":["Using the API requires the read_analytics authorization scope and installing Color Me Analytics on the target shop.","Time-series endpoints return a sequence of daily buckets for each day in the period, zero-filling days without data.","Snapshot endpoints return aggregated values for the specified day or month.","The accessible period is within 18 months from the latest aggregation date (GET /analytics/v1/last_aggregated_date).","Dates and times are based on JST (Asia/Tokyo), and errors are returned in the errors array format (code, message, status)."]},"targets":["read_analytics","GET /analytics/v1/shop","GET /analytics/v1/referrers","GET /analytics/v1/access_by_hour","GET /analytics/v1/products","GET /analytics/v1/products/{product_id}/time_series","GET /analytics/v1/products/{product_id}/referrers","GET /analytics/v1/last_aggregated_date"],"action":null,"images":[]},{"id":"6173c3852a83","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_v1_products_id_options_and_values_20260617","publishedAt":"2026-06-17","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで商品オプションと商品オプション値を追加および削除できるようになりました","en":"You can now add and delete product options and option values via Color Me Shop API"},"summary":{"ja":"商品バリエーションが自動構成されるオプションやオプション値の管理エンドポイントをβ版として利用できます。","en":"You can now use four beta endpoints to manage product options and values, with variations automatically configured accordingly."},"points":{"ja":["エンドポイントの利用にはOAuthスコープ write_products が必要です","商品オプションは1商品あたり最大2つまで設定できます","商品オプションの追加時に構成される商品バリエーションの stocks は null になります","商品オプションに紐づく最後の商品オプション値を削除しようとすると422エラーが発生します","4つのエンドポイントはβ版であり、提供期間中に仕様や挙動が変わる可能性があります"],"en":["Using the endpoints requires the write_products OAuth scope","You can set up to two product options per product","The stocks value for product variations configured upon adding a product option becomes null","Attempting to delete the last option value associated with a product option results in a 422 error","The four endpoints are in beta, and specifications or behavior may change during the period"]},"targets":["POST /v1/products/{product_id}/options","DELETE /v1/products/{product_id}/options/{id}","POST /v1/products/{product_id}/options/{option_id}/values","DELETE /v1/products/{product_id}/options/{option_id}/values/{id}"],"action":null,"images":[]},{"id":"f06436aa04f6","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_put_v1_products_id_variants_id_20260612","publishedAt":"2026-06-12","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで商品バリエーションを更新できるようになりました","en":"You can now update product variants in the Color Me Shop API"},"summary":{"ja":"商品IDとバリエーションIDを指定して、指定した項目のみを1件更新できます。","en":"You can now update a single product variant by specifying its IDs, modifying only the fields included in the request."},"points":{"ja":["利用にはOAuthスコープwrite_productsが必要です。","全バリエーションのstocksが未設定の状態で0以上を指定すると、他のバリエーションは0になり商品全体の在庫数も指定値に揃います。","フリープランを利用するショップではoption_priceとoption_members_priceの最低価格が100円です。","weight、option_price、option_members_price、option_market_price、option_costにnullを明示的に指定すると未設定状態に戻ります。"],"en":["The OAuth scope write_products is required.","Setting stocks to 0 or more when all variant stocks are unset sets other variants to 0 and matches total product stock to the specified value.","For shops on the Free plan, the minimum price for option_price and option_members_price is 100 yen.","Explicitly specifying null for weight, option_price, option_members_price, option_market_price, or option_cost resets them to an unset state."]},"targets":["write_products","stocks","few_num","model_number","weight","option_price","option_members_price","option_cost"],"action":null,"images":[]},{"id":"ffa4cb78d6c9","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_get_v1_products_id_variants_id_20260526","publishedAt":"2026-05-26","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで商品オプションを1件取得できるようになりました","en":"You can now retrieve a single product option via the Colorme Shop API"},"summary":{"ja":"商品IDと商品オプションIDを指定して該当する商品オプションの情報を取得できます。","en":"You can retrieve details of a specific product option by specifying its product ID and product option ID."},"points":{"ja":["利用にはOAuthスコープ read_products が必要","レスポンス項目の詳細は商品オプション一覧の取得と同一"],"en":["Using the endpoint requires the read_products OAuth scope","Response field details are identical to those for retrieving a list of product options"]},"targets":["商品オプションの取得","read_products"],"action":null,"images":[]},{"id":"532acea607b7","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_cli_skills_20260410","publishedAt":"2026-04-10","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ CLIとSkillsでターミナルやAIエージェントから操作できるようになりました","en":"You can now operate Color Me Shop via the CLI and AI agent skills"},"summary":{"ja":"OAuth 2.0認証を使ってターミナルからAPIやファイルを操作し、MCPを通じてAIエージェントとも連携できるようになりました。","en":"You can now manage APIs and files from the terminal using OAuth 2.0 and integrate shop operations into AI agents via MCP."},"points":{"ja":["Node.js v20以上の環境でnpmから@colorme/cliをインストールして利用できます。","colorme setupで認証するために、リダイレクトURIをhttp://127.0.0.1/callbackに設定したOAuthアプリを事前に登録する必要があります。","colorme apiでREST APIを呼び出せ、colorme api-docsでエンドポイント一覧や詳細を確認できます。","colorme templateでテンプレートの取得やプレビュー、colorme ftpで静的ファイルの同期や送受信ができます。","colorme skill installでClaude CodeなどのAIエージェントにMCPスキルを導入でき、デフォルトで~/.claude/skills/に保存されます。"],"en":["You can install @colorme/cli via npm on Node.js v20 or higher.","You must register an OAuth app with redirect URI http://127.0.0.1/callback beforehand to authenticate via colorme setup.","You can call REST APIs with colorme api and view endpoint lists and details with colorme api-docs.","You can download and preview templates with colorme template, and sync or transfer static files with colorme ftp.","You can install MCP skills into AI agents such as Claude Code using colorme skill install, which saves to ~/.claude/skills/ by default."]},"targets":["@colorme/cli","colorme setup","colorme api","colorme api-docs","colorme template","colorme ftp","colorme docs","colorme skill"],"action":null,"images":[]},{"id":"ebd4aac9f35a","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_v1_templates_20260409","publishedAt":"2026-04-09","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIでテンプレートの取得や更新ができるようになりました","en":"You can now retrieve and update templates via the Color Me Shop API"},"summary":{"ja":"ショップが保有するHTMLテーマの一覧確認やページ別の編集、プレビュー表示用URLの発行ができるようになりました。","en":"You can now list HTML themes, retrieve or update content by page, and obtain preview URLs through the API."},"points":{"ja":["GET /v1/templates と read_templates スコープでテンプレート一覧を取得できます","GET /v1/templates/{template_id}/pages/{page_type} と read_templates スコープで指定ページの HTML や CSS を取得できます","PUT /v1/templates/{template_id}/pages/{page_type} と write_templates スコープで指定ページの HTML や CSS を更新できます","GET /v1/templates/{template_id}/preview_url と read_templates スコープで有効期限が1時間のプレビュー表示用 URL を取得できます"],"en":["You can retrieve the template list using GET /v1/templates with the read_templates scope.","You can retrieve the HTML and CSS of a page using GET /v1/templates/{template_id}/pages/{page_type} with the read_templates scope.","You can update the HTML and CSS of a page using PUT /v1/templates/{template_id}/pages/{page_type} with the write_templates scope.","You can obtain a preview URL valid for 1 hour using GET /v1/templates/{template_id}/preview_url with the read_templates scope."]},"targets":["GET /v1/templates","GET /v1/templates/{template_id}/pages/{page_type}","PUT /v1/templates/{template_id}/pages/{page_type}","GET /v1/templates/{template_id}/preview_url","read_templates","write_templates"],"action":null,"images":[]},{"id":"d21943da8ff5","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_post_v1_products_id_images_20260316","publishedAt":"2026-03-16","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"new_feature","importance":4,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで商品画像を登録できるようになりました","en":"You can now register product images using the Color Me Shop API"},"summary":{"ja":"商品IDに対して画像ファイルと表示位置を直接送信し、メイン画像やその他画像を設定できます。","en":"You can set main and additional images by sending an image file and display position for a specified product ID."},"points":{"ja":["最大5MBのJPEG、PNG、GIF画像（image）と表示位置（position、0〜49）をmultipart/form-data形式で送信できます。","positionに0を指定するとサムネイル付きのメイン画像になり、1〜49を指定するとその他画像の表示順に設定されます。","同じpositionに画像が既に存在する場合は上書きされます。","利用にはread_productsおよびwrite_productsのスコープが必要です。","レート制限は10秒あたり5リクエストまでで、利用者が多い場合は一時的に503ステータスコードが返る可能性があります。"],"en":["You can upload JPEG, PNG, or GIF images up to 5MB (image) with a display position of 0 to 49 (position) using multipart/form-data.","Setting position to 0 creates a main image with a thumbnail, while 1 to 49 sets the display order for additional images.","Existing images are overwritten if an image already exists at the specified position.","The read_products and write_products scopes are required.","The rate limit is 5 requests per 10 seconds, and a 503 status code may be returned temporarily during high traffic."]},"targets":["image","position","read_products","write_products"],"action":null,"images":[]},{"id":"686a945c6abf","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_get_v1_products_id_images20260122","publishedAt":"2026-01-22","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"商品IDを指定してすべての商品画像を取得できるようになりました","en":"You can now retrieve all product images by specifying a product ID"},"summary":{"ja":"商品IDをリクエストに含めることで対象商品に紐づく画像の一覧をエンドポイント経由で取得できます。","en":"You can now fetch all images registered for a product through a dedicated endpoint by providing the target product ID."},"points":{"ja":["レスポンスから商品IDのidおよびposition（0〜49の整数）とurl（文字列）を含むimagesを取得できます","レスポンスにname、mobile_name、mobile_urlの各キーは含まれません"],"en":["You can retrieve the product ID id and images containing position (integer 0-49) and url (string) in the response","The keys name, mobile_name, and mobile_url are not included in the response"]},"targets":["id","images","position","url","name","mobile_name","mobile_url"],"action":null,"images":[]},{"id":"8a76848a0eb4","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_delete_v1_customers_id_membership20260106","publishedAt":"2026-01-06","firstSeenAt":"2026-11-03T12:09:19.668Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで顧客の会員ランクの紐付きを解除できるようになりました","en":"You can now unlink customer member ranks via the Color Me Shop API"},"summary":{"ja":"カラーミーショップ APIのエンドポイントを通じて顧客に紐づく会員ランクを解除できます。","en":"You can now remove member ranks associated with customers through the Color Me Shop API."},"points":{"ja":["カラーミーショップ アプリストアで提供されている「会員ランク」を利用しているショップでのみ利用可能"],"en":["Only available for shops using the Member Rank app provided in the Color Me Shop App Store"]},"targets":[],"action":null,"images":[]},{"id":"c5b4f90cbcd3","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_put_v1_customers_id_membership20251216","publishedAt":"2025-12-17","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで顧客の会員ランクを更新できるようになりました","en":"You can now update customer membership ranks via the Colorme Shop API"},"summary":{"ja":"カラーミーショップ APIで、指定した会員ランクIDを用いて対象顧客の所属ランクを変更できるようになりました。","en":"You can now change a customer's assigned rank by specifying a membership rank ID via the Colorme Shop API."},"points":{"ja":["リクエストボディの membership_id（文字列）に会員ランクIDを指定します","アプリストアの「会員ランク」を利用しているショップでのみ動作します"],"en":["Specify the membership rank ID as a string in the membership_id request body field","This only works for shops using the \"会員ランク\" app from the app store"]},"targets":["membership_id"],"action":null,"images":[]},{"id":"8e56d0ec08ac","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_v1_reviews_20251112","publishedAt":"2025-11-12","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIでレビュー一覧を取得できるようになりました","en":"You can now retrieve a list of reviews via the Colorme Shop API"},"summary":{"ja":"ショップで管理しているレビュー情報の一覧をAPI経由で取得できるようになりました。","en":"You can now retrieve a list of review information managed in your shop through the API."},"points":{"ja":["リクエストパラメータとしてlimitとoffsetを指定できます。","レビューID、評価、コメント、商品ID、顧客情報、ショップからの返信などの情報を取得できます。"],"en":["You can specify limit and offset as request parameters.","You can retrieve review details including review ID, rating, comment, product ID, customer info, and shop replies."]},"targets":["limit","offset","id","product_id","customer","reply","status","star"],"action":null,"images":[]},{"id":"2b4f6f915808","vendor":"colorme","product":"api","url":"https://developer.shop-pro.jp/news/releases/release_post_v1_sales_payment_urls_20251030","publishedAt":"2025-10-30","firstSeenAt":"2026-11-03T12:51:41.058Z","category":"new_feature","importance":3,"actionRequired":false,"deadline":null,"title":{"ja":"カラーミーショップ APIで未決済受注の決済URLを発行可能に","en":"Issue payment URLs for unpaid orders via Colorme Shop API"},"summary":{"ja":"カラーミーショップ APIで、未決済の受注を指定して顧客向けの決済用URLを発行できるようになりました。","en":"You can now generate payment URLs for unpaid orders using the Colorme Shop API."},"points":{"ja":["レスポンスにpayment_urlとexpires_atが含まれます。","canceledがfalseかつpaidがfalseの未決済受注を指定してリクエストできます。","イプシロンのクレジットカード決済やコンビニ決済など、対応する決済方法の受注で利用できます。"],"en":["The response includes payment_url and expires_at.","Requests can be made for unpaid orders where canceled is false and paid is false.","Supported payment methods include Epsilon credit card, convenience store, and other compatible options."]},"targets":["決済URL発行","payment_url","expires_at"],"action":null,"images":[]}]