483 lines
35 KiB
Go
483 lines
35 KiB
Go
package mtwmapi
|
||
|
||
//#region 买赠活动
|
||
|
||
// BatchCreateBuyGiftsParam 活动创建参数
|
||
type BatchCreateBuyGiftsParam struct {
|
||
AppSpuCode string `json:"app_spu_code"` // APP方商品id
|
||
StartTime int64 `json:"start_time"` // 活动开始时间，传10位秒级的时间戳
|
||
EndTime int64 `json:"end_time"` // 活动结束时间，传10位秒级的时间戳
|
||
GiftsType int `json:"gifts_type"` // 赠品类型。取值范围：0-非本商品非在售商品；1-本商品；2-非本商品在售商品
|
||
GiftsName string `json:"gifts_name,omitempty"` // 为赠品名称
|
||
GiftsAppSpuCode string `json:"gifts_app_spu_code,omitempty"` // 非本商品在售商品id，当gifts_type=2时上传。
|
||
BuyNum int `json:"buy_num"` // 达到送赠品条件的商品购买数量，须上传大于0的正整数
|
||
GiftsNum int `json:"gifts_num"` // 达到购买数量时赠送的赠品数量。须上传大于0的为正整数。例如buy_num=2，gifts_num=3，则代表买2件商品，赠送3件赠品。
|
||
GiftsCharge float64 `json:"gifts_charge"` // 单个赠品的成本，单位是元。此字段信息须大于0，最多支持两位小数。注意，赠品成本为商家成本，不涉及美团成本。
|
||
GiftsDayLimit int `json:"gifts_day_limit"` // 当日活动赠品库存，字段类型int。须上传大于0的正整数或-1，如传-1则表示不限制活动赠品库存。
|
||
}
|
||
|
||
// BatchQueryBuyGiftsAll 活动创建参数
|
||
type BatchQueryBuyGiftsAll struct {
|
||
ItemId int `json:"item_id"` // 活动id
|
||
AppSpuCode string `json:"app_spu_code"` // 活动商品，为APP方商品id，即商家中台系统里商品的编码（spu_code值）。
|
||
AppPoiCode string `json:"app_poi_code"` //
|
||
GiftsType int `json:"gifts_type"` // 赠品类型，参考值：0-非本商品非在售商品；1-本商品；2-非本商品在售商品。
|
||
GiftsName string `json:"gifts_name"` // 赠品名称
|
||
GiftsAppSpuCode string `json:"gifts_app_spu_code"` // 赠品的app_spu_code信息，非活动本商品的店内在售商品。
|
||
StartTime int64 `json:"start_time"` // 开始时间
|
||
EndTime int64 `json:"end_time"` // 结束时间
|
||
BuyNum int `json:"buy_num"` // 达到送赠品条件的商品购买数量
|
||
GiftsNum int `json:"gifts_num"` //
|
||
BuyGiftsNum int `json:"buy_gifts_num"` //
|
||
GiftsCharge float64 `json:"gifts_charge"` //
|
||
GiftsDayLimit int `json:"gifts_day_limit"` // 当日活动赠品库存，为大于0的正整数或-1，如为-1则表示不限制活动赠品库存。
|
||
Status int `json:"status"` // 活动当前的状态，参考值：2-待生效；1-生效；0-过期
|
||
ItemName string `json:"item_name"` // 活动名称
|
||
BuyGiftsModel string `json:"buy_gifts_model"` // 补贴模式，目前仅有“商家进货补贴模式(走结算流程)”模式。
|
||
Charge string `json:"charge"` // 成本相关，单位是元。参数包括： giftsCharge，赠品成本； giftsPoiCharge，商家承担成本； giftsMtCharge，美团承担成本。
|
||
}
|
||
|
||
type GiftsChargeObj struct {
|
||
GiftsPoiCharge string `json:"giftsPoiCharge"` // 商家成本
|
||
GiftsMtCharge int `json:"giftsMtCharge"` // 美团成本
|
||
GiftsCharge string `json:"giftsCharge"` // 赠品成本
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 满减活动
|
||
|
||
// GetDiscountList 获取满减活动列表
|
||
type GetDiscountList struct {
|
||
ActDetails []struct {
|
||
ActId interface{} `json:"act_id"`
|
||
ActPrice float64 `json:"act_price"`
|
||
AppFoodCode interface{} `json:"app_food_code"`
|
||
AppPoiCode interface{} `json:"app_poi_code"`
|
||
AppSpuCode interface{} `json:"app_spu_code"`
|
||
DayLimit interface{} `json:"day_limit"`
|
||
EndTime interface{} `json:"end_time"`
|
||
Name interface{} `json:"name"`
|
||
OrderLimit interface{} `json:"order_limit"`
|
||
OriginPrice float64 `json:"origin_price"`
|
||
Period interface{} `json:"period"`
|
||
StartTime interface{} `json:"start_time"`
|
||
Status interface{} `json:"status"`
|
||
Stock interface{} `json:"stock"`
|
||
UserType interface{} `json:"user_type"`
|
||
WeeksTime interface{} `json:"weeks_time"`
|
||
} `json:"act_details"` // 满减活动详情
|
||
ActInfo struct { // 活动信息，json格式字符串。
|
||
ActIds string `json:"act_ids"`
|
||
ActName string `json:"act_name"`
|
||
ActType interface{} `json:"act_type"`
|
||
AutoDelay interface{} `json:"auto_delay"`
|
||
EndTime int64 `json:"end_time"`
|
||
StartTime int64 `json:"start_time"`
|
||
ExtraInfo struct {
|
||
Offset interface{} `json:"offset"`
|
||
TotalCount interface{} `json:"total_count"`
|
||
Limit interface{} `json:"limit"`
|
||
PageNum interface{} `json:"page_num"`
|
||
TaskId interface{} `json:"task_id"`
|
||
BatchActId int64 `json:"batch_act_id"` // 批次维度活动ID
|
||
SkuExtraInfo []struct {
|
||
AppSpuCode interface{} `json:"app_spu_code"` // 同入参app_spu_code或app_food_code，仅在指定商品满减时返回
|
||
SkuId interface{} `json:"sku_id"` // 同入参sku_id，
|
||
SkuActId interface{} `json:"sku_act_id"` // 商品维度的活动ID
|
||
} `json:"sku_extra_info"` // sku维度活动额外信息，仅在指定商品满减时返回
|
||
PageSize interface{} `json:"page_size"`
|
||
} `json:"extraInfo"`
|
||
Period interface{} `json:"period"`
|
||
Quantity int `json:"quantity"` // 参加指定商品满减活动的商品数，仅适用于指定商品满减活动类型。
|
||
Status int `json:"status"` // 活动状态。(1)指定商品满减活动状态：2-待生效；1-生效；0-过期。(2)全店满减活动状态：0-待生效；1-生效；2-过期。
|
||
WeeksTime interface{} `json:"weeks_time"`
|
||
} `json:"act_info"`
|
||
ActRemark string `json:"act_remark"`
|
||
AppPoiCode string `json:"app_poi_code"`
|
||
}
|
||
|
||
// CreateDiscountList 创建满减活动(门店/商品)
|
||
type CreateDiscountList struct {
|
||
AppPoiCode string `json:"app_poi_code"` // APP方门店id
|
||
ActInfo string `json:"act_info"` // 活动信息 CreateDisCountActInfo
|
||
ActDetails string `json:"act_details"` // 活动详情信息，json格式数组。活动满减不能超过5层阶梯。[CreateDiscountActDetails]
|
||
AppFoods string `json:"app_foods"` // 活动商品信息，为json格式数组，此字段仅用于创建指定商品满减活动时上传 [CreateDiscountAppFoods]
|
||
}
|
||
|
||
type CreateDisCountActInfo struct {
|
||
ActName string `json:"act_name"` // 活动名字
|
||
StartTime int64 `json:"start_time"` // 开始时间
|
||
EndTime int64 `json:"end_time"` // 结束时间
|
||
ActType int `json:"act_type"` // 活动类型，取值范围：0-全店满减；1-指定商品满减。如此字段不传则默认act_type=1，表示指定商品满减类型；act_type=0时，不可以传app_foods字段。
|
||
WeeksTime string `json:"weeks_time"` // 生效活动周期, 1、仅当act_type传0（全店满减）时，支持传本参数； 2、取值范围及意义：1,2,3,4,5,6,7；分别表示周一至周日，多个星期之间用英文逗号分隔； 3、非必传，创建时如不传，则默认周期为"1,2,3,4,5,6,7"。 4、上传的周期相互不能重复
|
||
Period string `json:"period"` // 生效时间段， 1、仅当act_type传0（全店满减）时，支持传本参数； 2、精确到分钟，24小时制，格式为HH:MM-HH:MM，最多支持上传3个时段，多个时段之间用英文逗号分隔； 3、每个时段的开始时间必须小于结束时间。传的多个时段不允许有重叠。 4、上传多个时段时，必须按时间先后顺序进行上传。每个时段最短为30分钟。 5、非必传，创建时如不传则默认时段为"00:00:-23:59"。
|
||
AutoDelay int `json:"auto_delay"` // 每次活动到期后自动延期30天，传1表示开启。 1、仅当act_type传0（全店满减）时，支持传本参数。 2、仅支持传1，表示开启，每当活动到期时自动延期30天。 3、非必传，创建活动时如不传则为关闭状态，不自动延期。
|
||
}
|
||
|
||
type CreateDiscountActDetails struct {
|
||
OriginPrice int `json:"origin_price"` // 表示满的金额
|
||
ActPrice int `json:"act_price"` // 表示减的金额
|
||
}
|
||
|
||
type CreateDiscountAppFoods struct {
|
||
AppSpuCode string `json:"app_spu_code"` // PP方商品id，即商家中台系统里商品的编码
|
||
DayLimit int `json:"day_limit"` // 当日活动商品库存，仅支持上传大于0的整数或-1，如传-1时则表示不限制商品活动库存。
|
||
}
|
||
|
||
// CreateDiscountResult 创建满减活动返回值结构
|
||
type CreateDiscountResult struct {
|
||
Data string `json:"data"` // ok
|
||
SuccessMsg string `json:"success_msg"` // 活动ID
|
||
ExtraInfo []DiscountData `json:"extra_info"` //
|
||
ResultCode int `json:"result_code"` // 1-全部操作成功，查询到的数据在data字段中；2-部分成功，成功的数据存储在data字段中，失败的数据存在error_list字段中；3-全部操作失败，失败的数据存在error_list字段中；4-请求失败，一般为签名或限流问题，关注error字段中的具体描述即可
|
||
SuccessMap []DiscountData `json:"success_map"` // 成功的集合信息
|
||
}
|
||
|
||
type DiscountData struct {
|
||
TaskId string `json:"task_id"` // 当商家使用异步排队方式请求接口时返回，商家可使用任务id查询任务进度
|
||
TaskDetailLink string `json:"task_detail_link"` // 创建异步排队任务成功，返回任务详情链接，通过浏览器打开链接查看任务处理结果
|
||
BatchActId string `json:"batch_act_id"` // 批次维度活动ID，
|
||
SkuExtraInfo []struct {
|
||
SkuActId int64 // 商品维度的活动ID
|
||
AppSpuCode string // 同入参app_spu_code
|
||
SkuId string // 同入参sku_id
|
||
} `json:"sku_extra_info"` // sku维度活动额外信息，仅在创建成功时返回，仅在指定商品满减时返回
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 运费满减活动
|
||
|
||
// ShippingFeeResult 满减运费活动配置
|
||
type ShippingFeeResult struct {
|
||
ResultCode int `json:"result_code"` // 返回状态码
|
||
SuccessList []ShippingFeeDetail `json:"success_list"` // 成功上数据列表
|
||
Data []ShippingFeeDetail `json:"data"` // 好像是所有的数据列表
|
||
}
|
||
|
||
// ShippingFeeDetail 运费活动返回详情值
|
||
type ShippingFeeDetail struct {
|
||
AppPoiCode string `json:"app_poi_code"` // 门店code
|
||
ActId int `json:"act_id"` // 活动ID
|
||
StartTime int `json:"start_time"` // 开始时间
|
||
EndTime int `json:"end_time"` // 结束时间
|
||
WeeksTime string `json:"weeks_time"` // 活动周期(周一-周末)
|
||
Period string `json:"period"` // 生效时间段，多个时段以英文逗号分隔；如创建活动时此字段未填写，则默认时段为"00:00:-23:59"。
|
||
ActDetail []struct {
|
||
LimitPrice float64 `json:"limit_price"` // 满减门槛
|
||
DiscountPrice float64 `json:"discount_price"` // 减配送费
|
||
PoiCharge float64 `json:"poi_charge"` // 门店承担费用
|
||
MtCharge float64 `json:"mt_charge"` // 美团承担费用
|
||
} `json:"act_detail"` // 活动详情
|
||
MaxPrice float64 `json:"max_price"` // 免配送费门槛
|
||
ActStatus string `json:"actStatus"` // 活动状态：NOT_START=待生效；IN_PROGRESS=已生效；EXPIRED=已过期；APPROVE=待审批；FREEZE=冻结中。
|
||
}
|
||
|
||
// ShippingFeeBatchCreate 批量创建阶梯满减活动
|
||
type ShippingFeeBatchCreate struct {
|
||
AppPoiCode string `json:"app_poi_code"` // 门店code
|
||
ActData string `json:"act_data"` // 门店满减运费活动信息，json格式数组。(1)同一门店同一时间仅允许参加一个活动。(2)同一门店的生效中+待生效活动最多支持20组。
|
||
}
|
||
|
||
// ShippingFeeBatchCreateActData 活动详情
|
||
type ShippingFeeBatchCreateActData struct {
|
||
StartTime int `json:"start_time"` // 开始时间
|
||
EndTime int `json:"end_time"` // 结束时间
|
||
WeeksTime string `json:"weeks_time"` // 活动周期(周一-周末)
|
||
Period string `json:"period"` // 生效时间段，多个时段以英文逗号分隔；如创建活动时此字段未填写，则默认时段为"00:00:-23:59"。
|
||
MaxPrice float64 `json:"max_price"` // 免配送费门槛
|
||
ActDetail []ShippingFeeBatchCreateActDataActDetail `json:"act_detail"` // 活动详情
|
||
}
|
||
|
||
type ShippingFeeBatchCreateActDataActDetail struct {
|
||
LimitPrice float64 `json:"limit_price"` // 满减门槛
|
||
DiscountPrice float64 `json:"discount_price"` // 减配送费
|
||
}
|
||
|
||
// ShippingResultData 运费满减活动创建返回值
|
||
type ShippingResultData struct {
|
||
ResultCode int `json:"result_code"` // 返回状态码
|
||
SuccessList []ShippingFeeDetail `json:"success_list"` // 成功上数据列表
|
||
SuccessMsg []ShippingFeeDetail `json:"success_msg"` // 好像是所有的数据列表
|
||
Data string `json:"data"`
|
||
Msg string `json:"msg"`
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 创建X元M件活动
|
||
|
||
// CreateBundlesActParam 创建X件优惠活动
|
||
type CreateBundlesActParam struct {
|
||
ActId int64 `json:"act_id"` // 更新时填写,活动ID
|
||
// 创建时填写
|
||
ActName string `json:"act_name"` // 活动名称
|
||
StartTime int `json:"start_time"` // 开始时间
|
||
EndTime int `json:"end_time"` // 结束时间
|
||
ActPrice float64 `json:"act_price"` // 活动价格
|
||
ActNum int `json:"act_num"` // 活动数量(表示“X元M件”中的M)
|
||
AppFoods []struct {
|
||
AppSpuCode string `json:"app_spu_code"` // 传APP方商品id
|
||
DayLimit int `json:"day_limit"` // 商品当日活动库存，须传大于0的整数或-1，如传-1则表示不限制商品活动库存。
|
||
} `json:"app_foods"` // 参加活动的商品信息
|
||
}
|
||
|
||
// BundlesSuccessListDetail 创建X件优惠活动返回值
|
||
type BundlesSuccessListDetail struct {
|
||
ActId int64 `json:"act_id"` // 活动id
|
||
BatchActId int64 `json:"batch_act_id"` // 批次维度活动ID
|
||
ActDetails []struct {
|
||
Discount float64 `json:"discount"` // 活动折扣，表示“X件Y折”中的Y折
|
||
ActNum int `json:"act_num"` // 活动数量，表示“X件Y折”中的X件
|
||
} `json:"act_details"` // 活动优惠信息，最多返回3个阶梯（只有X件Y折返回该信息）
|
||
ExtraInfo struct {
|
||
BatchActId int64 `json:"batch_act_id"` // 批次维度活动ID
|
||
SkuExtraInfo []struct {
|
||
SkuActId int64 `json:"sku_act_id"` // 商品维度的活动ID，该ID是对act_id的补全
|
||
AppSpuCode string `json:"app_spu_code"` // 活动商品，传APP方商品id，即商家中台系统里商品的编码（spu_code值）。
|
||
SkuId string `json:"sku_id"` // 商品规格id，本接口暂未支持多规格商品创建活动，均返回null
|
||
}
|
||
} `json:"extraInfo"` // 活动额外信息，包括批次和商品维度活动id（X件Y折不返回该信息）
|
||
ActName string `json:"act_name"` // 活动名称
|
||
StartTime int `json:"start_time"` // 开始时间
|
||
EndTime int `json:"end_time"` // 结束时间
|
||
ActRemark string `json:"act_remark"` //活动文案
|
||
}
|
||
|
||
// BundlesSkuSuccessListDetail 查询X件商品优惠活动商品信息返回值
|
||
type BundlesSkuSuccessListDetail struct {
|
||
AppSpuCode string `json:"app_spu_code"` // 活动商品，传APP方商品id，即商家中台系统里商品的编码（spu_code值）。
|
||
SkuId string `json:"sku_id"` // 商品规格id，本接口暂未支持多规格商品创建活动，均返回null
|
||
DayLimit int `json:"day_limit"` // 商品当日活动库存，须为大于0的整数或-1，如传-1则表示不限制。
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 加价购活动
|
||
|
||
// RepurchaseCreate 创建门店加价购活动
|
||
type RepurchaseCreate struct {
|
||
// 修改时填写
|
||
ActId int64 `json:"act_id"` // 活动ID
|
||
|
||
// 创建时填写
|
||
ActName string `json:"act_name"` // 活动名称
|
||
StartTime int `json:"start_time"` // 开始时间
|
||
EndTime int `json:"end_time"` // 结束时间
|
||
ActPrice float64 `json:"act_price"` // 换购门槛，表示可参加本次换购活动的订单金额门店(不包含运费)，
|
||
ActRemark string `json:"actRemark"` // 加价换购活动描述
|
||
AppFoods []RepurchaseCreateAppFoods `json:"app_foods"` // 参加换购的活动商品数据
|
||
}
|
||
|
||
type RepurchaseCreateAppFoods struct {
|
||
AppSpuCode string `json:"app_spu_code"` // 活动商品，传APP方商品id
|
||
ActPrice float64 `json:"act_price"` // 活动价(单价)，表示换购一件此商品需额外支付的价格，单位元；活动价不能大于商品原价
|
||
DayLimit int `json:"day_limit"` // 商品当日活动库存，须为大于0的整数或-1，如传-1则表示不限制。
|
||
}
|
||
|
||
type RepurchaseCreateResult struct {
|
||
SkuActId string `json:"sku_act_id"` // 商品维度的活动ID，该ID是对act_id的补全
|
||
AppSpuCode string `json:"app_spu_code"` // 同入参app_spu_code
|
||
SkuId string `json:"sku_id"` // 商品规格id，本接口暂未支持多规格商品创建活动，均返回null
|
||
}
|
||
|
||
// RepurchaseResult 获取门店加价购活动返回值
|
||
type RepurchaseResult struct {
|
||
ActId int64 `json:"act_id"` // 活动ID
|
||
ActName string `json:"act_name"` // 活动名称
|
||
StartTime int `json:"start_time"` // 开始时间
|
||
EndTime int `json:"end_time"` // 结束时间
|
||
ActPrice float64 `json:"act_price"` // 换购门槛，表示可参加本次换购活动的订单金额门店(不包含运费)，
|
||
ActRemark string `json:"actRemark"` // 加价换购活动描述
|
||
OrderLimitTotal int `json:"order_limit_total"` // 每单可换购的商品总数，为大于0的整数或-1，如为-1则表示不限制。
|
||
ExtraInfo struct {
|
||
BatchActId int64 `json:"batch_act_id"` // 批次维度活动ID
|
||
SkuExtraInfo []struct {
|
||
SkuActId int64 `json:"sku_act_id"` // 商品维度的活动ID
|
||
AppSpuCode string `json:"app_spu_code"` // 活动商品，传APP方商品id
|
||
SkuId interface{} `json:"sku_id"` // 商品规格id，本接口暂未支持多规格商品创建活动，均返回nu
|
||
} `json:"sku_extra_info"` // sku维度活动额外信息
|
||
} `json:"extraInfo"` // 活动额外信息，包括批次和商品维度活动id
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 商品券活动
|
||
|
||
// CreateCouponAct 创建门店优惠券活动
|
||
type CreateCouponAct struct {
|
||
AppPoiCodes string `json:"app_poi_codes"` // 可使用券的门店id列表，多个用英文逗号分隔
|
||
CouponName string `json:"coupon_name"` // 券名称，不能超过12个字符，仅支持汉字、数字和字母。
|
||
IsSinglePoi int `json:"is_single_poi"` // 券使用范围是否限制单门店，取值范围：0-门店通用券；1-单门店券。(1)门店通用券：如app_poi_codes字段传的门店ABC，则A门店领，ABC门店通用。(2)单门店券：A门店领，仅A门店用。
|
||
AppSpuCodes string `json:"app_spu_codes"` // 参加活动的商品，传APP方商品id，即商家中台系统里商品的编码（spu_code值）。(1)如不同门店内同一商品的app_spu_code不同，则视为不同商品，多个商品id用英文逗号分隔。(2)当创建按折扣的商品券活动且discount=0时，本参数仅支持传一个参加活动的商品
|
||
SpuData []CreateCouponActSpuData `json:"spu_data"` // 创建商品券活动支持按照sku维度创建，传入spu_data字段。若同时传入spu_data和app_spu_code字段，默认以spu_data数据为准进行创建商品券
|
||
TakeCouponStartTime int64 `json:"take_coupon_start_time"` // 领券开始时间，传10位秒级的时间戳。
|
||
TakeCouponEndTime int64 `json:"take_coupon_end_time"` // 领券结束时间，传10位秒级的时间戳。
|
||
UseCouponStartTime int64 `json:"use_coupon_start_time"` // 用券开始时间，传10位秒级的时间戳。
|
||
CouponLimitCount int64 `json:"coupon_limit_count"` // 活动期间每个用户领券的最大数量限制，范围1~99999999的整数。
|
||
Type int `json:"type"` // 商品券类型，取值范围：1-按活动价格；2-按折扣。
|
||
ActPriceCouponInfo []GetStoreCouponActSuccessListActPriceCouponInfo `json:"act_price_coupon_info"` // 按活动价格的商品券信息，json格式数组。按活动价格的商品券活动最多支持设置三层优惠。
|
||
DiscountCouponInfo []GetStoreCouponActSuccessListDiscountCouponInfo `json:"discount_coupon_info"` // 按折扣的商品券信息，json格式数组。(1)当discount大于0时，折扣商品券活动的优惠信息不能超过三层。(2)当discount等于0时，为商品兑换券活动，仅支持设置一层。
|
||
}
|
||
|
||
// CreateCouponActSpuData SpuData参数
|
||
type CreateCouponActSpuData struct {
|
||
AppSpuCode string `json:"app_spu_code"` // APP方商品id
|
||
SkuId string `json:"sku_id"` // 是sku唯一标识码，字段信息限定长度不能超过40个字符。不允许上传emoji等表情符。
|
||
Upc string `json:"upc"` // upc
|
||
}
|
||
|
||
//// CreateActPriceCouponInfo ActPriceCouponInfo 参数
|
||
//type CreateActPriceCouponInfo struct {
|
||
// FullPrice int `json:"full_price"` // 券使用门槛金额，范围是1~999的正整数，单位元。
|
||
// ReducePrice int `json:"reduce_price"` // 券金额，范围是1~999的正整数，单位元；表示达到使用门槛后可以减的金额
|
||
// Stock int `json:"stock"` // 券库存，范围1-99999的正整数。(1)当选择单门店券时(is_single_poi=1)，该库存指的是每门店的券库存。(2) 当选择门店通用券时(is_single_poi=0)，该库存指的是所有门店共享的券库存
|
||
// UseType int `json:"user_type"` // 可领券的用户，取值范围：0-新客&老客；1-门店联合新客(原新客，全部可用门店为新客)；2-老客； 7-门店新客(当前门店为新客)。如不传此字段，则默认为0。
|
||
//}
|
||
//
|
||
//// CreateDiscountCouponInfo DiscountCouponInfo 参数
|
||
//type CreateDiscountCouponInfo struct {
|
||
// FullPrice int `json:"full_price"` // 券使用门槛金额，范围是1~999的正整数，单位元。
|
||
// Discount float64 `json:"discount"` // 折扣系数，需大于0且小于10，最多一位小数；或传0，表示兑换券。当discount=0时，则此活动为无门槛商品兑换券活动；此时app_spu_codes字段上传的商品数不能大于1个，且该商品不可再参加其他优惠活动。
|
||
// MaxReducePrice int64 `json:"max_reduce_price"`
|
||
// Stock int `json:"stock"` // 券库存，范围1-99999的正整数。(1)当选择单门店券时(is_single_poi=1)，该库存指的是每门店的券库存。(2) 当选择门店通用券时(is_single_poi=0)，该库存指的是所有门店共享的券库存
|
||
// UseType int `json:"user_type"` // 可领券的用户，取值范围：0-新客&老客；1-门店联合新客(原新客，全部可用门店为新客)；2-老客； 7-门店新客(当前门店为新客)。如不传此字段，则默认为0。
|
||
//}
|
||
|
||
// CreateStoreCouponActResult 获取门店优惠券活动
|
||
type CreateStoreCouponActResult struct {
|
||
AppPoiCodes []string `json:"app_poi_codes"` // 门店ID列表
|
||
AppSpuCodes []string `json:"app_spu_codes"` // 成功商品列表
|
||
UpcList []string `json:"upc_list"` // 成功商品upc列表
|
||
ActId int64 `json:"act_id"` // 活动ID
|
||
}
|
||
|
||
// GetStoreCouponActParam 获取门店商品券活动
|
||
type GetStoreCouponActParam struct {
|
||
AppPoiCode string `json:"app_poi_code"` // 门店ID
|
||
ActStatus int `json:"act_status"` // 活动当前状态，取值范围：-1-全部；0-未生效；1-已生效；2-已结束。
|
||
StartTime int64 `json:"start_time"` // 开始时间
|
||
EndTime int64 `json:"end_time"` // 结束时间
|
||
PageNum int `json:"page_num"` // 页码
|
||
PageSize int `json:"page_size"` // 页数
|
||
}
|
||
|
||
// GetStoreCouponActSuccessList 获取门店优惠券返回列表
|
||
type GetStoreCouponActSuccessList struct {
|
||
ActId int64 `json:"actId"` // 活动id
|
||
AppPoiCodes string `json:"app_poi_codes"` // 可使用券的门店列表
|
||
CouponName string `json:"coupon_name"` // 券名称
|
||
IsSinglePoi int `json:"is_single_poi"` // 券使用范围是否限制单门店，参考值：0-门店通用券；1-单门店券。(1)门店通用券：如app_poi_codes字段传的门店ABC，则A门店领，ABC门店通用。(2)单门店券：A门店领，仅A门店用。
|
||
TakeCouponStartTime int64 `json:"take_coupon_start_time"` // 领券开始时间
|
||
TakeCouponEndTime int64 `json:"take_coupon_end_time"` // 领券结束时间
|
||
UseCouponStartTime int64 `json:"use_coupon_start_time"` // 用券开始时间
|
||
CouponLimitCount int64 `json:"coupon_limit_count"` // 活动期间每个用户领券的最大数量限制，范围1~99999999的整数
|
||
Type int64 `json:"type"` // 商品券类型，参考值：1-按活动价格；2-按折扣。
|
||
//ActPriceCouponInfo []interface{} `json:"act_price_coupon_info"` // 按活动价格的商品券信息，json格式数组。按活动价格的商品券活动最多支持设置三层优惠
|
||
ActPriceCouponInfo []GetStoreCouponActSuccessListActPriceCouponInfo `json:"-"`
|
||
//DiscountCouponInfo []interface{} `json:"discount_coupon_info"` // 按折扣的商品券信息，json格式数组。(1)当discount大于0时，为折扣商品券活动，优惠信息最多三层。(2)当discount等于0时，为商品兑换券活动，优惠信息仅一层
|
||
DiscountCouponInfo []GetStoreCouponActSuccessListDiscountCouponInfo `json:"-"`
|
||
}
|
||
|
||
// GetStoreCouponActSuccessListActPriceCouponInfo ActPriceCouponInfo数据
|
||
type GetStoreCouponActSuccessListActPriceCouponInfo struct {
|
||
FullPrice int `json:"full_price"` // 券使用门槛金额，范围是1~999的正整数，单位元。
|
||
ReducePrice int `json:"reduce_price"` // 券金额，范围是1~999的正整数，单位元；表示达到使用门槛后可以减的金额。
|
||
Stock int `json:"stock"` // 券库存，范围1-99999的正整数。(1)当选择单门店券时(is_single_poi=1)，该库存指的是每门店的券库存。(2) 当选择门店通用券时(is_single_poi=0)，该库存指的是所有门店共享的券库存。
|
||
UserType int `json:"user_type"` // 可领券的用户，取值范围：null或0-新客&老客；1-门店联合新客(原新客，全部可用门店为新客)；2-老客； 7-门店新客(当前门店为新客)。
|
||
}
|
||
|
||
// GetStoreCouponActSuccessListDiscountCouponInfo DiscountCouponInfo
|
||
type GetStoreCouponActSuccessListDiscountCouponInfo struct {
|
||
FullPrice int `json:"full_price"` // 券使用门槛金额，范围是1~999的正整数，单位元。
|
||
Discount float64 `json:"discount"` // 折扣系数，范围0-10之间，最多一位小数；或为0，表示无门槛商品兑换券活
|
||
MaxReducePrice int `json:"max_reduce_price"` // 券最高可减金额，单位元。(1)当discount大于0时，为折扣商品券活动，优惠信息最多三层。(2)当discount等于0时，为商品兑换券活动，不支持设置最高可减金额，max_reduce_price默认为0。
|
||
Stock int `json:"stock"` // 券库存，范围1-99999的正整数。(1)当选择单门店券时(is_single_poi=1)，该库存指的是每门店的券库存。(2) 当选择门店通用券时(is_single_poi=0)，该库存指的是所有门店共享的券库存。
|
||
UserType int `json:"user_type"` // 可领券的用户，取值范围：null或0-新客&老客；1-门店联合新客(原新客，全部可用门店为新客)；2-老客； 7-门店新客(当前门店为新客)。
|
||
}
|
||
|
||
// CouponActSkuListSuccessList 获取商品券活动商品列表
|
||
type CouponActSkuListSuccessList struct {
|
||
ActId int `json:"actId"` // 活动ID
|
||
AppPoiCodes string `json:"app_poi_codes"` // 门店ID
|
||
CouponName string `json:"coupon_name"` // 活动名称
|
||
IsSinglePoi int `json:"is_single_poi"` // 券使用范围是否限制单门店，参考值：0-门店通用券；1-单门店券。(1)门店通用券：如app_poi_codes字段传的门店ABC，则A门店领，ABC门店通用。(2)单门店券：A门店领，仅A门店用。
|
||
AppSpuCodes string `json:"app_spu_codes"` // 商品ID
|
||
TakeCouponStartTime int64 `json:"take_coupon_start_time"` // 领券开始时间
|
||
TakeCouponEndTime int64 `json:"take_coupon_end_time"` // 领券结束时间
|
||
UseCouponStartTime int64 `json:"use_coupon_start_time"` // 使用开始时间
|
||
CouponLimitCount int64 `json:"coupon_limit_count"` // 用户领券最大数
|
||
Type int `json:"type"` // 商品券类型，参考值：1-按活动价格；2-按折扣。
|
||
ActPriceCouponInfo []GetStoreCouponActSuccessListActPriceCouponInfo `json:"act_price_coupon_info"` // 按活动价格的商品券信息，json格式数组。按活动价格的商品券活动最多支持设置三层优惠。
|
||
DiscountCouponInfo []GetStoreCouponActSuccessListDiscountCouponInfo `json:"discount_coupon_info"` // 按折扣的商品券信息，json格式数组。(1)当discount大于0时，为折扣商品券活动，优惠信息最多三层。(2)当discount等于0时，为商品兑换券活动，优惠信息仅一层。
|
||
|
||
ActStatus int `json:"act_status"`
|
||
AppFoodCodes string `json:"app_food_codes"`
|
||
CouponRetailType int `json:"coupon_retail_type"`
|
||
IsShare int `json:"is_share"`
|
||
SpuData []struct {
|
||
AppSpuCode string `json:"app_spu_code"`
|
||
SkuId string `json:"sku_id"`
|
||
Upc string `json:"upc"`
|
||
} `json:"spu_data"`
|
||
UseCouponEndTime int `json:"use_coupon_end_time"`
|
||
ValidityDays int `json:"validity_days"`
|
||
}
|
||
|
||
//#endregion
|
||
|
||
//#region 第X件优惠活动
|
||
|
||
// GetStoreXDiscountSuccessList 第X件优惠返回值
|
||
type GetStoreXDiscountSuccessList struct {
|
||
ActId int64 `json:"act_id"`
|
||
BatchActId string `json:"batch_act_id"` // 批次维度活动ID，
|
||
StartTime int64 `json:"start_time"` // 开始时间
|
||
EndTime int64 `json:"end_time"` // 结束时间
|
||
ActName string `json:"act_name"` // 活动名字
|
||
ActSettingType int `json:"act_setting_type"` // 1）字段描述：活动子类型选择。 2）取值范围：0-第N件X折；1-第N件X元。 3）活动信息的字段规则根据此字段而变化
|
||
ActDetails []GetStoreXDiscountSuccessListActDetails `json:"act_details"` // 1）字段描述：活动具体信息。 2）至少有一阶，最多三阶。
|
||
ExtraInfo GetStoreXDiscountSuccessListExtraInfo `json:"extra_info"`
|
||
}
|
||
|
||
// GetStoreXDiscountSuccessListActDetails ActDetails
|
||
type GetStoreXDiscountSuccessListActDetails struct {
|
||
Price string `json:"price"` // 1）字段描述：活动商品售价 2）取值范围：0≤X，最多支持两位小数。 3）此范围当“活动子类型”为1时有效
|
||
Discount string `json:"discount"` // 1）字段描述：活动商品折扣系数。 2）取值范围：0≤X≤9.99，最多支持两位小数。 3）此范围当“活动子类型”为0时有效
|
||
Index int `json:"index"` // 1）字段描述：活动商品件数。 2）取值范围：N：1≤N≤5
|
||
}
|
||
|
||
// GetStoreXDiscountSuccessListExtraInfo ExtraInfo
|
||
type GetStoreXDiscountSuccessListExtraInfo struct {
|
||
BatchActId int64 `json:"batch_act_id"` // 批次维度活动ID
|
||
SkuExtraInfo []struct {
|
||
SkuActId int64 `json:"sku_act_id"` // 商品维度的活动ID，该ID是对act_id的补全
|
||
AppSpuCode string `json:"app_spu_code"` // 同入参app_spu_code
|
||
SkuId string `json:"sku_id"` // 商品规格id，本接口暂未支持多规格商品创建活动，均返回null
|
||
} `json:"sku_extra_info"` // sku维度活动额外信息
|
||
}
|
||
|
||
// CreateStoreXDiscountParam 创建地X件优惠活动
|
||
type CreateStoreXDiscountParam struct {
|
||
ActId int64 `json:"act_id"`
|
||
ActName string `json:"act_name"` // 活动名字
|
||
StartTime int64 `json:"start_time"` // 开始时间
|
||
EndTime int64 `json:"end_time"` // 结束时间
|
||
ActSettingType int `json:"act_setting_type"` // 1）字段描述：活动子类型选择。 2）取值范围：0-第N件X折；1-第N件X元。 3）活动信息的字段规则根据此字段而变化
|
||
ActDetails []GetStoreXDiscountSuccessListActDetails `json:"act_details"` // 1）字段描述：活动具体信息。 2）至少有一阶，最多三阶。
|
||
ActProducts []struct {
|
||
AppSpuCode string `json:"app_spu_code"` // （原app_food_code字段） 1）字段描述：活动商品编码。 2）选择第N件X元时，所选商品原价必须大于活动价X。 3）仅支持单规格商品参加活动 4）商品原价乘活动件数必须大于活动价。 5）如填写了活动id，输入未在活动中存在的app_spu_code，默认为在该活动中新增参加活动的商品。 6）如填写了活动id，输入已在活动中存在的app_spu_code，则认为更新此活动中该商品库存信息。
|
||
DayLimit int `json:"day_limit"` // 1）字段描述：活动商品当日库存。 2）格式：正整数，不大于999999999。 3）如当日库存为无限，则传-1。
|
||
} `json:"act_products"`
|
||
}
|
||
|
||
// CreateStoreXDiscountResult 创建X件优惠返回值
|
||
type CreateStoreXDiscountResult struct {
|
||
SkuActId int64 `json:"sku_act_id"` // 商品维度的活动ID，该ID是对act_id的补全
|
||
AppSpuCode string `json:"app_spu_code"` // 同入参app_spu_code
|
||
SkuId string `json:"sku_id"` // 商品规格id，本接口暂未支持多规格商品创建活动，均返回null
|
||
}
|
||
|
||
//#endregion
|