model

Documentation

Index

• type Attribute
• type Brand
• type BrandInfo
• type Category
• type Coupon
• type CouponInfo
• type CouponStatus
• type CouponStock
• type CouponType
• type CouponValid
• type CouponValidType
• type DeliveryAddress
• type DeliveryCompany
• type DeliveryProduct
• type FreightTemplate
• type Order
• type OrderAftersale
• type OrderDelivery
• type OrderDetail
• type OrderPay
• type OrderPrice
• type OrderProduct
• type OrderStatus
• type Sku
• type Spu
• type Store
• type ValuationType

Types

type Attribute

type Attribute struct {
	Key   string `json:"attr_key,omitempty"`   // 属性键key（属性自定义用）
	Value string `json:"attr_value,omitempty"` // 属性值（属性自定义用）
}

type Brand

type Brand struct {
	Cid1 uint64     `json:"first_cat_id,omitempty"`  // 第一级类目
	Cid2 uint64     `json:"second_cat_id,omitempty"` // 第二级类目
	Cid3 uint64     `json:"third_cat_id,omitempty"`  // 第三级类目
	Info *BrandInfo `json:"brand_info,omitempty"`
}

type BrandInfo

type BrandInfo struct {
	Id   uint64 `json:"brand_id,omitempty"`   // 品牌ID
	Name string `json:"brand_name,omitempty"` // 品牌名称
}

type Category

type Category struct {
	Id    uint64 `json:"cat_id,omitempty"`   // 类目ID
	Pid   uint64 `json:"f_cat_id,omitempty"` // 类目父ID
	Name  string `json:"name,omitempty"`     // 类目名称
	Level int    `json:"level,omitempty"`
}

type Coupon

type Coupon struct {
	Id         uint64       `json:"coupon_id,omitempty"`   // 优惠券
	Type       CouponType   `json:"type,omitempty"`        // 优惠券类型
	Status     CouponStatus `json:"status,omitempty"`      // 优惠券状态
	CreateTime string       `json:"create_time,omitempty"` // 优惠券创建时间
	UpdateTime string       `json:"update_time,omitempty"` // 优惠券更新时间
	Info       *CouponInfo  `json:"coupon_info,omitempty"`
	Stock      *CouponStock `json:"stock_info,omitempty"`
}

type CouponInfo

type CouponInfo struct {
	Name  string       `json:"name,omitempty"` // 优惠券名称
	Valid *CouponValid `json:"valid_info,omitempty"`
}

type CouponStatus

type CouponStatus = int

优惠券状态

const (
	EDITING_COUPON      CouponStatus = 1   // 未生效，编辑中
	READY_COUPON        CouponStatus = 2   // 生效
	EXPIRED_COUPON      CouponStatus = 3   // 已过期
	CANCELED_COUPON     CouponStatus = 4   // 已作废
	DELETED_COUPON      CouponStatus = 5   // 删除
	READY_TO_USE_COUPON CouponStatus = 101 // 生效中
	EXPIRED2_COUPON     CouponStatus = 102 // 已过期
	USED_COUPON         CouponStatus = 103 // 已经使用
)

type CouponStock

type CouponStock struct {
	IssuedNum  int `json:"issued_num,omitempty"`  // 优惠券发放量
	ReceiveNum int `json:"receive_num,omitempty"` // 优惠券领用量
	UsedNum    int `json:"used_num,omitempty"`    // 优惠券已用量
}

type CouponType

type CouponType = int

优惠券类型

const (
	PRODUCT_CONDITION_DISCOUNT_COUPON CouponType = 1   // 商品条件折扣券
	PRODUCT_REACH_DISCOUNT_COUPON     CouponType = 2   // 商品满减券
	PRODUCT_GENERAL_DISCOUNT_COUPON   CouponType = 3   // 商品统一折扣券
	PRODUCT_PURCHASE_DISCOUNT_COUPON  CouponType = 4   // 商品直减券
	STORE_CONDITION_DISCOUNT_COUPON   CouponType = 101 // 店铺条件折扣券
	STORE_REACH_DISCOUNT_COUPON       CouponType = 102 // 店铺满减券
	STORE_GENERAL_DISCOUNT_COUPON     CouponType = 103 // 店铺统一折扣券
	STORE_PURCHASE_DISCOUNT_COUPON    CouponType = 104 // 店铺直减券
)

type CouponValid

type CouponValid struct {
	Type      CouponValidType `json:"valid_type,omitempty"`    // 优惠券有效期类型
	DayNum    int             `json:"valid_day_num,omitempty"` // 优惠券有效天数，valid_type=2时才有意义
	StartTime string          `json:"start_time,omitempty"`    // 优惠券有效期开始时间，valid_type=1时才有意义
	EndTime   string          `json:"end_time,omitempty"`      // 优惠券有效期结束时间，valid_type=1时才有意义
}

type CouponValidType

type CouponValidType = int

const (
	DATE_RANGE_VALID_COUPON CouponValidType = 1 // 商品指定时间区间
	DAY_NUM_VALID_COUPON    CouponValidType = 2 // 生效天数
)

type DeliveryAddress

type DeliveryAddress struct {
	Username     string `json:"username,omitempty"`      // 收货人姓名
	PostalCode   string `json:"postal_code,omitempty"`   // 邮编
	ProvinceName string `json:"province_name,omitempty"` // 国标收货地址第一级地址
	CityName     string `json:"city_name,omitempty"`     // 国标收货地址第二级地址
	CountyName   string `json:"county_name,omitempty"`   // 国标收货地址第三级地址
	Detail       string `json:"detail_info,omitempty"`   // 详细收货地址信息
	NationalCode string `json:"national_code,omitempty"` // 收货地址国家码
	Mobile       string `json:"tel_number,omitempty"`    // 收货人手机号码
}

type DeliveryCompany

type DeliveryCompany struct {
	Id   string `json:"delivery_id"`
	Name string `json:"delivery_name"`
}

type DeliveryProduct

type DeliveryProduct struct {
	WaybillId  string `json:"waybill_id,omitempty"`  // 快递单号
	DeliveryId string `json:"delivery_id,omitempty"` // 快递公司编号
}

type FreightTemplate

type FreightTemplate struct {
	Id            uint64        `json:"template_id,omitempty"` // 模板ID
	Name          string        `json:"name,omitempty"`        // 模板名称
	ValuationType ValuationType `json:"valuation_type,omitempty"`
}

type Order

type Order struct {
	Id         uint64          `json:"order_id,omitempty"`    // 订单ID
	Status     OrderStatus     `json:"status,omitempty"`      // 订单状态
	CreateTime string          `json:"create_time,omitempty"` // 创建时间
	UpdateTime string          `json:"update_time,omitempty"` // 更新时间
	Detail     *OrderDetail    `json:"order_detail,omitempty"`
	Pay        *OrderPay       `json:"pay_info,omitempty"`
	Price      *OrderPrice     `json:"price_info,omitempty"`
	Delivery   *OrderDelivery  `json:"delivery_info,omitempty"`
	Aftersale  *OrderAftersale `json:"aftersale_detail,omitempty"`
	OpenId     string          `json:"openid,omitempty"` // 用户的openid，用于物流助手接口
}

type OrderAftersale

type OrderAftersale struct {
	OrderList []struct {
		OrderId uint64 `json:"aftersale_order_id,omitempty"`
	} `json:"aftersale_order_list,omitempty"` // 售后单ID（售后接口开放后可用于查询）
	OrderCnt int `json:"on_aftersale_order_cnt,omitempty"` // 正在售后流程的售后单数
}

type OrderDelivery

type OrderDelivery struct {
	Method       string           `json:"delivery_method,omitempty"` // 快递方式（目前只有"快递"）
	DeliveryTime string           `json:"delivery_time,omitempty"`   // 发货时间
	Product      *DeliveryProduct `json:"delivery_product_info,omitempty"`
	Address      *DeliveryAddress `json:"address_info,omitempty"`
}

type OrderDetail

type OrderDetail struct {
	Products []OrderProduct `json:"product_infos,omitempty"`
}

type OrderPay

type OrderPay struct {
	Method        string `json:"pay_method,omitempty"`     // 支付方式（目前只有"微信支付"）
	PrepayId      uint64 `json:"prepay_id,omitempty"`      // 预支付ID
	TransactionId uint64 `json:"transaction_id,omitempty"` // 支付订单号
	PrepayTime    string `json:"prepay_time,omitempty"`    // 预付款时间
	PayTime       string `json:"pay_time,omitempty"`       // 付款时间
}

type OrderPrice

type OrderPrice struct {
	ProductPrice  uint `json:"product_price,omitempty"`  // 商品金额（单位：分）
	OrderPrice    uint `json:"order_price,omitempty"`    // 订单金额（单位：分）
	Freight       uint `json:"freight,omitempty"`        // 运费（单位：分）
	DiscountPrice uint `json:"discount_price,omitempty"` // 优惠金额（单位：分）
	IsDiscounted  bool `json:"is_discounted,omitempty"`  // 是否有优惠（false：无优惠/true：有优惠）
}

type OrderProduct

type OrderProduct struct {
	SpuId                 uint64      `json:"product_id,omitempty"`               // 小商店内部商品ID
	SkuId                 uint64      `json:"sku_id,omitempty"`                   // 小商店内部skuID
	ThumbImg              string      `json:"thumb_img,omitempty"`                // sku小图
	SkuCnt                int         `json:"sku_cnt,omitempty"`                  // sku数量
	OnAftersaleSkuCnt     int         `json:"on_aftersale_sku_cnt,omitempty"`     // 正在售后/退款流程中的sku数量
	FinishAftersaleSkuCnt int         `json:"finish_aftersale_sku_cnt,omitempty"` // 完成售后/退款的sku数量
	SalePrice             uint        `json:"sale_price,omitempty"`               // 售卖价格,以分为单位
	Attrs                 []Attribute `json:"sku_attrs,omtitempty"`               // 属性自定义用
}

type OrderStatus

type OrderStatus = int

订单状态

const (
	PENDING_PAY_ORDER      OrderStatus = 10  // 待付款
	PENDING_DELIVERY_ORDER OrderStatus = 20  // 待发货
	PENDING_RECEIVE_ORDER  OrderStatus = 30  // 待收货
	COMPLETE_ORDER         OrderStatus = 100 // 完成
	AFTERSALE_CANCEL_ORDER OrderStatus = 200 // 全部商品售后之后，订单取消
	CANCEL_ORDER           OrderStatus = 250 // 用户主动取消或待付款超时取消
)

type Sku

type Sku struct {
	Id           uint64      `json:"sku_id,omitempty"`         // 小商店内部SKU ID
	OutProductId string      `json:"out_product_id,omitempty"` // 商家自定义商品ID
	OutId        string      `json:"out_sku_id,omitempty"`     // sku_id
	ThumbImg     string      `json:"thumb_img,omitempty"`      // sku小图
	SalePrice    uint        `json:"sale_price,omitempty"`     // 售卖价格,以分为单位
	MarketPrice  uint        `json:"market_price,omitempty"`   // 市场价格,以分为单位
	StockNum     int         `json:"stock_num,omitempty"`      // 库存
	Barcode      string      `json:"barcode,omitempty"`        // 条形码
	SkuCode      string      `json:"sku_code,omitempty"`       // 商品编码
	Attrs        []Attribute `json:"sku_attrs,omitempty"`      // 属性自定义用
	UpdateType   int         `json:"type,omitempty"`           // 1:全量更新 2:增量更新
	CreateTime   string      `json:"create_time,omitempty"`
	UpdateTime   string      `json:"update_time,omitempty"`
}

type Spu

type Spu struct {
	Id         uint64   `json:"product_id,omitempty"`     // 小商店内部商品ID
	OutId      string   `json:"out_product_id,omitempty"` // 商家自定义商品ID，与product_id二选一
	Title      string   `json:"title,omitempty"`          // 标题
	SubTitle   string   `json:"sub_title,omitempty"`      // 副标题
	HeadImages []string `json:"head_img,omitempty"`       // 主图,多张,列表
	DescInfo   *struct {
		Imgs []string `json:"imgs,omitempty"`
	} `json:"desc_info,omitempty"` // 商品详情，图文(目前只支持图片)
	BrandId     uint64     `json:"brand_id,omitempty"` // 商家需要申请品牌
	Cats        []Category `json:"cats,omitempty"`     // 商家需要先申请可使用类目
	Attrs       []Attribute
	Model       string           `json:"model,omitempty"`        // 商品型号
	ExpressInfo *FreightTemplate `json:"express_info,omitempty"` // 运费模板ID（先通过获取运费模板接口拿到）
	Skus        []Sku            `json:"skus,omitempty"`         // 该 skus 列表非必填，可另行通过 BatchAddSKU 添加 SKU
	CreateTime  string           `json:"create_time,omitmepty"`  // 创建时间
	UpdateTime  string           `json:"update_time,omitempty"`  // 更新时间
}

type Store

type Store struct {
	Name string `json:"store_name,omitempty"` // 商店名称
	Logo string `json:"store_logo,omitempty"` // 商店头像
}

type ValuationType

type ValuationType = int

计费类型

const (
	PIECE_VALUATION  ValuationType = 1 // 按件
	WEIGHT_VALUATION ValuationType = 2 // 按重量
)