下单接口支持其他店铺

/api/order/get_shipping_fee 与购物车加入逻辑此前只认官方自营详情页，加盟店运费分桶
仅靠自由文本 supplier 判断，未与其他店铺列表的 tenpo_cd 打通。补充 OrderItem/
CargoItemRequest 的 tenpo_cd/branch_number 字段，运费计算优先按 tenpo_cd 分桶
（无则回退 supplier 保持兼容），cargo_service 加购 URL 同步带上店铺参数。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

app/api/routes/scrape.py

@@ -176,9 +176,10 @@ async def order_get_shipping_fee(payload: OrderShippingFeeRequest) -> ApiRespons
     """计算订单运费与手续费。
 
     规则:
-      - 官方店铺(supplier 为空)运费: 按官方部分商品总额套阶梯价(440/385/0)
+      - 官方店铺(店铺标识为空)运费: 按官方部分商品总额套阶梯价(440/385/0)
         * 订单中无任何官方商品时,官方运费 0
-      - 加盟店运费(supplier 非空,同名视为同一家): 每家统一 800 日元
+      - 加盟店运费(店铺标识非空,同标识视为同一家): 每家统一 800 日元
+        * 店铺标识优先取 tenpo_cd(与 other_shop_list 中的 tenpo_cd 一致),未提供时回退取 supplier
       - 通贩手续费: 按全部商品(含官方+加盟店)总额套阶梯价(240/0)
     """
     official_amount = 0
@@ -187,10 +188,11 @@ async def order_get_shipping_fee(payload: OrderShippingFeeRequest) -> ApiRespons
     for item in payload.item_list:
         subtotal = item.goods_number * item.goods_price
         goods_amount += subtotal
-        if item.supplier == "":
+        shop_key = item.tenpo_cd or item.supplier
+        if shop_key == "":
             official_amount += subtotal
         else:
-            franchise_stores.add(item.supplier)
+            franchise_stores.add(shop_key)
 
     official_shipping_fee = get_shipping_fee(official_amount) if official_amount > 0 else 0
     franchise_shipping_fee = get_franchise_shipping_fee(len(franchise_stores))

app/models/scrape.py

@@ -42,6 +42,7 @@ class DetailRequest(BaseModel):
     product_url: HttpUrl | None = None
     tenpo_cd: str | None = None  # 指定店铺代码；跳转查看某个加盟店/市场店铺的报价时传入
     branch_number: str | None = None  # 指定分支编号，与 tenpo_cd 搭配使用
+    include_other_shops: bool = False  # 为 True 时，随详情额外抓取并返回 other_shop_list（多付出一次页面请求）
 
 
 class ProductSummary(BaseModel):
@@ -104,6 +105,7 @@ class ProductDetailData(BaseModel):
     sku_list: list[dict[str, Any]]  # 规格列表
     sku: str = ""  # 规格
     breadcrumb_list: list[dict[str, Any]] = []  # 面包屑
+    other_shop_list: list[OtherShopItem] = []  # 仅当请求 include_other_shops=True 时才会填充，否则为空列表
 
 
 class OtherShopListData(BaseModel):
@@ -126,6 +128,8 @@ class CargoItemRequest(BaseModel):
     id: str
     number: int = 1
     price_limit: int | None = None
+    tenpo_cd: str | None = None  # 指定店铺代码;跳转加入指定加盟店/市场店铺的商品时传入
+    branch_number: str | None = None  # 指定分支编号,与 tenpo_cd 搭配使用
 
 
 class CargoPayload(BaseModel):
@@ -160,6 +164,10 @@ class OrderItem(BaseModel):
     goods_price: int = Field(ge=0)
     # 店铺标识: 空串 = 官方店铺;非空 = 加盟店标识(同名视为同一家加盟店)
     supplier: str = ""
+    # 店铺代码,来自 other_shop_list 中的 tenpo_cd;非空 = 加盟店/市场店铺。
+    # 优先于 supplier 用于判定"同一家店铺"(同 tenpo_cd 视为同一家);未提供时回退使用 supplier。
+    tenpo_cd: str = ""
+    branch_number: str = ""  # 分支编号,可选,与 tenpo_cd 搭配使用
 
 
 class OrderShippingFeeRequest(BaseModel):

app/services/cargo_service.py

@@ -91,7 +91,7 @@ class CargoService:
                         continue
 
                     logger.debug("进入商品 %s 详情页，准备购买数量: %s...", product_id, number)
-                    detail_url = product_detail_url(product_id)
+                    detail_url = product_detail_url(product_id, item.tenpo_cd, item.branch_number)
                     await page.goto(detail_url, wait_until="domcontentloaded", timeout=20000)
 
                     # 判断是否缺货

app/services/surugaya_client.py

@@ -265,6 +265,11 @@ class SurugayaClient:
         # 提取面包屑
         breadcrumb_list = self.get_breadcrumb_list(tree)
 
+        # 仅当调用方显式要求时，才额外抓取「他のショップ」页面（多付出一次 Cloudflare 保护页面请求）
+        other_shop_list: list[OtherShopItem] = []
+        if payload.include_other_shops:
+            other_shop_list = await self._fetch_other_shop_list(goods_id)
+
         detail = ProductDetailData(
             goods_id=goods_id,
             goods_name=goods_name,
@@ -279,6 +284,7 @@ class SurugayaClient:
             price_note=price_note,
             shipping_comission_fee=shipping_comission_fee,
             breadcrumb_list=breadcrumb_list,
+            other_shop_list=other_shop_list,
         )
         logger.debug("详情页解析完成：goods_id=%s goods_name=%s ", detail.goods_id, detail.goods_name)
         return detail