商品（Goods）对象

概述

Goods 是积分商城与周边商城统一使用的商品对象，用于描述商品的基础信息、价格、库存、履约方式及状态。

业务含义

积分商城与周边商城统一商品对象。

字段定义

字段名	类型	必填	默认值	字段说明	状态值枚举
goodsId	string	是	-	商品 ID	-
channel	enum	是	merch	商品渠道	points, merch
goodsType	enum	是	physical	商品类型	service, rights, physical
title	string	是	-	商品标题	-
highlight	string	否	null	商品亮点	-
pointsPrice	int	否	0	所需积分	-
cashPrice	decimal	否	0	现金价格	-
linePrice	decimal	否	0	划线价	-
supportModes	json	是	[]	支持的履约方式	pickup, shipping
storeId	string	否	null	关联门店	-
stock	int	是	0	可售库存	-
soldCount	int	是	0	已售/已兑数量	-
atlasId	string	否	null	关联图鉴 ID	-
status	enum	是	onsale	商品状态	draft, onsale, offsale, soldout

枚举说明

商品渠道 channel

• points：积分商城
• merch：周边商城

商品类型 goodsType

• service：服务类商品
• rights：权益类商品
• physical：实体商品

履约方式 supportModes

• pickup：到店自提
• shipping：物流配送

商品状态 status

• draft：草稿
• onsale：上架中
• offsale：已下架
• soldout：售罄

建模说明

• 该对象同时适用于积分兑换与现金购买场景。
• pointsPrice 与 cashPrice 可组合使用，以支持不同定价模式。
• supportModes 使用 JSON 数组表示，可支持多种履约方式并存。
• storeId 用于和门店建立关联，适用于自提等场景。
• atlasId 用于关联图鉴内容，便于商品与内容体系打通。