Final Product Blueprint
跨境 AI 电商平台最终产品蓝图
本报告定义跨境 AI 电商平台的最终产品蓝图：以 H2B 采购商审核准入和商品审核为起点，覆盖商品、商家、交易、推荐人、网红店铺、BTOB 大 B 分拨、BTOC 零售、分账结算与验收标准。系统建设、原型确认、开发拆解与上线验收均以本报告为产品基准。
已实现底座
部分实现
新增开发
待业务确认
4 类生命周期商家、产品、分账、前端买家
3 条 H2B 路径直接采购、BTOC 联合开店、BTOB 联合开店
2 类增长机制B 端推荐人、C 端网红店铺
1 份最终验收表按本报告检查系统是否达标
0. 文件定位与适用范围
本文件整合平台架构、差距分析、推荐人系统与网红推广中心，形成统一的产品基准。内容覆盖系统主流程、角色权限、生命周期、渠道分发、归因结算、实现状态与验收标准。
本报告用于
定性产品
定义平台目标形态，包括 H2B、BTOB、BTOC、推荐人、网红店铺与分账结算。
开发团队用于
拆任务
每个模块均标注“已实现 / 部分实现 / 新增开发 / 已决策”，用于形成开发清单。
验收团队用于
过 checklist
系统上线前按最终 Checklist 检查各生命周期闭环。
本文件统一使用 H2B 表示跨境供货撮合与采购商审核制商城；历史文档中出现的 HTOB 与代码目录中的
h2b-storefront，在本报告中均指同一业务起点。
2026-07-06 策略调整：取消前置仓备货模式，联合开店改为以销定采的期货模式。日方采购商与中方商家线下完成日本化改造（包装、规格、元器件、说明书、法规适配等），日方用改造后的素材在自有渠道预售，达到起订量后向中方下批量采购订单；买家定金与尾款进入平台接入的第三方持牌支付机构托管账户，平台、买方、卖方三方可见且任何一方不能单方动用。中方生产后完成正规报关报检，通过跨境物流发往平台在日本的交付中心；日方验货合格后支付尾款，仓库放行买家提货，平台按约定账期把定金 + 尾款结算给中方；验货不合格则退回并退款。每笔交易同步生成国家标准版外贸合同和报关文件。
2026-07-06 已确认业务规则
| 编号 | 规则 | 影响模块 | 系统执行方式 | 状态 |
|---|---|---|---|---|
| R1 | H2B 商城为封闭采购商商城，普通访客不可查看商品；采购商注册后需管理员审核，通过后才可查看；申请表新增「是否愿意联合开店」字段。 | H2B 前台、采购商注册、权限、后台审核 | H2B 前台按 buyer approval 控制可见性；未审核用户仅可访问注册、登录、审核进度页。「是否愿意联合开店」只在后台审核展示，不驱动实际逻辑。 | 已确认 |
| R2 | H2B 商品上架必须经过管理员审核。 | 商品审核、H2B 发布 | 供应商提交商品后进入 pending_review；管理员审核通过后才可在 H2B 展示。 | 已确认 |
| R3 | BTOB / BTOC 商品上架需经管理员审核；联合开店为协议层、日企自主发布，不再有镜像派生。上架审核开关可按店铺类型配置。 | BTOB、BTOC、商品发布 | 非 H2B 源头商品进入平台审核，通过后发布；联合开店店铺与普通店铺的上架审核统一由开关控制。 | 已确认 |
| R4 | BTOC 联合开店目前仅开放给平台指定的一家壳店，暂不开放其他日企 BTOC 联合开店申请。 | 联合开店、BTOC | BTOC 联合开店为协议层，仅平台指定壳店可签协议；联合开店无镜像、无关联，日企自主发布产品；套壳壳店坑位费按订单实付金额百分比计算，比例后台可改并进入订单快照。 | 已确认 |
| R5 | BTOC 联合开店：日企签署协议后自主发布产品到 BTOC，产品报价栏即网红选品库。 | BTOC 联合开店、选品库 | 联合开店仅作协议同意标记（joint_agreement），不驱动产品复制；日企自主发布，BTOC 报价栏即网红选品库，其他日企 B2C 网店产品暂不进选品库。 | 已确认 |
| R6 | BTOB 联合开店：H2B 注册采购商经企业申请、平台确认后成为 BTOB 经销商，发布产品到 BTOB，受理正常采购业务；价格只保留单一售价，线下谈妥后由中国侧商务或平台运营后台改价。 | BTOB 联合开店、经销开店 | 联合开店仅作协议同意标记（joint_agreement），不驱动产品复制；日企按渠道发布商品；可选二次发布：生成二维码扫码到自有平台下单 + 导出产品图片字段供商家自传电商平台。 | 已确认 |
| R7 | 同一后台企业主体可承接多渠道资格；BTOC、BTOB、H2B 的前端登录态、访问权限和渠道资格相互独立；H2B 采购商需管理员审核通过后才可查看；BTOB 前台保持开放浏览，注册后才可下单，不新增后台买家审核。 | 账号体系、前台权限 | 复用同一后台企业 / 商家主体与资格层；三端登录态、角色权限和渠道资格分离，不跨端默认共享访问权限；审核只用于 H2B 采购商、商家入驻、渠道资格和商品上架，不作为 BTOB 买家浏览门禁。 | 已确认 |
| R8 | 网红需要店铺。 | 网红中心、BTOC 店铺 | 网红审核通过后创建或绑定 influencer store，推广链接落到网红店铺或店铺商品页。 | 已确认 |
| R9 | BTOB、H2B 做店铺；店铺只显示对应商家的产品，联合开店日企自主发布的产品同样归属其店铺。 | 店铺、商品展示、联合开店 | 店铺页按 owner_seller_id / display_seller_id 过滤商品；不展示其他商家商品。 | 已确认 |
| R10 | 商品和店铺都可以生成分享二维码。 | 分享、二维码、访问追踪 | 商品二维码和店铺二维码均记录 owner、channel、target、source；落地后仍执行对应前台权限规则。 | 已确认 |
1. 全局系统大图：从入驻到分账的主流程
所有业务从 H2B 审核制商城开始。中国供货方和 H2B 采购商先完成注册与管理员审核，H2B 商品经管理员审核后才可展示。交易路径按本次规则分为直接采购、BTOC 联合开店（壳店协议）、BTOB 联合开店（经销开店）；联合开店为协议层、日企自主发布，BTOC 仅平台指定壳店、BTOB 经经销申请。
推荐人招商推荐人二维码拉中国供方、H2B 采购商、BTOB 大 B 企业入驻。
H2B 注册入驻企业上传资料，绑定推荐来源，采购商和供货方均需管理员审核。
商品上传审核H2B 商品必须管理员审核，并满足海外联网、模型可用、英文界面、日本合规资料。
交易路径选择H2B 直接采购、BTOC 联合开店、BTOB 联合开店。
BTOB / BTOC 发布联合开店日企自主发布到指定渠道：BTOC 联合开店发布到 BTOC，BTOB 联合开店发布到 BTOB。
订单与分账买家付款，平台佣金、供方结算、日方收益、网红佣金、推荐人分成入账。
总流程泳道图
中国供货方
扫码/被邀请注册
上传企业资料
上传 AI 商品
选择交易路径
收款/结算/售后
H2B 采购商 / BTOB 大 B
H2B 审核 / BTOB 注册
浏览 H2B 商品
谈联合开店
按路径上架 BTOB / BTOC
分拨小 B / 零售
平台后台
审核商家
审核商品门禁
维护佣金规则
归因与账本
结算与打款
外部买家
小 B 扫海报
消费者点短链
进入对应店铺
下单付款
售后/复购
渠道发布规则：联合开店达成后，商品具备发布到 BTOB / BTOC 的能力；实际展示范围由商品发布时绑定的
sales_channel_ids、商家渠道资格和商品平台审核状态决定。
2. 角色与平台职责
本系统由源头撮合、多销售场景、多归因结算组成。角色边界需保持清晰，推荐人招商、网红推广与 BTOB 大 B 商品分拨分别独立归因、独立统计、独立结算。
| 角色 | 主要入口 | 核心动作 | 归因/分账关系 | 状态 |
|---|---|---|---|---|
| 中国供货方 | H2B、Vendor Panel | 入驻、上传 AI 商品、设置库存与价格、提交管理员审核、参与联合开店、承担对应成本。 | H2B 直接采购按托管账户流程收款结算；BTOC / BTOB 联合开店线下确认日本化改造后的最终售价，由中国侧商务或平台运营后台维护价格。 | 部分实现 |
| H2B 采购商 / BTOB 大 B | H2B、BTOB | 审核通过后浏览 H2B 商品、直接采购、签署联合开店协议自主发布产品、向下游小 B 分拨。 | 联合开店日企自主经营获销售货款（扣平台佣金、核规费）；BTOB 大 B 获分拨差价。 | 部分实现 |
| BTOB 下游小 B | BTOB 商品链接 / 海报二维码 | 扫海报、看商品、提交采购意向，或跳转到大 B 自有平台下单；P0 不在本平台完成 BTOB 二次发布成交。 | 企业买家身份，归属大 B 分拨销售链路，与推荐人招商关系分离。 | 新增开发 |
| BTOC 消费者 | BTOC 商城、网红店铺、短链、优惠码 | 看商品、领优惠、下单、售后、复购。 | 订单可被网红优惠码/短链归因。 | 部分实现 |
| 推荐人 | 推荐人招商系统 | 用招商二维码推荐企业入驻，跟踪审核结果和分成。 | 绑定企业主体，在有效期内从平台实收佣金中获得分成。 | 部分实现 |
| 网红 | 网红推广中心 / BTOC 工作台 | 开通网红店铺，选择 BTOC 商品，生成短链/优惠码，推广给粉丝。 | 按优惠码优先、短链末次点击归因，获得商品推广佣金。 | 后端基础能力已具备 |
3. 商家生命周期：从被推荐到经营、结算、停用
商家生命周期要覆盖中国供货方、日本采购方、BTOB 大 B 和 BTOC 企业会员。系统必须知道商家来自谁、是什么身份、能在哪个平台卖、能承担哪种成本。
1. 推荐/邀请推荐人展示招商二维码，或平台运营创建邀请入口。
2. 注册企业主体填写公司信息、联系人、国家/地区、业务类型，绑定推荐来源。
3. 资料审核平台审核营业资质、联系人、经营范围、合规风险。
4. 身份开通中国供货方、日方采购方、BTOB 大 B、BTOC 企业会员分别开权限。
5. 经营与结算上传商品、下单交易、推广分拨、对账、打款、停用或续约。
商家状态机
| 状态 | 含义 | 允许动作 | 禁止动作 | 开发验收点 |
|---|---|---|---|---|
| 草稿 / 待提交 | 企业开始注册但资料未完整。 | 补充资料、修改联系人、查看推荐人绑定。 | 上传正式商品、下单、生成海报。 | 注册表单能保存进度，来源二维码不丢失。 |
| 待审核 | 资料提交给平台运营。 | 运营查看资料、补充备注、要求补件。 | 对外展示商品、参与分账。 | 后台有审核队列和审核记录。 |
| 已通过 | 企业主体可经营。 | 按已审核通过的渠道资格上传商品、采购、发布到渠道、结算。 | 越权进入未开通平台。 | H2B 采购商可承接为 BTOB 大 B。 |
| 渠道资格已开通 | 同一企业主体获得 BTOB 或 BTOC 单项经营资格。 | 在对应渠道创建商品销售版本、管理对应店铺、生成对应渠道二维码。 | 未获 BTOB 资格时发布 BTOB 商品；未获 BTOC 资格时发布 BTOC 商品；跨渠道混绑同一个销售版本。 | 后台以 seller/profile 统一企业主体，以 channel qualification / allowed sales channel 控制经营范围。 |
| 限制经营 | 合规、欠款、售后异常或资料过期。 | 处理异常、补件、售后、对账。 | 新增上架、生成推广链接。 | 权限应可按平台/商品/结算维度冻结。 |
| 停用 / 解除合作 | 主体不再经营或合作结束。 | 历史订单、售后、财务归档。 | 新订单、新推广、新推荐结算。 | 历史账本不可删除，只能归档。 |
示例：日方采购商成为 BTOB 大 B
H2B 企业关系关联到 BTOB 大 B 能力场景。
日本渠道商 A 通过推荐人二维码注册 H2B，管理员审核通过后成为 H2B 采购商。平台给它关联开通 BTOB 大 B 能力后，A 可签署 BTOB 联合开店协议、自主发布产品到 BTOB，并生成商品/店铺海报或链接发给下游小企业采购。
身份承接：部分实现
海报/小 B 意向：新增开发
代下单 / API 回写：P2 后期概念
4. 产品生命周期：从 H2B 商品源头到指定渠道销售
H2B 商品必须先完成供应商提交与管理员审核。审核通过后进入对应渠道：直接采购留在 H2B；联合开店为协议层，日企（H2B 注册采购商）签署协议后，与中方商家线下完成日本化改造，再使用改造后的产品素材在自有渠道预售，达到起订量后向中方下批量采购订单。联合开店不再以前置仓备货或日本成品库存为默认前提；定金和尾款进入平台接入的第三方持牌支付机构托管账户，平台、买方、卖方三方可见且不可单方动用；货物生产后完成正规报关报检并发往平台日本交付中心，日方验货合格后支付尾款，仓库放行买家提货，平台按约定账期结算给中方；验货不合格则退回并退款。BTOC 套壳壳店仅由管理员内部指定，坑位费按订单实付金额百分比计算并进入订单快照。BTOB / BTOC 非 H2B 源头商品上架同样需要管理员审核，上架审核开关可按店铺类型配置。自助申请成为 BTOB 或 BTOC 商家的企业，后台仍归属于同一商家主体，但经营资格按渠道分开审核；BTOB 买家端不新增审核门禁，保持开放浏览、注册后下单。
1. 商品上传中国供货方上传图片、参数、价格、起订量、交付周期、出口资料。
2. 国际化门禁海外联网、AI 模型可用、至少英文界面、说明资料可国际化。
3. H2B 展示仅面向管理员审核通过的采购商展示，支持询盘、采购、联合开店。
4. 路径确认确认直接采购、BTOC 联合开店或 BTOB 联合开店。
5. 预售集单日方用改造后素材在自有渠道预售，达到起订量后批采。
6. 交付验货第三方托管账户锁定定金/尾款，生产报关报检，日本交付中心验货，合格放货，不合格退货退款。
产品门禁报表
| 门禁项 | 通过标准 | 不通过后果 | 系统能力 | 状态 |
|---|---|---|---|---|
| 海外联网 | 产品在日本可正常联网，云服务可访问。 | 不能进入 H2B 正式展示。 | 商品审核字段、测试记录、附件上传。 | 需补强 |
| AI 模型可用 | 大模型能力在海外可用，无地区封锁。 | 不能标记为可国际化 AI 商品。 | 审核 checklist + 运营备注。 | 需补强 |
| 界面语言 | 至少英文版；日本销售建议日文版。 | 可在 H2B 展示，但不能进入 BTOC 联合开店零售。 | 商品属性、版本、截图附件。 | 需补强 |
| 日本化改造 | 日文说明、认证、包装、售后规则等按品类完成。 | 不能进入 BTOC 或 BTOB 联合开店的本地化销售链路。 | 改造任务、成本承担方、验收附件。 | 新增开发 |
| 渠道发布 | 联合开店协议标记按渠道绑定指定销售渠道。 | 商品无法在对应前台展示。 | 联合开店协议标记（joint_agreement）+ sales_channel_ids + 渠道守卫；联合开店不驱动产品复制。 | 渠道绑定已实现，协议标记新增 |
产品上架系统实现流程
供应商建档Vendor Panel 创建商品草稿，填写基础信息、规格、价格、起订量、交付周期、图片和附件。
提交审核商品进入 pending_review，锁定关键字段，允许补充附件。
平台人工审核Admin 按门禁项逐项勾选，通过、驳回或要求补件。
生成可售范围根据审核结果标记 H2B 可展示、可直接采购、可 BTOC 联合开店、可 BTOB 联合开店。
渠道发布运营按路径规则选择 sales_channel_ids，发布到指定前台和对应商家店铺。
销售后管理预售状态、定金/尾款、验货结果、价格变更、内容修订、下架、售后和退款冲正。
产品字段与后台人工审核要求
| 字段组 | 供应商上传内容 | 后台人工审核动作 | 影响范围 | 开发要求 |
|---|---|---|---|---|
| 基础商品资料 | 名称、品牌、型号、类目、描述、图片、视频、规格参数、SKU。 | 检查信息完整性、图片质量、类目匹配、是否存在禁售风险。 | 影响所有平台展示。 | 商品表或扩展表需保存审核状态、驳回原因、最后审核人。 |
| AI 能力资料 | AI 功能说明、模型服务区域、联网方式、App/云服务说明、演示视频。 | 人工确认海外联网、海外模型可用、无明显地区封锁。 | 影响 H2B AI 商品门禁。 | 新增 ai_capability_status、overseas_model_status、connectivity_status。 |
| 语言与国际化 | 英文界面截图、英文说明书、日文资料、包装文本、App 语言列表。 | 人工勾选英文可用、日文资料完整度、本地化缺口。 | 影响 BTOC 日本零售和联合开店。 | 新增 language_status、manual_files、localization_required 字段。 |
| 价格与预售采购参数 | 单一售价、线下底价建议、最小起订量、交付周期、预售规则、定金/尾款比例。 | 审核统一售价是否可履约；确认日本化改造、合规整改、起订量、预售周期和交付承诺。 | 影响购物车、报价、第三方持牌托管账户、分账快照。 | 价格、起订量和定金/尾款规则需按渠道和交易路径留快照；订单下单后不可被后续配置覆盖；系统不按买家身份、年采购额或数量自动改价。 |
| 供应商工厂与外贸验厂资料 | 工厂视频、工厂照片、营业执照、生产许可证、ISO / CE / PSE / TELEC 等证书、检测报告、生产线、年产能、设备清单、质检体系、出口经验、客户案例、售后能力、联系人。 | 供应商后台维护上传；管理员审核资料完整性、有效期和补件要求。 | 影响 H2B 前端商城供应商栏目展示和日方采购商验厂判断。 | 建立 supplier_trade_profile 或供应商扩展表，支持附件、视频、证书有效期、审核备注、补件状态。 |
| 合规与认证 | PSE/TELEC/电池/无线/安全认证、出口文件、检测报告、保修政策。 | 人工上传或确认附件，标记适用地区、有效期和缺失项。 | 影响日本化改造和本土销售。 | 建立 compliance_checklist，支持附件、有效期、审核备注。 |
| 日本化改造 | 改造需求、责任方、预算、预计完成时间、验收文件。 | 运营确认成本承担方：中国供方或 BTOB 大 B；具体改造沟通线下完成。 | 影响 BTOC 和 BTOB 联合开店路径。 | 建立 localization_task，记录 owner、cost_owner、status、evidence_files。 |
| 渠道发布配置 | 期望发布平台、店铺、销售渠道、推广权限、预售素材、起订量。 | 运营确认可发布平台，绑定 H2B / BTOB / BTOC 对应 sales channel，并执行路径渠道限制。 | 决定商品是否在对应前台展示。 | 联合开店协议标记发布时保存 sales_channel_ids、agreement_scope、publish_status。 |
产品状态机与前台可见性
| 产品状态 | 触发动作 | 前台可见性 | 后台操作 | 验收点 |
|---|---|---|---|---|
| draft | 供应商创建商品草稿。 | 不可见。 | 供应商可编辑全部字段。 | 未提交商品不得进入任何销售渠道。 |
| pending_review | 供应商提交审核。 | 不可见或仅后台可见。 | 运营审核门禁项、附件和价格库存。 | 审核记录必须留痕。 |
| approved_h2b | H2B 门禁通过。 | H2B 已审核采购方可见。 | 可开启直接采购或联合开店洽谈。 | 未审核买家不可看到完整商品售价。 |
| approved_joint_path | 双方达成联合开店协议。 | 源商品仍在 H2B；联合开店新链路不再生成派生商品，日企按协议自主新建对应渠道销售商品。 | 签署联合开店协议（joint_agreement），绑定渠道类型与结算规则。 | 通过 joint_agreement_id、source_product_id 或订单快照追踪协议来源，不依赖 linked listing / forked product。 |
| published_btob | 绑定 BTOB sales channel。 | BTOB 大 B 店铺或商品链接可见。 | 可生成海报、意向表、企业采购订单。 | 小 B 访问应带来源追踪。 |
| published_btoc | 绑定 BTOC sales channel 并允许零售。 | BTOC 消费者可见。 | 可配置网红推广、优惠码、短链。 | 只允许 BTOC 可售池商品被网红选择。 |
| suspended / archived | 合规过期、库存异常、合作终止或运营下架。 | 前台隐藏或禁止购买。 | 保留历史订单、账本、售后。 | 下架不影响历史订单对账。 |
产品状态与下游去向
路径与渠道强约束
| 路径 | 可发布渠道 | 开放范围 | 系统校验 | 违规处理 |
|---|---|---|---|---|
| H2B 直接采购 | H2B | 仅管理员审核通过的 H2B 采购商可查看和采购。 | 校验 buyer approval、product approval、H2B sales channel。 | 未审核采购商不可查看商品详情和价格。 |
| BTOC 联合开店（壳店协议） | BTOC | 目前仅开放给平台指定的一家壳店，暂不开放其他日企 BTOC 联合开店申请。 | 校验协议标记 joint_agreement_btoc、BTOC sales channel、平台指定壳店。 | 禁止绑定 BTOB sales channel；仅平台指定壳店可发起 BTOC 联合开店。 |
| BTOB 联合开店（经销开店） | BTOB | 开放给符合审核规则的 BTOB 大 B。 | 校验协议标记 joint_agreement_btob、BTOB sales channel、BTOB 店铺归属。 | 禁止绑定 BTOC sales channel；店铺不得展示非本商家商品。 |
| BTOB / BTOC 自有商品 | 对应平台 | 不是 H2B 源头商品时也允许上架，但必须管理员审核。 | 校验 source_type、product approval、目标平台 sales channel。 | 未审核自有商品不可上架展示。 |
5. H2B 三种交易路径：每条分支独立说明
H2B 采购商拿到货后有三条经营路径：A 直接采购（H2B 内跨境交易）、B BTOC 联合开店（壳店协议，日方自有渠道预售）、C BTOB 联合开店（经销开店，日方面向下游 B 端集单）。每条路径写清价格权、预售/起订量、核规整改责任、可发布渠道与结算规则。联合开店为协议层 + 线下日本化改造 + 以销定采期货模式，无镜像、无关联、不以前置仓备货为前提。
路径 A：H2B 直接采购
审核制直接采购
仅面向已审核 H2B 采购商，不对普通访客开放。
基础电商能力可复用
H2B 采购商浏览审核通过后在 H2B 查看商品、起订量、交付周期和统一售价。
线下确认买卖双方确认标准、底价、合规整改成本和交付周期。
下单付定金定金进入第三方持牌支付机构托管账户，三方可见且不可单方动用。
生产报关报检中方生产后正规报关报检，跨境发往平台日本交付中心。
验货放行结算买家验货合格后付尾款，仓库放行，平台按账期结算给中方。
| 示例订单 | 金额 | 说明 |
|---|---|---|
| 订单额 | ¥100,000 | 日方采购商按线下确认价在 H2B 下单。 |
| 平台佣金 | ¥5,000 | 示例 5%，动态可配置（承担方与比例后台可调）。 |
| 供货方应得 | ¥95,000 | 定金 + 尾款在托管账户中锁定，验货通过后按账期结算给中方。 |
路径 B：BTOC 联合开店（壳店协议）
日企自主发布 · 协议层
目前仅平台指定的一家壳店开放联合开店，暂不开放其他日企 BTOC 联合开店申请。
联合开店为协议层，无镜像、无 linked listing / forked product，日企自主发布
签署联合开店协议日企（H2B 注册采购商）申请，平台确认后签署 BTOC 联合开店协议。
核规整改事项由日企负责，费用由中企承担（或从后续平台服务费扣）。
自有渠道预售日方用改造后的素材收集订单，达到起订量后批采。
生产与交付中心中方生产后发往日本交付中心，日方验货。
定金尾款与放货定金和尾款进入第三方持牌托管账户；验货合格后仓库放行，平台按账期结算给中方。
| 示例 | 规则 | 可配置点 |
|---|---|---|
| BTOC 商品售价 | 线下确认日本化改造和合规整改后的最终售价。 | 由中国侧商务或平台运营在后台维护单一售价。 |
| 核规整改费 | 中企承担（或从后续平台服务费扣）。 | 承担方式与比例动态可配。 |
| 套壳坑位费 | 仅平台内部指定 BTOC 套壳壳店收取，按订单实付金额百分比计算。 | 坑位费率后台可调，下单时写入订单快照。 |
| 网红佣金 | 由商家/商品毛利承担，平台代结算，不从平台佣金中扣除。 | 按商品、活动、网红等级配置，并设置毛利护栏。 |
| 售后准备金 | 从平台佣金切份额。 | 比例后台可调。 |
路径 C：BTOB 联合开店（经销开店）
H2B 采购商成为 BTOB 经销商
H2B 注册采购商经企业申请、平台确认后成为 BTOB 经销商（店家），发布产品到 BTOB，受理正常采购业务。
联合开店为协议层，按渠道发布，可二次发布（二维码导流 + 产品导出）
申请成为经销商H2B 注册采购商申请，平台确认后开店。
核规整改按日企品牌整改，事项与费用均由日企承担。
预售与集单按后台维护的单一售价，在 BTOB 或自有渠道面向下游 B 端收集订单。
达量批采达到起订量后向中方下批量采购订单，生成二维码/导出素材用于招商。
验货与尾款定金和尾款进入第三方持牌托管账户，货到日本交付中心后由日方验货，合格后放货并按账期结算给中方。
| 示例 | 金额 | 说明 |
|---|---|---|
| BTOB 商品售价 | 后台维护单一售价 | 联合开店后线下谈妥合规整改成本与最终售价，由中国侧商务或平台运营后台改价。 |
| 核规整改费 | 日企承担 | 按日企品牌整改，费用日企出。 |
| 二次发布成交 | 走自有平台下单 | P0 不计入本平台订单、GMV、分账或推荐佣金；仅记录导出/点击/线索效果，API 回写放 P2。 |
| 售后准备金 | 从平台佣金切份额 | 比例动态可配。 |
6. BTOB 大 B 分拨生命周期
BTOB 面向企业采购场景。大 B 具备独立店铺和下游小 B 圈层；店铺只展示该大 B 的商品，联合开店商品同样按店铺归属展示。P0 平台只提供商品/店铺海报、店铺分享二维码、采购意向、产品导出和自有平台导流；代下单、API 同步和成交回写为 P2 后期概念，不进入本期平台订单、GMV、分账或推荐佣金。
大 B 选品从 H2B 联合开店商品或审核通过的自有商品中选。
BTOB 上架维护大 B 自己的单一售价、起订量、交付周期或可售范围。
生成分享二维码商品和店铺均可生成海报、二维码、短链接。
下游小 B 访问扫码进入大 B 店铺或商品页，仅查看该店铺对应商家的产品。
大 B 承接大 B 在自有平台成交或线下跟进；本平台只记录点击、导出和线索效果。
后期 API对成熟大客户开放商品、预售、订单、物流 API。
BTOB 买家准入与交易规则
入口来源小 B 可通过大 B 商品/店铺二维码进入，也可直接访问 BTOB 官方入口。
访客浏览允许按当前 BTOB 前台规则查看商品、大 B 店铺信息、采购说明和注册入口。
企业注册提交企业资料、联系人、采购类型、发票/收货信息。
注册登录下单前必须注册并登录，形成可追踪的企业买家和订单主体。
企业采购注册后可下单；也可提交意向或跳转自有平台，P0 不做平台代下单。
| 买家状态 | 来源 | 允许动作 | 下单规则 | 系统实现要求 |
|---|---|---|---|---|
| 访客 | 二维码 / 官方入口 | 浏览公开商品信息、查看大 B 店铺、提交采购意向；店铺仅展示对应商家的产品。 | 不可直接完成企业采购付款。 | 记录来源参数：大 B、商品、海报、短链、访问时间。 |
| 已注册企业买家 | 注册后提交资料 | 补充企业资料、保存意向单、查看商品信息、进入结算。 | 可按当前 BTOB 规则自主下单；也可提交采购意向，或跳转到大 B 自有平台完成交易。 | 记录 company、buyer user、来源渠道和下单主体；不新增 BTOB 买家后台审核状态。 |
| 重点企业 / 专属客户 | 管理员配置 | 查看后台确认的单一售价、加入购物车、下单、售后、复购。 | 可在 BTOB 平台自主完成企业采购订单。 | 绑定 company、buyer user、sales channel 权限、单一售价和订单快照。 |
| 大 B 自有平台承接客户 | 采购意向表 / 线下汇总 | 向大 B 提交采购需求，或跳转大 B 自有平台下单。 | P0 不在本平台生成订单；仅保存线索、导出、点击等效果数据。 | 记录 ultimate_buyer 线索信息、来源海报、owner_seller_id 和外部承接方式。 |
BTOB 官方入口成交属于“BTOB 企业采购直接交易”。若商品来源为 H2B 联合开店商品，则继承该商品的联合开店结算规则；若商品为大 B 自有审核商品，则按 BTOB 企业采购订单规则结算。该场景可复用“H2B 直接采购”的购物车和订单模型，但不等同于 H2B 采购商在 H2B 商城内发起的直接跨境采购。
BTOB 三种小 B 连接方式
| 方式 | 业务说明 | 开发复杂度 | 适合阶段 | 状态 |
|---|---|---|---|---|
| 商品/店铺二维码 | 大 B 把商品/店铺海报发到企业群，小 B 扫码进入平台上的大 B 商品页下单。 | 低到中 | P0，最先做，能快速跑通。 | 新增开发 |
| 采购意向 + 自有平台承接 | 小 B 不进入平台或不完成注册，只提交采购信息；大 B 在自有平台或线下承接成交。 | 中 | P0/P1，解决大 B 不想让客户直接进入平台的问题。 | 新增开发 |
| 企业 API 对接 | 商品展示、商品列表、付款、物流、售后和订单状态与大 B 自有系统对接。 | 高 | P2，必须和具体大客户单独讨论需求。 | 后期定制 |
BTOB / H2B 店铺与二维码规则
| 对象 | 展示范围 | 二维码能力 | 权限校验 | 验收标准 |
|---|---|---|---|---|
| H2B 供应商店铺 | 仅展示该供应商自己的 H2B 审核通过商品。 | 可生成店铺二维码和商品二维码。 | 落地后仅审核通过的 H2B 采购商可查看。 | 普通访客扫码后只进入登录/注册/审核提示，不显示商品详情。 |
| BTOB 大 B 店铺 | 仅展示该大 B 自有商品和归属该大 B 的 BTOB 联合开店商品。 | 可生成店铺二维码、商品二维码、海报和短链接。 | 访客可看公开摘要；企业采购下单需审核通过。 | 店铺页不得混入其他大 B 或平台商品。 |
| 联合开店商品 | 按 display_seller_id / owner_seller_id 展示在对应商家店铺。 | 可生成对应商家名义下的商品二维码。 | BTOC 联合开店商品只落 BTOC；BTOB 联合开店商品只落 BTOB。 | 同一源商品的不同派生 listing 不得跨店铺串货。 |
| 分享二维码 | 商品页或店铺页。 | 记录 target_type、target_id、owner_seller_id、channel、source。 | 二维码只负责进入入口，不能绕过平台权限与审核。 | 扫码访问、意向提交、下单均可追踪来源。 |
例子：大 B 发团购海报
适用于大 B 面向下游小 B 批量分拨的采购场景。
日本大渠道商 A 在 BTOB 选择一款 AI 翻译耳机，系统生成日文商品/店铺海报和二维码。A 把海报发到下游小企业采购群。小企业 B 扫码进入 A 的 BTOB 店铺商品页，查看商品后提交采购意向，或跳转到 A 的自有平台下单；P0 只记录点击、导出和线索效果，不把外部成交计入本平台订单、GMV、分账或推荐佣金。
海报生成
小 B 意向表
自有平台承接
API P2
7. BTOC 网红推广生命周期：C 端销售机制
网红不负责企业招商，也不替代 BTOB 大 B 分拨。网红必须拥有店铺，只推广已经进入 BTOC 可售池且允许推广的商品，通过网红店铺、短链和优惠码带来消费者订单，然后按订单归因获得佣金。
商品进入 BTOCBTOC 联合开店壳店商品（报价栏即选品库）或 BTOC 企业自有商品通过管理员审核并允许推广。
商家 opt-in商家设置是否允许进入网红店铺推广、佣金率、优惠规则、有效期。
网红选品网红在选品库选择商品，发布到网红店铺，并生成短链、二维码或优惠码。
粉丝点击/下单消费者通过 TikTok/IG/视频链接进入网红店铺或 BTOC 商品页下单。
归因计算优惠码优先，其次短链有效期内末次点击。
佣金结算生成 commission line，进入 settlement / payout。
网红推广示例报表
| 字段 | 示例值 | 说明 | 可配置性 |
|---|---|---|---|
| 商品售价 | ¥10,000 | BTOC 商品或网红店铺商品标价。 | 商家维护。 |
| 优惠 | 10% | 消费者实际折扣。 | 可按商品/活动配置。 |
| 折后实付 | ¥9,000 | 建议作为佣金基数，不含运费。 | 规则需固定。 |
| 网红佣金 | 10% = ¥900 | 由商家/商品毛利承担，平台代结算；BTOB 联合开店不进入 BTOC 网红推广。 | 动态可配，需商品毛利护栏。 |
| 归因优先级 | 优惠码 > 短链末次点击 > 自然流量 | 一笔订单最多一个有效网红归因。 | 应固化成系统规则。 |
已实现底座：后端已有 affiliate source、promotion code、click log、attribution、commission line、settlement statement、payout 等模型和工作流基础。
新增重点：网红工作台、BTOC 商家 opt-in、佣金实时算账、商品推广效果报表和 admin 运营页面仍要补齐。
8. 推荐人招商生命周期：B 端招商机制
推荐人系统拉的是企业，不是 C 端消费者，也不是 BTOB 商品/店铺海报扫码的小 B。推荐关系绑定企业主体，在有效期内从平台实收佣金中让利。
推荐人注册/审核平台审核推荐人身份、区域、等级和合作协议。
生成招商二维码每个推荐人有唯一二维码或邀请链接。
企业扫码入驻中国供方、日本采购方或 BTOB 大 B 注册并绑定推荐人。
审核通过生效企业通过平台审核后，推荐关系进入有效期。
平台佣金分成推荐人按规则从平台实收佣金中获得分成。
推荐人分成示例
| 项目 | 示例 | 规则口径 | 状态 |
|---|---|---|---|
| 平台佣金 | ¥5,000 | 由订单产生的平台实收佣金；是否扣支付手续费、准备金比例均动态可配。 | 动态可配 |
| 推荐人比例 | 10% / 15% / 30% | 促销期可高、常规期可低，必须可配置。 | 需产品化 |
| 推荐人分成 | ¥500 / ¥750 / ¥1,500 | 平台佣金 × 推荐人比例。 | 底座可复用 |
| 有效期 | 12 个月 / 6 个月 | 从企业审核通过或首单开始计算（默认值，后台可调）。 | 动态可配 |
| 关系延续 | H2B → BTOB 大 B | H2B 采购商承接为 BTOB 大 B 后，推荐关系延续，不重新归因。 | 需明确实现 |
推荐人招商二维码和 BTOB 商品/店铺二维码必须分开：前者用于企业入驻和招商分成，后者用于商品分拨和小 B 采购入口，不能自动生成推荐关系。
9. 分账结算生命周期：从买家付款到各方到账
这套平台最复杂的不是“谁下单”，而是“每种路径下钱应该归谁”。系统必须支持平台佣金、售后准备金、6% 售后保障费、供货方结算、联合开店日企货款、网红佣金（商家/商品毛利承担，平台代结算）、推荐人分成（平台佣金让利）、支付手续费、退款冲正。
买家付款
统一进入
平台结算链路
统一进入
平台结算链路
供货方 / 底价结算最大主体
BTOB 大 B / 联合开店日企 / 毛利按路径
平台交易佣金可配置
网红推广佣金BTOC
推荐人招商分成B 端
资金生命周期流程图
1. 买家付款H2B 采购商、BTOC 消费者在平台付款；BTOB 二次发布 P0 外部成交不进入本平台订单。
2. 订单识别识别路径：直接采购、BTOC 联合开店、BTOB 联合开店、网红归因、推荐人关系。
3. 费用快照固定平台佣金率、坑位费率、售后准备金、6% 售后保障费、底价、网红率、推荐人比例。
4. 生成账本记录平台、供方、日方、网红、推荐人的应收应付。
5. 对账结算退款、售后、异常订单冲正后进入结算单。
6. 打款归档自动或人工打款，保留审计记录。
订单到分佣的系统事件流
下单前识别用户身份、商品来源、交易路径、销售渠道、海报/短链/优惠码来源。
创建购物车写入 buyer_type、company_id、seller_id、listing_id、sales_channel_id、source_tracking。
锁定价格生成价格、底价、平台佣金、售后准备金、售后保障费、优惠、网红率、推荐人规则快照。
支付成功订单进入 paid/captured，触发财务账本与佣金计算事件。
生成分佣生成平台佣金、供应商应得、日方应得、网红佣金、推荐人分成。
结算打款结算单确认后自动或人工打款；退款售后触发冲正。
订单快照字段要求
| 字段组 | 必须记录 | 来源 | 用途 | 验收要求 |
|---|---|---|---|---|
| 买家身份 | buyer_type、user_id、company_id、approval_status、ultimate_buyer 信息。 | 登录账号、企业审核、采购意向表、导流来源。 | 区分 BTOC 消费者、BTOB 企业买家、BTOB 二次发布线索客户。 | 订单详情能显示实际下单主体和最终采购方。 |
| 商品来源 | source_product_id、joint_agreement_id、seller_id、display_seller_id、fulfillment_seller_id。 | H2B 商品、联合开店协议记录、指定渠道发布记录。 | 判断供货方、展示方、履约方和分账主体。 | 任何订单都能追溯到源商品和销售商品。 |
| 交易路径 | trade_path：direct_cross_border、joint_agreement_btoc、joint_agreement_btob、btob_direct、btob_proxy_order。 | 商品发布配置、购物车上下文。 | 决定成本承担方、控价方、佣金规则和账本分录。 | 订单创建后路径不可被覆盖，只能冲正重建。 |
| 渠道来源 | sales_channel_id、poster_id、qr_code_id、short_link_id、referrer_id、affiliate_source_id。 | 二维码、短链、推荐人绑定、网红链接。 | 用于 BTOB 海报效果、推荐人招商、网红归因。 | 不同来源互不覆盖，按优先级独立保存。 |
| 价格与费用 | unit_price、base_settlement_price、platform_fee_rate、after_sales_reserve、warranty_fee、discount、affiliate_rate、referrer_rate。 | 商品价格、协议规则、推广规则、平台配置。 | 作为分佣和对账唯一依据。 | 后续改价不影响历史订单金额。 |
| 履约与售后 | warehouse_type、shipping_owner、after_sales_owner、refund_status、reversal_entry_id。 | 交易路径、仓储配置、售后处理。 | 处理物流责任、退款冲正和结算延迟。 | 退款后能追溯原账本与冲正账本。 |
不同订单类型的系统处理
| 订单类型 | 买家 | 商品来源 | 归因来源 | 分佣/结算动作 |
|---|---|---|---|---|
| H2B 直接采购订单 | 已审核 H2B 采购商 | H2B 原始商品 | 企业推荐人关系可参与招商分成 | 平台佣金 + 供应商应得；推荐人按有效期从平台佣金让利。 |
| BTOC 联合开店零售订单 | BTOC 消费者 | 联合开店日企自主发布商品 | 网红短链/优惠码可归因 | 按线下谈妥后的单一售价发布并承担零售经营；核规费中企出；网红费由商家/商品毛利承担并由平台代结算；平台收佣并切售后准备金。 |
| BTOB 联合开店企业采购订单 | 已注册企业买家 | 联合开店日企自主发布商品 | BTOB 商品/店铺二维码来源 | 日企（经销商）按线下谈妥后的单一售价发布；货款归日企；核规费日企出；平台收佣，切售后准备金。 |
| BTOB 官方入口企业采购订单 | 已注册企业买家 | 大 B 自有商品或联合开店商品 | 官方入口、自然流量或历史客户 | 按商品来源继承结算规则；无海报来源时不生成海报效果数据。 |
| BTOB 海报扫码企业订单 | 已注册小 B 企业买家 | 大 B 店铺商品 | poster_id / qr_code_id / 大 B 店铺 | 生成大 B 分拨效果数据；不自动生成推荐人招商分成。 |
| BTOB 二次发布线索 / 外部成交 | P0 不生成本平台订单；外部成交由大 B 自有平台承接 | 大 B 店铺商品 | 采购意向单、产品导出或外部跳转记录 | 只记录线索、点击、导出等效果；不进入平台订单、GMV、分账或推荐佣金。 |
不同路径的分账口径
| 场景 | 控价方 | 日本化成本 | 网红/优惠成本 | 推荐人分成 | 必须可配置 |
|---|---|---|---|---|---|
| H2B 直接采购 | 中国供方按 H2B 审核价格销售 | 通常无日本化改造 | 通常无网红 | 如商家由推荐人引入，可从平台佣金中分成 | 平台佣金率、承担方、有效期 |
| BTOC 联合开店 | 日企 | 中企承担（或从平台服务费扣） | 商家/商品毛利承担，平台代结算 | 按企业推荐关系计算 | 平台佣金、售后准备金、核规费、网红率、优惠率、毛利护栏 |
| BTOB 联合开店 | 日企（经销商） | 日企承担 | BTOB 联合开店不进入 BTOC 网红推广 | 按企业推荐关系计算 | 单一售价、平台佣金、售后准备金、核规费 |
| BTOB 二次发布外部成交 | 大 B 或上游协议决定 | 按商品路径继承 | 一般无网红 | 不因海报扫码自动产生推荐关系 | 外部成交状态、线索归属、后期 API 回写范围 |
10. 前端买家生命周期：不同买家看到不同路径
前端买家不能只按“用户”统一处理。H2B 采购商、BTOB 小 B、BTOC 消费者的入口、审核规则、订单动作和售后体验都不同。
H2B 采购商
被推荐入驻
管理员审核通过
查看 H2B 审核商品
直接采购或谈联合店
承接为 BTOB 大 B
BTOB 小 B 企业买家
二维码或官方入口
访客看商品
注册并提交企业资料
审核后下单或提交意向
大 B 自有平台承接
BTOC 消费者
刷到网红内容
点短链或用优惠码
进入 BTOC 商品页
下单付款
归因/售后/复购
前端入口对照
| 入口 | 主要用户 | 核心能力 | 边界规则 | 状态 |
|---|---|---|---|---|
| H2B 前台 | 中国供货方、日方采购方 | 企业入驻、商品审核、采购、联合开店。 | C 端网红推广不作为 H2B 主入口能力。 | 部分实现 |
| BTOB 前台 | 大 B、小 B 企业买家 | 大 B 店铺、商品链接、海报扫码、采购意向、企业注册、企业下单。 | 游客可看商品；下单必须注册登录；扫码小 B 归属商品分拨链路，不自动变成推荐人招商下线。 | 新增开发 |
| BTOC 前台 | 消费者、网红粉丝 | 商品页、短链落地页、优惠码、购物车、订单。 | BTOC 只展示进入 BTOC 可售池的商品。 | 部分实现 |
| 后台 / Admin | 平台运营 | 审核、规则、结算、归因、报表、异常处理。 | 账本事实保留审计轨迹，异常通过冲正处理。 | 部分实现 |
BTOB 前端访问与下单权限
| 用户状态 | 可访问页面 | 可执行动作 | 下单权限 | 系统提示 |
|---|---|---|---|---|
| 未登录访客 | BTOB 商品页、官方入口、大 B 店铺公开页、海报落地页。 | 查看商品、提交采购意向、发起企业注册。 | 无自主下单权限。 | 提示“注册登录后可下单”。 |
| 已注册企业买家 | BTOB 商品页、企业资料页、意向单、购物车、订单中心。 | 补充资料、查看已提交意向、加入购物车、下单、支付。 | 有自主下单权限。 | 提示订单主体、企业资料和履约说明。 |
| 重点企业 / 专属客户 | BTOB 商品页、后台确认的单一售价、购物车、订单中心。 | 加入购物车、下单、支付、售后、复购。 | 有自主下单权限。 | 展示单一售价、起订量、库存和履约说明。 |
| 外部承接客户 | 采购意向页或大 B 提供的确认页。 | 提交需求、确认收货信息、等待大 B 操作。 | 由大 B 下单。 | 明确订单主体、售后联系人和发票处理方式。 |
11. 已实现 vs 新增开发：系统实现矩阵
本矩阵将产品要求、现有系统位置、开发缺口和验收标准进行对应。绿色表示可直接复用的底座能力，蓝色表示需要补全的部分实现，橙色表示新增开发，紫色表示待业务确认。
| 能力 | 现有位置 / 证据 | 当前判断 | 后续开发内容 | 验收标准 |
|---|---|---|---|---|
| 联合开店协议标记 | backend/src/workflows/joint-store/（协议标记，不再生成派生商品） |
底座改用途 | 补充协议字段：渠道类型、核规费承担方、协议状态。 | 签署协议后日企自主发布产品（协议仅作标记，不生成派生商品）。 |
| 路径渠道守卫 | sales_channel_ids、联合开店协议查询、BTOB 商品组件。 |
底座可复用 | 新增 path_channel_guard：BTOC 联合开店仅 BTOC；BTOB 联合开店仅 BTOB；直接采购仅 H2B。 | 发布时无法选择错误渠道，API 也不能绕过限制。 |
| H2B 商品审核与准入 | 现有商品审核可复用，但缺少 H2B 审核制商城专用门禁字段。 | 新增开发 | 新增 H2B 商品管理员审核、海外联网、模型可用、语言、认证、日文资料、改造状态、审核附件和人工审核记录。 | H2B 商品未审核通过时，采购商不可查看或采购。 |
| 产品上架状态机 | 现有 product status 可复用，但缺少 H2B/BTOB / BTOC 业务状态。 | 新增开发 | 补充 draft、pending_review、approved_h2b、approved_joint_btoc、approved_joint_btob、published_btob、published_btoc、suspended 状态。 | 商品从上传、审核、发布、下架到售后均可追踪。 |
| BTOB / BTOC 非 H2B 商品审核 | 现有商品审核可复用；需要按 source_type 判断是否为 H2B 源头商品。 | 新增开发 | 新增 source_type、origin_product_id、admin_review_required；非 H2B 源头商品发布到目标销售渠道前必须管理员审核。 | 商家自有商品未审核通过时，不能在 BTOB / BTOC 展示。 |
| BTOC 联合开店壳店配置 | 联合开店为协议层；BTOC 仅开放平台指定壳店。 | 新增开发 | 新增 shell_store 配置（指定壳店）、协议记录、运营备注、上架审核开关。 | 仅平台指定一家壳店可发起 BTOC 联合开店；其他日企暂不开放。 |
| BTOB 商品/店铺海报 / QR | 未找到完整海报、QR、小 B 分拨链路。 | 新增开发 | 海报模板、短链接、二维码、点击统计、落地页。 | 大 B 能一键生成商品/店铺海报，小 B 扫码进入正确店铺商品。 |
| BTOB 采购意向 / 二次发布导流 | 现有订单不承接 P0 二次发布成交；缺少小 B 意向、导出和外部导流效果记录。 | 新增开发 | 采购意向表、客户信息、导出记录、外部链接、来源追踪。 | 小 B 可不上平台完成注册；P0 不做大 B 代下单，后期再评估 API / 回写。 |
| BTOB 注册下单权限 | 沿用现有 B2B 前台逻辑：游客可看商品，下单必须注册登录；不新增后台买家审核。 | 新增开发 | 访客、已注册企业买家、重点企业 / 专属客户、外部承接线索四种状态；注册资料、来源参数、下单权限。 | 未登录访客只能浏览和提交意向；已注册企业买家可按平台 BTOB 入口下单，但二次发布外部成交不进入 P0 平台订单。 |
| 主体共用，三端登录态与资格独立 | 现有企业 / 商家主体、前台账号与权限可复用；需明确 H2B / BTOB / BTOC 登录态、访问权限和渠道资格独立。 | 新增开发 | 后台企业 / 商家主体共用；前端按 portal 隔离登录态、访问权限和资格判定；H2B 采购商需管理员审核后才可查看，BTOB 买家注册后下单。 | BTOC 用户不能直接访问 H2B 商品；BTOB 用户不能自动获得 H2B 采购商权限。 |
| 店铺与分享二维码 | 商品链接、店铺展示和短链能力可复用；缺少统一店铺归属与二维码模型。 | 新增开发 | 新增 store ownership、target_type=product/store、qr_code、poster、source_tracking；BTOB/H2B 店铺只展示对应商家商品。 | 商品和店铺都能生成二维码，扫码后仍执行对应前台权限规则。 |
| 网红店铺 | affiliate 后端底座可复用；缺少网红店铺实体和落地页。 | 新增开发 | 网红审核后创建或绑定 influencer store，推广商品发布到网红店铺，支持店铺二维码和商品二维码。 | 网红无店铺时不能开始推广；订单可追溯到网红店铺、短链或优惠码。 |
| BTOB 企业 API | 没有完整开放接口产品。 | P2 定制 | 商品、库存、订单、付款、物流、售后 API 需按大客户定制。 | 有 API key、权限、签名、限流、对账文档。 |
| 网红归因与佣金 | backend/src/modules/affiliate/backend/src/workflows/affiliate/ |
后端底座已实现 | 补网红工作台、BTOC 商家 opt-in、运营报表、护栏。 | 优惠码/短链能产生归因，订单能生成佣金和结算单。 |
| 推荐人招商绑定 | create-registration-referral.tsadmin-panel/src/routes/affiliate/referrals/ |
已有基础 | 推荐人档案、等级、有效期、企业绑定、分成报表、打款。 | 企业审核通过后推荐关系生效，并可按有效期分账。 |
| 分账 / 账本 / 打款 | Stripe Connect、finance、commission 底座可复用。 | 部分实现 | 把 H2B 直接采购、BTOC/BTOB 联合开店、套壳坑位费、售后准备金、6% 保障费、底价、推荐人、网红统一入费用快照。 | 每笔订单能解释“各方结算金额及计算依据”。 |
| 订单快照与事件流 | 订单、commission、finance 账本可复用，但缺少统一业务快照字段。 | 新增开发 | 新增 buyer_type、trade_path、joint_agreement_id、source_tracking、费用快照、ultimate_buyer、reversal_entry_id。 | 每笔订单可追溯用户身份、商品来源、渠道来源、价格费用和退款冲正。 |
| 最终报表与运营看板 | 局部 admin 页面存在，但缺少总览。 | 新增开发 | 商家生命周期、商品生命周期、推广效果、分账结算、待审核事项。 | 运营能从一个后台看完整链路状态和异常。 |
12. 关键配置参数与已决策点
金额相关参数均为动态可配置（后台可调），先按默认值跑通、不阻塞开发，临上线前由业务方拍板；非金额项已写入产品口径。
| 决策项 | 建议默认示例 | 影响范围 | 系统设计方式 |
|---|---|---|---|
| H2B 直接采购平台佣金承担方与比例 | 订单额 5%，可由供方或采购方承担 | 前台价格展示与账本。 | 交易路径级配置，动态可调。 |
| 售后准备金 + 6% 售后保障费 | 准备金从平台佣金切份额；无售后保障产品向卖家收 6%（平台兜底） | 平台收入、售后成本、卖家收益。 | 比例动态可配，3 个平台统一开。 |
| 推荐人有效期 | 促销期 12 个月，常规期 6 个月 | 长期分成成本。 | 按推荐人等级和活动配置，动态可调。 |
| 推荐人分成基数 | 平台实收佣金（是否扣支付手续费动态可配） | 直接决定推荐人金额。 | 费用快照记录基数公式。 |
| 网红佣金承担方（已决策） | 由商家/商品毛利承担，平台代结算；BTOB 联合开店不进入 BTOC 网红推广 | 订单结算中推广成本承担方。 | 按交易路径默认，可手动覆盖，并受商品毛利护栏约束。 |
| BTOC 联合开店范围（已决策） | 目前仅平台指定一家壳店，暂不开放其他日企 BTOC 联合开店申请；套壳坑位费按订单实付金额百分比计算 | 选品库（= 壳店报价栏）与零售经营、协议费用。 | 联合开店为协议层；坑位费率后台可调并进入订单快照；后续扩大开放另评估。 |
| BTOB 小 B 自主下单准入 | 平台 BTOB 入口游客可看商品，自主下单必须注册登录；BTOB 二次发布 P0 只做外部导流和线索 | 企业采购准入、订单主体、线索归属。 | P0 设计注册下单、扫码意向、产品导出和自有平台导流；代下单/API 回写放 P2。 |
| API 对接范围 | P2 单独定制 | 商品、付款、物流、售后接口工作量大。 | 先保留 API 产品边界，不纳入 P0。 |
13. 最终验收 Checklist
上线验收需按生命周期逐项验证，覆盖前台入口、后台审核、订单事件、归因分佣、账本结算和异常冲正。
商家生命周期
- 推荐人二维码注册企业后，系统能保存推荐来源。
- 中国供货方、H2B 采购商、BTOB 大 B、BTOC 企业会员、网红店铺身份可区分。
- H2B 采购商审核通过后，可按规则承接为 BTOB 大 B。
- 商家被限制或停用后，不能新增商品、推广或订单。
产品生命周期
- H2B 商品必须记录海外联网、AI 模型可用、语言、合规资料和管理员审核状态。
- 供应商上传商品时必须支持附件、截图、价格、库存和认证资料。
- 后台必须支持人工逐项审核门禁、填写备注、驳回原因和补件要求。
- 未通过管理员审核和门禁的商品不能进入对应交易路径。
- 联合开店新链路不生成派生商品；如需追踪协议来源，只记录 joint_agreement_id、source_product_id 或订单快照。
- 商家主体统一，BTOB / BTOC / H2B 渠道资格分开审核、分开开通、分开冻结。
- 商品发布按路径强约束控制：BTOC 联合开店仅 BTOC，BTOB 联合开店仅 BTOB，直接采购仅 H2B。
- 一个商品销售版本只能绑定一个目标销售渠道；同一实物产品多渠道经营必须生成独立销售版本。
- 商品状态必须覆盖草稿、待审核、H2B 可见、BTOC 联合开店、BTOB 联合开店、BTOB 发布、BTOC 发布、停用归档。
H2B 三种交易路径
- H2B 直接采购能在采购商审核通过后购物车结算并按佣金规则入账。
- BTOC 联合开店能记录线下谈妥后的单一售价、核规整改费（中企承担）。
- BTOB 联合开店能记录线下谈妥后的单一售价、核规费（日企承担）。
- 三种路径都能生成清晰订单费用快照和渠道限制快照。
H2B 供应商外贸资料
- 供应商后台必须能维护工厂视频、工厂照片、资质证书、检测报告、生产能力、质检体系、出口经验、客户案例和售后能力。
- H2B 前端商城的供应商栏目必须展示这些外贸验厂资料，供日方采购商考察。
- 后台必须能审核资料完整性、有效期和补件要求；过期或缺失资料需要可标记。
BTOB 大 B 分拨
- 大 B 能从可售商品生成商品/店铺海报、二维码和短链接。
- 小 B 扫码后能进入大 B 的商品页或采购意向页。
- 小 B 也能通过 BTOB 官方入口进入平台并发起企业注册。
- 未登录小 B 可以浏览商品和提交采购意向，但不能直接完成企业采购付款。
- 已注册企业买家可以加入购物车、下单和售后；不新增 BTOB 买家后台审核门禁。
- 大 B 能汇总采购意向并导出线索，或引导小 B 到自有平台下单。
- P0 不生成大 B 代下单订单；线索记录必须保存实际采购企业、联系人、来源海报和大 B 归属。
- 海报扫码不能自动创建推荐人招商关系。
用户独立与店铺二维码
- H2B、BTOB、BTOC 前端用户、登录态、访问权限和渠道资格互相独立。
- H2B 普通访客不能查看商品，采购商需管理员审核通过后才可查看。
- BTOB、H2B 店铺只展示对应商家的产品，联合开店商品同样按店铺归属展示。
- 商品和店铺均可生成分享二维码，二维码不能绕过前台权限和审核规则。
- 二维码访问、采购意向和外部承接线索均能追踪 target_type、target_id、owner_seller_id、channel 和 source。
BTOC 网红推广
- 只有进入 BTOC 可售池且允许推广的商品能被网红店铺选择。
- 网红必须拥有店铺，并可生成店铺二维码、商品短链、商品二维码和优惠码。
- 订单归因遵守“优惠码优先，其次短链末次点击”。
- 佣金明细、结算单、退款冲正能追溯。
推荐人招商
- 推荐人有唯一招商二维码，不与商品/店铺二维码混用。
- 企业审核通过后推荐关系进入有效期。
- H2B 企业关系关联到 BTOB 大 B 能力时推荐关系延续。
- 推荐人分成从平台佣金中计算，比例和有效期可配置。
分账结算
- 每笔订单能解释平台、供方、日方、网红、推荐人分别拿多少钱。
- 佣金率、坑位费率、售后准备金、6% 保障费、底价、优惠、网红率都在费用快照里留痕。
- 订单必须记录 buyer_type、portal、trade_path、sales_channel_id、joint_agreement_id、store_id、source_tracking。
- BTOB 官方入口订单、海报扫码线索、外部承接记录必须能区分；二次发布外部成交 P0 不进入平台订单。
- 退款、售后和取消订单能冲正原账本。
- 打款记录可审计，不能手动删除历史账本。
报表与运营
- 后台能看商家入驻漏斗、商品审核漏斗和交易路径分布。
- 能按大 B 查看海报点击、意向、导出和外部承接线索；外部成交不计入 P0 平台 GMV。
- 能按网红查看点击、订单、GMV、退款、佣金。
- 能按推荐人查看企业数、有效期内订单、平台佣金和分成。
最终开发优先级建议
P0-1固化 H2B 入驻、商品门禁、交易路径字段。
P0-2把联合开店发布到 BTOB / BTOC 做成清晰产品动作。
P0-3开发 BTOB 海报、扫码落地页、采购意向、产品导出和自有平台导流。
P0-4补齐推荐人企业招商产品化能力。
P0-5跑通 BTOC 壳店、网红选品 / 短链 / 优惠码、商家 opt-in 和佣金代结算最小闭环。
P1补齐网红高级报表、ASP / 税务配置和运营优化。
P2面向大客户做 API 对接和高级结算策略。
本报告是产品最终形态基准稿。后续需求、原型、开发任务和验收标准应以此报告为主线展开。