用途:在 Spree 6 上搭建或扩展多商户市场。技能指出 Spree 6 开源版已内置卖家、入驻、商品评审、拆单、佣金、打款台账、Stripe Connect 与卖家面板,没有“市场模式”开关,店铺有卖家即为市场,多数需求靠配置而非写代码。
主要能力:一、卖家模型含 Seller、ProductSubmission 审核、SellerRequirement 清单、OrderGroup 拆单、PaymentSplit 分账、CommissionRate/Rule/Line 佣金、SellerTransfer 与 SellerPayout 台账。二、卖家状态 pending、invited、onboarding、ready_for_review、approved、rejected、suspended 通过工作流与钩子迁移,不应直接改状态。三、入驻清单每店配置、读取时计算,在提交审核与批准两个节点强制。四、商品可选 proposed/rejected 状态,卖家提交、运营审批。五、跨卖家结算生成 OrderGroup,一次付款拆分为 PaymentSplits,确认邮件按组发送一次。六、佣金在 order.placed 同步计算,费率按列表顺序首个匹配,规则类型含 product_rule、category_rule、seller_rule、item_total_rule。七、打款按订单履约产生 earning,退款产生 reversal;需宿主调度重建两个定时任务,否则卖家可能永远收不到钱。
使用方式:通过 Admin API 与 @spree/admin-sdk、@spree/seller-sdk 操作;卖家侧 /api/v3/seller/* 使用受众 seller_api 的 JWT,需带 X-Spree-Seller-Id。自定义扩展通过 Spree 钩子与依赖键注册。
限制:退款追回与净额、对账、KYC、DAC7 卖家税务报告及平台代缴税标记仅 Spree 企业版提供,不应在开源版承诺;佣金不属于 Spree::Fee,顾客不可见;金额按币种独立、不转换。