{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "get-shopping-shipping-multiple.json",
  "title": "GET /shopping/shipping-multiple response",
  "description": "GET /shopping/shipping-multiple response の response body schema。ALPSの意味、be/var/fakeの観察値、Resource境界の実形状から導いたSemantic-Ex制約。",
  "type": "object",
  "properties": {
    "fields": {
      "type": [
        "array",
        "null"
      ],
      "title": "静的表示フィールド",
      "description": "/shopping/shipping-multiple でテンプレートへ渡す表示用フィールド集合。フォーム入力値ではなく画面文脈データ。",
      "items": {
        "type": "string",
        "title": "表示フィールド",
        "minLength": 0,
        "maxLength": 255,
        "description": "/shopping/shipping-multiple のレスポンスに含まれる注文行。親コレクション `fields` の1行を表し、固定できる業務列はschema propertyで明示する。"
      }
    },
    "submitTo": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 0,
      "maxLength": 255,
      "title": "フォーム送信先リンク",
      "description": "/shopping/shipping-multiple のフォーム送信に使う送信先リンク。HTTPメソッドと遷移先をまとめ、unsafe操作の入口を明示する。"
    },
    "staticContent": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 0,
      "maxLength": 255,
      "title": "静的コンテンツ",
      "description": "/shopping/shipping-multiple で表示する規約・ヘルプ・エラー等の静的ページ本文とセクション情報。"
    },
    "transitionId": {
      "title": "ALPS遷移ID",
      "description": "このレスポンス/操作が対応するALPS遷移ID。クライアントの状態遷移追跡に使う。",
      "type": "string",
      "minLength": 2,
      "maxLength": 96,
      "pattern": "^(go|do)[A-Z][A-Za-z0-9]*$",
      "example": "doAddCartItem"
    },
    "addresses": {
      "type": [
        "array",
        "null"
      ],
      "title": "住所一覧",
      "description": "/shopping/shipping-multiple のレスポンスで扱う住所一覧。配列要素はALPS意味とFake観察に基づき、固定できない動的列は例外理由を台帳化する。",
      "items": {
        "type": "object",
        "title": "住所",
        "description": "/shopping/shipping-multiple のレスポンスに含まれる住所。親コレクション `addresses` の1行を表し、固定できる業務列はschema propertyで明示する。",
        "properties": {
          "addressId": {
            "type": [
              "string",
              "null"
            ],
            "title": "配送先住所ID",
            "description": "dtb_customer_address.id の不透明な文字列ハンドル。BeMart の AddressEntity 層は数値ではなく文字列として保持する。Fake 実装は 32桁hex を生成し、SQL 実装は dtb_customer_address.id (int unsigned AUTO_INCREMENT) を文字列化して使用（同インターフェイス・異 ID 形状）。所有者は customerId、AUTHZ 検査は CustomerAddressUpdated / CustomerAddressDeleted で getById → customerId 一致確認の順で実施 Fake観察文字長 32〜32; 観察値 'addr00000000000000000000000000a1'。",
            "example": "addr00000000000000000000000000a1",
            "minLength": 0,
            "maxLength": 128,
            "pattern": "^[A-Za-z0-9._:@/-]*$",
            "$comment": "BeMart/Fake境界で観察される不透明な文字列ID。DB採番値としての数値演算には使わない。"
          },
          "shippingAddressId": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 2147483647,
            "title": "配送先ID",
            "description": "/shopping/shipping-multiple のレスポンスで対象を識別する配送先ID。DB採番ID、Fake文字列ID、互換境界IDのどれに該当するかをschemaの型とコメントで分ける。",
            "$comment": "EC-CUBE側の採番IDとして扱う。"
          },
          "name01": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 0,
            "maxLength": 80,
            "title": "姓",
            "description": "顧客・受注・配送先・お問い合わせで共通使用される姓 Fake観察文字長 2〜2; 観察値 '鈴木', '山田', '佐藤', '高橋', '退会'。",
            "example": "鈴木"
          },
          "name02": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 0,
            "maxLength": 80,
            "title": "名",
            "description": "顧客・受注・配送先・お問い合わせで共通使用される名 Fake観察文字長 1〜3; 観察値 'アリス', '太郎', '次郎', '花子', '三郎', '済'。",
            "example": "アリス"
          },
          "postalCode": {
            "title": "郵便番号",
            "description": "日本の郵便番号。ハイフンなし7桁またはハイフン付き8桁 日本の郵便番号。入力フォームではハイフン有無をどちらも受け入れる。 Fake観察文字長 7〜8; 観察値 '1500001', '1000005', '5300001', '530-0001'; null 18/33。",
            "type": [
              "string",
              "null"
            ],
            "pattern": "^\\d{3}-?\\d{4}$",
            "example": "1500001"
          },
          "pref": {
            "title": "都道府県",
            "description": "日本の都道府県（1=北海道〜47=沖縄県）。住所の最上位区分として顧客・受注・配送先で使用。配送料の地域区分（DeliveryFee）や税率の地域設定（TaxRule）にも使用 都道府県ID。住所フォームの未選択状態では0、確定住所では1〜47を使う。 Fake観察数値 13〜27; 観察値 '13', '27'; null 3/9。",
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 47,
            "example": 13
          },
          "addr01": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 0,
            "maxLength": 32,
            "title": "市区町村",
            "description": "都道府県より下位の市区町村名 Fake観察文字長 3〜7; 観察値 '渋谷区', '千代田区', '大阪市北区', '大阪市北区梅田'; null 18/33。",
            "example": "渋谷区"
          },
          "addr02": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 0,
            "maxLength": 32,
            "title": "番地・建物名",
            "description": "番地・ビル名・部屋番号等の詳細住所 Fake観察文字長 5〜8; 観察値 '神宮前1-1-1', '丸の内2-2-2', '梅田1-1-1', '1-2-3'; null 18/33。",
            "example": "神宮前1-1-1"
          },
          "phoneNumber": {
            "title": "電話番号",
            "description": "日本の電話番号形式（ハイフン区切り） 日本の電話番号。Fake corpusはハイフンなし中心だが、入力ではハイフン付きも許容する。 Fake観察文字長 10〜10; 観察値 '0312345678', '0901234567', '0612345678'; null 18/33。",
            "type": [
              "string",
              "null"
            ],
            "pattern": "^0\\d{1,4}-?\\d{1,4}-?\\d{3,4}$",
            "minLength": 10,
            "maxLength": 13,
            "example": "0312345678"
          }
        },
        "additionalProperties": false,
        "$comment": "配列要素はFake/Resourceで観察された既知propertyに固定する。新しい列が必要になった場合はSemantic-Ex観察に追加してschemaを更新する。"
      },
      "minItems": 0
    },
    "cartItems": {
      "type": [
        "array",
        "null"
      ],
      "title": "カート明細一覧",
      "description": "/shopping/shipping-multiple のレスポンスで扱うカート明細一覧。配列要素はALPS意味とFake観察に基づき、固定できない動的列は例外理由を台帳化する。",
      "items": {
        "type": "object",
        "title": "カート明細",
        "description": "/shopping/shipping-multiple のレスポンスに含まれるカート明細。親コレクション `cartItems` の1行を表し、固定できる業務列はschema propertyで明示する。",
        "properties": {
          "productCode": {
            "title": "商品コード",
            "description": "SKU/品番。在庫管理や受注明細での識別に使用 商品を識別するSKU。Fake corpusではASCII英数・ハイフン中心で、受注明細/カート明細の結合キーになる。 Fake観察文字長 10〜26。",
            "type": [
              "string",
              "null"
            ],
            "minLength": 0,
            "maxLength": 64,
            "example": "sample-001"
          },
          "productId": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 2147483647,
            "title": "商品ID",
            "description": "dtb_product.id — 商品ヘッダの代理キー。商品詳細リンク（EC-CUBE の url('product_detail', {id})）のターゲットとして画面に露出する。自然キー productCode（dtb_product_class 側）とは別物で、こちらは商品ヘッダ単位の識別子",
            "$comment": "EC-CUBE側の採番IDとして扱う。"
          },
          "productClassId": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 2147483647,
            "title": "商品規格ID",
            "description": "dtb_product_class.id — 特定 SKU（規格バリエーション行）の代理キー。EC-CUBE のカート画面では削除/数量増減リンク（cart_handle_item の productClassId パラメータ）のキーとして使われる。CartItem 1件は default class ではなく購入された具体的な product_class を指す",
            "$comment": "EC-CUBE側の採番IDとして扱う。"
          },
          "productName": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 0,
            "maxLength": 128,
            "title": "商品名",
            "description": "商品の表示名 Fake観察文字長 6〜17。",
            "example": "サンプル商品 A"
          },
          "quantity": {
            "title": "数量",
            "description": "購入数量。カート明細と受注明細で共通使用 Fake観察数値 1〜3; 観察値 '1', '2', '3'。",
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "maximum": 999,
            "example": 1
          },
          "price": {
            "title": "販売価格（表示/計算用）",
            "description": "実際の販売価格（税抜）。税計算・小計計算のベース Fake観察数値 800〜13500; 観察値 '1200', '8000', '1500', '800', '1000', '13500', '9800'。",
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 999999999,
            "example": 1200
          },
          "price02": {
            "title": "販売価格",
            "description": "実際の販売価格（税抜）。税計算・小計計算のベース Fake観察数値 800〜28000。",
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 999999999,
            "example": 3500
          },
          "totalPrice": {
            "title": "カート合計金額",
            "description": "カート内の税込合計金額。PurchaseFlow.calculateTotal()で毎回再計算されるキャッシュ値。受注のtotalとは別プロパティ Fake観察数値 0〜3600; 観察値 '0', '1500', '3600'。",
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 999999999,
            "example": 0
          },
          "cartKey": {
            "title": "カートキー",
            "description": "カート分離キー。形式: {セッションプレフィックス}_{販売種別ID}。EC-CUBEは販売種別ごとにカートを分離するため、異なる販売種別の商品は別カートになる 販売種別ごとにカートを分離するキー。ALPSのcartKeyはセッション接頭辞と販売種別IDから構成される。 Fake観察文字長 18〜23; 観察値 'session-prefix-1_1', 'session-prefix-1_2', 'session-checkout-pilot5'。",
            "type": [
              "string",
              "null"
            ],
            "minLength": 3,
            "maxLength": 128,
            "pattern": "^.+_[0-9]+$",
            "example": "session-prefix-1_1"
          },
          "unitPrice": {
            "title": "単価（表示/計算用）",
            "description": "明細1件あたりの単価。受注/カート明細・お気に入りスナップショットでは追加時点の price02 をスナップショットして保持する（後の値引きやマスタ改定に影響されない）。BeMart 側では `int` 円整数 Fake観察数値 1200〜9800; 観察値 '1200', '9800'。",
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 999999999,
            "example": 1200
          },
          "fileName": {
            "type": [
              "string",
              "null"
            ],
            "minLength": 1,
            "maxLength": 255,
            "title": "ファイル名",
            "description": "商品画像のファイル名 Fake観察文字長 12〜15; 観察値 'Mail/order.twig', 'Mail/entry.twig', 'sample-a.jpg', 'sample-b.jpg'。",
            "example": "Mail/order.twig"
          }
        },
        "additionalProperties": false,
        "$comment": "配列要素はFake/Resourceで観察された既知propertyに固定する。新しい列が必要になった場合はSemantic-Ex観察に追加してschemaを更新する。"
      },
      "minItems": 0
    }
  },
  "additionalProperties": false,
  "$defs": {
    "productCode": {
      "title": "商品コード",
      "description": "SKU/品番。在庫管理や受注明細での識別に使用 SKUとして在庫・カート・受注明細を接続する。Fake観察ではASCII英数とハイフン中心。",
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$",
      "example": "sample-001"
    },
    "email": {
      "title": "メールアドレス",
      "description": "会員のログインIDを兼ねる。有効会員間で一意 ログインID/通知先として使うためRFC準拠のemail形式。",
      "type": "string",
      "format": "email",
      "minLength": 3,
      "maxLength": 254,
      "example": "alice@example.com"
    },
    "postalCode": {
      "title": "郵便番号",
      "description": "日本の郵便番号。ハイフンなし7桁またはハイフン付き8桁 日本国内住所向け。ハイフンなし7桁またはハイフン付き8桁。",
      "type": "string",
      "pattern": "^\\d{3}-?\\d{4}$",
      "example": "1500001"
    },
    "phoneNumber": {
      "title": "電話番号",
      "description": "日本の電話番号形式（ハイフン区切り） 日本国内電話番号。Fakeはハイフンなし中心、入力ではハイフン付きも許容。",
      "type": "string",
      "pattern": "^0\\d{1,4}-?\\d{1,4}-?\\d{3,4}$",
      "minLength": 10,
      "maxLength": 13,
      "example": "0312345678"
    },
    "price": {
      "title": "金額",
      "description": "EC-CUBEの商品価格・送料・手数料・売上金額。日本円の整数金額として扱う。",
      "type": "integer",
      "minimum": 0,
      "maximum": 999999999,
      "example": 1200
    },
    "quantity": {
      "title": "数量",
      "description": "購入数量。カート明細と受注明細で共通使用 購入/調整数量。入力は1以上、調整後や集計では0以上を許容する場合がある。",
      "type": "integer",
      "minimum": 1,
      "maximum": 999,
      "example": 2
    },
    "nonNegativeInteger": {
      "title": "非負整数",
      "description": "件数、在庫、ページ番号、集計値など0以上の整数。",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "example": 1
    },
    "opaqueId": {
      "title": "不透明ID",
      "description": "BeMart/Fake/アプリ層で外部に公開する文字列ID。DB採番値としての数値演算には使わない。",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9._:@/-]+$",
      "example": "customer-001"
    },
    "dbId": {
      "title": "DB採番ID",
      "description": "EC-CUBEマスタや内部行を指す非負整数ID。表示やフォーム境界では文字列化される場合があるが、意味は採番ID。",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647,
      "example": 1
    },
    "mixedBoundaryId": {
      "title": "互換境界ID",
      "description": "同一ResourceでFake文字列IDとEC-CUBE整数IDの両方が観察される互換境界専用ID。恒久的なドメイン型ではない。",
      "type": [
        "string",
        "integer"
      ],
      "minLength": 0,
      "maxLength": 128,
      "example": "pay-cod",
      "$comment": "mixedBoundaryIdは移行互換のための例外。可能ならopaqueIdまたはdbIdへ分解する。"
    },
    "pref": {
      "title": "都道府県ID",
      "description": "日本の都道府県（1=北海道〜47=沖縄県）。住所の最上位区分として顧客・受注・配送先で使用。配送料の地域区分（DeliveryFee）や税率の地域設定（TaxRule）にも使用 確定住所は1〜47。入力フォームの未選択初期値として0を許容する。",
      "type": "integer",
      "minimum": 0,
      "maximum": 47,
      "example": 13
    },
    "productStatus": {
      "title": "商品ステータス",
      "description": "1=公開（フロント表示）, 2=非公開（フロント非表示）, 3=廃止（論理削除、管理画面でもデフォルト非表示）",
      "type": "integer",
      "enum": [
        1,
        2,
        3
      ],
      "example": 1
    },
    "customerStatus": {
      "title": "会員ステータス",
      "description": "1=仮会員（メール未認証）, 2=本会員（認証済み）, 3=退会。退会時はメールアドレスが無効化される",
      "type": "integer",
      "enum": [
        1,
        2,
        3
      ],
      "example": 2
    },
    "orderStatus": {
      "title": "注文ステータス",
      "description": "1=新規受付, 3=注文取消, 4=対応中, 5=発送済み, 6=入金済み, 7=決済処理中, 8=購入処理中, 9=返品。Symfony Workflowステートマシンで遷移を制御。許可される遷移: pay(1->6), packing(1,6->4), cancel(1,4,6->3), back_to_in_progress(3->4), ship(1,6,4->5), return(5->9), cancel_return(9->5)。7と8はPurchaseFlow内で直接セットされステートマシン遷移の対象外 EC-CUBE受注状態。Fake/管理画面で扱う状態ID。",
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "example": 1
    },
    "cartKey": {
      "title": "カートキー",
      "description": "カート分離キー。形式: {セッションプレフィックス}_{販売種別ID}。EC-CUBEは販売種別ごとにカートを分離するため、異なる販売種別の商品は別カートになる",
      "type": "string",
      "minLength": 3,
      "maxLength": 128,
      "pattern": "^.+_[0-9]+$",
      "example": "session-prefix-1_1"
    },
    "csrfToken": {
      "title": "CSRFトークン",
      "description": "フォーム送信元を検証するトークン。Fake環境では deterministic な値を使う。",
      "type": "string",
      "minLength": 8,
      "maxLength": 160,
      "pattern": "^[A-Za-z0-9_.:-]+$",
      "example": "fake-csrf-token-bemart-2026"
    },
    "uriReference": {
      "title": "URI参照",
      "description": "画面遷移・リダイレクト・リンク先を表す相対または絶対URI。",
      "type": "string",
      "format": "uri-reference",
      "minLength": 1,
      "maxLength": 2048,
      "example": "/products"
    },
    "transitionId": {
      "title": "ALPS遷移ID",
      "description": "alps.json に定義された safe/unsafe descriptor のID。",
      "type": "string",
      "minLength": 2,
      "maxLength": 96,
      "pattern": "^(go|do)[A-Z][A-Za-z0-9]*$",
      "example": "doAddCartItem"
    },
    "date": {
      "title": "日付",
      "description": "業務上の日付。",
      "type": "string",
      "format": "date",
      "example": "2026-01-01"
    },
    "dateTime": {
      "title": "日時",
      "description": "業務イベント発生日時。",
      "type": "string",
      "format": "date-time",
      "example": "2026-01-01T00:00:00+09:00"
    },
    "link": {
      "title": "ハイパーメディアリンク",
      "description": "ALPS遷移に対応するリンク。hrefはURI参照。",
      "type": "object",
      "required": [
        "href"
      ],
      "additionalProperties": false,
      "properties": {
        "href": {
          "title": "URI参照",
          "description": "画面遷移・リダイレクト・リンク先を表す相対または絶対URI。",
          "type": "string",
          "format": "uri-reference",
          "minLength": 1,
          "maxLength": 2048,
          "example": "/products"
        },
        "rel": {
          "type": "string",
          "minLength": 1,
          "maxLength": 96
        },
        "method": {
          "type": "string",
          "enum": [
            "get",
            "post",
            "put",
            "patch",
            "delete",
            "GET",
            "POST",
            "PUT",
            "PATCH",
            "DELETE"
          ]
        }
      }
    }
  },
  "$comment": "Derived from ALPS meaning, be/var/fake observation, and Resource schema shape.",
  "required": [
    "transitionId",
    "addresses",
    "cartItems"
  ]
}