SuperAPI AI 工具集

spree-b2b

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:在 Spree 6 上搭建 B2B 或批发商城。整套 B2B 由四块开源配置组成,同一店面与后台可同时服务零售与批发:Company 描述买方组织与人员,Catalog 定义该客群可见范围、价格与起订量,渠道门控(storefront_access)决定访客能否看目录或价格,Freight(配送规则加 Freight 费率提供者)处理整箱、托盘、集装箱与审核后报价。端到端步骤见 Build a B2B Store 指南,本技能是其背后的规则与陷阱。

主要能力:公司树最多 5 层(MAX_DEPTH),根节点 kind 必须为 company;成员资格覆盖整棵子树,权限判断该客户在本节点或任一祖先是否有身份。可通过邮箱邀请成员(邀请 30 天过期),后台添加已有客户则立即成为成员。公司维护独立地址簿与默认收发货地址,税务按最近的 company 祖先生效。目录有商品集(空集为价格覆盖层,加首个商品即转为限制模式)、自有价格表、面向客户组或公司的分配及最低起订量等商业条款;目录创建时默认未激活,需 activate。价格解析按公司链、客户组、渠道默认目录顺序取首个命中,再按拥有列表、普通价格表、基础价格依次定价。数量规则按变体基础、目录默认、目录商品覆盖三级解析,MOQ 与倍数在加购和结单时校验。渠道门控有 public、prices_hidden、login_required 三档,由 Store API 强制。支持 PO 号与 PO 文档,以及发票付款和后台代客下单。

使用方式:通过 Store SDK(如 client.account.companies、carts.update 传 company_id)与 Admin SDK(catalogs.create、catalogs.products.create、catalogs.activate、orders.create 等)操作,命令与参数保持原样。示例数据含演示买家 wholesale@example.com / spree123,属公开凭据,切勿加载到生产环境。

限制:公司角色与权限、订单审批、支出限额、治理审计、公司入驻审批及付款条款、净额发票、报价均为 Spree Enterprise 专属,OSS 中成员角色只是名义标签;OSS 无付款条款引擎。企业不能自助注册公司,删除节点会删整棵子树且存在订单时被拒。价格不做货币换算。公司买方一旦公司链上已分配目录,就不再采用客户组目录。