このページでは API の機能追加・変更をお知らせします（Keep a Changelog 形式）。
現在の API バージョンはレスポンスヘッダ X-API-Version で確認できます。
/v1 のパスは後方互換を維持します（既存の連携を壊す変更は行いません。
やむを得ず互換性のない変更が必要な場合は新しいパスを並行提供し、十分な移行期間を設けてこのページで告知します）。
get_cart / add_to_cart / update_cart_item / remove_cart_item / set_cart_ship_to）の応答に、
バイヤーポータルで同じカートを開くリンク portal_cart_url を追加しました。AI が組んだカートの内容をポータルで確認し、
そのまま注文できます（カードの登録もポータルで行えます）。REST API の応答は変わりませんstock_observed_at は在庫の最新の確認日時（最後に確認した時刻と、在庫数が最後に変わった時刻のうち新しい方）を返すようになりましたexpected_arrival を null で返します。予約注文（POST /v1/preorders と quote）は
422 PREORDER_ARRIVAL_UNDETERMINED になります。has_preorder と preorder=only|exclude は、予約注文できるバリエーションだけで判定しますGET /v1/products?q=・MCP search_products）を改善しました弁当箱 保冷）。商品名・ブランド名に加えて型番・カテゴリ名・バリエーション名も対象になり、
カタカナ / ひらがな・全角 / 半角の表記ゆれを吸収します（例: マグカップ と まぐかっぷ は同じ結果）q を指定したときの並びが関連度順になりました（ブランド・型番の完全一致 > 商品名に語句 > 商品名に各語 > その他、同点は更新日時の新しい順）。
従来の更新日時順にするには sort=updated を指定してください。q を指定しないときの並びは従来どおりですq=4901234567894,4909876543214）。バリエーションの JAN も従来どおり対象ですq が英数字 1 文字だけのときは 400 INVALID_QUERY を返します（漢字・かなの 1 文字は従来どおり検索できます）towel や Handtuch でタオルが見つかりますbuyer_price）が割引後の価格になり、
その価格で注文されます（注文の内訳・請求書の形・上代 retail_price は変わりません）campaign（code / label / rate_pct / ends_at）を追加しました。実施中でないときは null ですlist_price（通常卸価格）、商品一覧の各商品に min_list_price / max_list_price を追加しました。
常に返り、キャンペーン適用中は buyer_price より高く、それ以外は buyer_price と同額です（合計計算には使われません）PRICE_CHANGED になります（カートを取り直してから注文してください）?format=jpeg を付けると、原寸を JPEG で返すようにしました（?w=240|800 との併用は不可・無指定は従来どおり）。
WebP を受け付けない取込先にお使いくださいship_to.postal_code・PUT /v1/cart/ship-to・予約 quote の ship_to_postal_code）は
7 桁（ハイフン任意・全角可）で検証し、150-0001 の形に正規化して保存・応答するようにしました。
7 桁でない値は 400 です（従来は「空でなければ可」）。ハイフン無し・全角で送っていた連携はそのまま動きます（保存形だけ揃います）ship_to）に通関番号 tax_id: { type, value } を追加しました（海外宛の注文で使います）。
配送先の国での要否と受け付ける種類は GET /v1/cross-border/eligibility の tax_id_requirement で確認できます
（MCP の place_order / place_preorder / check_cross_border_eligibility にも同じ項目があります）GET /v1/orders）の各注文に tax_exempt（輸出免税の注文か）を追加しましたship_to.country に日本以外の国を指定して注文できます。日本国内のお取引は従来どおりです。
海外宛の注文は消費税 0%（輸出免税・tax_exempt: true）、国際送料は注文前に参考額を表示し発送時の実費をご請求、
輸入関税・通関費用は受取側のご負担（DAP）です。海外宛に販売する商品は一部です（順次拡大します）GET /v1/cross-border/eligibility（商品ごと）/ GET /v1/cross-border/cart-estimate（カート全体）。
MCP にも同じツール（check_cross_border_eligibility / estimate_cross_border_shipping）がありますdest（配送先の国）、カートに PUT /v1/cart/ship-to を追加。指定した国へ送れる商品だけを扱います
（省略時はご登録の主なお届け先の国。MCP の検索系ツールにも同じ dest・カートには set_cart_ship_to）notices を追加。海外宛の注文で関税の負担者と通関書類のご案内を返します（国内宛は空配列。code は安定・message は可変）orderable（注文可能か）・language（テキストの言語・ISO 639-1）・ship_from_country（配送元の国・ISO 3166-1 alpha-2）。
今後、日本国外から発送される商品や外貨建ての商品が「表示のみ」（orderable: false）で掲載されることがあります。
現時点では既存商品はすべて orderable: true・language / ship_from_country は null（= 日本語 / 日本）ですcurrency（価格の通貨・ISO 4217。既存商品は "JPY"）・made_to_order（受注生産品）display_name（出品者名。名前を公開している出品者のみ。匿名の配送グループは null）currency パラメータ（ISO 4217・既定 JPY）を追加しました。
min_price / max_price と価格集計（min_buyer_price 等）は指定通貨のスコープ内で動作します
（通貨をまたぐ価格比較・為替換算は提供しません）orderable: false の商品はカート追加・注文確定が 422 NOT_ORDERABLE になります（現時点で該当する商品はありません）POST /v1/preorders/quote（見積もり・何度でも）→ POST /v1/preorders（作成）。
1回の予約は1商品のみ（バリエーションは複数可）で、カートは使いません。
作成時はカード与信までで、実請求は予約が確定した時点ですpreorder=include|exclude|only パラメータと has_preorder フィールドを追加stock_level に preorder が加わり、expected_arrival（入荷予定日）を返しますGET /v1/orders?kind=preorder|standard で絞り込めます。注文に order_kind と expected_arrival が付きますquote_preorder / place_preorder / list_orders ツールを追加X-API-Version ヘッダで返すようになりました。変更履歴はこのページ（/changelog）でお知らせしますship_to）の検証を厳格化しましたcountry は現在配送可能な JP のみ受け付けます（ISO 3166-1 alpha-2）state（都道府県）は正式表記の47値のみ受け付けます（例: 東京都。東京 や Tokyo は 400 になります）。許容値は API リファレンスの ShipTo スキーマに掲載していますmin_stock フィルタは「今すぐ発注可能な在庫」基準となり、予約商品の予約可能数は含まれません