{ "openapi": "3.0.1", "info": { "title": "管理后台", "description": "提供管理员管理的所有功能", "contact": {}, "license": {}, "version": "1.0.0" }, "servers": [ { "url": "http://172.16.8.7:48003", "description": "Generated server url" } ], "security": [ { "Authorization": [] }, { "Authorization": [] } ], "paths": { "/open-api/promotion/redeem-code/redeem": { "post": { "tags": [ "开放平台 / 优惠券随机兑换" ], "summary": "优惠券随机兑换（按邮箱发券）", "operationId": "redeem", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenRedeemCodeReqVO" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CommonResultOpenRedeemCodeRespVO" } } } } } } } }, "components": { "schemas": { "AppAllianceWalletWithdrawMethodUpdateReqVO": { "required": [ "accountDetail", "accountType", "accountTypeCode", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 13859 }, "accountType": { "type": "integer", "description": "收款账号类型:1-PayPal, 2-Bank Transfer, 3-RizzitGO Wallet, 4-USDT, 5-Binance", "format": "int32", "example": 1 }, "accountTypeCode": { "type": "string", "description": "收款账号类型编码:PAYPAL, BANK_TRANSFER, RIZZITGO_WALLET, USDT, BINANCE", "example": "PAYPAL" }, "accountNumber": { "type": "string", "description": "收款人账号" }, "accountUsername": { "type": "string", "description": "收款人名称", "example": "李四" }, "accountDetail": { "type": "string", "description": "收款账号详情" } }, "description": "用户 APP - 推广联盟用户提现收款方式新增/修改 Request VO" }, "CommonResultBoolean": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "boolean" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceShareGoodsCategoryUpdateReqVO": { "required": [ "id", "title" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 8365 }, "title": { "type": "string", "description": "分类标题" } }, "description": "用户 APP - 推广者自定义分类更新 Request VO" }, "AppAllianceShareGoodsCategoryUpdateSortReqVO": { "required": [ "id", "sort" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 8365 }, "sort": { "type": "integer", "description": "排序，越大越靠前", "format": "int32", "example": 1 } }, "description": "用户 APP - 推广者自定义分类更新排序 Request VO" }, "AppAlliancePromoterSocialChannelUpdateReqVO": { "required": [ "id", "socialChannelCode", "socialChannelLinks" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 16979 }, "socialChannelCode": { "type": "string", "description": "社媒编码" }, "socialChannelLinks": { "type": "string", "description": "社媒账号地址" }, "displayOnSharePage": { "type": "boolean", "description": "是否分享到推广商品页" }, "code": { "type": "string", "description": "邮箱验证码" } }, "description": "用户 APP - 推广联盟推广者社媒账号新增/修改 Request VO" }, "PointRuleExtraConfigVO": { "type": "object", "properties": { "rnoGoodsDetailBrowse": { "$ref": "#/components/schemas/RnoGoodsDetailBrowseConfig" }, "rnoWarehouseArrived": { "$ref": "#/components/schemas/RnoWarehouseArrivedConfig" } }, "description": "管理后台 - 积分规则扩展配置" }, "PointRuleTierVO": { "required": [ "bizType", "minAmount", "pointRatio" ], "type": "object", "properties": { "bizType": { "type": "string", "description": "业务类型: RECHARGE-充值, WITHDRAW-提现, RNO_WAREHOUSE_ARRIVED-RNO入库", "example": "RECHARGE" }, "minAmount": { "minimum": 0, "type": "integer", "description": "最小金额(元, 包含)", "format": "int32", "example": 0 }, "maxAmount": { "type": "integer", "description": "最大金额(元, 不包含), null表示无上限", "format": "int32", "example": 100 }, "pointRatio": { "type": "number", "description": "积分倍率(1.00=1元1积分, 1.50=1元1.5积分)", "example": 1 }, "sort": { "type": "integer", "description": "排序", "format": "int32", "example": 0 } }, "description": "管理后台 - 积分规则阶梯 VO" }, "PointRuleUpdateReqVO": { "required": [ "id", "name", "status", "tiers" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 1 }, "name": { "type": "string", "description": "规则名称", "example": "默认积分规则" }, "status": { "type": "integer", "description": "状态: 0-禁用, 1-启用", "format": "int32", "example": 0 }, "description": { "type": "string", "description": "规则描述" }, "tiers": { "type": "array", "description": "阶梯列表", "items": { "$ref": "#/components/schemas/PointRuleTierVO" } }, "extraConfig": { "$ref": "#/components/schemas/PointRuleExtraConfigVO" } }, "description": "管理后台 - 积分规则更新 Request VO" }, "RnoGoodsDetailBrowseConfig": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "是否启用", "example": false }, "rnoWhitelist": { "type": "array", "description": "rno 白名单，为空表示全部 rno 均生效", "items": { "type": "string", "description": "rno 白名单，为空表示全部 rno 均生效" } }, "pointsPerBrowse": { "type": "integer", "description": "每次浏览获得积分（正整数，不固定为 1）", "format": "int32", "example": 1 }, "dailyCapPerUser": { "type": "integer", "description": "每用户每天最多获得积分上限", "format": "int32", "example": 20 }, "perGoodsOncePerDay": { "type": "boolean", "description": "同一商品每天是否只计一次", "example": false } }, "description": "RNO 商品浏览送分子配置" }, "RnoWarehouseArrivedConfig": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "是否启用", "example": false }, "rnoWhitelist": { "type": "array", "description": "rno 白名单，为空表示全部 rno 均生效", "items": { "type": "string", "description": "rno 白名单，为空表示全部 rno 均生效" } } }, "description": "RNO 订单入库送分子配置" }, "PointProductUpdateReqVO": { "required": [ "id", "name", "pointPrice", "productType", "status", "stock" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 1 }, "name": { "type": "string", "description": "商品名称（英文）", "example": "10 Dollar Coupon" }, "localName": { "type": "string", "description": "商品名称（中文）", "example": "10元商品券" }, "productType": { "type": "string", "description": "商品类型编码", "example": "GOODS_COUPON" }, "pointPrice": { "minimum": 1, "type": "integer", "description": "所需积分", "format": "int32", "example": 100 }, "relatedId": { "type": "integer", "description": "关联ID（如优惠券模板ID）", "format": "int64", "example": 1 }, "stock": { "type": "integer", "description": "库存数量（-1表示无限）", "format": "int32", "example": 100 }, "limitPerUser": { "type": "integer", "description": "每人限兑数量（0表示不限）", "format": "int32", "example": 1 }, "status": { "type": "integer", "description": "状态", "format": "int32", "example": 1 }, "startTime": { "type": "string", "description": "兑换开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "兑换结束时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32", "example": 0 }, "description": { "type": "string", "description": "商品描述（英文）" }, "localDescription": { "type": "string", "description": "商品描述（中文）" }, "image": { "type": "string", "description": "商品图片" } }, "description": "管理后台 - 积分商品更新 Request VO" }, "PromotionMerchUserDiscountSaveReqVO": { "required": [ "id", "name", "sourceType", "templateId", "totalCount", "type", "unionId", "usedCount", "userId", "validEndTime", "validStartTime", "value" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "templateId": { "type": "integer", "description": "关联折扣模板ID", "format": "int64" }, "name": { "type": "string", "description": "折扣名称快照" }, "type": { "type": "integer", "description": "折扣类型: 1-比例折扣, 2-固定金额抵扣", "format": "int32" }, "value": { "type": "integer", "description": "折扣数值", "format": "int32" }, "minOrderAmount": { "type": "integer", "description": "门槛金额(分)", "format": "int32" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限(分)", "format": "int32" }, "totalCount": { "type": "integer", "description": "总可用次数(-1无限)", "format": "int32" }, "usedCount": { "type": "integer", "description": "已使用次数", "format": "int32" }, "validStartTime": { "type": "string", "description": "有效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "有效结束时间", "format": "date-time" }, "sourceType": { "type": "integer", "description": "获取来源: 1-抽奖活动, 2-系统发放", "format": "int32" }, "sourceBizId": { "type": "integer", "description": "来源业务ID", "format": "int64" }, "lastUsedOrderId": { "type": "string", "description": "最近使用该折扣的订单号" }, "lastUsedTime": { "type": "string", "description": "最近使用时间", "format": "date-time" } }, "description": "管理后台 - 用户平台商品折扣资产新增/修改 Request VO" }, "PromotionMerchDiscountTemplateSaveReqVO": { "required": [ "id", "name", "type", "usageLimitCount", "validityType", "value" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "name": { "type": "string", "description": "折扣模板名称(如: 双11全场9折)" }, "type": { "type": "integer", "description": "折扣类型: 1-比例折扣, 2-固定金额抵扣", "format": "int32" }, "value": { "type": "integer", "description": "折扣数值: 若类型1，90代表90%(9折); 若类型2，1000代表10元", "format": "int32" }, "minOrderAmount": { "type": "integer", "description": "门槛金额: 单位分，0为无门槛", "format": "int32" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限: 单位分，0为不封顶", "format": "int32" }, "scopeType": { "type": "integer", "description": "适用范围: 0-全场通用, 1-指定分类, 2-指定商品", "format": "int32" }, "scopeTargetIds": { "type": "string", "description": "适用目标ID集合" }, "usageLimitCount": { "type": "integer", "description": "单用户最大使用次数: -1为无限次, 1为仅限1次", "format": "int32" }, "validityType": { "type": "integer", "description": "有效期类型: 1-固定时间段, 2-领取后有效天数", "format": "int32" }, "validStartTime": { "type": "string", "description": "类型1: 固定开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "类型1: 固定结束时间", "format": "date-time" }, "validDays": { "type": "integer", "description": "类型2: 领取后多少天内有效", "format": "int32" } }, "description": "管理后台 - 平台商品折扣模板新增/修改 Request VO" }, "PromotionLuckyDrawSaveReqVO": { "required": [ "code", "displayPrizeCount", "endTime", "id", "name", "prizeDisplayMode", "regRequired", "startTime", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "code": { "type": "string", "description": "抽奖活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "抽奖活动名称" }, "startTime": { "type": "string", "description": "活动开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "活动结束时间", "format": "date-time" }, "prizeDisplayMode": { "type": "integer", "description": "奖品展示模式: 1-抽奖前展示(如大转盘/九宫格), 2-抽奖后揭晓(如盲盒/刮刮乐)", "format": "int32" }, "displayPrizeCount": { "type": "integer", "description": "前端展示奖品数量: 0-展示全部, >0-随机展示N个(需包含中奖项)", "format": "int32" }, "regRequired": { "type": "boolean", "description": "是否强制要求报名: 1-是, 0-否" }, "regActivityId": { "type": "integer", "description": "若强制报名，关联的报名活动ID (promotion_activity_reg.id)", "format": "int64" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" } }, "description": "管理后台 - 抽奖活动新增/修改 Request VO" }, "PromotionLuckyDrawWalletSaveReqVO": { "required": [ "availableCount", "id", "luckyDrawId", "totalConsumedCount", "totalGainedCount", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "totalGainedCount": { "type": "integer", "description": "累计获得的次数(历史总和)", "format": "int32" }, "totalConsumedCount": { "type": "integer", "description": "累计消耗的次数(已抽奖次数)", "format": "int32" }, "availableCount": { "type": "integer", "description": "当前可用次数", "format": "int32" } }, "description": "管理后台 - 用户抽奖活动-次数钱包新增/修改 Request VO" }, "PromotionLuckyDrawUserVisitSaveReqVO": { "required": [ "id", "luckyDrawId", "totalVisitCount", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "独立用户ID", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "totalVisitCount": { "type": "integer", "description": "独立用户访问活动的总次数", "format": "int32" }, "lastVisitIp": { "type": "string", "description": "最后一次访问IP地址" }, "lastEventMeta": { "type": "string", "description": "最后一次访问的来源埋点" } }, "description": "管理后台 - 抽奖活动用户访问统计新增/修改 Request VO" }, "PromotionLuckyDrawSpecialUserSaveReqVO": { "required": [ "id", "luckyDrawId", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "prizeId": { "type": "integer", "description": "中奖的奖品ID", "format": "int64" }, "prizeName": { "type": "string", "description": "中奖的奖品名称（冗余显示）", "example": "王五" }, "remark": { "type": "string", "description": "备注", "example": "你说的对" } }, "description": "管理后台 - 抽奖活动-特殊用户配置新增/修改 Request VO" }, "PromotionLuckyDrawRecordSaveReqVO": { "required": [ "id", "luckyDrawId", "unionId", "userId", "won" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64", "example": 26151 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 6309 }, "unionId": { "type": "string", "description": "会员编号(冗余)", "example": "19806" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64", "example": 19465 }, "prizeId": { "type": "integer", "description": "中奖的奖品ID, 未中奖可为空", "format": "int64", "example": 4580 }, "prizeSnapshotName": { "type": "string", "description": "奖品名称快照", "example": "李四" }, "won": { "type": "boolean", "description": "是否中奖" }, "assetStatus": { "type": "integer", "description": "资产发放状态: 0-待发放, 1-发放成功, 2-发放失败", "format": "int32", "example": 1 }, "assetId": { "type": "string", "description": "发放后的资产ID(如 discount_id)", "example": "21328" } }, "description": "管理后台 - 用户抽奖活动-抽奖结果记录新增/修改 Request VO" }, "PromotionLuckyDrawPrizeSaveReqVO": { "required": [ "currentStock", "fixedDisplay", "id", "luckyDrawId", "name", "prizeType", "stockLimit", "totalStock", "winProbability" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "name": { "type": "string", "description": "奖品对外展示名称" }, "prizeType": { "type": "string", "description": "奖品类型: 例如: PLATFORM_DISCOUNT, PLATFORM_COUPON, FORWARDER_DISCOUNT, FORWARDER_COUPON, PHYSICAL, NO_PRIZE" }, "templateId": { "type": "integer", "description": "关联模板ID (如：商品折扣关联 promotion_merch_discount_template)", "format": "int64" }, "winProbability": { "type": "integer", "description": "中奖概率(基点): 10000代表100%", "format": "int32" }, "stockLimit": { "type": "boolean", "description": "是否限制库存: 1-是(扣减库存), 0-否(无限量)" }, "totalStock": { "type": "integer", "description": "总库存: 若不限库存，此字段无意义或仅作展示", "format": "int32" }, "currentStock": { "type": "integer", "description": "当前剩余库存: 若不限库存，此字段不参与扣减逻辑", "format": "int32" }, "fixedDisplay": { "type": "boolean", "description": "是否固定显示(返回的奖品清单是否始终包含该奖品)" } }, "description": "管理后台 - 抽奖活动-奖品配置新增/修改 Request VO" }, "PromotionLuckyDrawChanceRuleSaveReqVO": { "required": [ "chancesAwarded", "id", "luckyDrawId", "maxCountPerUser", "name", "type" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "name": { "type": "string", "description": "规则名称" }, "type": { "type": "string", "description": "规则类型标识: DEFAULT_FREE-无门槛, ACTIVITY_REGISTERED-关联报名, RECHARGE_AMOUNT-充值金额" }, "config": { "type": "string", "description": "规则配置(JSON)" }, "chancesAwarded": { "type": "integer", "description": "满足规则后赠送的次数", "format": "int32" }, "maxCountPerUser": { "type": "integer", "description": "单用户该规则最大获取次数", "format": "int32" }, "startTime": { "type": "string", "description": "规则约束业务的开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "规则约束业务的结束时间", "format": "date-time" } }, "description": "管理后台 - 抽奖机会获取规则新增/修改 Request VO" }, "PromotionLuckyDrawChanceLogSaveReqVO": { "required": [ "changeCount", "changeType", "id", "luckyDrawId", "reasonCode", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "changeType": { "type": "integer", "description": "变动类型: 1-增加, 2-扣减", "format": "int32" }, "changeCount": { "type": "integer", "description": "变动数量", "format": "int32" }, "reasonCode": { "type": "string", "description": "变动原因: DEFAULT_FREE, SHARE_REWARD, USE_DRAW" }, "ruleId": { "type": "integer", "description": "关联抽奖机会获取规则ID", "format": "int64" } }, "description": "管理后台 - 用户抽奖活动-次数流水新增/修改 Request VO" }, "PromotionLuckyDrawChanceItemSaveReqVO": { "required": [ "expirationTime", "gainedTime", "id", "luckyDrawId", "ruleId", "status", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "ruleId": { "type": "integer", "description": "关联抽奖机会获取规则ID", "format": "int64" }, "gainedTime": { "type": "string", "description": "机会获取时间", "format": "date-time" }, "expirationTime": { "type": "string", "description": "机会过期时间 (由机会获取规则计算生成)", "format": "date-time" }, "status": { "type": "integer", "description": "状态: 0-未使用, 1-已使用", "format": "int32" }, "consumedLogId": { "type": "integer", "description": "关联的扣减流水ID (promotion_lucky_draw_chance_log.id)", "format": "int64" } }, "description": "管理后台 - 用户抽奖机会凭证新增/修改 Request VO" }, "HomeSearchKeywordSaveReqVO": { "required": [ "action", "actionData", "displayKeyword", "keyword" ], "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "keyword": { "type": "string", "description": "实际搜索词" }, "displayKeyword": { "type": "string", "description": "展示给用户的关键词" }, "action": { "type": "integer", "description": "关键词类型: 1-搜索关键词, 2-跳转URL", "format": "int32" }, "actionData": { "type": "string", "description": "关键词对应值" }, "terminalType": { "type": "integer", "description": "终端类型: 0-ALL, 20-H5, 21-PC, 31-APP, 3120-APP_H5", "format": "int32" }, "validStart": { "type": "string", "description": "上架时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "下架时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "status": { "type": "integer", "description": "状态: 0-启用, 1-停用", "format": "int32" } }, "description": "管理后台 - 首页搜索热词新增/修改 Request VO" }, "HomePopupSaveReqVO": { "required": [ "name", "sceneCode" ], "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "name": { "type": "string", "description": "运营备注名称" }, "title": { "type": "string", "description": "弹窗标题" }, "content": { "type": "string", "description": "弹窗描述文案" }, "highlightContent": { "type": "string", "description": "高亮内容（前端特殊渲染）" }, "contentLink": { "type": "string", "description": "内容区域点击跳转链接" }, "contentRedirectType": { "type": "integer", "description": "内容跳转类型", "format": "int32" }, "buttonText": { "type": "string", "description": "按钮文字（如 Join Now）" }, "buttonLink": { "type": "string", "description": "按钮点击跳转链接" }, "buttonRedirectType": { "type": "integer", "description": "按钮跳转类型", "format": "int32" }, "iconUrl": { "type": "string", "description": "图标 URL（可选）" }, "sceneCode": { "type": "string", "description": "场景编码" }, "displayStrategy": { "type": "string", "description": "展示策略: ALL-全部, NEW-新用户, OLD-老用户" }, "loginShow": { "type": "string", "description": "登录可见性: ALL-不限, NOT_LOGIN-仅未登录展示, LOGGED_IN-仅已登录展示" }, "terminalType": { "type": "integer", "description": "终端类型: 0-ALL, 20-H5, 21-PC, 31-APP, 3120-APP_H5", "format": "int32" }, "validStart": { "type": "string", "description": "上架时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "下架时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "status": { "type": "integer", "description": "状态: 0-启用, 1-停用", "format": "int32" } }, "description": "管理后台 - 首页底部弹窗新增/修改 Request VO" }, "CouponSaveReqVO": { "required": [ "code", "discountType", "id", "name", "productScope", "status", "takeType", "templateId", "usageAmountScope", "usageCountryScope", "usageRouteScope", "usageWarehouseScope", "usePrice", "userId", "validEndTime", "validStartTime" ], "type": "object", "properties": { "id": { "type": "integer", "description": "优惠劵编号", "format": "int64", "example": 19847 }, "templateId": { "type": "integer", "description": "优惠劵模板编号", "format": "int64", "example": 7488 }, "name": { "type": "string", "description": "优惠劵名", "example": "李四" }, "userId": { "type": "integer", "description": "用户编号", "format": "int64", "example": 8405 }, "usePrice": { "type": "integer", "description": "是否设置满多少金额可用，单位：分", "format": "int32", "example": 8211 }, "validStartTime": { "type": "string", "description": "生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "生效结束时间", "format": "date-time" }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32" }, "discountPrice": { "type": "integer", "description": "优惠金额，单位：分", "format": "int32", "example": 18697 }, "discountLimitPrice": { "type": "integer", "description": "折扣上限", "format": "int32", "example": 30802 }, "useOrderId": { "type": "integer", "description": "使用订单号", "format": "int64", "example": 16453 }, "useTime": { "type": "string", "description": "使用时间", "format": "date-time" }, "productScope": { "type": "integer", "description": "商品范围(1-全部商品可用,2-部分商品可用)", "format": "int32" }, "productScopeValues": { "type": "string", "description": "商品范围编号的数组" }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32" }, "usageWarehouseCodes": { "type": "string", "description": "可使用的仓库编码列表" }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32" }, "usageRouteCodes": { "type": "string", "description": "可使用的路线编码列表" }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32" }, "usageCountryCodes": { "type": "string", "description": "可使用的国家编码列表" }, "code": { "type": "string", "description": "优惠券券码" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "nameLangConfig": { "type": "string", "description": "优惠券名称国际化i18n" }, "status": { "type": "integer", "description": "优惠码状态 : 1-未使用,2-已使用,3-已核销,4-已失效", "format": "int32", "example": 1 }, "takeType": { "type": "integer", "description": "领取类型:1 - 用户主动领取,2 - 后台自动发放 , 3-新人券注册自动发放", "format": "int32", "example": 1 }, "validType": { "type": "integer", "description": "优惠券生效类型 : 1-固定日期,2-领取后多少天", "format": "int32", "example": 1 }, "discountType": { "type": "integer", "description": "折扣类型 : 1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 1 }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32" }, "usageAmountCodes": { "type": "string", "description": "可使用的费用类型编码列表" }, "isAllowedStackable": { "type": "boolean", "description": "优惠券是否支持叠加使用" } }, "description": "管理后台 - 优惠劵新增/修改 Request VO" }, "CommonResultInteger": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "integer", "format": "int32" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponExtendReqVO": { "required": [ "extendDays", "ids" ], "type": "object", "properties": { "ids": { "type": "array", "description": "优惠券ID列表", "items": { "type": "integer", "description": "优惠券ID列表", "format": "int64" } }, "extendDays": { "maximum": 365, "minimum": 1, "type": "integer", "description": "延期天数", "format": "int32", "example": 30 } }, "description": "管理后台 - 优惠券批量延期 Request VO" }, "CouponNameI18nConfigVO": { "type": "object", "properties": { "zh": { "type": "string", "description": "优惠券模板中文名称" }, "en": { "type": "string", "description": "优惠券模板英文名称" }, "es": { "type": "string", "description": "优惠券模板西班牙名称" }, "ko": { "type": "string", "description": "优惠券模板韩文名称" } }, "description": "管理后台 - 优惠劵模板分页 Request VO" }, "CouponScopeCodeConfigVO": { "type": "object", "properties": { "name": { "type": "string", "description": "对应配置的中文名称", "example": "中国" }, "uuid": { "type": "string", "description": "对应配置的uuid" }, "code": { "type": "string", "description": "对应配置的code" } }, "description": "管理后台 - 优惠劵模板分页 Request VO" }, "CouponTemplateUpdateReqVO": { "required": [ "couponType", "discountType", "id", "nameI18nConfig", "takeLimitCount", "takeType", "totalCount", "usageAmountScope", "usageCountryScope", "usageMerchantScope", "usageRouteScope", "usageWarehouseScope", "usePrice", "validityType" ], "type": "object", "properties": { "nameI18nConfig": { "$ref": "#/components/schemas/CouponNameI18nConfigVO" }, "usePrice": { "type": "integer", "description": "优惠券门槛(单位:分)", "format": "int32", "example": 37 }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "totalCount": { "type": "integer", "description": "领取发放数量:-1则表示不限制", "format": "int32", "example": 31538 }, "takeLimitCount": { "type": "integer", "description": "优惠券限领数量:-1则表示不限制", "format": "int32", "example": 225 }, "takeType": { "type": "integer", "description": "优惠券领取方式", "format": "int32", "example": 2 }, "discountType": { "type": "integer", "description": "优惠类型：1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 2 }, "discountPrice": { "type": "integer", "description": "优惠金额(单位:分)", "format": "int32", "example": 13445 }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32" }, "discountLimitPrice": { "type": "integer", "description": "折扣上限，仅在 discount_type 等于 2 时生效", "format": "int32", "example": 20547 }, "validityType": { "type": "integer", "description": "生效日期类型 : 1-固定日期,2-领取后多少天", "format": "int32", "example": 2 }, "validStartTime": { "type": "string", "description": "固定日期-生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "固定日期-生效结束时间", "format": "date-time" }, "fixedStartTerm": { "type": "integer", "description": "领取日期-开始天数", "format": "int32" }, "fixedEndTerm": { "type": "integer", "description": "领取日期-结束天数", "format": "int32" }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32" }, "usageAmountCodes": { "type": "array", "description": "可使用的费用类型编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32" }, "usageWarehouseCodes": { "type": "array", "description": "可使用的仓库编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32" }, "usageRouteCodes": { "type": "array", "description": "可使用的路线编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32" }, "usageCountryCodes": { "type": "array", "description": "可使用的国家编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageMerchantScope": { "type": "integer", "description": "可使用商家范围:1-不限商家,2-指定商家,3-排除指定商家", "format": "int32" }, "usageMerchantCodes": { "type": "array", "description": "可使用的商家编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "sceneId": { "type": "integer", "description": "优惠券模板场景ID", "format": "int64", "example": 1 }, "remark": { "type": "string", "description": "备注" }, "id": { "type": "integer", "description": "模板ID", "format": "int64" } }, "description": "管理后台 - 优惠劵模板新增/修改 Request VO" }, "CouponTemplateSceneSaveReqVO": { "required": [ "id", "sceneCode", "sceneName" ], "type": "object", "properties": { "id": { "type": "integer", "description": "场景编号，自增唯一", "format": "int64", "example": 25877 }, "sceneCode": { "type": "string", "description": "场景编码，例如 NEW_USER-新人券, FESTIVAL_XMAS-圣诞节券" }, "sceneName": { "type": "string", "description": "场景名称，例如 新人专属, 圣诞节专属", "example": "李四" }, "description": { "type": "string", "description": "场景描述/备注", "example": "你说的对" }, "remark": { "type": "string", "description": "备注信息", "example": "随便" } }, "description": "管理后台 - 优惠券模板场景新增/修改 Request VO" }, "CouponExchangeLogSaveReqVO": { "required": [ "code", "couponCode", "couponTemplateId", "exchangeStatus", "id", "source", "usedTime", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "自增ID", "format": "int64", "example": 29117 }, "code": { "type": "string", "description": "兑换码" }, "couponTemplateId": { "type": "integer", "description": "关联的优惠券模板ID", "format": "int64", "example": 3288 }, "userId": { "type": "integer", "description": "使用用户ID", "format": "int64", "example": 25075 }, "usedTime": { "type": "string", "description": "使用时间", "format": "date-time" }, "source": { "type": "integer", "description": "兑换码来源(1:后台生成,2:第三方渠道)", "format": "int32" }, "couponCode": { "type": "string", "description": "关联的优惠券编码" }, "exchangeStatus": { "type": "integer", "description": "兑换状态(1-待兑换,2-兑换成功,3-兑换失败)", "format": "int32", "example": 1 }, "exchangeFailCode": { "type": "string", "description": "兑换失败异常状态码" }, "exchangeFailReason": { "type": "string", "description": "兑换失败原因", "example": "不香" }, "exchangeFailTime": { "type": "string", "description": "兑换失败时间", "format": "date-time" } }, "description": "管理后台 - 优惠券兑换记录新增/修改 Request VO" }, "CouponExchangeCodeSaveReqVO": { "required": [ "batchNum", "businessName", "code", "couponTemplateId", "couponTemplateIds", "maxUsage", "takeLimitCount", "validEnd", "validStart" ], "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "code": { "type": "string", "description": "兑换码" }, "businessName": { "type": "string", "description": "业务名字" }, "couponTemplateId": { "type": "integer", "description": "关联的优惠券模板ID", "format": "int64", "example": 20218 }, "couponTemplateIds": { "type": "string", "description": "关联的优惠券模板ID", "example": "20218" }, "validStart": { "type": "string", "description": "有效期开始时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "有效期结束时间", "format": "date-time" }, "maxUsage": { "type": "integer", "description": "最大使用次数", "format": "int32" }, "takeLimitCount": { "type": "integer", "description": "最大使用次数 -1 - 则表示不限制", "format": "int32" }, "batchNum": { "type": "integer", "description": "默认生成多少个", "format": "int32" }, "sceneCode": { "type": "string", "description": "场景编码", "example": "SHIPPING_ESTIMATE" }, "grantMode": { "type": "string", "description": "发放模式: ALL-全部发放, RANDOM_ONE-随机发放一张", "example": "ALL" }, "grantRule": { "type": "string", "description": "发放规则(JSON), 权重配置", "example": "{\"weights\":[{\"couponTemplateId\":101,\"weight\":80}]}" }, "dailyTakeLimitCount": { "type": "integer", "description": "单用户每日限兑次数, -1 不限制", "format": "int32", "example": -1 }, "dailyIpLimitCount": { "type": "integer", "description": "单IP每日限兑次数, -1 不限制", "format": "int32", "example": -1 } }, "description": "管理后台 - 优惠券兑换码新增/修改 Request VO" }, "AlliancePromoterSaveReqVO": { "required": [ "id", "promoterLevel", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 24588 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 28476 }, "unionId": { "type": "string", "description": "用户唯一ID", "example": "29722" }, "sda": { "type": "string", "description": "推广者分销码" }, "promoterLevel": { "type": "integer", "description": "推广者等级(默认1级推广者)", "format": "int32" }, "bonusRate": { "maximum": 0.09, "exclusiveMaximum": false, "type": "number", "description": "推广佣金奖励比例,填写:0.04" }, "bonusType": { "type": "integer", "description": "佣金类型(1-按成长等级阶梯比例, 2-固定比例佣金)", "format": "int32" }, "status": { "type": "integer", "description": "推广者状态(0-未激活,1-已激活,2-已禁用)", "format": "int32", "example": 2 }, "avatar": { "type": "string", "description": "推广者头像地址" }, "nickname": { "type": "string", "description": "推广者昵称", "example": "王五" }, "contact": { "type": "string", "description": "推广者联系方式" }, "remark": { "type": "string", "description": "推广者备注信息", "example": "你猜" }, "type": { "type": "integer", "description": "推广者类型", "format": "int32" }, "monthlyRechargeBalance": { "type": "string", "description": "每月余额充值金额" }, "monthlyFreeShippingKg": { "type": "string", "description": "每月免费运输公斤" }, "contractStartTime": { "type": "string", "description": "签约合作时间", "format": "date-time" } }, "description": "管理后台 - 推广联盟推广者信息新增/修改 Request VO" }, "AlliancePromoterRemarkUpdateReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 24588 }, "remark": { "type": "string", "description": "推广者备注信息", "example": "优质推广者" } }, "description": "管理后台 - 推广联盟推广者备注调整 Request VO" }, "AlliancePromoterLevelUpdateReqVO": { "required": [ "id", "promoterLevel" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 24588 }, "promoterLevel": { "minimum": 1, "type": "integer", "description": "推广者等级", "format": "int32", "example": 2 } }, "description": "管理后台 - 推广联盟推广者等级调整 Request VO" }, "AlliancePromoterContractUpdateReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "推广者编号", "format": "int64", "example": 1024 }, "monthlyRechargeBalance": { "type": "string", "description": "每月余额充值金额" }, "monthlyFreeShippingKg": { "type": "string", "description": "每月免费运输公斤" }, "contractStartTime": { "type": "string", "description": "签约合作时间", "format": "date-time" } }, "description": "管理后台 - 推广联盟推广者签约合作信息更新 Request VO" }, "AlliancePromoterBonusRateUpdateReqVO": { "required": [ "bonusRate", "bonusType", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 24588 }, "bonusRate": { "maximum": 0.09, "exclusiveMaximum": false, "type": "number", "description": "推广佣金奖励比例,填写:0.04" }, "bonusType": { "type": "integer", "description": "佣金类型(1-按成长等级阶梯比例, 2-固定比例佣金)", "format": "int32" } }, "description": "管理后台 - 推广联盟推广者佣金比例调整 Request VO" }, "AlliancePromoterBatchUpdateGroupReqVO": { "required": [ "groupIds", "ids" ], "type": "object", "properties": { "ids": { "type": "array", "description": "推广者编号列表", "items": { "type": "integer", "description": "推广者编号列表", "format": "int64" } }, "groupIds": { "type": "array", "description": "分组编号列表", "items": { "type": "integer", "description": "分组编号列表", "format": "int64" } } }, "description": "管理后台 - 推广联盟推广者批量修改分组 Request VO" }, "AlliancePromoterGrowthLevelSaveReqVO": { "required": [ "id", "level", "levelBonusRate", "levelGrowth", "levelTitle", "sort", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 22508 }, "level": { "type": "integer", "description": "等级数值，从1开始递增", "format": "int32" }, "levelTitle": { "type": "string", "description": "等级名称，例如 Enthusiast" }, "levelBonusRate": { "type": "number", "description": "分成比例，百分数形式，例如 4.00 表示 4%" }, "levelGrowth": { "type": "integer", "description": "达到该等级所需成长值", "format": "int32" }, "status": { "type": "integer", "description": "等级是否启用：0-启用，1-禁用", "format": "int32", "example": 2 }, "sort": { "type": "integer", "description": "排序值，越小越靠前", "format": "int32" } }, "description": "管理后台 - 推广者等级配置新增/修改 Request VO" }, "AlliancePromoterGroupSaveReqVO": { "required": [ "groupName", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "分组ID", "format": "int64", "example": 30189 }, "groupName": { "type": "string", "description": "分组名称", "example": "王五" }, "description": { "type": "string", "description": "分组描述", "example": "你说的对" } }, "description": "管理后台 - 推广者分组信息新增/修改 Request VO" }, "AlliancePromoterGroupRelSaveReqVO": { "required": [ "groupId", "id", "promoterId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 5734 }, "promoterId": { "type": "integer", "description": "推广者ID", "format": "int64", "example": 8343 }, "groupId": { "type": "integer", "description": "分组ID", "format": "int64", "example": 2657 } }, "description": "管理后台 - 推广者-分组关联新增/修改 Request VO" }, "AllianceInviteUsersSaveReqVO": { "required": [ "bagOrderCount", "bagOrderStatus", "id", "inviteUserSda", "inviteUserUnionId", "promoterUserId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 2060 }, "inviteUserSda": { "type": "string", "description": "被邀请者填写的分销码" }, "inviteUserUnionId": { "type": "string", "description": "被邀请者用户唯一编号", "example": "7319" }, "inviteUserId": { "type": "integer", "description": "被邀请者用户ID", "format": "int64", "example": 14524 }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64", "example": 10726 }, "promoterUnionId": { "type": "string", "description": "推广者用户唯一编号", "example": "31588" }, "sda": { "type": "string", "description": "推广者分销码" }, "bagOrderCount": { "type": "integer", "description": "累计提包订单数量(通过定时任务统计)", "format": "int32", "example": 3960 }, "bagOrderStatus": { "type": "boolean", "description": "用户是否发生过提包", "example": false } }, "description": "管理后台 - 推广联盟邀请用户记录新增/修改 Request VO" }, "AllianceBagOrdersSaveReqVO": { "required": [ "bagOrderCreateTime", "bagOrderNo", "bagOrderSda", "bagOrderTotalAmount", "bagOrderUserUnionId", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9735 }, "bagOrderUserUnionId": { "type": "string", "description": "提包订单用户唯一编号", "example": "18117" }, "bagOrderSda": { "type": "string", "description": "提报订单分销码" }, "bagOrderNo": { "type": "string", "description": "提包订单号" }, "bagOrderTotalAmount": { "type": "integer", "description": "提包总支付金额(单位:分)", "format": "int64" }, "bagOrderCreateTime": { "type": "string", "description": "提包时间", "format": "date-time" } }, "description": "管理后台 - 推广联盟提包订单记录新增/修改 Request VO" }, "ActivitySectionSaveReqVO": { "required": [ "sectionCode" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 31573 }, "sectionCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "分区编码，例如 TOP5、HOT_SALE、BANNER_HOME", "example": "HOT_SALE" }, "sectionName": { "maxLength": 64, "minLength": 0, "type": "string", "description": "分区中文名称，例如 热销商品", "example": "热销商品" }, "sectionType": { "maximum": 3, "minimum": 1, "type": "integer", "description": "分区类型：1-商品卡片，2-Banner， 3-商品&banner", "format": "int32", "example": 1 }, "sort": { "minimum": 0, "type": "integer", "description": "分区排序，值越小越靠前", "format": "int32", "example": 0 }, "merchantCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "商家编码，用于区分不同商家促销页", "example": "MERCHANT001" }, "remark": { "maxLength": 255, "minLength": 0, "type": "string", "description": "备注信息", "example": "这是一个热销商品分区" }, "extraConfig": { "type": "string", "description": "拓展信息" } }, "description": "管理后台 - 促销页分区配置新增/修改 Request VO" }, "ActivitySectionSortReqVO": { "required": [ "id", "sort" ], "type": "object", "properties": { "id": { "type": "integer", "description": "分区ID", "format": "int64", "example": 1024 }, "sort": { "type": "integer", "description": "排序值，值越小越靠前", "format": "int32", "example": 1 } }, "description": "排序项信息" }, "ActivitySectionItemSaveReqVO": { "required": [ "itemData", "itemType", "sectionId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 1024 }, "sectionId": { "type": "integer", "description": "所属分区ID", "format": "int64", "example": 1 }, "itemType": { "maximum": 4, "minimum": 1, "type": "integer", "description": "内容类型：1-商品，2-banner组件2，3-banner组件3，4-banner组件4", "format": "int32", "example": 1 }, "itemData": { "type": "string", "description": "内容 JSON 数据，结构根据 item_type 而不同" }, "sort": { "type": "integer", "description": "排序值，值越小越靠前", "format": "int32", "example": 1 }, "merchantCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "商家编码，方便查询隔离", "example": "MERCHANT_001" } }, "description": "管理后台 - 分区内容项新增/修改 Request VO" }, "ActivitySectionItemSortReqVO": { "required": [ "id", "sort" ], "type": "object", "properties": { "id": { "type": "integer", "description": "内容项ID", "format": "int64", "example": 1024 }, "sort": { "type": "integer", "description": "排序值，值越小越靠前", "format": "int32", "example": 1 } }, "description": "排序项信息" }, "ActivitySectionItemBatchSortReqVO": { "required": [ "items" ], "type": "object", "properties": { "items": { "type": "array", "description": "排序项列表", "items": { "$ref": "#/components/schemas/ActivitySectionItemSortReqVO" } } }, "description": "管理后台 - 分区内容项批量排序 Request VO" }, "PromotionActivityRegSaveReqVO": { "required": [ "code", "endTime", "id", "name", "startTime", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "code": { "type": "string", "description": "活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "报名活动名称" }, "description": { "type": "string", "description": "报名说明" }, "startTime": { "type": "string", "description": "报名开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "报名结束时间", "format": "date-time" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" } }, "description": "管理后台 - 报名活动主新增/修改 Request VO" }, "PromotionActivityRegRecordSaveReqVO": { "required": [ "eventMeta", "id", "regActivityId", "regTime", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "regActivityId": { "type": "integer", "description": "关联报名活动ID", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "regTime": { "type": "string", "description": "实际报名时间", "format": "date-time" }, "eventMeta": { "type": "string", "description": "报名来源的埋点信息" } }, "description": "管理后台 - 用户报名记录新增/修改 Request VO" }, "ActivityMerchantSaveReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 16466 }, "shopName": { "type": "string", "description": "商品名称", "example": "王五" }, "shopId": { "type": "string", "description": "商家ID", "example": "10348" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "remark": { "type": "string", "description": "备注信息", "example": "随便" }, "shopUrl": { "type": "string", "description": "店铺链接", "example": "https://www.iocoder.cn" }, "shopSource": { "type": "string", "description": "店铺来源（如淘宝、京东等）" }, "shopLogo": { "type": "string", "description": "店铺 Logo 图片链接" }, "shopBannerImages": { "type": "string", "description": "店铺 Banner 图（多张，英文逗号分隔）" }, "discountStatus": { "type": "integer", "description": "店铺折扣状态（0-开启，1-关闭）", "format": "int32", "example": 1 }, "merchantSort": { "type": "integer", "description": "商家排序（值越大越靠前）", "format": "int32", "example": 100 }, "merchantDisplayLogo": { "type": "string", "description": "商家对外展示 Logo", "example": "https://example.com/logo.png" }, "merchantDisplayName": { "type": "string", "description": "商家对外展示名称", "example": "NIKE官方旗舰店" }, "discountMode": { "type": "integer", "description": "折扣模式：0-平台折扣（直接计算），1-商家折扣（平台不计算）", "format": "int32", "example": 0 } }, "description": "管理后台 - 商家折扣管理新增/修改 Request VO" }, "ActivityGoodsSaveReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 24462 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格", "example": "20440" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图", "example": "https://www.iocoder.cn" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址", "example": "https://www.iocoder.cn" }, "goodsCategoryCode": { "type": "string", "description": "热销商品分类编码" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "sort": { "type": "integer", "description": "排序字段，数值越大越靠前", "format": "int32", "example": 100 }, "remark": { "type": "string", "description": "备注信息", "example": "你说的对" } }, "description": "管理后台 - 促销活动商品新增/修改 Request VO" }, "ActivityGoodsUpdateSortReqVO": { "required": [ "id", "sort" ], "type": "object", "properties": { "id": { "type": "integer", "description": "商品ID", "format": "int64", "example": 1024 }, "sort": { "type": "integer", "description": "排序值，数值越大越靠前", "format": "int32", "example": 100 } }, "description": "管理后台 - 更新促销活动商品排序值 Request VO" }, "ActivityGoodsUpdateCategoryCodeReqVO": { "required": [ "goodsCategoryCode", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "商品ID", "format": "int64", "example": 1024 }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码", "example": "CATEGORY001" } }, "description": "管理后台 - 更新促销活动商品分类编码 Request VO" }, "ActivityGoodsBatchUpdateDiscountReqVO": { "required": [ "discountAction", "discountRate", "merchantCode", "updateScope" ], "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码", "example": "YOLO" }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码（为空时更新全部活动商品）", "example": "nike" }, "discountAction": { "type": "string", "description": "折扣操作类型", "example": "set" }, "discountRate": { "maximum": 100, "minimum": 1, "type": "integer", "description": "折扣率（1-100）", "format": "int32", "example": 50 }, "updateScope": { "type": "string", "description": "更新范围：all-所有商品，with_discount-有折扣商品(<100)，without_discount-无折扣商品(=100)", "example": "without_discount" } }, "description": "管理后台 - 批量更新商品折扣 Request VO" }, "ActivityGoodsBatchUpdateCategoryReqVO": { "required": [ "goodsIds" ], "type": "object", "properties": { "goodsIds": { "type": "array", "description": "商品ID列表", "example": [ "7262819852", "7247444781" ], "items": { "type": "string", "description": "商品ID列表", "example": "[\"7262819852\",\"7247444781\"]" } }, "newCategoryCode": { "type": "string", "description": "新的商品分类编码（为空则代表没有关联任何活动信息）", "example": "BLACK_FRIDAY_2025" } }, "description": "管理后台 - 批量更新商品分类 Request VO" }, "PointChangeReqDTO": { "required": [ "bizId", "bizType", "point", "userId" ], "type": "object", "properties": { "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "bizId": { "type": "string", "description": "业务ID（如充值单号、提现单号）" }, "bizType": { "type": "string", "description": "业务类型", "enum": [ "RECHARGE", "WITHDRAW", "WITHDRAW_REFUND", "EXCHANGE", "EXCHANGE_REFUND", "ADMIN_GIVE", "ADMIN_DEDUCT", "SUBMIT_PARCEL", "CANCEL_PARCEL", "EXPIRED", "RNO_GOODS_DETAIL_BROWSE", "RNO_WAREHOUSE_ARRIVED" ] }, "point": { "type": "integer", "description": "变动积分（正数增加，负数扣除）", "format": "int32" }, "title": { "type": "string", "description": "积分标题（英文）" }, "description": { "type": "string", "description": "积分描述（英文）" }, "localTitle": { "type": "string", "description": "积分标题（中文）" }, "localDescription": { "type": "string", "description": "积分描述（中文）" }, "ruleId": { "type": "integer", "description": "匹配的积分规则ID", "format": "int64" }, "ruleName": { "type": "string", "description": "匹配的积分规则名称" }, "pointRatio": { "type": "number", "description": "匹配的积分倍率" } } }, "CommonResultDiscountCodeCheckRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/DiscountCodeCheckRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "DiscountCodeCheckRespDTO": { "type": "object", "properties": { "valid": { "type": "boolean", "description": "是否有效" }, "code": { "type": "string", "description": "折扣码" }, "title": { "type": "string", "description": "标题" }, "type": { "type": "string", "description": "优惠类型（PLATFORM_SERVICE_FEE_DISCOUNT-平台服务费）" }, "discountRate": { "type": "string", "description": "折扣比例:比如1,表示1%" }, "sourceId": { "type": "string", "description": "折扣关联ID:用户ID|活动ID" }, "sourceType": { "type": "string", "description": "折扣类型:PROMOTER|PLATFORM" }, "sourceDetail": { "type": "object", "additionalProperties": { "type": "object", "description": "折扣详情" }, "description": "折扣详情" } }, "description": "校验折扣码返回信息" }, "CouponOrderUseReqDTO": { "required": [ "couponCode", "userId" ], "type": "object", "properties": { "couponCode": { "type": "string" }, "userId": { "type": "integer", "format": "int64" } } }, "CouponOrderUnLockReqDTO": { "required": [ "couponCode", "userId" ], "type": "object", "properties": { "couponCode": { "type": "string" }, "userId": { "type": "integer", "format": "int64" }, "orderNos": { "type": "array", "items": { "type": "string" } } } }, "CouponOrderInfoReqDTO": { "required": [ "orderAmount", "orderId", "orderType" ], "type": "object", "properties": { "orderType": { "type": "integer", "description": "订单类型", "format": "int32" }, "orderId": { "type": "string", "description": "订单编号" }, "orderAmount": { "type": "integer", "description": "订单金额(单位:分)", "format": "int32" }, "orderWarehouseCode": { "type": "string", "description": "订单仓库编码" }, "orderCountryCode": { "type": "string", "description": "订单国家编码" }, "orderRouteCode": { "type": "string", "description": "订单路线编码" }, "orderFeeType": { "type": "integer", "description": "订单费用类型", "format": "int32" }, "totalDiscountAmount": { "type": "integer", "description": "订单本次优惠金额", "format": "int32" } } }, "CouponOrderLockReqDTO": { "required": [ "couponCode", "orderList", "userId" ], "type": "object", "properties": { "couponCode": { "type": "string" }, "userId": { "type": "integer", "format": "int64" }, "orderList": { "type": "array", "items": { "$ref": "#/components/schemas/CouponOrderInfoReqDTO" } } } }, "CommonResultUserAvailableCouponRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/UserAvailableCouponRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "UsageScopeRespDTO": { "required": [ "code", "name" ], "type": "object", "properties": { "code": { "type": "string", "description": "编码", "example": "1" }, "name": { "type": "string", "description": "名称", "example": "1" } }, "description": "可使用商家范围列表集合", "example": 1 }, "UserAvailableCouponRespDTO": { "required": [ "code", "couponType", "discountType", "id", "sceneCode", "sourceExchangeCode", "status", "templateId", "title", "usageAmountScope", "usageAmountScopeList", "usageCountryScope", "usageCountryScopeList", "usageMerchantScope", "usageMerchantScopeList", "usageRouteScope", "usageRouteScopeList", "usageWarehouseScope", "usageWarehouseScopeList", "usePriceCondition" ], "type": "object", "properties": { "id": { "type": "integer", "description": "优惠劵唯一ID", "format": "int64", "example": 1 }, "templateId": { "type": "integer", "description": "优惠劵模板ID", "format": "int64", "example": 1 }, "title": { "type": "string", "description": "优惠劵标题", "example": "春节送送送" }, "code": { "type": "string", "description": "优惠券唯一code", "example": "21224752056818" }, "sourceExchangeCode": { "type": "string", "description": "兑换码", "example": "21224752056818" }, "sceneId": { "type": "integer", "format": "int64" }, "sceneCode": { "type": "string", "description": "场景编码，例如 NEW_USER-新人券, FESTIVAL_XMAS-圣诞节券" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "status": { "type": "integer", "description": "优惠劵状态", "format": "int32", "example": 1 }, "usePriceCondition": { "type": "integer", "description": "是否设置满多少金额可用(门槛)(单位:分)", "format": "int32", "example": 100 }, "validType": { "type": "integer", "description": "优惠券生效类型 : 1-固定日期,2-领取后多少天", "format": "int32" }, "validDays": { "type": "integer", "description": "领取后 {validDays} 天有效", "format": "int32", "nullable": true }, "takeTime": { "type": "string", "description": "优惠券领取时间", "format": "date-time" }, "validStartTime": { "type": "string", "description": "固定日期 - 生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "固定日期 - 生效结束时间", "format": "date-time" }, "discountType": { "type": "integer", "description": "优惠类型:1-满元减,2-满元折", "format": "int32" }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32", "nullable": true, "example": 80 }, "discountPrice": { "minimum": 0, "type": "integer", "description": "优惠金额(单位:分)", "format": "int32", "nullable": true, "example": 10 }, "discountLimitPrice": { "type": "integer", "description": "折扣上限(单位:分)", "format": "int32", "nullable": true, "example": 100 }, "isAllowedStackable": { "type": "boolean", "description": "优惠券是否支持叠加使用", "nullable": true, "example": false }, "isAvailable": { "type": "boolean", "description": "当前优惠券是否可用", "nullable": true, "example": false }, "unavailableReasonEnum": { "type": "string", "description": "当前优惠券不可用原因枚举", "nullable": true, "example": "false", "enum": [ "OK", "WAREHOUSE_MISMATCH", "ROUTE_MISMATCH", "COUNTRY_MISMATCH", "FEE_TYPE_MISMATCH", "USE_ORDER_PRICE_MISMATCH", "MERCHANT_MISMATCH", "OTHER" ] }, "unavailableReason": { "type": "string", "description": "当前优惠券不可用原因", "nullable": true, "example": "false" }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32", "example": 1 }, "usageAmountScopeList": { "type": "array", "description": "可使用费用类型集合", "example": [ 1 ], "items": { "$ref": "#/components/schemas/UsageScopeRespDTO" } }, "usageAmountCodes": { "type": "string" }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32", "example": 1 }, "usageWarehouseScopeList": { "type": "array", "description": "可使用仓库列表ID集合", "example": [ 1 ], "items": { "$ref": "#/components/schemas/UsageScopeRespDTO" } }, "usageWarehouseCodes": { "type": "string" }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32", "example": 1 }, "usageRouteScopeList": { "type": "array", "description": "可使用路线范围列表ID集合", "example": [ 1 ], "items": { "$ref": "#/components/schemas/UsageScopeRespDTO" } }, "usageRouteCodes": { "type": "string" }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32", "example": 1 }, "usageCountryScopeList": { "type": "array", "description": "可使用国家范围列表集合", "example": 1, "items": { "$ref": "#/components/schemas/UsageScopeRespDTO" } }, "usageCountryCodes": { "type": "string" }, "usageMerchantScope": { "type": "integer", "description": "可使用商家范围:1-不限商家,2-指定商家,3-排除指定商家", "format": "int32", "example": 1 }, "usageMerchantScopeList": { "type": "array", "description": "可使用商家范围列表集合", "example": 1, "items": { "$ref": "#/components/schemas/UsageScopeRespDTO" } }, "usageMerchantCodes": { "type": "string" } }, "description": "用户 App - 优惠劵列表 Response VO" }, "UserAvailableCouponReqDTO": { "required": [ "orderAmount", "scenarioType", "usageAmountCodeEnum", "usageCountryCode", "usageMerchantCodes", "usageRouteCode", "usageWarehouseCode", "userId" ], "type": "object", "properties": { "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "orderAmount": { "type": "integer", "description": "订单金额(单位:分)", "format": "int32" }, "usageAmountCodeEnum": { "type": "string", "description": "费用类型", "enum": [ "PACKAGE_SHIPPING_FEE", "PRODUCT_FEE" ] }, "usageWarehouseCode": { "type": "string", "description": "仓库编码" }, "usageRouteCode": { "type": "string", "description": "路线编码" }, "usageCountryCode": { "type": "string", "description": "国家编码" }, "usageMerchantCodes": { "type": "array", "description": "商家编码列表", "items": { "type": "string", "description": "商家编码列表" } }, "scenarioType": { "type": "string", "description": "场景值", "enum": [ "PRODUCT_SETTLEMENT", "SHIPPING_SETTLEMENT" ] } }, "description": "用户 App - 可用优惠劵列表 Request VO" }, "CommonResultListUserAvailableCouponRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/UserAvailableCouponRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultLong": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "integer", "format": "int64" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponBatchSendReqDTO": { "required": [ "takeTypeEnum", "userIds" ], "type": "object", "properties": { "templateIdList": { "type": "array", "items": { "type": "integer", "format": "int64" } }, "takeTypeEnum": { "type": "integer", "format": "int32" }, "userIds": { "uniqueItems": true, "type": "array", "items": { "type": "integer", "format": "int64" } }, "invitationCode": { "type": "string" } } }, "AlliancePromoterJoinReqDTO": { "type": "object", "properties": { "userId": { "type": "integer", "description": "用户编号", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号" }, "avatar": { "type": "string", "description": "用户头像" }, "nickname": { "type": "string", "description": "用户昵称" }, "contact": { "type": "string", "description": "用户联系方式" }, "sda": { "type": "string", "description": "推广者分销码" } }, "description": "用户 APP - 推广联盟邀请用户记录新增/修改 Request VO" }, "AllianceInviteUsersBindReqDTO": { "required": [ "inviteUserUnionId", "promoterUserId", "sda" ], "type": "object", "properties": { "sda": { "type": "string", "description": "被邀请者填写的分销码" }, "inviteUserUnionId": { "type": "string", "description": "被邀请者用户唯一编号", "example": "7319" }, "inviteUserId": { "type": "integer", "description": "被邀请者用户ID", "format": "int64", "example": 14524 }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64", "example": 10726 }, "promoterUnionId": { "type": "string", "description": "推广者用户唯一编号", "example": "31588" }, "registerTime": { "type": "string", "description": "用户注册时间", "format": "date-time" } }, "description": "用户 APP - 推广联盟邀请用户记录新增/修改 Request VO" }, "AllianceBagOrdersDeleteReqDTO": { "required": [ "bagOrderNo" ], "type": "object", "properties": { "bagOrderNo": { "type": "string", "description": "提包订单号" } }, "description": "用户 RPC - 推广联盟提包订单记录删除/撤销 Request VO" }, "AllianceBagOrdersSaveReqDTO": { "required": [ "bagOrderCreateTime", "bagOrderNo", "bagOrderSda", "bagOrderTotalAmount", "bagOrderUserId", "bagOrderUserUnionId" ], "type": "object", "properties": { "bagOrderUserUnionId": { "type": "string", "description": "提包订单用户唯一编号", "example": "18117" }, "bagOrderUserId": { "type": "integer", "description": "提包订单用户ID", "format": "int64", "example": 18117 }, "bagOrderSda": { "type": "string", "description": "提报订单分销码" }, "bagOrderNo": { "type": "string", "description": "提包订单号" }, "bagOrderTotalAmount": { "type": "integer", "description": "提包总支付金额(单位:分)", "format": "int32" }, "bagOrderCreateTime": { "type": "string", "description": "提包时间", "format": "date-time" } }, "description": "用户 RPC - 推广联盟提包订单记录新增/修改 Request VO" }, "PromotionActivityGoodsReqDTO": { "required": [ "goodsId", "goodsSource" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "shopId": { "type": "string", "description": "商品所属门店ID" }, "priceInCents": { "type": "integer", "description": "商品价格,单位:分", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号" }, "userId": { "type": "integer", "description": "用户编号", "format": "int64" }, "scene": { "type": "integer", "description": "查询场景：PRODUCT_DETAIL-商品详情页，SHOPPING_CART-购物车，CHECKOUT-结算页", "format": "int32" } }, "description": "校验折扣码返回信息" }, "CommonResultPromotionActivityGoodsRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionActivityGoodsRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsLevelDiscountDTO": { "type": "object", "properties": { "discountSource": { "type": "integer", "description": "折扣来源：1-商品独立折扣，2-店铺折扣", "format": "int32" }, "discountRate": { "type": "integer", "description": "折扣率（例如：85 表示 8.5 折）", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠百分比（例如：15 表示优惠了 15%）", "format": "int32" }, "priceBeforeDiscount": { "type": "integer", "description": "折扣前金额（单位：分）- 应用商品折扣前的原价", "format": "int64" }, "actualDiscountAmount": { "type": "integer", "description": "商品层级实际优惠金额（单位：分）", "format": "int64" }, "shopId": { "type": "string", "description": "店铺ID" }, "shopName": { "type": "string", "description": "店铺名称" }, "merchantCode": { "type": "string", "description": "商家编码" }, "discountMode": { "type": "integer", "description": "商家折扣模式：0-平台提供商品折扣（直接计算），1-商家提供商品折扣（平台不计算）", "format": "int32" } }, "description": "商品层级折扣信息" }, "PlatformDiscountDTO": { "type": "object", "properties": { "discountId": { "type": "integer", "description": "折扣记录ID", "format": "int64" }, "discountName": { "type": "string", "description": "折扣名称" }, "discountType": { "type": "integer", "description": "折扣类型：1-比例折扣，2-固定金额抵扣", "format": "int32" }, "discountValue": { "type": "integer", "description": "折扣值（类型1时表示折扣率如90表示9折，类型2时表示固定金额单位分）", "format": "int32" }, "priceBeforeDiscount": { "type": "integer", "description": "折扣前金额（单位：分）- 应用平台折扣前的价格", "format": "int64" }, "actualDiscountAmount": { "type": "integer", "description": "实际优惠金额（单位：分）", "format": "int64" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限（单位：分）", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠百分比（例如：10 表示优惠了 10%）", "format": "int32" }, "validStartTime": { "type": "string", "description": "有效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "有效结束时间", "format": "date-time" }, "sourceType": { "type": "integer", "description": "来源类型：1-抽奖活动，2-系统发放", "format": "int32" }, "sourceBizId": { "type": "integer", "description": "来源业务ID", "format": "int64" } }, "description": "平台折扣信息（抽奖活动折扣）" }, "PromotionActivityGoodsRespDTO": { "required": [ "goodsInfo", "matched" ], "type": "object", "properties": { "matched": { "type": "boolean", "description": "是否命中促销活动" }, "goodsInfo": { "$ref": "#/components/schemas/PromotionGoodsInfoDTO" }, "activityInfo": { "$ref": "#/components/schemas/PromotionActivityInfoDTO" }, "goodsLevelDiscount": { "$ref": "#/components/schemas/GoodsLevelDiscountDTO" }, "platformDiscount": { "$ref": "#/components/schemas/PlatformDiscountDTO" }, "activityType": { "type": "string", "description": "活动类型编码：PLATFORM_DISCOUNT-平台折扣活动，MERCHANT_DISCOUNT-商家折扣活动，NEW_USER_DISCOUNT-新用户折扣活动" }, "merchantCode": { "type": "string", "description": "合作商家编码" } } }, "PromotionActivityInfoDTO": { "required": [ "actualDiscountRate", "discountMode", "discountPercentage", "discountPriceInCents", "discountRate", "discountType", "originalPriceInCents" ], "type": "object", "properties": { "originalPriceInCents": { "type": "integer", "description": "商品优惠前价格（单位：分）", "format": "int64" }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "discountRate": { "type": "integer", "description": "预估折扣率", "format": "int32" }, "actualDiscountRate": { "type": "integer", "description": "实际折扣率（通过最终价格计算，例如：72 表示实际是 7.2 折）", "format": "int32" }, "discountType": { "type": "integer", "description": "折扣类型: 1-折扣", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠百分比（平台折扣 + 商品/店铺折扣，例如：30 表示总共优惠了 30%）", "format": "int32" }, "discountMode": { "type": "integer", "description": "商家折扣模式：0-平台提供商品折扣（直接计算），1-商家提供商品折扣（平台不计算）", "format": "int32" } }, "description": "促销活动信息（matched 为 true 时有效）" }, "PromotionGoodsInfoDTO": { "required": [ "goodsId", "goodsSource", "skuId" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "skuId": { "type": "string", "description": "skuId" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "shopId": { "type": "string", "description": "商品所属门店ID" }, "priceInCents": { "type": "integer", "description": "商品价格,单位:分", "format": "int64" } }, "description": "商品信息" }, "PromotionActivityGoodsByCategoryReqDTO": { "required": [ "categoryCode", "count" ], "type": "object", "properties": { "categoryCode": { "type": "string", "description": "商品活动分类编码", "example": "CATEGORY_001" }, "count": { "minimum": 1, "type": "integer", "description": "查询数量", "format": "int32", "example": 10 } }, "description": "根据分类编码查询活动商品请求参数" }, "CommonResultPromotionActivityGoodsByCategoryRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionActivityGoodsByCategoryRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsDiscountInfoDTO": { "type": "object", "properties": { "discountRate": { "type": "integer", "description": "折扣比例（例如：90 表示 9 折）", "format": "int32" }, "discountType": { "type": "integer", "description": "折扣类型: 1-折扣", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠比例百分比（例如：10 表示优惠了 10%）", "format": "int32" }, "activityType": { "type": "string", "description": "活动类型编码：PLATFORM_DISCOUNT-平台折扣活动，MERCHANT_DISCOUNT-商家折扣活动，NEW_USER_DISCOUNT-新用户折扣活动" } }, "description": "商品优惠折扣信息" }, "PromotionActivityGoodsByCategoryRespDTO": { "type": "object", "properties": { "goodsList": { "type": "array", "description": "商品列表", "items": { "$ref": "#/components/schemas/PromotionActivityGoodsItemDTO" } } }, "description": "根据分类编码查询活动商品响应" }, "PromotionActivityGoodsItemDTO": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 1024 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格（单位：分）", "example": "20440" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址" }, "goodsCategoryCode": { "type": "string", "description": "商品活动分类编码" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "sort": { "type": "integer", "description": "排序值，数值越大越靠前", "format": "int32" }, "goodsShareShortUrl": { "type": "string", "description": "商品分享短链" }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接" }, "goodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "discountInfo": { "$ref": "#/components/schemas/GoodsDiscountInfoDTO" } }, "description": "活动商品项信息" }, "PromotionActivitySkuReqDTO": { "required": [ "goodsId", "goodsSource", "key", "priceInCents", "skuId" ], "type": "object", "properties": { "key": { "type": "string", "description": "唯一标识 Key，格式：商品ID_SKUID，用于批量查询时追踪对应关系", "example": "123456_789012" }, "goodsId": { "type": "string", "description": "商品ID" }, "skuId": { "type": "string", "description": "SKU ID" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" }, "shopId": { "type": "string", "description": "商品所属门店ID" }, "priceInCents": { "type": "integer", "description": "SKU 价格,单位:分", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号" }, "userId": { "type": "integer", "description": "用户编号", "format": "int64" }, "scene": { "type": "integer", "description": "查询场景：PRODUCT_DETAIL-商品详情页，SHOPPING_CART-购物车，CHECKOUT-结算页", "format": "int32" } }, "description": "商品 SKU 促销活动查询请求参数" }, "CommonResultListPromotionActivitySkuRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/PromotionActivitySkuRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionActivitySkuRespDTO": { "required": [ "goodsId", "goodsInfo", "key", "matched", "skuId" ], "type": "object", "properties": { "key": { "type": "string", "description": "唯一标识 Key，格式：商品ID_SKUID，与请求参数中的 key 对应", "example": "123456_789012" }, "goodsId": { "type": "string", "description": "商品ID" }, "skuId": { "type": "string", "description": "SKU ID" }, "matched": { "type": "boolean", "description": "是否命中促销活动" }, "goodsInfo": { "$ref": "#/components/schemas/PromotionGoodsInfoDTO" }, "activityInfo": { "$ref": "#/components/schemas/PromotionActivityInfoDTO" }, "goodsLevelDiscount": { "$ref": "#/components/schemas/GoodsLevelDiscountDTO" }, "platformDiscount": { "$ref": "#/components/schemas/PlatformDiscountDTO" }, "activityType": { "type": "string", "description": "活动类型编码：PLATFORM_DISCOUNT-平台折扣活动，MERCHANT_DISCOUNT-商家折扣活动，NEW_USER_DISCOUNT-新用户折扣活动" } } }, "CommonResultListPromotionActivityGoodsRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/PromotionActivityGoodsRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenRedeemCodeReqVO": { "required": [ "code", "email" ], "type": "object", "properties": { "code": { "type": "string", "description": "兑换码", "example": "E602F4DC626E4948" }, "email": { "type": "string", "description": "收券会员邮箱（用于定位我方会员）", "example": "user@example.com" }, "requestId": { "type": "string", "description": "外部请求流水号，用于幂等防重（可选）", "example": "REQ-20260604-0001" } }, "description": "开放平台 - 优惠券随机兑换 Request VO" }, "CommonResultOpenRedeemCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/OpenRedeemCodeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "OpenRedeemCodeRespVO": { "type": "object", "properties": { "code": { "type": "string", "description": "兑换码", "example": "E602F4DC626E4948" }, "email": { "type": "string", "description": "收券会员邮箱", "example": "user@example.com" }, "prize": { "type": "string", "description": "本次中奖/获得的奖品描述（取中奖券标题，多张时以逗号分隔）", "example": "30% OFF" }, "success": { "type": "boolean", "description": "兑换是否成功", "example": true }, "message": { "type": "string", "description": "兑换结果描述", "example": "兑换成功，共获得 1 张优惠券" }, "coupons": { "type": "array", "description": "本次兑换得到的优惠券列表（随机模式下通常为 1 张）", "items": { "$ref": "#/components/schemas/OpenRedeemCouponItemVO" } } }, "description": "开放平台 - 优惠券随机兑换 Response VO" }, "OpenRedeemCouponItemVO": { "type": "object", "properties": { "templateId": { "type": "integer", "description": "优惠券模板ID", "format": "int64", "example": 1 }, "title": { "type": "string", "description": "优惠券标题", "example": "满100减10" }, "couponType": { "type": "integer", "description": "优惠券类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 2 }, "discountType": { "type": "integer", "description": "优惠类型:1-满元减,2-满元折", "format": "int32", "example": 1 }, "discountPrice": { "type": "integer", "description": "优惠金额(单位:分)", "format": "int32", "example": 1000 }, "discountPercent": { "type": "integer", "description": "折扣百分比(discountType=2 时有效)", "format": "int32", "example": 80 }, "usePriceCondition": { "type": "integer", "description": "门槛:满多少金额可用(单位:分,0 不限制)", "format": "int32", "example": 10000 }, "validStartTime": { "type": "string", "description": "生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "生效结束时间", "format": "date-time" } }, "description": "开放平台 - 兑换得到的优惠券 Item VO" }, "AppRedeemCodeReqVO": { "required": [ "redeemCode" ], "type": "object", "properties": { "redeemCode": { "type": "string", "description": "兑换码", "example": "E602F4DC626E4948" }, "redeemType": { "type": "string", "description": "兑换类型：EVENT-活动兑换（需配合 eventCode 使用，用于从 Apollo 配置中查找兑换码对应的实际兑换策略）, SHIPPING_COUPON-运费券（直接兑换，无需 eventCode）, PRODUCT_COUPON-商品券（直接兑换，无需 eventCode）, WALLET_BALANCE-钱包余额（直接兑换，无需 eventCode）。为空时会依次尝试 SHIPPING_COUPON → PRODUCT_COUPON → WALLET_BALANCE 进行兑换，任一成功即返回（兜底旧版本客户端）", "example": "EVENT" }, "eventCode": { "type": "string", "description": "活动编码（redeemType 为 EVENT 时必填），用于定位 Apollo 中对应的活动配置并校验活动时间", "example": "EASTER_DAY" } }, "description": "用户 App - 兑换码兑换 Request VO" }, "AppCouponRespVO": { "required": [ "code", "couponType", "discountType", "id", "status", "templateId", "title", "usageAmountScope", "usageAmountScopeList", "usageCountryScope", "usageCountryScopeList", "usageRouteScope", "usageRouteScopeList", "usageWarehouseScope", "usageWarehouseScopeList", "usePriceCondition" ], "type": "object", "properties": { "id": { "type": "integer", "description": "优惠劵唯一ID", "format": "int64", "example": 1 }, "templateId": { "type": "integer", "description": "优惠劵模板ID", "format": "int64", "example": 1 }, "title": { "type": "string", "description": "优惠劵标题", "example": "春节送送送" }, "code": { "type": "string", "description": "优惠券唯一code", "example": "21224752056818" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "status": { "type": "integer", "description": "优惠劵状态", "format": "int32", "example": 1 }, "usePriceCondition": { "type": "integer", "description": "是否设置满多少金额可用(门槛)(单位:分)", "format": "int32", "example": 100 }, "validType": { "type": "integer", "description": "优惠券生效类型 : 1-固定日期,2-领取后多少天", "format": "int32" }, "validDays": { "type": "integer", "description": "领取后 {validDays} 天有效", "format": "int32", "nullable": true }, "takeTime": { "type": "string", "description": "优惠券领取时间", "format": "date-time" }, "validStartTime": { "type": "string", "description": "固定日期 - 生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "固定日期 - 生效结束时间", "format": "date-time" }, "discountType": { "type": "integer", "description": "优惠类型:1-满元减,2-满元折", "format": "int32" }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32", "nullable": true, "example": 80 }, "discountPrice": { "minimum": 0, "type": "integer", "description": "优惠金额(单位:分)", "format": "int32", "nullable": true, "example": 10 }, "discountLimitPrice": { "type": "integer", "description": "折扣上限(单位:分)", "format": "int32", "nullable": true, "example": 100 }, "isAllowedStackable": { "type": "boolean", "description": "优惠券是否支持叠加使用", "nullable": true, "example": false }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32", "example": 1 }, "usageAmountCodes": { "type": "string" }, "usageAmountScopeList": { "type": "array", "description": "可使用费用类型集合", "example": [ 1 ], "items": { "$ref": "#/components/schemas/AppUsageScopeCodesRespVO" } }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32", "example": 1 }, "usageWarehouseCodes": { "type": "string" }, "usageWarehouseScopeList": { "type": "array", "description": "可使用仓库列表ID集合", "example": [ 1 ], "items": { "$ref": "#/components/schemas/AppUsageScopeCodesRespVO" } }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32", "example": 1 }, "usageRouteCodes": { "type": "string" }, "usageRouteScopeList": { "type": "array", "description": "可使用路线范围列表ID集合", "example": [ 1 ], "items": { "$ref": "#/components/schemas/AppUsageScopeCodesRespVO" } }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32", "example": 1 }, "usageCountryCodes": { "type": "string" }, "usageCountryScopeList": { "type": "array", "description": "可使用国家范围列表集合", "example": 1, "items": { "$ref": "#/components/schemas/AppUsageScopeCodesRespVO" } }, "sceneInfo": { "$ref": "#/components/schemas/CouponTemplateSceneRespVO" } }, "description": "用户 App - 优惠劵列表 Response VO" }, "AppRedeemCodeRespVO": { "type": "object", "properties": { "redeemCode": { "type": "string", "description": "兑换码" }, "redeemType": { "type": "string", "description": "兑换类型", "example": "SHIPPING_COUPON" }, "redeemTypeName": { "type": "string", "description": "兑换类型名称", "example": "运费券" }, "success": { "type": "boolean", "description": "兑换是否成功" }, "message": { "type": "string", "description": "兑换结果描述" }, "data": { "$ref": "#/components/schemas/RedeemResultDataVO" } }, "description": "用户 App - 兑换码兑换结果 Response VO" }, "AppUsageScopeCodesRespVO": { "required": [ "code", "name", "uuid" ], "type": "object", "properties": { "code": { "type": "string", "description": "编码", "example": "1" }, "name": { "type": "string", "description": "名称", "example": "1" }, "uuid": { "type": "string", "description": "uuid", "example": "1" } }, "description": "可使用国家范围列表集合", "example": 1 }, "CommonResultAppRedeemCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppRedeemCodeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponTemplateRespVO": { "required": [ "createTime", "discountType", "id", "name", "status", "takeLimitCount", "takeType", "totalCount", "usageAmountScope", "usageCountryScope", "usageMerchantScope", "usageRouteScope", "usageWarehouseScope", "usePrice", "validityType" ], "type": "object", "properties": { "id": { "type": "integer", "description": "优惠券模板编号", "format": "int64", "example": 10563 }, "nameI18nConfig": { "$ref": "#/components/schemas/CouponNameI18nConfigVO" }, "name": { "type": "string", "description": "优惠券中文名称", "example": "赵六" }, "status": { "type": "integer", "description": "优惠券状态", "format": "int32", "example": 2 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "usePrice": { "type": "integer", "description": "使用门槛", "format": "int32", "example": 37 }, "takeType": { "type": "integer", "description": "领取方式", "format": "int32", "example": 2 }, "totalCount": { "type": "integer", "description": "发放数量, -1 - 则表示不限制", "format": "int32", "example": 31538 }, "takeLimitCount": { "type": "integer", "description": "每人限领个数, -1 - 则表示不限制", "format": "int32", "example": 225 }, "takeCount": { "type": "integer", "description": "领取数量（已发放券张数，来自 promotion_coupon 聚合）", "format": "int32", "example": 100 }, "takeUserCount": { "type": "integer", "description": "领取用户数量（去重用户数，来自 promotion_coupon 聚合）", "format": "int32", "example": 80 }, "useCount": { "type": "integer", "description": "券使用数量（已使用+已核销，来自 promotion_coupon 聚合）", "format": "int32", "example": 50 }, "todayTakeCount": { "type": "integer", "description": "今日领取数量（当天领取的券张数，来自 promotion_coupon 聚合）", "format": "int32", "example": 10 }, "discountType": { "type": "integer", "description": "优惠类型：1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 2 }, "discountPrice": { "type": "integer", "description": "优惠金额，单位：分", "format": "int32", "example": 13445 }, "discountLimitPrice": { "type": "integer", "description": "折扣上限，仅在 discount_type 等于 2 时生效", "format": "int32", "example": 20547 }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32" }, "validityType": { "type": "integer", "description": "生效日期类型 : 1-固定日期,2-领取后多少天", "format": "int32", "example": 2 }, "validStartTime": { "type": "string", "description": "固定日期-生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "固定日期-生效结束时间", "format": "date-time" }, "fixedStartTerm": { "type": "integer", "description": "领取日期-开始天数", "format": "int32" }, "fixedEndTerm": { "type": "integer", "description": "领取日期-结束天数", "format": "int32" }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32" }, "usageAmountCodes": { "type": "array", "description": "可使用的费用类型编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32" }, "usageWarehouseCodes": { "type": "array", "description": "可使用的仓库编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32" }, "usageRouteCodes": { "type": "array", "description": "可使用的路线编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32" }, "usageCountryCodes": { "type": "array", "description": "可使用的国家编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageMerchantScope": { "type": "integer", "description": "可使用商家范围:1-不限商家,2-指定商家,3-排除指定商家", "format": "int32" }, "usageMerchantCodes": { "type": "array", "description": "可使用的商家编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "sceneInfo": { "$ref": "#/components/schemas/CouponTemplateSceneRespVO" }, "remark": { "type": "string", "description": "备注" } }, "description": "管理后台 - 优惠劵模板 Response VO" }, "CouponTemplateSceneRespVO": { "required": [ "createTime", "id", "sceneCode", "sceneName" ], "type": "object", "properties": { "id": { "type": "integer", "description": "场景编号，自增唯一", "format": "int64", "example": 25877 }, "sceneCode": { "type": "string", "description": "场景编码，例如 NEW_USER-新人券, FESTIVAL_XMAS-圣诞节券" }, "sceneName": { "type": "string", "description": "场景名称，例如 新人专属, 圣诞节专属", "example": "李四" }, "description": { "type": "string", "description": "场景描述/备注", "example": "你说的对" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "remark": { "type": "string", "description": "备注信息", "example": "随便" }, "templateCount": { "type": "integer", "description": "关联的优惠券模板数量", "format": "int64", "example": 10 }, "templateList": { "type": "array", "description": "关联的优惠券模板列表", "items": { "$ref": "#/components/schemas/CouponTemplateRespVO" } } }, "description": "管理后台 - 优惠券模板场景 Response VO", "nullable": true }, "RedeemResultDataVO": { "type": "object", "properties": { "couponList": { "type": "array", "description": "优惠券列表（运费券 / 商品券兑换时返回）", "items": { "$ref": "#/components/schemas/AppCouponRespVO" } }, "walletResult": { "$ref": "#/components/schemas/WalletRedeemResultVO" } }, "description": "兑换业务数据，根据 redeemType 只会填充对应的字段" }, "WalletRedeemResultVO": { "type": "object", "properties": { "code": { "type": "string", "description": "兑换码", "example": "ABC123" }, "amount": { "type": "integer", "description": "中奖金额（单位：分）", "format": "int64", "example": 10000 }, "sceneCode": { "type": "string", "description": "兑换场景编码（如：CUSTOMER_COMPENSATION、ACTIVITY_GIFT）" }, "userHasRedeemed": { "type": "boolean", "description": "当前用户是否已兑换过（未登录或未统计时为 null）" }, "userRemainingCount": { "type": "integer", "description": "当前用户剩余可兑换次数（限领多次时为剩余；不限领为 null）", "format": "int32" } }, "description": "钱包余额兑换结果" }, "AppPointExchangeCreateReqVO": { "required": [ "productCode", "quantity" ], "type": "object", "properties": { "productCode": { "type": "string", "description": "积分商品编码", "example": "PT20240101ABC123" }, "quantity": { "minimum": 1, "type": "integer", "description": "兑换数量", "format": "int32", "example": 1 } }, "description": "用户 App - 积分兑换创建 Request VO" }, "AppPointExchangeCreateRespVO": { "type": "object", "properties": { "exchangeNo": { "type": "string", "description": "兑换单号" }, "productCode": { "type": "string", "description": "积分商品编码" }, "productName": { "type": "string", "description": "商品名称" }, "productType": { "type": "string", "description": "商品类型编码" }, "pointPrice": { "type": "integer", "description": "消耗积分（单价）", "format": "int32" }, "quantity": { "type": "integer", "description": "兑换数量", "format": "int32" }, "totalPoint": { "type": "integer", "description": "总消耗积分", "format": "int32" }, "status": { "type": "integer", "description": "兑换状态：1-处理中，2-成功，3-失败，4-已退回", "format": "int32" }, "resultId": { "type": "string", "description": "结果ID（如发放的优惠券ID）" }, "remainingPoint": { "type": "integer", "description": "兑换后账户积分余额", "format": "int32" }, "createTime": { "type": "string", "description": "兑换时间", "format": "date-time" } }, "description": "用户 App - 积分兑换成功 Response VO" }, "CommonResultAppPointExchangeCreateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppPointExchangeCreateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppCouponTakeReqVO": { "required": [ "templateId" ], "type": "object", "properties": { "templateId": { "type": "integer", "description": "优惠劵模板编号", "format": "int64", "example": 1 } }, "description": "用户 App - 优惠劵领取 Request VO" }, "AppUsedCouponExchangeCodeReqVO": { "required": [ "exchangeCode" ], "type": "object", "properties": { "exchangeCode": { "type": "string", "description": "优惠劵兑换码", "example": "1" } }, "description": "用户 App - 优惠劵兑换 Request VO" }, "CommonResultListAppCouponRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppCouponRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppCouponBatchInvalidReqVO": { "required": [ "codes" ], "type": "object", "properties": { "codes": { "type": "array", "description": "优惠券 Code 列表", "example": [ "21224752056818", "21224752056819" ], "items": { "type": "string", "description": "优惠券 Code 列表", "example": "[\"21224752056818\",\"21224752056819\"]" } } }, "description": "用户 App - 批量作废优惠券 Request VO" }, "AppPromotionLuckyDrawDoLuckyDrawReq": { "type": "object", "properties": { "eventCode": { "type": "string", "description": "活动编码" }, "eventMeta": { "type": "string", "description": "用户抽奖来源的埋点信息" } }, "description": "用户 APP - 执行抽奖" }, "AppPromotionLuckyDrawPrizeRespVO": { "required": [ "id", "name", "prizeType" ], "type": "object", "properties": { "id": { "type": "integer", "description": "奖品ID", "format": "int64" }, "name": { "type": "string", "description": "奖品名称" }, "prizeType": { "type": "string", "description": "奖品类型" } }, "description": "用户 APP - 抽奖活动奖品信息 (脱敏后)" }, "AppPromotionLuckyDrawResultRespVO": { "required": [ "prizeName", "prizeType", "prizes" ], "type": "object", "properties": { "prizeId": { "type": "integer", "description": "中奖奖品ID", "format": "int64" }, "prizeName": { "type": "string", "description": "中奖奖品名称" }, "prizeType": { "type": "string", "description": "奖品类型" }, "prizes": { "type": "array", "description": "奖品列表 (已脱敏)", "items": { "$ref": "#/components/schemas/AppPromotionLuckyDrawPrizeRespVO" } } }, "description": "用户 APP - 抽奖结果" }, "CommonResultAppPromotionLuckyDrawResultRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppPromotionLuckyDrawResultRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceWalletWithdrawSupportChannelRespVO": { "required": [ "code", "name", "type" ], "type": "object", "properties": { "name": { "type": "string", "description": "收款方式类型名称", "example": "31907" }, "code": { "type": "string", "description": "收款方式类型编码", "example": "31907" }, "type": { "type": "integer", "description": "收款方式类型:1-PayPal , 2-银行转账", "format": "int32", "example": 2 }, "icon": { "type": "string", "description": "收款方式类型图标" }, "formType": { "type": "integer", "description": "表单类型：1-通用表单（可直接收集邮箱、钱包地址、链上地址等信息），2-银行专用表单（收集开户行、账号、户名等信息）", "format": "int32", "example": 1 } }, "description": "用户 APP - 推广联盟用户提现收款方式 Response VO" }, "CommonResultListAppAllianceWalletWithdrawSupportChannelRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppAllianceWalletWithdrawSupportChannelRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceWalletWithdrawMethodSaveReqVO": { "required": [ "accountDetail", "accountType", "accountTypeCode" ], "type": "object", "properties": { "accountType": { "type": "integer", "description": "收款账号类型:1-PayPal, 2-Bank Transfer, 3-RizzitGO Wallet, 4-USDT, 5-Binance", "format": "int32", "example": 1 }, "accountTypeCode": { "type": "string", "description": "收款账号类型编码:PAYPAL, BANK_TRANSFER, RIZZITGO_WALLET, USDT, BINANCE", "example": "PAYPAL" }, "accountNumber": { "type": "string", "description": "收款人账号" }, "accountUsername": { "type": "string", "description": "收款人名称", "example": "李四" }, "accountDetail": { "type": "string", "description": "收款账号详情" } }, "description": "用户 APP - 推广联盟用户提现收款方式新增/修改 Request VO" }, "AppAllianceWalletWithdrawPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "withdrawStatus": { "type": "integer", "description": "提现状态:1-提现中,2-提现成功,3-提现失败", "format": "int32" } }, "description": "用户 APP - 推广联盟用户提现记录分页 Request VO" }, "AppAllianceWithdrawRespVO": { "required": [ "createTime", "no", "paymentMethodCode", "paymentMethodName", "paymentMethodType", "updateTime", "withdrawFailedTime", "withdrawSucceedTime" ], "type": "object", "properties": { "no": { "type": "string", "description": "申请提现单号", "example": "17801" }, "receiverAccount": { "type": "string", "description": "提现收款账户", "example": "24847" }, "receiverAccountChannel": { "type": "string", "description": "提现收款账户渠道" }, "applyAmount": { "type": "integer", "description": "本次申请提现金额(单位:分)", "format": "int32" }, "receivedAmount": { "type": "integer", "description": "提现最终到账金额(单位:分)", "format": "int32" }, "status": { "type": "integer", "description": "提现处理状态", "format": "int32" }, "withdrawStatus": { "type": "integer", "description": "提现状态:1-申请提现中,2-提现成功,3-提现失败", "format": "int32" }, "reason": { "type": "string", "description": "提现失败原因", "nullable": true, "example": "不对" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" }, "withdrawSucceedTime": { "type": "string", "description": "提现成功时间", "format": "date-time" }, "withdrawFailedTime": { "type": "string", "description": "提现失败时间", "format": "date-time" }, "paymentMethodType": { "type": "integer", "description": "收款账号类型", "format": "int32" }, "paymentMethodName": { "type": "string", "description": "收款方式名称", "example": "微信支付" }, "paymentMethodCode": { "type": "string", "description": "收款方式编码", "example": "WECHAT" }, "paymentMethodIcon": { "type": "string", "description": "收款方式图标" } }, "description": "用户 APP - 推广联盟用户提现记录 Response VO" }, "CommonResultPageResultAppAllianceWithdrawRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceWithdrawRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceWithdrawRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceWithdrawRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceWithdrawSaveReqVO": { "required": [ "accountId", "applyAmount" ], "type": "object", "properties": { "applyAmount": { "minimum": 1, "type": "integer", "description": "本次申请提现金额(单位:分)", "format": "int32" }, "accountId": { "type": "integer", "description": "提现收款账户ID", "format": "int64", "example": 1 } }, "description": "用户 APP - 推广联盟用户提现记录新增/修改 Request VO" }, "AppAllianceWalletTransactionPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "用户 APP - 推广联盟钱包流水分页 Request VO" }, "AppAllianceWalletTransactionRespVO": { "required": [ "balance", "bizId", "bizType", "bizTypeDesc", "createTime", "no", "price" ], "type": "object", "properties": { "balance": { "type": "integer", "description": "推广联盟钱包余额, 单位分", "format": "int32" }, "bizId": { "type": "string", "description": "关联业务编号", "example": "3301" }, "bizType": { "type": "integer", "description": "钱包流水类型:1-包裹佣金入账,2-额外奖励佣金入账,3-申请提现支出,4-提现退回入账", "format": "int32", "example": 1 }, "bizTypeDesc": { "type": "string", "description": "钱包流水类型描述", "example": "1" }, "no": { "type": "string", "description": "钱包流水号" }, "price": { "type": "integer", "description": "交易金额, 单位分", "format": "int32", "example": 3522 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "用户 APP - 推广联盟钱包流水 Response VO" }, "CommonResultPageResultAppAllianceWalletTransactionRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceWalletTransactionRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceWalletTransactionRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceWalletTransactionRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceShareGoodsCategoryCreateReqVO": { "required": [ "title" ], "type": "object", "properties": { "title": { "type": "string", "description": "分类标题" } }, "description": "用户 APP - 推广者自定义分类创建 Request VO" }, "AppAlliancePromoterInfoUpdateReqVO": { "type": "object", "properties": { "avatar": { "type": "string", "description": "推广者头像" }, "nickname": { "type": "string", "description": "推广者昵称" }, "biography": { "type": "string", "description": "推广者个人简介" } }, "description": "用户 APP - 推广者信息 Response VO" }, "AppAlliancePromoterSocialChannelSaveReqVO": { "required": [ "socialChannelCode", "socialChannelLinks" ], "type": "object", "properties": { "socialChannelCode": { "type": "string", "description": "社媒编码" }, "socialChannelLinks": { "type": "string", "description": "社媒账号地址" }, "displayOnSharePage": { "type": "boolean", "description": "是否分享到推广商品页" }, "code": { "type": "string", "description": "邮箱验证码" } }, "description": "用户 APP - 推广联盟推广者社媒账号新增/修改 Request VO" }, "AppAllianceProductOrdersPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "keyword": { "type": "string", "description": "关键字搜索（订单编号或会员编号）", "example": "DG202401010001" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "platformChannel": { "type": "integer", "description": "平台渠道", "format": "int32", "example": 1 } }, "description": "用户 App - 推广联盟代购订单分页 Request VO" }, "AppAllianceProductOrderOrdersRespVO": { "required": [ "createTime", "goodsTotalAmount", "orderNo", "platformChannel", "qty", "shopName", "status", "unionId" ], "type": "object", "properties": { "orderNo": { "type": "string", "description": "订单编号" }, "unionId": { "type": "string", "description": "会员编号" }, "status": { "type": "integer", "description": "订单状态", "format": "int32" }, "shopName": { "type": "string", "description": "店铺名称" }, "platformChannel": { "type": "string", "description": "平台渠道" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "qty": { "type": "integer", "description": "商品数量", "format": "int32" }, "goodsTotalAmount": { "type": "integer", "description": "商品总额(单位:分)", "format": "int64" } }, "description": "用户 APP - 推广联盟代购订单列表 Response VO" }, "CommonResultPageResultAppAllianceProductOrderOrdersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceProductOrderOrdersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceProductOrderOrdersRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceProductOrderOrdersRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceInviteUserPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "createTime": { "type": "array", "description": "创建时间（可选，用于筛选邀请记录）", "items": { "type": "string", "description": "创建时间（可选，用于筛选邀请记录）", "format": "date-time" } } }, "description": "用户 APP - 推广联盟邀请用户列表记录分页 Request VO" }, "AppAllianceInviteUsersRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "registerTime": { "type": "string", "description": "注册时间", "format": "date-time" }, "email": { "type": "string", "description": "邮箱" }, "unionId": { "type": "string", "description": "会员编号" }, "nickname": { "type": "string", "description": "用户昵称" }, "goodsOrderCount": { "type": "integer", "description": "商品订单数量", "format": "int64" }, "parcelOrderCount": { "type": "integer", "description": "包裹订单数量", "format": "int32" }, "parcelOrderTotalAmount": { "type": "integer", "description": "包裹订单数量总金额", "format": "int64" }, "parcelOrderAverageAmount": { "type": "integer", "description": "平均订单金额(单位:分)", "format": "int64" }, "parcelOrderMaxOrderAmount": { "type": "integer", "description": "最高订单金额", "format": "int64" }, "parcelOrderLastOrderTime": { "type": "string", "description": "最近下单时间", "format": "date-time" } }, "description": "用户 APP - 推广联盟邀请用户记录 Response VO" }, "CommonResultPageResultAppAllianceInviteUsersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceInviteUsersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceInviteUsersRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceInviteUsersRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceShareGoodsUpdateReqVO": { "required": [ "goodsId" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID", "example": "25016" }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码" } }, "description": "用户 APP - 推广联盟推广者分享商品新增/修改 Request VO" }, "AppAllianceShareGoodsSaveReqVO": { "required": [ "goodsDetailUrl", "goodsId", "goodsPicUrl", "goodsPrice", "goodsSource", "goodsTitle", "localGoodsTitle" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID", "example": "25016" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地中文商品名称" }, "goodsPrice": { "type": "integer", "description": "商品价格", "format": "int32", "example": 30200 }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图", "example": "https://www.iocoder.cn" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址", "example": "https://www.iocoder.cn" }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码" } }, "description": "用户 APP - 推广联盟推广者分享商品新增/修改 Request VO" }, "AppAllianceShareGoodsAddViewCountReqVO": { "required": [ "code", "goodsId" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "code": { "type": "string", "description": "商品分销码,传rno的值" } }, "description": "用户 APP - 推广联盟推广者分享商品新增/修改 Request VO" }, "AppAllianceBagOrdersPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "bagOrderSda": { "type": "string", "description": "提报订单分销码" }, "keyword": { "type": "string", "description": "搜索关键字" }, "status": { "type": "integer", "description": "结算状态:0-待结算,1-结算中,2-已结算", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "用户 APP - 推广联盟提包订单记录分页 Request VO" }, "AppAllianceBagOrdersRespVO": { "required": [ "bagOrderCreateTime", "bagOrderExtraCommissionAmount", "bagOrderNo", "bagOrderRewardCommissionAmount", "bagOrderSda", "bagOrderTotalAmount", "bagOrderTotalCommissionAmount", "bagOrderUserUnionId", "id", "settlementStatus" ], "type": "object", "properties": { "settlementStatus": { "type": "integer", "description": "提包状态:0-待结算,1-结算中,2-已结算", "format": "int32" }, "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9735 }, "bagOrderUserUnionId": { "type": "string", "description": "提包订单用户唯一编号", "example": "18117" }, "bagOrderSda": { "type": "string", "description": "提报订单分销码" }, "bagOrderNo": { "type": "string", "description": "提包订单号" }, "bagOrderTotalAmount": { "type": "integer", "description": "提包总支付金额(单位:分)", "format": "int32" }, "bagOrderRewardCommissionAmount": { "type": "integer", "description": "提包奖励佣金(单位:分)", "format": "int32" }, "bagOrderExtraCommissionAmount": { "type": "integer", "description": "提包额外奖励佣金(单位:分)", "format": "int32" }, "bagOrderTotalCommissionAmount": { "type": "integer", "description": "提包总奖励佣金(单位:分)", "format": "int32" }, "bagOrderCreateTime": { "type": "string", "description": "提包时间", "format": "date-time" }, "bagOrderBonusAmount": { "type": "integer", "description": "当前提包订单佣金(单位:分)", "format": "int32" }, "bagOrderExtraBonusAmount": { "type": "integer", "description": "当前提包订单额外奖励佣金(单位:分)", "format": "int32" }, "settlementTime": { "type": "string", "description": "佣金结算时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "最后更新时间", "format": "date-time" } }, "description": "用户 APP - 推广联盟提包订单记录 Response VO" }, "CommonResultPageResultAppAllianceBagOrdersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceBagOrdersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceBagOrdersRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceBagOrdersRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppPromotionActivityRegRegisterActivityReq": { "type": "object", "properties": { "eventCode": { "type": "string", "description": "活动编码" }, "eventMeta": { "type": "string", "description": "用户报名来源的埋点信息" } }, "description": "用户 APP - 活动报名" }, "CommonResultVoid": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "object" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PointRuleCreateReqVO": { "required": [ "name", "status", "tiers" ], "type": "object", "properties": { "name": { "type": "string", "description": "规则名称", "example": "默认积分规则" }, "status": { "type": "integer", "description": "状态: 0-禁用, 1-启用", "format": "int32", "example": 0 }, "description": { "type": "string", "description": "规则描述" }, "tiers": { "type": "array", "description": "阶梯列表", "items": { "$ref": "#/components/schemas/PointRuleTierVO" } }, "extraConfig": { "$ref": "#/components/schemas/PointRuleExtraConfigVO" } }, "description": "管理后台 - 积分规则创建 Request VO" }, "PointProductCreateReqVO": { "required": [ "name", "pointPrice", "productType", "status", "stock" ], "type": "object", "properties": { "name": { "type": "string", "description": "商品名称（英文）", "example": "10 Dollar Coupon" }, "localName": { "type": "string", "description": "商品名称（中文）", "example": "10元商品券" }, "productType": { "type": "string", "description": "商品类型编码", "example": "GOODS_COUPON" }, "pointPrice": { "minimum": 1, "type": "integer", "description": "所需积分", "format": "int32", "example": 100 }, "relatedId": { "type": "integer", "description": "关联ID（如优惠券模板ID）", "format": "int64", "example": 1 }, "stock": { "type": "integer", "description": "库存数量（-1表示无限）", "format": "int32", "example": 100 }, "limitPerUser": { "type": "integer", "description": "每人限兑数量（0表示不限）", "format": "int32", "example": 1 }, "status": { "type": "integer", "description": "状态", "format": "int32", "example": 1 }, "startTime": { "type": "string", "description": "兑换开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "兑换结束时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32", "example": 0 }, "description": { "type": "string", "description": "商品描述（英文）" }, "localDescription": { "type": "string", "description": "商品描述（中文）" }, "image": { "type": "string", "description": "商品图片" } }, "description": "管理后台 - 积分商品创建 Request VO" }, "PointGiveReqVO": { "required": [ "point", "userId" ], "type": "object", "properties": { "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 1 }, "point": { "minimum": 1, "type": "integer", "description": "赠送积分", "format": "int32", "example": 100 }, "reason": { "type": "string", "description": "赠送原因", "example": "活动奖励" } }, "description": "管理后台 - 积分赠送 Request VO" }, "CouponSendReqVO": { "required": [ "templateId" ], "type": "object", "properties": { "templateId": { "type": "integer", "description": "优惠劵模板编号", "format": "int64", "example": 1 }, "userIdList": { "uniqueItems": true, "type": "array", "description": "指定用户ID集合", "items": { "type": "integer", "description": "指定用户ID集合", "format": "int64" } } }, "description": "用户 App - 优惠劵领取 Request VO" }, "CouponTemplateSaveReqVO": { "required": [ "couponType", "discountType", "nameI18nConfig", "takeLimitCount", "takeType", "totalCount", "usageAmountScope", "usageCountryScope", "usageMerchantScope", "usageRouteScope", "usageWarehouseScope", "usePrice", "validityType" ], "type": "object", "properties": { "nameI18nConfig": { "$ref": "#/components/schemas/CouponNameI18nConfigVO" }, "usePrice": { "type": "integer", "description": "优惠券门槛(单位:分)", "format": "int32", "example": 37 }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "totalCount": { "type": "integer", "description": "领取发放数量:-1则表示不限制", "format": "int32", "example": 31538 }, "takeLimitCount": { "type": "integer", "description": "优惠券限领数量:-1则表示不限制", "format": "int32", "example": 225 }, "takeType": { "type": "integer", "description": "优惠券领取方式", "format": "int32", "example": 2 }, "discountType": { "type": "integer", "description": "优惠类型：1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 2 }, "discountPrice": { "type": "integer", "description": "优惠金额(单位:分)", "format": "int32", "example": 13445 }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32" }, "discountLimitPrice": { "type": "integer", "description": "折扣上限，仅在 discount_type 等于 2 时生效", "format": "int32", "example": 20547 }, "validityType": { "type": "integer", "description": "生效日期类型 : 1-固定日期,2-领取后多少天", "format": "int32", "example": 2 }, "validStartTime": { "type": "string", "description": "固定日期-生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "固定日期-生效结束时间", "format": "date-time" }, "fixedStartTerm": { "type": "integer", "description": "领取日期-开始天数", "format": "int32" }, "fixedEndTerm": { "type": "integer", "description": "领取日期-结束天数", "format": "int32" }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32" }, "usageAmountCodes": { "type": "array", "description": "可使用的费用类型编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32" }, "usageWarehouseCodes": { "type": "array", "description": "可使用的仓库编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32" }, "usageRouteCodes": { "type": "array", "description": "可使用的路线编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32" }, "usageCountryCodes": { "type": "array", "description": "可使用的国家编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "usageMerchantScope": { "type": "integer", "description": "可使用商家范围:1-不限商家,2-指定商家,3-排除指定商家", "format": "int32" }, "usageMerchantCodes": { "type": "array", "description": "可使用的商家编码列表", "items": { "$ref": "#/components/schemas/CouponScopeCodeConfigVO" } }, "sceneId": { "type": "integer", "description": "优惠券模板场景ID", "format": "int64", "example": 1 }, "remark": { "type": "string", "description": "备注" } }, "description": "管理后台 - 优惠劵模板新增/修改 Request VO" }, "CouponTemplateSceneBatchBindReqVO": { "required": [ "sceneId", "templateIds" ], "type": "object", "properties": { "sceneId": { "type": "integer", "description": "场景ID", "format": "int64", "example": 1 }, "templateIds": { "type": "array", "description": "优惠券模板ID列表", "items": { "type": "integer", "description": "优惠券模板ID列表", "format": "int64" } } }, "description": "管理后台 - 批量关联优惠券模板到场景 Request VO" }, "AllianceWalletWithdrawTransferSucceedReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9572 }, "transferAmount": { "type": "integer", "description": "财务转账金额(单位:分)", "format": "int32" }, "transferReceiverAccount": { "type": "string", "description": "财务转账收款账号", "example": "1972" }, "transferReceiverAccountChannel": { "type": "string", "description": "财务转账收款账号渠道" }, "transferBankNo": { "type": "string", "description": "财务转账银行单号" }, "transferRemark": { "type": "string", "description": "财务转账备注", "example": "你猜" }, "transferImageUrls": { "type": "array", "description": "财务转账截图", "items": { "type": "string", "description": "财务转账截图" } } }, "description": "管理后台 - 推广联盟用户提现记录新增/修改 Request VO" }, "AllianceWalletWithdrawTransferFailedReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9572 }, "transferRemark": { "type": "string", "description": "财务转账备注", "example": "你猜" }, "transferFailedReason": { "type": "string", "description": "转账失败/异常原因" } }, "description": "管理后台 - 推广联盟用户提现记录新增/修改 Request VO" }, "AllianceWalletWithdrawRejectReqVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9572 }, "reviewRejectReason": { "type": "string", "description": "审核不通过原因", "example": "不对" } }, "description": "管理后台 - 推广联盟用户提现记录新增/修改 Request VO" }, "AllianceWalletWithdrawApproveReqVO": { "required": [ "id", "reviewRemark" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9572 }, "reviewRemark": { "type": "string", "description": "审核通过备注信息", "example": "9572" } }, "description": "管理后台 - 推广联盟用户提现记录新增/修改 Request VO" }, "AllianceBagOrdersUnsettleReqVO": { "required": [ "id", "unsettleReason" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 98 }, "unsettleReason": { "type": "string", "description": "不支持结算原因", "example": "订单已取消" } }, "description": "管理后台 - 推广联盟提包订单设置为不支持结算 Request VO" }, "AllianceBagOrdersSettleReqVO": { "required": [ "activityRewardAmount", "id", "orderCommissionAmount", "settlementAmount" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 98 }, "orderCommissionAmount": { "type": "integer", "description": "订单佣金金额，单位分", "format": "int32", "example": 2528 }, "activityRewardAmount": { "type": "integer", "description": "活动奖励金额，单位分", "format": "int32", "example": 758 }, "settlementAmount": { "type": "integer", "description": "结算金额，单位分", "format": "int32", "example": 3286 }, "remark": { "type": "string", "description": "备注" } }, "description": "管理后台 - 推广联盟提包订单结算 Request VO" }, "ActivitySectionBatchConfigReqVO": { "required": [ "merchantCode", "sections" ], "type": "object", "properties": { "merchantCode": { "maxLength": 50, "minLength": 0, "type": "string", "description": "商家编码", "example": "MERCHANT001" }, "sections": { "type": "array", "description": "分区配置列表", "items": { "$ref": "#/components/schemas/SectionConfigItem" } } }, "description": "管理后台 - 促销页分区批量配置 Request VO" }, "SectionConfigItem": { "required": [ "sectionCode", "sectionName", "sectionType", "sort" ], "type": "object", "properties": { "sectionCode": { "maxLength": 50, "minLength": 0, "type": "string", "description": "分区编码", "example": "BANNER" }, "sectionName": { "maxLength": 100, "minLength": 0, "type": "string", "description": "分区名称", "example": "轮播图" }, "sectionType": { "maxLength": 50, "minLength": 0, "type": "string", "description": "分区类型", "example": "BANNER" }, "sort": { "type": "integer", "description": "排序", "format": "int32", "example": 1 }, "remark": { "maxLength": 500, "minLength": 0, "type": "string", "description": "备注", "example": "这是轮播图分区" }, "extraConfig": { "type": "string", "description": "扩展配置", "example": "{\"autoPlay\":true}" }, "items": { "type": "array", "description": "分区内容项列表", "items": { "$ref": "#/components/schemas/SectionItemConfigItem" } } }, "description": "分区配置项" }, "SectionItemConfigItem": { "required": [ "itemData", "itemType", "sort" ], "type": "object", "properties": { "itemType": { "maxLength": 50, "minLength": 0, "type": "string", "description": "内容项类型", "example": "IMAGE" }, "itemData": { "type": "string", "description": "内容项数据", "example": "{\"imageUrl\":\"https://example.com/image.jpg\"}" }, "sort": { "type": "integer", "description": "排序", "format": "int32", "example": 1 } }, "description": "分区内容项配置" }, "ActivitySectionItemBatchCreateReqVO": { "required": [ "items", "sectionId" ], "type": "object", "properties": { "sectionId": { "type": "integer", "description": "所属分区ID", "format": "int64", "example": 1 }, "merchantCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "商家编码", "example": "MERCHANT_001" }, "items": { "type": "array", "description": "内容项列表", "items": { "$ref": "#/components/schemas/ActivitySectionItemCreateReqVO" } } }, "description": "管理后台 - 分区内容项批量创建 Request VO" }, "ActivitySectionItemCreateReqVO": { "required": [ "itemData", "itemType" ], "type": "object", "properties": { "itemType": { "maximum": 4, "minimum": 1, "type": "integer", "description": "内容类型：1-商品，2-banner组件2，3-banner组件3，4-banner组件4", "format": "int32", "example": 1 }, "itemData": { "type": "string", "description": "内容 JSON 数据，结构根据 item_type 而不同" }, "sort": { "type": "integer", "description": "排序值，值越小越靠前", "format": "int32", "example": 1 } }, "description": "内容项创建信息" }, "ActivitySectionItemBatchAddGoodsReqVO": { "required": [ "merchantCode", "sectionId" ], "type": "object", "properties": { "sectionId": { "type": "integer", "description": "所属分区ID", "format": "int64", "example": 25 }, "merchantCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "商家编码", "example": "QCXC" }, "goodsCategoryCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "商品分类编码，为空时添加该商家的全部活动商品", "example": "HOT_SALE" } }, "description": "管理后台 - 分区内容项批量添加商品 Request VO" }, "ActivityGoodsImportReqVO": { "required": [ "merchantCode", "platformCategoryCode", "shopCategoryId", "shopId", "shopSource" ], "type": "object", "properties": { "shopCategoryId": { "type": "string", "description": "微店分类ID", "example": "11" }, "merchantCode": { "type": "string", "description": "商家编码", "example": "YOLO" }, "shopId": { "type": "string", "description": "店铺ID", "example": "1850717273" }, "shopSource": { "type": "integer", "description": "店铺来源", "format": "int32", "example": 3 }, "platformCategoryCode": { "type": "string", "description": "平台分类编码", "example": "11" } }, "description": "管理后台 - 导入微店分类商品 Request VO" }, "ActivityGoodsBatchCreateByUrlReqVO": { "required": [ "activityImageType", "discountRate", "goodsSource", "goodsUrls", "merchantCode" ], "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码" }, "remark": { "type": "string", "description": "备注信息" }, "goodsUrls": { "type": "array", "description": "商品URL列表", "example": [ "https://weidian.com/item.html?itemID=123456", "https://weidian.com/item.html?itemID=789012" ], "items": { "type": "string", "description": "商品URL列表", "example": "[\"https://weidian.com/item.html?itemID=123456\",\"https://weidian.com/item.html?itemID=789012\"]" } }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "discountRate": { "type": "integer", "description": "商品折扣（例如 90 表示 9 折）", "format": "int32" }, "activityImageType": { "type": "integer", "description": "活动图片类型: 1-商品主图, 2-商品首图", "format": "int32" }, "enableMultiThread": { "type": "boolean", "description": "是否启用多线程处理", "example": true } }, "description": "管理后台 - 根据商品链接批量创建促销活动商品 Request VO" }, "ActivityGoodsBatchCreateRespVO": { "type": "object", "properties": { "totalCount": { "type": "integer", "description": "总处理数量", "format": "int32" }, "successCount": { "type": "integer", "description": "成功创建数量", "format": "int32" }, "failureCount": { "type": "integer", "description": "失败数量", "format": "int32" }, "successIds": { "type": "array", "description": "成功创建的商品ID列表", "items": { "type": "integer", "description": "成功创建的商品ID列表", "format": "int64" } }, "failures": { "type": "array", "description": "失败的商品URL及错误信息", "items": { "$ref": "#/components/schemas/FailureItem" } } }, "description": "管理后台 - 批量创建促销活动商品 Response VO" }, "CommonResultActivityGoodsBatchCreateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivityGoodsBatchCreateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "FailureItem": { "type": "object", "properties": { "goodsUrl": { "type": "string", "description": "失败的商品URL" }, "errorMessage": { "type": "string", "description": "错误信息" } }, "description": "失败项详情" }, "CommonResultPointAccountRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PointAccountRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PointAccountRespDTO": { "type": "object", "properties": { "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "totalPoint": { "type": "integer", "description": "当前总积分（可为负数）", "format": "int32" }, "frozenPoint": { "type": "integer", "description": "冻结积分", "format": "int32" }, "availablePoint": { "type": "integer", "description": "可用积分（totalPoint - frozenPoint）", "format": "int32" }, "totalEarned": { "type": "integer", "description": "累计获得积分", "format": "int32" }, "totalUsed": { "type": "integer", "description": "累计使用积分", "format": "int32" } } }, "CommonResultListHomeSearchKeywordRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/HomeSearchKeywordRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HomeSearchKeywordRespDTO": { "required": [ "action", "actionData", "displayKeyword", "keyword" ], "type": "object", "properties": { "keyword": { "type": "string", "description": "实际搜索的关键词" }, "displayKeyword": { "type": "string", "description": "展示给用户的关键词" }, "action": { "type": "integer", "description": "关键词类型:1-搜索关键词,2-点击跳转指定url", "format": "int32" }, "actionData": { "type": "string", "description": "关键词对应值" } }, "description": "RPC 服务 - 首页搜索热词 Response DTO" }, "ActivityMerchantRespDTO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 16466 }, "shopName": { "type": "string", "description": "商家名称", "example": "王五" }, "shopId": { "type": "string", "description": "商家ID", "example": "10348" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商家编码", "example": "MERCHANT001" }, "remark": { "type": "string", "description": "备注", "example": "这是一个备注" }, "shopUrl": { "type": "string", "description": "商家链接", "example": "https://shop123.example.com" }, "shopSource": { "type": "string", "description": "商家来源", "example": "taobao" }, "shopLogo": { "type": "string", "description": "商家Logo", "example": "https://example.com/logo.png" }, "shopBannerImages": { "type": "string", "description": "店铺 Banner 图（多张，英文逗号分隔）" }, "discountStatus": { "type": "integer", "description": "折扣状态", "format": "int32", "example": 1 }, "merchantSort": { "type": "integer", "description": "商家排序（值越大越靠前）", "format": "int32", "example": 100 }, "merchantDisplayLogo": { "type": "string", "description": "商家对外展示 Logo", "example": "https://example.com/display-logo.png" }, "merchantDisplayName": { "type": "string", "description": "商家对外展示名称", "example": "NIKE官方旗舰店" }, "discountMode": { "type": "integer", "description": "折扣模式：0-平台折扣（直接计算），1-商家折扣（平台不计算）", "format": "int32", "example": 0 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "RPC 服务 - 合作商家 Response DTO" }, "CommonResultListActivityMerchantRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ActivityMerchantRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultActivityMerchantRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivityMerchantRespDTO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppEventRedeemCodeRespVO": { "type": "object", "properties": { "eventCode": { "type": "string", "description": "活动编码", "example": "EASTER_DAY" }, "eventType": { "type": "string", "description": "活动类型标识，前端根据此字段决定渲染模式，大部分情况与 eventCode 一致。如 EASTER_DAY-复活节彩蛋, CHRISTMAS_DAY-圣诞节礼物", "example": "EASTER_DAY" }, "itemNo": { "type": "integer", "description": "兑换项序号", "format": "int32", "example": 1 }, "redeemCode": { "type": "string", "description": "兑换码", "example": "E602F4DC626E4948" }, "redeemType": { "type": "string", "description": "兑换类型：SHIPPING_COUPON-运费券, PRODUCT_COUPON-商品券, WALLET_BALANCE-钱包余额", "example": "SHIPPING_COUPON" }, "redeemTypeName": { "type": "string", "description": "兑换类型名称", "example": "运费券" }, "properties": { "type": "object", "additionalProperties": { "type": "object", "description": "活动特有属性，不同活动通过此字段携带自定义数据" }, "description": "活动特有属性，不同活动通过此字段携带自定义数据" } }, "description": "用户 App - 活动兑换码 Response VO" }, "CommonResultListAppEventRedeemCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppEventRedeemCodeRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppQcGoodsPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "merchantCode": { "type": "string", "description": "商家编码", "example": "商家编码" }, "shopIds": { "type": "array", "description": "店铺ID列表", "example": [ 10, 20 ], "items": { "type": "string", "description": "店铺ID列表", "example": "[10,20]" } }, "keyword": { "type": "string", "description": "模糊搜索关键字", "example": "商品名称" } }, "description": "App - 质检商品分页查询 Request VO" }, "AppQcGoodsRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "质检单ID", "format": "int64", "example": 10 }, "shopId": { "type": "integer", "description": "店铺ID", "format": "int64", "example": 10 }, "shopName": { "type": "string", "description": "店铺名称", "example": "XX的店铺" }, "platformChannel": { "type": "integer", "description": "平台渠道", "format": "int32" }, "goodsId": { "type": "string", "description": "商品ID", "example": "1001" }, "skuId": { "type": "string", "description": "SKU ID", "example": "2001" }, "goodsName": { "type": "string", "description": "商品名称", "example": "潮流T恤" }, "specName": { "type": "string", "description": "规格名称", "example": "白色, L" }, "imagePath": { "type": "string", "description": "商品主图路径" }, "goodsLinks": { "type": "string", "description": "商品源链接" }, "completionTime": { "type": "string", "description": "完成时间", "format": "date-time" }, "length": { "type": "string", "description": "长(cm)", "example": "10.5" }, "width": { "type": "string", "description": "宽(cm)", "example": "5.2" }, "height": { "type": "string", "description": "高(cm)", "example": "3.0" }, "weight": { "type": "string", "description": "重量(g)", "example": "500" }, "volume": { "type": "string", "description": "体积(cm³)", "example": "163.8" }, "qcPathList": { "type": "array", "description": "质检照片列表", "items": { "type": "string", "description": "质检照片列表" } } }, "description": "App - 质检商品信息 Response VO" }, "CommonResultPageResultAppQcGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppQcGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppQcGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppQcGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppActivityQcCenterMerchantRespVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 16466 }, "merchantCode": { "type": "string", "description": "商家编码" }, "shopId": { "type": "string", "description": "店铺ID", "example": "10348" }, "shopName": { "type": "string", "description": "店铺名称" }, "shopUrl": { "type": "string", "description": "店铺链接", "example": "https://www.iocoder.cn" }, "shopSource": { "type": "string", "description": "店铺来源（如淘宝、京东等）" }, "shopLogo": { "type": "string", "description": "店铺 Logo 图片链接" }, "merchantSort": { "type": "integer", "description": "商家排序（值越大越靠前）", "format": "int32", "example": 100 }, "merchantDisplayLogo": { "type": "string", "description": "商家对外展示 Logo", "example": "https://example.com/logo.png" }, "merchantDisplayName": { "type": "string", "description": "商家对外展示名称", "example": "NIKE官方旗舰店" }, "internalShopUrl": { "type": "string", "description": "内部店铺跳转地址", "example": "https://rizzitgo.com/store-product?shopId=123&source=taobao" } }, "description": "用户APP - 商家质检中心" }, "CommonResultListAppActivityQcCenterMerchantRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppActivityQcCenterMerchantRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppQcGoodsDetailRespVO": { "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID", "example": "1001" }, "length": { "type": "string", "description": "长(cm)", "example": "10.5" }, "width": { "type": "string", "description": "宽(cm)", "example": "5.2" }, "height": { "type": "string", "description": "高(cm)", "example": "3.0" }, "weight": { "type": "string", "description": "重量(g)", "example": "500" }, "volume": { "type": "string", "description": "体积(cm³)", "example": "163.8" }, "completionTime": { "type": "string", "description": "完成时间", "format": "date-time" }, "qcPathList": { "type": "array", "description": "质检照片列表", "items": { "type": "string", "description": "质检照片列表" } } }, "description": "App - 质检商品详情 Response VO" }, "CommonResultAppQcGoodsDetailRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppQcGoodsDetailRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppPointRecordPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "bizType": { "type": "string", "description": "业务类型编码", "example": "RECHARGE" }, "status": { "type": "integer", "description": "状态值：1-已获得，2-已使用，3-已撤销，4-已失效", "format": "int32", "example": 1 }, "startTime": { "type": "string", "description": "开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "结束时间", "format": "date-time" } }, "description": "用户 App - 积分记录分页 Request VO" }, "AppPointRecordRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "no": { "type": "string", "description": "流水单号" }, "bizType": { "type": "string", "description": "业务类型编码" }, "status": { "type": "integer", "description": "状态值：1-已获得，2-已使用，3-已撤销，4-已失效", "format": "int32" }, "title": { "type": "string", "description": "积分标题（英文）" }, "description": { "type": "string", "description": "积分描述（英文）" }, "localTitle": { "type": "string", "description": "积分标题（中文）" }, "localDescription": { "type": "string", "description": "积分描述（中文）" }, "point": { "type": "integer", "description": "变动积分", "format": "int32" }, "afterPoint": { "type": "integer", "description": "变动后积分", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "用户 App - 积分记录 Response VO" }, "CommonResultPageResultAppPointRecordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppPointRecordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppPointRecordRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppPointRecordRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppPointRecordCategoryRespVO": { "type": "object", "properties": { "code": { "type": "string", "description": "类型编码" }, "name": { "type": "string", "description": "类型名称" } }, "description": "用户 App - 积分记录类型 Response VO" }, "CommonResultListAppPointRecordCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppPointRecordCategoryRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppPointProductRespVO": { "type": "object", "properties": { "productCode": { "type": "string", "description": "商品编码" }, "name": { "type": "string", "description": "商品名称（英文）" }, "localName": { "type": "string", "description": "商品名称（中文）" }, "productType": { "type": "string", "description": "商品类型编码" }, "pointPrice": { "type": "integer", "description": "所需积分", "format": "int32" }, "stock": { "type": "integer", "description": "库存数量（-1表示无限）", "format": "int32" }, "limitPerUser": { "type": "integer", "description": "每人限兑数量（0表示不限）", "format": "int32" }, "endTime": { "type": "string", "description": "兑换结束时间", "format": "date-time" }, "description": { "type": "string", "description": "商品描述（英文）" }, "localDescription": { "type": "string", "description": "商品描述（中文）" }, "image": { "type": "string", "description": "商品图片" }, "relatedId": { "type": "integer", "description": "关联商品ID（如优惠券模板ID）", "format": "int64" }, "couponInfo": { "$ref": "#/components/schemas/AppCouponRespVO" } }, "description": "用户 App - 积分商品 Response VO" }, "CommonResultPageResultAppPointProductRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppPointProductRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppPointProductRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppPointProductRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAppPointProductRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppPointProductRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppPointProductCategoryRespVO": { "type": "object", "properties": { "code": { "type": "string", "description": "分类编码", "example": "GOODS_COUPON" }, "name": { "type": "string", "description": "分类名称（国际化）", "example": "商品券" } }, "description": "用户 App - 积分商品分类 Response VO" }, "CommonResultListAppPointProductCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppPointProductCategoryRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppPointExchangePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "status": { "type": "integer", "description": "状态", "format": "int32" } }, "description": "用户 App - 积分兑换记录分页 Request VO" }, "AppPointExchangeRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "exchangeNo": { "type": "string", "description": "兑换单号" }, "productName": { "type": "string", "description": "商品名称" }, "productType": { "type": "string", "description": "商品类型编码" }, "pointPrice": { "type": "integer", "description": "消耗积分（单价）", "format": "int32" }, "quantity": { "type": "integer", "description": "兑换数量", "format": "int32" }, "totalPoint": { "type": "integer", "description": "总消耗积分", "format": "int32" }, "status": { "type": "integer", "description": "状态", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "用户 App - 积分兑换记录 Response VO" }, "CommonResultPageResultAppPointExchangeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppPointExchangeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppPointExchangeRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppPointExchangeRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppPointAccountRespVO": { "type": "object", "properties": { "totalPoint": { "type": "integer", "description": "当前总积分", "format": "int32" }, "availablePoint": { "type": "integer", "description": "可用积分", "format": "int32" }, "frozenPoint": { "type": "integer", "description": "冻结积分", "format": "int32" }, "totalEarned": { "type": "integer", "description": "累计获得积分", "format": "int32" }, "totalUsed": { "type": "integer", "description": "累计使用积分", "format": "int32" } }, "description": "用户 App - 积分账户 Response VO" }, "CommonResultAppPointAccountRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppPointAccountRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppCouponPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "status": { "type": "integer", "description": "优惠劵状态:1-未使用,2-已使用,已核销,3-已过期,已作废/已失效", "format": "int32", "example": 1 }, "templateId": { "type": "integer", "description": "优惠劵模板编号", "format": "int64", "example": 1024 }, "code": { "maxLength": 64, "minLength": 0, "type": "string", "description": "优惠劵码", "example": "COUPON001" } }, "description": "用户 App - 优惠劵分页 Request VO" }, "CommonResultPageResultAppCouponRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppCouponRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppCouponRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppCouponRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAppCouponRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppCouponRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultListString": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "type": "string" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppLimitReceiveCouponRespVO": { "type": "object", "properties": { "couponList": { "type": "array", "description": "优惠券列表", "items": { "$ref": "#/components/schemas/AppCouponRespVO" } }, "couponRedemptionCode": { "type": "string", "description": "券兑换码" }, "totalStock": { "type": "integer", "description": "总库存", "format": "int32" }, "receivedCouponNum": { "type": "integer", "description": "已领取数", "format": "int32" }, "todayReceiveCoupon": { "type": "boolean", "description": "今日是否已领取" } }, "description": "用户 App - 限量领券出参 Response VO" }, "CommonResultAppLimitReceiveCouponRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppLimitReceiveCouponRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppPromotionActivityRegRespVO": { "required": [ "code", "createTime", "endTime", "id", "name", "registerable", "registered", "startTime", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "code": { "type": "string", "description": "活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "报名活动名称" }, "description": { "type": "string", "description": "报名说明" }, "startTime": { "type": "string", "description": "报名开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "报名结束时间", "format": "date-time" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "registerable": { "type": "boolean", "description": "是否可报名: true-可以报名, false-不可报名 (条件: 已发布 且 在报名时间内 且 未报名)" }, "registered": { "type": "boolean", "description": "用户是否已报名: true-已报名, false-未报名" }, "startCountdown": { "type": "integer", "description": "距离活动开始倒计时 (毫秒), 若已开始则为 0", "format": "int64" }, "endCountdown": { "type": "integer", "description": "距离活动结束倒计时 (毫秒), 若已结束则为 0", "format": "int64" } }, "description": "用户 APP - 报名活动主 Response VO" }, "AppPromotionLuckyDrawInfoRespVO": { "required": [ "activityReg", "availableChances", "luckyDrawRecords", "prizes", "promotionLucky" ], "type": "object", "properties": { "activityReg": { "$ref": "#/components/schemas/AppPromotionActivityRegRespVO" }, "promotionLucky": { "$ref": "#/components/schemas/AppPromotionLuckyDrawRespVO" }, "prizes": { "type": "array", "description": "奖品列表 (已脱敏)", "items": { "$ref": "#/components/schemas/AppPromotionLuckyDrawPrizeRespVO" } }, "availableChances": { "type": "integer", "description": "用户当前剩余可用抽奖次数", "format": "int32" }, "luckyDrawRecords": { "type": "array", "description": "用户已抽中的奖品列表", "items": { "$ref": "#/components/schemas/AppPromotionLuckyDrawRecordRespVO" } }, "serverTime": { "type": "string", "description": "服务器时间", "format": "date-time" }, "ruleQualifications": { "type": "array", "description": "不同规则获得的资格", "items": { "$ref": "#/components/schemas/AppPromotionLuckyDrawStrategyRespVO" } } }, "description": "用户 APP - 抽奖活动信息" }, "AppPromotionLuckyDrawRecordRespVO": { "required": [ "assetExpirationTime", "createTime", "luckyDrawId", "prizeId", "prizeSnapshotName" ], "type": "object", "properties": { "luckyDrawId": { "type": "string", "description": "关联抽奖活动ID" }, "prizeId": { "type": "integer", "description": "奖品ID", "format": "int64" }, "prizeSnapshotName": { "type": "string", "description": "奖品名称" }, "createTime": { "type": "string", "description": "奖品获得时间", "format": "date-time" }, "assetExpirationTime": { "type": "string", "description": "奖品失效时间", "format": "date-time" } }, "description": "用户 APP - 抽奖记录 Response VO (仅展示中奖信息)" }, "AppPromotionLuckyDrawRespVO": { "required": [ "code", "createTime", "endTime", "id", "name", "regRequired", "registerable", "startTime", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "code": { "type": "string", "description": "抽奖活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "抽奖活动名称" }, "startTime": { "type": "string", "description": "活动开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "活动结束时间", "format": "date-time" }, "prizeDisplayMode": { "type": "integer", "description": "奖品展示模式: 1-抽奖前展示(如大转盘/九宫格), 2-抽奖后揭晓(如盲盒/刮刮乐)", "format": "int32" }, "displayPrizeCount": { "type": "integer", "description": "前端展示奖品数量: 0-展示全部, >0-随机展示N个(需包含中奖项)", "format": "int32" }, "regRequired": { "type": "boolean", "description": "是否强制要求报名: 1-是, 0-否" }, "regActivityId": { "type": "integer", "description": "若强制报名，关联的报名活动ID (promotion_activity_reg.id)", "format": "int64" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "registerable": { "type": "boolean", "description": "用户是否可以参加抽奖活动: true-可以参加, false-不可参加" }, "startCountdown": { "type": "integer", "description": "距离活动开始倒计时 (毫秒), 若已开始则为 0", "format": "int64" }, "endCountdown": { "type": "integer", "description": "距离活动结束倒计时 (毫秒), 若已结束则为 0", "format": "int64" } }, "description": "用户 APP - 抽奖活动 Response VO" }, "AppPromotionLuckyDrawStrategyRespVO": { "type": "object", "properties": { "ruleType": { "type": "string" }, "currentQuota": { "type": "integer", "format": "int64" }, "targerQuota": { "type": "integer", "format": "int64" }, "haveRewardCount": { "type": "integer", "format": "int32" } }, "description": "不同规则获得的资格" }, "CommonResultAppPromotionLuckyDrawInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppPromotionLuckyDrawInfoRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppHomePopupRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64" }, "sceneCode": { "type": "string", "description": "场景编码（前端据此选择样式模板）" }, "title": { "type": "string", "description": "弹窗标题" }, "content": { "type": "string", "description": "弹窗描述文案" }, "highlightContent": { "type": "string", "description": "高亮内容（前端特殊渲染）" }, "contentLink": { "type": "string", "description": "内容区域点击跳转链接" }, "contentRedirectType": { "type": "integer", "description": "内容跳转类型", "format": "int32" }, "buttonText": { "type": "string", "description": "按钮文字" }, "buttonLink": { "type": "string", "description": "按钮点击跳转链接" }, "buttonRedirectType": { "type": "integer", "description": "按钮跳转类型", "format": "int32" }, "iconUrl": { "type": "string", "description": "图标 URL（可选）" }, "displayStrategy": { "type": "string", "description": "展示策略: ALL-全部用户, NEW-仅新用户, OLD-仅老客户" }, "loginShow": { "type": "string", "description": "登录可见性: ALL-不限, NOT_LOGIN-仅未登录展示, LOGGED_IN-仅已登录展示" }, "sort": { "type": "integer", "description": "排序", "format": "int32" } }, "description": "用户 App - 首页底部弹窗 Response VO" }, "CommonResultListAppHomePopupRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppHomePopupRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppCheckDiscountCodeRespVO": { "type": "object", "properties": { "valid": { "type": "boolean", "description": "是否有效" }, "code": { "type": "string", "description": "折扣码" }, "title": { "type": "string", "description": "标题" }, "type": { "type": "string", "description": "优惠类型（PLATFORM_SERVICE_FEE_DISCOUNT-平台服务费）" }, "discountRate": { "type": "string", "description": "折扣比例:比如1,表示1%" }, "sourceId": { "type": "string", "description": "折扣关联ID:用户ID|活动ID" }, "sourceType": { "type": "string", "description": "折扣类型:PROMOTER|PLATFORM" }, "sourceDetail": { "type": "object", "additionalProperties": { "type": "object", "description": "折扣详情" }, "description": "折扣详情" } }, "description": "校验折扣码返回信息" }, "CommonResultAppCheckDiscountCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppCheckDiscountCodeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceWalletWithdrawMethodPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 } }, "description": "用户 APP - 推广联盟用户提现收款方式分页 Request VO" }, "AppAllianceWalletWithdrawMethodRespVO": { "required": [ "accountDetail", "accountType", "accountTypeCode", "createTime", "id", "paymentMethodCode", "paymentMethodName", "paymentMethodType" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 13859 }, "accountType": { "type": "integer", "description": "收款账号类型:1-PayPal, 2-Bank Transfer, 3-RizzitGO Wallet, 4-USDT, 5-Binance", "format": "int32", "example": 1 }, "accountTypeCode": { "type": "string", "description": "收款账号类型编码:PAYPAL, BANK_TRANSFER, RIZZITGO_WALLET, USDT, BINANCE", "example": "PAYPAL" }, "accountNumber": { "type": "string", "description": "收款人账号" }, "accountUsername": { "type": "string", "description": "收款人名称", "example": "李四" }, "accountDetail": { "type": "string", "description": "收款账号详情" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "paymentMethodType": { "type": "integer", "description": "收款账号类型", "format": "int32" }, "paymentMethodName": { "type": "string", "description": "收款方式名称", "example": "微信支付" }, "paymentMethodCode": { "type": "string", "description": "收款方式编码", "example": "WECHAT" }, "paymentMethodIcon": { "type": "string", "description": "收款方式图标" } }, "description": "用户 APP - 推广联盟用户提现收款方式 Response VO" }, "CommonResultPageResultAppAllianceWalletWithdrawMethodRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceWalletWithdrawMethodRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceWalletWithdrawMethodRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceWalletWithdrawMethodRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceWalletRespVO": { "required": [ "balance", "createTime", "freezeAmount", "id", "promoterUnionId", "promoterUserId", "totalBonusAmount", "totalWithdrawAmount" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 8440 }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64", "example": 28 }, "promoterUnionId": { "type": "string", "description": "推广者用户编号", "example": "17315" }, "balance": { "type": "integer", "description": "推广联盟钱包可提现佣金余额，单位分", "format": "int32" }, "freezeAmount": { "type": "integer", "description": "推广联盟钱包提现中/冻结中佣金，单位分", "format": "int32" }, "totalWithdrawAmount": { "type": "integer", "description": "推广联盟钱包累计已提现/已到账佣金，单位分", "format": "int32" }, "totalBonusAmount": { "type": "integer", "description": "推广联盟钱包累计奖励佣金，单位分", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "用户 APP - 会员钱包 Response VO" }, "CommonResultAppAllianceWalletRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceWalletRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultAppAllianceWithdrawRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceWithdrawRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultAppAllianceWalletTransactionRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceWalletTransactionRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceShareGoodsCategoryPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 } }, "description": "用户 APP - 推广者自定义分类分页 Request VO" }, "AppAllianceShareGoodsCategoryRespVO": { "required": [ "code", "createTime", "goodsCount", "id", "promoterUnionId", "promoterUserId", "title" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 8365 }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64", "example": 23628 }, "promoterUnionId": { "type": "string", "description": "推广者 UnionID", "example": "14195" }, "code": { "type": "string", "description": "分类编码" }, "title": { "type": "string", "description": "分类标题" }, "sort": { "type": "integer", "description": "排序，越大越靠前", "format": "int32" }, "goodsCount": { "type": "integer", "description": "关联商品数量", "format": "int64", "example": 10 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "用户 APP - 推广者自定义分类 Response VO" }, "CommonResultPageResultAppAllianceShareGoodsCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceShareGoodsCategoryRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceShareGoodsCategoryRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceShareGoodsCategoryRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultListAppAllianceShareGoodsCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppAllianceShareGoodsCategoryRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultAppAllianceShareGoodsCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceShareGoodsCategoryRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceSocialChannelInfoRespVO": { "type": "object", "properties": { "code": { "type": "string", "description": "社媒渠道编码" }, "name": { "type": "string", "description": "社媒渠道名称" }, "logo": { "type": "string", "description": "社媒渠道Logo" } }, "description": "用户 APP - 社媒渠道信息 Response VO" }, "CommonResultListAppAllianceSocialChannelInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppAllianceSocialChannelInfoRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAffiliatePromoterRespVO": { "type": "object", "properties": { "level": { "type": "integer", "description": "等级", "format": "int32" }, "levelTitle": { "type": "string", "description": "等级名称" }, "levelBonusRate": { "type": "string", "description": "当前等级佣金率" }, "levelStatus": { "type": "boolean", "description": "是否命中当前等级" }, "levelGrowth": { "type": "integer", "description": "等级成长值", "format": "int32" } }, "description": "用户 APP - 推广联盟等级特权信息 Response VO" }, "CommonResultListAppAffiliatePromoterRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppAffiliatePromoterRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAlliancePromoterInfoRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "用户唯一ID" }, "promoterLevel": { "type": "integer", "description": "推广者等级", "format": "int32" }, "bonusRate": { "type": "number", "description": "推广佣金奖励比例" }, "extraBonusRate": { "type": "number", "description": "额外推广佣金奖励比例" }, "avatar": { "type": "string", "description": "推广者头像" }, "nickname": { "type": "string", "description": "推广者昵称" }, "contact": { "type": "string", "description": "推广者联系方式" }, "sda": { "type": "string", "description": "推广者分销码" }, "remark": { "type": "string", "description": "推广者备注信息" }, "status": { "type": "integer", "description": "推广者状态(0-未激活,1-已激活,2-已禁用)", "format": "int32" }, "type": { "type": "integer", "description": "推广者类型:0-KOC,1-KOL", "format": "int32" }, "growth": { "type": "integer", "description": "推广者成长值", "format": "int32" }, "nextLevelGrowth": { "type": "integer", "description": "下一个等级成长值", "format": "int32" }, "biography": { "type": "string", "description": "推广者个人简介" }, "self": { "type": "boolean", "description": "是否为当前登录用户访问" } }, "description": "用户 APP - 推广者信息 Response VO" }, "CommonResultAppAlliancePromoterInfoRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAlliancePromoterInfoRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAlliancePromoterRankRespVO": { "type": "object", "properties": { "userId": { "type": "integer", "description": "用户 ID", "format": "int64", "example": 1001 }, "unionId": { "type": "string", "description": "用户唯一 ID", "example": "abc123xyz" }, "promoterLevel": { "type": "integer", "description": "推广者等级", "format": "int32", "example": 2 }, "avatar": { "type": "string", "description": "推广者头像 URL", "example": "https://example.com/avatar.jpg" }, "nickname": { "type": "string", "description": "推广者昵称", "example": "推广达人001" }, "totalInviteUserCount": { "type": "integer", "description": "总邀请用户数量", "format": "int32", "example": 125 }, "totalCommissionAmount": { "type": "integer", "description": "佣金总金额（单位：分）", "format": "int32", "example": 500000 }, "totalSalesAmount": { "type": "integer", "description": "带货销售总额（单位：分）", "format": "int64", "example": 1200000 } }, "description": "用户 APP - 用户推广者榜单列表 Response VO" }, "CommonResultPageResultAppAlliancePromoterRankRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAlliancePromoterRankRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAlliancePromoterRankRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAlliancePromoterRankRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceProductRankRespVO": { "required": [ "goodsDetailUrl", "goodsId", "goodsPicUrl", "goodsSource", "goodsTitle", "localGoodsTitle", "priceInCents", "salesCount" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "商品标题(本地国内语言)" }, "goodsDetailUrl": { "type": "string", "description": "商品地址" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int32" }, "salesCount": { "type": "string", "description": "商品销售数量" }, "goodsSource": { "type": "integer", "description": "商品来源:1-淘宝,2-阿里巴巴,3-微店", "format": "int32" } }, "description": "用户 APP - 用户推广商品榜单列表 Response VO" }, "CommonResultPageResultAppAllianceProductRankRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceProductRankRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceProductRankRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceProductRankRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceTodayAchievementRespVO": { "type": "object", "properties": { "goodsOrderCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "parcelOrderCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "parcelOrderTotalAmountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "parcelOrderTotalEstimatedCommissionStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "inviteUserCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "pageViewCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "conversionRateStats": { "$ref": "#/components/schemas/AppStatisticsChangeRateRespVO" } }, "description": "用户 APP - 推广者今日推广数据统计 Response VO" }, "AppReportDetailRespVO": { "type": "object", "properties": { "x": { "type": "string" }, "y": { "type": "string" } }, "description": "统计图数据列表" }, "AppStatisticsChangeRateRespVO": { "type": "object", "properties": { "currentRate": { "type": "number", "description": "当前数据", "format": "double", "example": 120 }, "lastRate": { "type": "number", "description": "上一个数据", "format": "double", "example": 120 }, "rateChange": { "type": "number", "description": "具体数据变化", "format": "double", "example": 120 }, "reportList": { "type": "array", "description": "统计图数据列表", "items": { "$ref": "#/components/schemas/AppReportDetailRespVO" } } }, "description": "用户 APP - 邀请用户数据统计 Response VO" }, "AppStatisticsChangeRespVO": { "type": "object", "properties": { "currentCount": { "type": "integer", "description": "当前数据", "format": "int64", "example": 120 }, "lastCount": { "type": "integer", "description": "上一个数据", "format": "int64", "example": 120 }, "countChange": { "type": "integer", "description": "具体数据变化", "format": "int64", "example": 120 }, "countChangeRate": { "type": "number", "description": "环比上一个数据变化(%)", "format": "double", "example": 1.2 }, "reportList": { "type": "array", "description": "统计图数据列表", "items": { "$ref": "#/components/schemas/AppReportDetailRespVO" } } }, "description": "用户 APP - 邀请用户数据统计 Response VO" }, "CommonResultAppAllianceTodayAchievementRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceTodayAchievementRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAlliancePromoterSocialAccountRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "ID", "format": "int64", "example": 1 }, "socialChannelId": { "type": "integer", "description": "社交渠道 ID", "format": "int64", "example": 1 }, "socialChannelCode": { "type": "string", "description": "社交渠道编码", "example": "wechat" }, "socialChannelLogo": { "type": "string", "description": "社交渠道 Logo", "example": "https://example.com/wechat-logo.png" }, "socialChannelAccountUrl": { "type": "string", "description": "社交渠道账号 URL", "example": "https://wechat.com/promoter123" }, "displayOnSharePage": { "type": "boolean", "description": "是否展示到分享页", "example": true } }, "description": "用户 APP - 推广者社交渠道账号 Response VO" }, "CommonResultListAppAlliancePromoterSocialAccountRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppAlliancePromoterSocialAccountRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceProductOrderStatisticsRespVO": { "type": "object", "properties": { "weekOrderCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "weekUserCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "totalUserCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "totalOrderCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" } }, "description": "用户 APP - 代购订单统计 Response VO" }, "CommonResultAppAllianceProductOrderStatisticsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceProductOrderStatisticsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceInviteStatisticsRespVO": { "type": "object", "properties": { "weekInviteUsersStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "totalInviteUserStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "totalInviteOrderUserStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "conversionRateStats": { "$ref": "#/components/schemas/AppStatisticsChangeRateRespVO" } }, "description": "用户 APP - 邀请用户数据统计 Response VO" }, "CommonResultAppAllianceInviteStatisticsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceInviteStatisticsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceShareGoodsPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "keyword": { "type": "string", "description": "搜索关键字" }, "source": { "type": "integer", "description": "商品来源:1-淘宝,2-1688,3-微店", "format": "int32" }, "sort": { "type": "integer", "description": "商品排序:为空表示默认排序,1-按销量倒序排序,2-按价格升序排序,3-按价格倒序排序", "format": "int32" }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码" }, "minGoodsPrice": { "type": "integer", "description": "价格区间:最小价格(单位传人民币:分)", "format": "int64" }, "maxGoodsPrice": { "type": "integer", "description": "价格区间:最大价格(单位传人民币:分)", "format": "int64" } }, "description": "用户 APP - 推广联盟推广者分享商品分页 Request VO" }, "AppAllianceShareGoodsRespVO": { "required": [ "goodsDetailUrl", "goodsId", "goodsPicUrl", "goodsSaleCount", "goodsSource", "goodsTitle", "gooodsCollectStatus", "localGoodsTitle" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID", "example": "25016" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图", "example": "https://www.iocoder.cn" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址", "example": "https://www.iocoder.cn" }, "goodsSaleCount": { "type": "integer", "description": "商品销量", "format": "int32", "example": 26539 }, "goodsViewCount": { "type": "integer", "description": "商品访问量", "format": "int32" }, "goodsSda": { "type": "string", "description": "商品分销码" }, "lastViewTime": { "type": "string", "description": "最近一次访问时间", "format": "date-time" }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接", "nullable": true }, "gooodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码" }, "price": { "type": "string" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64", "example": 5154 } }, "description": "用户 APP - 推广联盟推广者分享商品 Response VO" }, "CommonResultPageResultAppAllianceShareGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceShareGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceShareGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceShareGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceHotSaleGoodsPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "keyword": { "type": "string", "description": "搜索关键字" }, "goodsCategoryCode": { "type": "string", "description": "商品分类编码" }, "source": { "type": "integer", "description": "商品来源", "format": "int32" }, "minGoodsPirce": { "type": "integer", "description": "价格区间:最小价格(单位传人民币:分)", "format": "int64" }, "maxGoodsPirce": { "type": "integer", "description": "价格区间:最大价格(单位传人民币:分)", "format": "int64" } }, "description": "用户 APP - 推广联盟热销商品分页 Request VO" }, "AppAllianceHotSaleGoodsRespVO": { "required": [ "gooodsCollectStatus" ], "type": "object", "properties": { "goodsId": { "type": "string", "description": "商品ID", "example": "15647" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "channelGoodsTitle": { "type": "string", "description": "渠道商品名称" }, "price": { "type": "string", "description": "商品价格", "example": "5154" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图", "example": "https://www.iocoder.cn" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址", "example": "https://www.iocoder.cn" }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接", "nullable": true }, "gooodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64", "example": 5154 }, "salesCount": { "type": "integer", "description": "商品销量", "format": "int32", "example": 28392 } }, "description": "用户 APP - 推广联盟热销商品 Response VO" }, "CommonResultPageResultAppAllianceHotSaleGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAppAllianceHotSaleGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAppAllianceHotSaleGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AppAllianceHotSaleGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "AppAllianceGoodsCategoryRespVO": { "type": "object", "properties": { "title": { "type": "string", "description": "分类标题", "example": "15647" }, "code": { "type": "string", "description": "分类标题", "example": "15647" } }, "description": "用户 APP - 推广联盟热销商品 Response VO" }, "CommonResultListAppAllianceGoodsCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppAllianceGoodsCategoryRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppAllianceParcelStatisticsRespVO": { "type": "object", "properties": { "weekEstimatedCommissionStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "totalEstimatedCommissionStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "weekParcelOrderCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" }, "totalParcelOrderCountStats": { "$ref": "#/components/schemas/AppStatisticsChangeRespVO" } }, "description": "用户 APP - 包裹订单与佣金统计 Response VO" }, "CommonResultAppAllianceParcelStatisticsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppAllianceParcelStatisticsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultAppPromotionActivityRegRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppPromotionActivityRegRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AppRecommendedGoodsRespVO": { "required": [ "discountPriceInCents", "goodsCollectStatus", "price", "priceInCents" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 1024 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格（单位：分）", "example": "20440" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址" }, "goodsCategoryCode": { "type": "string", "description": "商品活动分类编码" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "sort": { "type": "integer", "description": "排序值，数值越大越靠前", "format": "int32" }, "goodsShareShortUrl": { "type": "string", "description": "商品分享短链", "nullable": true }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接", "nullable": true }, "goodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "discountInfo": { "$ref": "#/components/schemas/GoodsDiscountInfoRespDTO" }, "merchantInfo": { "$ref": "#/components/schemas/MerchantInfo" } }, "description": "用户 APP - 推荐商品（广告位）Response VO" }, "CommonResultListAppRecommendedGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppRecommendedGoodsRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "GoodsDiscountInfoRespDTO": { "required": [ "discountPercentage", "discountRate", "discountType" ], "type": "object", "properties": { "discountRate": { "type": "integer", "description": "折扣比例（例如：90 表示 9 折）", "format": "int32" }, "discountType": { "type": "integer", "description": "折扣类型: 1-折扣", "format": "int32" }, "discountPercentage": { "type": "integer", "description": "优惠比例百分比（例如：10 表示优惠了 10%）", "format": "int32" }, "activityType": { "type": "string", "description": "活动类型编码：PLATFORM_DISCOUNT-平台折扣活动，MERCHANT_DISCOUNT-商家折扣活动，NEW_USER_DISCOUNT-新用户折扣活动" } }, "description": "商品优惠折扣信息" }, "MerchantInfo": { "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码", "example": "NIKE" }, "merchantName": { "type": "string", "description": "商家名称", "example": "NIKE官方旗舰店" }, "shopId": { "type": "string", "description": "店铺ID" }, "shopLogo": { "type": "string", "description": "店铺Logo" }, "shopUrl": { "type": "string", "description": "店铺链接" }, "shopSource": { "type": "string", "description": "店铺来源" }, "discountRate": { "type": "integer", "description": "折扣率（例如 90 表示 9 折）", "format": "int32" }, "discountStatus": { "type": "integer", "description": "折扣状态（0-开启，1-关闭）", "format": "int32" }, "merchantSort": { "type": "integer", "description": "商家排序（值越大越靠前）", "format": "int32" }, "merchantDisplayLogo": { "type": "string", "description": "商家对外展示 Logo" }, "merchantDisplayName": { "type": "string", "description": "商家对外展示名称" }, "discountMode": { "type": "integer", "description": "折扣模式：0-平台折扣，1-商家折扣", "format": "int32" }, "jumpShopUrl": { "type": "string", "description": "店铺跳转地址", "example": "https://rizzitgo.com/store-product?shopId=123&source=1" } }, "description": "商家信息" }, "AppPromotionBaseItemRespVO": { "type": "object", "description": "分区数据" }, "AppPromotionSectionRespVO": { "type": "object", "properties": { "sectionId": { "type": "integer", "description": "分区ID", "format": "int64" }, "sectionCode": { "type": "string", "description": "分区编码，例如 TOP5、HOT_SALE、BANNER_HOME" }, "sectionName": { "type": "string", "description": "分区标题，例如 热销商品" }, "sectionType": { "type": "integer", "description": "分区类型：1-商品卡片，2-Banner， 3-商品&banner", "format": "int32" }, "sort": { "type": "integer", "description": "分区排序", "format": "int32" }, "showTitle": { "type": "boolean", "description": "分区是否展示标题" }, "dataList": { "type": "array", "description": "分区数据", "items": { "$ref": "#/components/schemas/AppPromotionBaseItemRespVO" } }, "dateItemCount": { "type": "integer", "description": "分区数量", "format": "int32" }, "extraConfig": { "type": "object", "description": "分区模块扩展字段配置" } } }, "CommonResultListAppPromotionSectionRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AppPromotionSectionRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "BannerRespDTO": { "required": [ "createTime", "imgUrl", "language", "name", "redirectType", "sceneType", "sort", "status", "terminalType" ], "type": "object", "properties": { "name": { "type": "string", "description": "banner名称", "example": "活动" }, "imgUrl": { "type": "string", "description": "图片链接", "example": "https://www.example.com/banner.png" }, "redirectType": { "type": "integer", "description": "跳转类型", "format": "int32", "example": 1 }, "targetLink": { "type": "string", "description": "跳转链接" }, "language": { "type": "string", "description": "语言" }, "terminalType": { "type": "integer", "description": "终端类型", "format": "int32", "example": 31 }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "status": { "type": "integer", "description": "状态（0正常 1停用）", "format": "int32", "example": 0 }, "sceneType": { "type": "string", "description": "页面场景类型（业务场景）", "example": "HOME" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "RPC - Banner Response DTO" }, "CommonResultListBannerRespDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/BannerRespDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivityGoodsItem": { "required": [ "discountPriceInCents", "goodsCollectStatus", "price", "priceInCents" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 1024 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格（单位：分）", "example": "20440" }, "price": { "type": "string", "description": "商品价格（元）" }, "priceInCents": { "type": "integer", "description": "商品价格（分）", "format": "int64" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址" }, "goodsCategoryCode": { "type": "string", "description": "热销商品分类编码" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "goodsShareShortUrl": { "type": "string", "description": "商品分享短链", "nullable": true }, "goodsShareOriginUrl": { "type": "string", "description": "商品分享链接", "nullable": true }, "goodsCollectStatus": { "type": "boolean", "description": "商品收藏状态" }, "sort": { "type": "integer", "description": "排序值，数值越大越靠前", "format": "int32" }, "hasDiscount": { "type": "boolean", "description": "商品SKU 是否享受优惠活动" }, "discountPriceInCents": { "type": "integer", "description": "商品优惠后价格（单位：分）", "format": "int64" }, "discountInfo": { "$ref": "#/components/schemas/GoodsDiscountInfoRespDTO" } }, "description": "活动商品项" }, "AppActivityGoodsByCategoryRespVO": { "type": "object", "properties": { "merchantGoodsList": { "type": "array", "description": "商家商品分组列表", "items": { "$ref": "#/components/schemas/MerchantGoodsGroup" } } }, "description": "用户 APP - 根据分类编码查询活动商品 Response VO" }, "CommonResultAppActivityGoodsByCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AppActivityGoodsByCategoryRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "MerchantGoodsGroup": { "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码", "example": "YOLO" }, "merchantName": { "type": "string", "description": "商家名称", "example": "YOLO商家" }, "shopId": { "type": "string", "description": "店铺ID" }, "shopLogo": { "type": "string", "description": "店铺Logo" }, "shopUrl": { "type": "string", "description": "店铺链接" }, "shopSource": { "type": "string", "description": "店铺来源" }, "discountRate": { "type": "integer", "description": "折扣率（例如 90 表示 9 折）", "format": "int32" }, "discountStatus": { "type": "integer", "description": "折扣状态（0-开启，1-关闭）", "format": "int32" }, "merchantSort": { "type": "integer", "description": "商家排序（值越大越靠前）", "format": "int32" }, "merchantDisplayLogo": { "type": "string", "description": "商家对外展示 Logo" }, "merchantDisplayName": { "type": "string", "description": "商家对外展示名称" }, "discountMode": { "type": "integer", "description": "折扣模式：0-平台折扣，1-商家折扣", "format": "int32" }, "jumpShopUrl": { "type": "string", "description": "店铺跳转地址", "example": "https://rizzitgo.com/store-product?shopId=123&source=1" }, "goodsList": { "type": "array", "description": "该商家的活动商品列表", "items": { "$ref": "#/components/schemas/ActivityGoodsItem" } } }, "description": "商家商品分组" }, "PointRulePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "name": { "type": "string", "description": "规则名称" }, "status": { "type": "integer", "description": "状态: 0-禁用, 1-启用", "format": "int32" } }, "description": "管理后台 - 积分规则分页 Request VO" }, "CommonResultPageResultPointRuleRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPointRuleRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPointRuleRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PointRuleRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PointRuleRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64" }, "name": { "type": "string", "description": "规则名称" }, "status": { "type": "integer", "description": "状态: 0-禁用, 1-启用", "format": "int32" }, "description": { "type": "string", "description": "规则描述" }, "tiers": { "type": "array", "description": "阶梯列表", "items": { "$ref": "#/components/schemas/PointRuleTierVO" } }, "extraConfig": { "$ref": "#/components/schemas/PointRuleExtraConfigVO" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "管理后台 - 积分规则 Response VO" }, "CommonResultPointRuleRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PointRuleRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PointRecordPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "bizType": { "type": "string", "description": "业务类型编码" }, "status": { "type": "integer", "description": "状态：1-已获得，2-已使用，3-已撤销，4-已失效", "format": "int32" }, "title": { "type": "string", "description": "积分标题" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 积分记录分页 Request VO" }, "CommonResultPageResultPointRecordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPointRecordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPointRecordRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PointRecordRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PointRecordRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 1 }, "no": { "type": "string", "description": "流水单号" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "系统会员编号" }, "bizId": { "type": "string", "description": "业务ID" }, "bizType": { "type": "string", "description": "业务类型编码" }, "status": { "type": "integer", "description": "状态值：1-已获得，2-已使用，3-已撤销，4-已失效", "format": "int32" }, "title": { "type": "string", "description": "积分标题" }, "description": { "type": "string", "description": "积分描述" }, "point": { "type": "integer", "description": "变动积分", "format": "int32" }, "beforePoint": { "type": "integer", "description": "变动前积分", "format": "int32" }, "afterPoint": { "type": "integer", "description": "变动后积分", "format": "int32" }, "ruleId": { "type": "integer", "description": "匹配的积分规则ID", "format": "int64" }, "ruleName": { "type": "string", "description": "匹配的积分规则名称" }, "pointRatio": { "type": "number", "description": "匹配的积分倍率" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 积分记录 Response VO" }, "PointProductPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "name": { "type": "string", "description": "商品名称" }, "productType": { "type": "string", "description": "商品类型编码" }, "status": { "type": "integer", "description": "状态", "format": "int32" } }, "description": "管理后台 - 积分商品分页 Request VO" }, "CommonResultPageResultPointProductRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPointProductRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPointProductRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PointProductRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PointProductRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 1 }, "productCode": { "type": "string", "description": "商品编码" }, "name": { "type": "string", "description": "商品名称（英文）" }, "localName": { "type": "string", "description": "商品名称（中文）" }, "productType": { "type": "string", "description": "商品类型编码" }, "pointPrice": { "type": "integer", "description": "所需积分", "format": "int32" }, "relatedId": { "type": "integer", "description": "关联ID", "format": "int64" }, "stock": { "type": "integer", "description": "库存数量", "format": "int32" }, "exchangeCount": { "type": "integer", "description": "已兑换数量", "format": "int32" }, "limitPerUser": { "type": "integer", "description": "每人限兑数量", "format": "int32" }, "status": { "type": "integer", "description": "状态", "format": "int32" }, "startTime": { "type": "string", "description": "兑换开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "兑换结束时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "description": { "type": "string", "description": "商品描述（英文）" }, "localDescription": { "type": "string", "description": "商品描述（中文）" }, "image": { "type": "string", "description": "商品图片" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 积分商品 Response VO" }, "CommonResultPointProductRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PointProductRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PointExchangePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "系统会员编号" }, "userIp": { "type": "string", "description": "用户IP地址" }, "countryCode": { "type": "string", "description": "用户国家编码" }, "countryName": { "type": "string", "description": "用户国家名称" }, "exchangeNo": { "type": "string", "description": "兑换单号" }, "productType": { "type": "string", "description": "商品类型编码" }, "productCode": { "type": "string", "description": "商品编码" }, "productName": { "type": "string", "description": "商品名称（模糊搜索）" }, "status": { "type": "integer", "description": "状态", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 积分兑换记录分页 Request VO" }, "CommonResultPageResultPointExchangeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPointExchangeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPointExchangeRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PointExchangeRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PointExchangeRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 1 }, "exchangeNo": { "type": "string", "description": "兑换单号" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "系统会员编号" }, "userIp": { "type": "string", "description": "用户IP地址" }, "countryCode": { "type": "string", "description": "用户国家编码" }, "countryName": { "type": "string", "description": "用户国家本地名称" }, "productCode": { "type": "string", "description": "积分商品编码" }, "productType": { "type": "string", "description": "商品类型编码" }, "productName": { "type": "string", "description": "商品名称" }, "pointPrice": { "type": "integer", "description": "消耗积分（单价）", "format": "int32" }, "quantity": { "type": "integer", "description": "兑换数量", "format": "int32" }, "totalPoint": { "type": "integer", "description": "总消耗积分", "format": "int32" }, "status": { "type": "integer", "description": "状态", "format": "int32" }, "resultId": { "type": "string", "description": "结果ID" }, "failReason": { "type": "string", "description": "失败原因" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 积分兑换记录 Response VO" }, "CommonResultPointExchangeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PointExchangeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PointAccountPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" } }, "description": "管理后台 - 积分账户分页 Request VO" }, "CommonResultPageResultPointAccountRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPointAccountRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPointAccountRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PointAccountRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PointAccountRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 1 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "系统会员编号" }, "totalPoint": { "type": "integer", "description": "当前总积分", "format": "int32" }, "frozenPoint": { "type": "integer", "description": "冻结积分", "format": "int32" }, "availablePoint": { "type": "integer", "description": "可用积分", "format": "int32" }, "totalEarned": { "type": "integer", "description": "累计获得积分", "format": "int32" }, "totalUsed": { "type": "integer", "description": "累计使用积分", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "管理后台 - 积分账户 Response VO" }, "CommonResultPointAccountRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PointAccountRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionMerchUserDiscountPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "templateId": { "type": "integer", "description": "关联折扣模板ID", "format": "int64" }, "name": { "type": "string", "description": "折扣名称快照" }, "type": { "type": "integer", "description": "折扣类型: 1-比例折扣, 2-固定金额抵扣", "format": "int32" }, "value": { "type": "integer", "description": "折扣数值", "format": "int32" }, "minOrderAmount": { "type": "integer", "description": "门槛金额(分)", "format": "int32" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限(分)", "format": "int32" }, "totalCount": { "type": "integer", "description": "总可用次数(-1无限)", "format": "int32" }, "usedCount": { "type": "integer", "description": "已使用次数", "format": "int32" }, "validStartTime": { "type": "array", "description": "有效开始时间", "items": { "type": "string", "description": "有效开始时间", "format": "date-time" } }, "validEndTime": { "type": "array", "description": "有效结束时间", "items": { "type": "string", "description": "有效结束时间", "format": "date-time" } }, "sourceType": { "type": "integer", "description": "获取来源: 1-抽奖活动, 2-系统发放", "format": "int32" }, "sourceBizId": { "type": "integer", "description": "来源业务ID", "format": "int64" }, "lastUsedOrderId": { "type": "string", "description": "最近使用该折扣的订单号" }, "lastUsedTime": { "type": "array", "description": "最近使用时间", "items": { "type": "string", "description": "最近使用时间", "format": "date-time" } }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 用户平台商品折扣资产分页 Request VO" }, "CommonResultPageResultPromotionMerchUserDiscountRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionMerchUserDiscountRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionMerchUserDiscountRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionMerchUserDiscountRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionMerchUserDiscountRespVO": { "required": [ "createTime", "id", "name", "sourceType", "templateId", "totalCount", "type", "unionId", "usedCount", "userId", "validEndTime", "validStartTime", "value" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "templateId": { "type": "integer", "description": "关联折扣模板ID", "format": "int64" }, "name": { "type": "string", "description": "折扣名称快照" }, "type": { "type": "integer", "description": "折扣类型: 1-比例折扣, 2-固定金额抵扣", "format": "int32" }, "value": { "type": "integer", "description": "折扣数值", "format": "int32" }, "minOrderAmount": { "type": "integer", "description": "门槛金额(分)", "format": "int32" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限(分)", "format": "int32" }, "totalCount": { "type": "integer", "description": "总可用次数(-1无限)", "format": "int32" }, "usedCount": { "type": "integer", "description": "已使用次数", "format": "int32" }, "validStartTime": { "type": "string", "description": "有效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "有效结束时间", "format": "date-time" }, "sourceType": { "type": "integer", "description": "获取来源: 1-抽奖活动, 2-系统发放", "format": "int32" }, "sourceBizId": { "type": "integer", "description": "来源业务ID", "format": "int64" }, "lastUsedOrderId": { "type": "string", "description": "最近使用该折扣的订单号" }, "lastUsedTime": { "type": "string", "description": "最近使用时间", "format": "date-time" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 用户平台商品折扣资产 Response VO" }, "CommonResultPromotionMerchUserDiscountRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionMerchUserDiscountRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionMerchDiscountTemplatePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "name": { "type": "string", "description": "折扣模板名称(如: 双11全场9折)" }, "type": { "type": "integer", "description": "折扣类型: 1-比例折扣, 2-固定金额抵扣", "format": "int32" }, "value": { "type": "integer", "description": "折扣数值: 若类型1，90代表90%(9折); 若类型2，1000代表10元", "format": "int32" }, "minOrderAmount": { "type": "integer", "description": "门槛金额: 单位分，0为无门槛", "format": "int32" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限: 单位分，0为不封顶", "format": "int32" }, "scopeType": { "type": "integer", "description": "适用范围: 0-全场通用, 1-指定分类, 2-指定商品", "format": "int32" }, "scopeTargetIds": { "type": "string", "description": "适用目标ID集合" }, "usageLimitCount": { "type": "integer", "description": "单用户最大使用次数: -1为无限次, 1为仅限1次", "format": "int32" }, "validityType": { "type": "integer", "description": "有效期类型: 1-固定时间段, 2-领取后有效天数", "format": "int32" }, "validStartTime": { "type": "array", "description": "类型1: 固定开始时间", "items": { "type": "string", "description": "类型1: 固定开始时间", "format": "date-time" } }, "validEndTime": { "type": "array", "description": "类型1: 固定结束时间", "items": { "type": "string", "description": "类型1: 固定结束时间", "format": "date-time" } }, "validDays": { "type": "integer", "description": "类型2: 领取后多少天内有效", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 平台商品折扣模板分页 Request VO" }, "CommonResultPageResultPromotionMerchDiscountTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionMerchDiscountTemplateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionMerchDiscountTemplateRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionMerchDiscountTemplateRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionMerchDiscountTemplateRespVO": { "required": [ "createTime", "id", "name", "type", "usageLimitCount", "validityType", "value" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "name": { "type": "string", "description": "折扣模板名称(如: 双11全场9折)" }, "type": { "type": "integer", "description": "折扣类型: 1-比例折扣, 2-固定金额抵扣", "format": "int32" }, "value": { "type": "integer", "description": "折扣数值: 若类型1，90代表90%(9折); 若类型2，1000代表10元", "format": "int32" }, "minOrderAmount": { "type": "integer", "description": "门槛金额: 单位分，0为无门槛", "format": "int32" }, "maxDiscountAmount": { "type": "integer", "description": "最大抵扣上限: 单位分，0为不封顶", "format": "int32" }, "scopeType": { "type": "integer", "description": "适用范围: 0-全场通用, 1-指定分类, 2-指定商品", "format": "int32" }, "scopeTargetIds": { "type": "string", "description": "适用目标ID集合" }, "usageLimitCount": { "type": "integer", "description": "单用户最大使用次数: -1为无限次, 1为仅限1次", "format": "int32" }, "validityType": { "type": "integer", "description": "有效期类型: 1-固定时间段, 2-领取后有效天数", "format": "int32" }, "validStartTime": { "type": "string", "description": "类型1: 固定开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "类型1: 固定结束时间", "format": "date-time" }, "validDays": { "type": "integer", "description": "类型2: 领取后多少天内有效", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 平台商品折扣模板 Response VO" }, "CommonResultPromotionMerchDiscountTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionMerchDiscountTemplateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "code": { "type": "string", "description": "抽奖活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "抽奖活动名称" }, "startTime": { "type": "array", "description": "活动开始时间", "items": { "type": "string", "description": "活动开始时间", "format": "date-time" } }, "endTime": { "type": "array", "description": "活动结束时间", "items": { "type": "string", "description": "活动结束时间", "format": "date-time" } }, "prizeDisplayMode": { "type": "integer", "description": "奖品展示模式: 1-抽奖前展示(如大转盘/九宫格), 2-抽奖后揭晓(如盲盒/刮刮乐)", "format": "int32" }, "displayPrizeCount": { "type": "integer", "description": "前端展示奖品数量: 0-展示全部, >0-随机展示N个(需包含中奖项)", "format": "int32" }, "regRequired": { "type": "boolean", "description": "是否强制要求报名: 1-是, 0-否" }, "regActivityId": { "type": "integer", "description": "若强制报名，关联的报名活动ID (promotion_activity_reg.id)", "format": "int64" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 抽奖活动分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawRespVO": { "required": [ "code", "createTime", "endTime", "id", "name", "regRequired", "startTime", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "code": { "type": "string", "description": "抽奖活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "抽奖活动名称" }, "startTime": { "type": "string", "description": "活动开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "活动结束时间", "format": "date-time" }, "prizeDisplayMode": { "type": "integer", "description": "奖品展示模式: 1-抽奖前展示(如大转盘/九宫格), 2-抽奖后揭晓(如盲盒/刮刮乐)", "format": "int32" }, "displayPrizeCount": { "type": "integer", "description": "前端展示奖品数量: 0-展示全部, >0-随机展示N个(需包含中奖项)", "format": "int32" }, "regRequired": { "type": "boolean", "description": "是否强制要求报名: 1-是, 0-否" }, "regActivityId": { "type": "integer", "description": "若强制报名，关联的报名活动ID (promotion_activity_reg.id)", "format": "int64" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 抽奖活动 Response VO" }, "CommonResultPromotionLuckyDrawRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawWalletPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "totalGainedCount": { "type": "integer", "description": "累计获得的次数(历史总和)", "format": "int32" }, "totalConsumedCount": { "type": "integer", "description": "累计消耗的次数(已抽奖次数)", "format": "int32" }, "availableCount": { "type": "integer", "description": "当前可用次数", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 用户抽奖活动-次数钱包分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawWalletRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawWalletRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawWalletRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawWalletRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawWalletRespVO": { "required": [ "availableCount", "createTime", "id", "luckyDrawId", "totalConsumedCount", "totalGainedCount", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "totalGainedCount": { "type": "integer", "description": "累计获得的次数(历史总和)", "format": "int32" }, "totalConsumedCount": { "type": "integer", "description": "累计消耗的次数(已抽奖次数)", "format": "int32" }, "availableCount": { "type": "integer", "description": "当前可用次数", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 用户抽奖活动-次数钱包 Response VO" }, "CommonResultPromotionLuckyDrawWalletRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawWalletRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawUserVisitPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "独立用户ID", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "totalVisitCount": { "type": "integer", "description": "独立用户访问活动的总次数", "format": "int32" }, "lastVisitIp": { "type": "string", "description": "最后一次访问IP地址" }, "lastEventMeta": { "type": "string", "description": "最后一次访问的来源埋点" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 抽奖活动用户访问统计分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawUserVisitRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawUserVisitRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawUserVisitRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawUserVisitRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawUserVisitRespVO": { "required": [ "createTime", "id", "luckyDrawId", "totalVisitCount", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "独立用户ID", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "totalVisitCount": { "type": "integer", "description": "独立用户访问活动的总次数", "format": "int32" }, "lastVisitIp": { "type": "string", "description": "最后一次访问IP地址" }, "lastEventMeta": { "type": "string", "description": "最后一次访问的来源埋点" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 抽奖活动用户访问统计 Response VO" }, "CommonResultPromotionLuckyDrawUserVisitRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawUserVisitRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawSpecialUserPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "prizeId": { "type": "integer", "description": "中奖的奖品ID", "format": "int64" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "prizeName": { "type": "string", "description": "中奖的奖品名称（冗余显示）", "example": "王五" }, "remark": { "type": "string", "description": "备注", "example": "你说的对" } }, "description": "管理后台 - 抽奖活动-特殊用户配置分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawSpecialUserRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawSpecialUserRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawSpecialUserRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawSpecialUserRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawSpecialUserRespVO": { "required": [ "createTime", "id", "luckyDrawId", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "prizeId": { "type": "integer", "description": "中奖的奖品ID", "format": "int64" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "prizeName": { "type": "string", "description": "中奖的奖品名称（冗余显示）", "example": "王五" }, "remark": { "type": "string", "description": "备注", "example": "你说的对" } }, "description": "管理后台 - 抽奖活动-特殊用户配置 Response VO" }, "CommonResultPromotionLuckyDrawSpecialUserRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawSpecialUserRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawRecordPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 6309 }, "unionId": { "type": "string", "description": "会员编号(冗余)", "example": "19806" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64", "example": 19465 }, "prizeId": { "type": "integer", "description": "中奖的奖品ID, 未中奖可为空", "format": "int64", "example": 4580 }, "prizeSnapshotName": { "type": "string", "description": "奖品名称快照", "example": "李四" }, "won": { "type": "boolean", "description": "是否中奖" }, "assetStatus": { "type": "integer", "description": "资产发放状态: 0-待发放, 1-发放成功, 2-发放失败", "format": "int32", "example": 1 }, "assetId": { "type": "string", "description": "发放后的资产ID(如 discount_id)", "example": "21328" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 用户抽奖活动-抽奖结果记录分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawRecordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawRecordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawRecordRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawRecordRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawRecordRespVO": { "required": [ "createTime", "id", "luckyDrawId", "unionId", "userId", "won" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64", "example": 26151 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 6309 }, "unionId": { "type": "string", "description": "会员编号(冗余)", "example": "19806" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64", "example": 19465 }, "prizeId": { "type": "integer", "description": "中奖的奖品ID, 未中奖可为空", "format": "int64", "example": 4580 }, "prizeSnapshotName": { "type": "string", "description": "奖品名称快照", "example": "李四" }, "won": { "type": "boolean", "description": "是否中奖" }, "assetStatus": { "type": "integer", "description": "资产发放状态: 0-待发放, 1-发放成功, 2-发放失败", "format": "int32", "example": 1 }, "assetId": { "type": "string", "description": "发放后的资产ID(如 discount_id)", "example": "21328" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 用户抽奖活动-抽奖结果记录 Response VO" }, "CommonResultPromotionLuckyDrawRecordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawRecordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawPrizePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "name": { "type": "string", "description": "奖品对外展示名称" }, "prizeType": { "type": "string", "description": "奖品类型: 例如: PLATFORM_DISCOUNT, PLATFORM_COUPON, FORWARDER_DISCOUNT, FORWARDER_COUPON, PHYSICAL, NO_PRIZE" }, "templateId": { "type": "integer", "description": "关联模板ID (如：商品折扣关联 promotion_merch_discount_template)", "format": "int64" }, "winProbability": { "type": "integer", "description": "中奖概率(基点): 10000代表100%", "format": "int32" }, "stockLimit": { "type": "boolean", "description": "是否限制库存: 1-是(扣减库存), 0-否(无限量)" }, "totalStock": { "type": "integer", "description": "总库存: 若不限库存，此字段无意义或仅作展示", "format": "int32" }, "currentStock": { "type": "integer", "description": "当前剩余库存: 若不限库存，此字段不参与扣减逻辑", "format": "int32" }, "fixedDisplay": { "type": "boolean", "description": "是否固定显示(返回的奖品清单是否始终包含该奖品)" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 抽奖活动-奖品配置分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawPrizeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawPrizeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawPrizeRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawPrizeRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawPrizeRespVO": { "required": [ "createTime", "currentStock", "fixedDisplay", "id", "luckyDrawId", "name", "prizeType", "stockLimit", "totalStock", "winProbability" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "name": { "type": "string", "description": "奖品对外展示名称" }, "prizeType": { "type": "string", "description": "奖品类型: 例如: PLATFORM_DISCOUNT, PLATFORM_COUPON, FORWARDER_DISCOUNT, FORWARDER_COUPON, PHYSICAL, NO_PRIZE" }, "templateId": { "type": "integer", "description": "关联模板ID (如：商品折扣关联 promotion_merch_discount_template)", "format": "int64" }, "winProbability": { "type": "integer", "description": "中奖概率(基点): 10000代表100%", "format": "int32" }, "stockLimit": { "type": "boolean", "description": "是否限制库存: 1-是(扣减库存), 0-否(无限量)" }, "totalStock": { "type": "integer", "description": "总库存: 若不限库存，此字段无意义或仅作展示", "format": "int32" }, "currentStock": { "type": "integer", "description": "当前剩余库存: 若不限库存，此字段不参与扣减逻辑", "format": "int32" }, "fixedDisplay": { "type": "boolean", "description": "是否固定显示(返回的奖品清单是否始终包含该奖品)" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 抽奖活动-奖品配置 Response VO" }, "CommonResultPromotionLuckyDrawPrizeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawPrizeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawChanceRulePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "name": { "type": "string", "description": "规则名称" }, "type": { "type": "string", "description": "规则类型标识: DEFAULT_FREE-无门槛, ACTIVITY_REGISTERED-关联报名, RECHARGE_AMOUNT-充值金额" }, "config": { "type": "string", "description": "规则配置(JSON)" }, "chancesAwarded": { "type": "integer", "description": "满足规则后赠送的次数", "format": "int32" }, "maxCountPerUser": { "type": "integer", "description": "单用户该规则最大获取次数", "format": "int32" }, "startTime": { "type": "array", "description": "规则约束业务的开始时间", "items": { "type": "string", "description": "规则约束业务的开始时间", "format": "date-time" } }, "endTime": { "type": "array", "description": "规则约束业务的结束时间", "items": { "type": "string", "description": "规则约束业务的结束时间", "format": "date-time" } }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 抽奖机会获取规则分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawChanceRuleRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawChanceRuleRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawChanceRuleRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawChanceRuleRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawChanceRuleRespVO": { "required": [ "chancesAwarded", "createTime", "id", "luckyDrawId", "maxCountPerUser", "name", "type" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "name": { "type": "string", "description": "规则名称" }, "type": { "type": "string", "description": "规则类型标识: DEFAULT_FREE-无门槛, ACTIVITY_REGISTERED-关联报名, RECHARGE_AMOUNT-充值金额" }, "config": { "type": "string", "description": "规则配置(JSON)" }, "chancesAwarded": { "type": "integer", "description": "满足规则后赠送的次数", "format": "int32" }, "maxCountPerUser": { "type": "integer", "description": "单用户该规则最大获取次数", "format": "int32" }, "startTime": { "type": "string", "description": "规则约束业务的开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "规则约束业务的结束时间", "format": "date-time" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 抽奖机会获取规则 Response VO" }, "CommonResultPromotionLuckyDrawChanceRuleRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawChanceRuleRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawChanceLogPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "changeType": { "type": "integer", "description": "变动类型: 1-增加, 2-扣减", "format": "int32" }, "changeCount": { "type": "integer", "description": "变动数量", "format": "int32" }, "reasonCode": { "type": "string", "description": "变动原因: DEFAULT_FREE, SHARE_REWARD, USE_DRAW" }, "ruleId": { "type": "integer", "description": "关联抽奖机会获取规则ID", "format": "int64" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 用户抽奖活动-次数流水分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawChanceLogRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawChanceLogRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawChanceLogRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawChanceLogRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawChanceLogRespVO": { "required": [ "changeCount", "changeType", "createTime", "id", "luckyDrawId", "reasonCode", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "changeType": { "type": "integer", "description": "变动类型: 1-增加, 2-扣减", "format": "int32" }, "changeCount": { "type": "integer", "description": "变动数量", "format": "int32" }, "reasonCode": { "type": "string", "description": "变动原因: DEFAULT_FREE, SHARE_REWARD, USE_DRAW" }, "ruleId": { "type": "integer", "description": " @ExcelProperty(\"关联抽奖机会获取规则ID\")\n", "format": "int64" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 用户抽奖活动-次数流水 Response VO" }, "CommonResultPromotionLuckyDrawChanceLogRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawChanceLogRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionLuckyDrawChanceItemPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "ruleId": { "type": "integer", "description": "关联抽奖机会获取规则ID", "format": "int64" }, "gainedTime": { "type": "array", "description": "机会获取时间", "items": { "type": "string", "description": "机会获取时间", "format": "date-time" } }, "expirationTime": { "type": "array", "description": "机会过期时间 (由机会获取规则计算生成)", "items": { "type": "string", "description": "机会过期时间 (由机会获取规则计算生成)", "format": "date-time" } }, "status": { "type": "integer", "description": "状态: 0-未使用, 1-已使用", "format": "int32" }, "consumedLogId": { "type": "integer", "description": "关联的扣减流水ID (promotion_lucky_draw_chance_log.id)", "format": "int64" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 用户抽奖机会凭证分页 Request VO" }, "CommonResultPageResultPromotionLuckyDrawChanceItemRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionLuckyDrawChanceItemRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionLuckyDrawChanceItemRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionLuckyDrawChanceItemRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionLuckyDrawChanceItemRespVO": { "required": [ "createTime", "expirationTime", "gainedTime", "id", "luckyDrawId", "ruleId", "status", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "luckyDrawId": { "type": "integer", "description": "关联抽奖活动ID", "format": "int64" }, "ruleId": { "type": "integer", "description": "关联抽奖机会获取规则ID", "format": "int64" }, "gainedTime": { "type": "string", "description": "机会获取时间", "format": "date-time" }, "expirationTime": { "type": "string", "description": "机会过期时间 (由机会获取规则计算生成)", "format": "date-time" }, "status": { "type": "integer", "description": "状态: 0-未使用, 1-已使用", "format": "int32" }, "consumedLogId": { "type": "integer", "description": "关联的扣减流水ID (promotion_lucky_draw_chance_log.id)", "format": "int64" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 用户抽奖机会凭证 Response VO" }, "CommonResultPromotionLuckyDrawChanceItemRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionLuckyDrawChanceItemRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSellerPageReqVO": { "required": [ "endTime", "pageNo", "pageSize", "startTime" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "startTime": { "type": "string", "description": "开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "结束时间", "format": "date-time" }, "platformChannel": { "type": "integer", "description": "平台渠道", "format": "int32", "example": 1 }, "statusList": { "type": "array", "description": "订单状态列表（为空时使用默认有效订单口径）", "example": [ 201, 301 ], "items": { "type": "integer", "description": "订单状态列表（为空时使用默认有效订单口径）", "format": "int32" } }, "sortField": { "type": "string", "description": "排序字段: salesCount / itemCount / salesAmount", "example": "salesCount" }, "sortAsc": { "type": "boolean", "description": "是否升序", "example": false }, "amountField": { "type": "string", "description": "金额口径字段: actual_price / price / write_price", "example": "actual_price" }, "sellerGroupMode": { "type": "string", "description": "卖家分组模式: shop / shop_platform", "example": "shop_platform" }, "shopName": { "type": "string", "description": "店铺名称搜索", "example": "某某店铺" } }, "description": "管理后台 - 热销卖家分页 Request VO" }, "CommonResultPageResultHotSellerRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultHotSellerRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotSellerRespVO": { "type": "object", "properties": { "rank": { "type": "integer", "description": "排名", "format": "int32" }, "shopId": { "type": "string", "description": "店铺ID" }, "shopName": { "type": "string", "description": "店铺名称" }, "localShopName": { "type": "string", "description": "店铺中文名称" }, "platformChannel": { "type": "integer", "description": "平台渠道", "format": "int32" }, "itemCount": { "type": "integer", "description": "订单明细数", "format": "int64" }, "salesCount": { "type": "integer", "description": "销量", "format": "int64" }, "salesAmount": { "type": "integer", "description": "销售金额（分）", "format": "int64" } }, "description": "管理后台 - 热销卖家 Response VO" }, "PageResultHotSellerRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/HotSellerRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "HotGoodsPageReqVO": { "required": [ "endTime", "pageNo", "pageSize", "startTime" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "startTime": { "type": "string", "description": "开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "结束时间", "format": "date-time" }, "platformChannel": { "type": "integer", "description": "平台渠道", "format": "int32", "example": 1 }, "statusList": { "type": "array", "description": "订单状态列表（为空时使用默认有效订单口径）", "example": [ 201, 301 ], "items": { "type": "integer", "description": "订单状态列表（为空时使用默认有效订单口径）", "format": "int32" } }, "sortField": { "type": "string", "description": "排序字段: salesCount / itemCount / salesAmount", "example": "salesCount" }, "sortAsc": { "type": "boolean", "description": "是否升序", "example": false }, "amountField": { "type": "string", "description": "金额口径字段: actual_price / price / write_price", "example": "actual_price" }, "goodsName": { "type": "string", "description": "商品名称搜索", "example": "某某商品" } }, "description": "管理后台 - 热销商品分页 Request VO" }, "CommonResultPageResultHotGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultHotGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HotGoodsRespVO": { "type": "object", "properties": { "rank": { "type": "integer", "description": "排名", "format": "int32" }, "goodsId": { "type": "string", "description": "商品ID" }, "goodsName": { "type": "string", "description": "商品名称" }, "localGoodsName": { "type": "string", "description": "商品中文名称" }, "imagePath": { "type": "string", "description": "商品主图" }, "goodsLinks": { "type": "string", "description": "商品链接" }, "platformChannel": { "type": "integer", "description": "平台渠道", "format": "int32" }, "salesCount": { "type": "integer", "description": "销量", "format": "int64" }, "itemCount": { "type": "integer", "description": "订单明细数", "format": "int64" }, "salesAmount": { "type": "integer", "description": "销售金额（分）", "format": "int64" } }, "description": "管理后台 - 热销商品 Response VO" }, "PageResultHotGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/HotGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "HomeSearchKeywordPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "keyword": { "type": "string", "description": "实际搜索词" }, "status": { "type": "integer", "description": "状态: 0-启用, 1-停用", "format": "int32" }, "terminalType": { "type": "integer", "description": "终端类型", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 首页搜索热词分页 Request VO" }, "CommonResultPageResultHomeSearchKeywordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultHomeSearchKeywordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HomeSearchKeywordRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "自增ID", "format": "int64" }, "keyword": { "type": "string", "description": "实际搜索词" }, "displayKeyword": { "type": "string", "description": "展示给用户的关键词" }, "action": { "type": "integer", "description": "关键词类型: 1-搜索关键词, 2-跳转URL", "format": "int32" }, "actionData": { "type": "string", "description": "关键词对应值" }, "terminalType": { "type": "integer", "description": "终端类型: 0-ALL, 20-H5, 21-PC, 31-APP, 3120-APP_H5", "format": "int32" }, "validStart": { "type": "string", "description": "上架时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "下架时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "status": { "type": "integer", "description": "状态: 0-启用, 1-停用", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 首页搜索热词 Response VO" }, "PageResultHomeSearchKeywordRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/HomeSearchKeywordRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultHomeSearchKeywordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/HomeSearchKeywordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HomePopupPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "name": { "type": "string", "description": "弹窗名称" }, "sceneCode": { "type": "string", "description": "场景编码" }, "status": { "type": "integer", "description": "状态: 0-启用, 1-停用", "format": "int32" }, "terminalType": { "type": "integer", "description": "终端类型", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 首页底部弹窗分页 Request VO" }, "CommonResultPageResultHomePopupRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultHomePopupRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "HomePopupRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "自增ID", "format": "int64" }, "name": { "type": "string", "description": "运营备注名称" }, "title": { "type": "string", "description": "弹窗标题" }, "content": { "type": "string", "description": "弹窗描述文案" }, "highlightContent": { "type": "string", "description": "高亮内容（前端特殊渲染）" }, "contentLink": { "type": "string", "description": "内容区域点击跳转链接" }, "contentRedirectType": { "type": "integer", "description": "内容跳转类型", "format": "int32" }, "buttonText": { "type": "string", "description": "按钮文字" }, "buttonLink": { "type": "string", "description": "按钮点击跳转链接" }, "buttonRedirectType": { "type": "integer", "description": "按钮跳转类型", "format": "int32" }, "iconUrl": { "type": "string", "description": "图标 URL" }, "sceneCode": { "type": "string", "description": "场景编码" }, "displayStrategy": { "type": "string", "description": "展示策略: ALL-全部, NEW-新用户, OLD-老用户" }, "loginShow": { "type": "string", "description": "登录可见性: ALL-不限, NOT_LOGIN-仅未登录展示, LOGGED_IN-仅已登录展示" }, "terminalType": { "type": "integer", "description": "终端类型: 0-ALL, 20-H5, 21-PC, 31-APP, 3120-APP_H5", "format": "int32" }, "validStart": { "type": "string", "description": "上架时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "下架时间", "format": "date-time" }, "sort": { "type": "integer", "description": "排序", "format": "int32" }, "status": { "type": "integer", "description": "状态: 0-启用, 1-停用", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 首页底部弹窗 Response VO" }, "PageResultHomePopupRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/HomePopupRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultHomePopupRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/HomePopupRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "templateId": { "type": "integer", "description": "优惠劵模板编号", "format": "int64", "example": 7488 }, "name": { "type": "string", "description": "优惠劵名", "example": "李四" }, "userId": { "type": "integer", "description": "用户编号", "format": "int64", "example": 8405 }, "useOrderId": { "type": "integer", "description": "使用订单号", "format": "int64", "example": 16453 }, "code": { "type": "string", "description": "优惠券券码" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "status": { "type": "integer", "description": "优惠码状态 : 1-未使用,2-已使用,3-已核销,4-已失效", "format": "int32", "example": 1 }, "takeType": { "type": "integer", "description": "领取类型:1 - 用户主动领取,2 - 后台自动发放 , 3-新人券注册自动发放", "format": "int32", "example": 1 }, "validType": { "type": "integer", "description": "优惠券生效类型 : 1-固定日期,2-领取后多少天", "format": "int32", "example": 1 }, "discountType": { "type": "integer", "description": "折扣类型 : 1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 1 }, "useTime": { "type": "array", "description": "使用时间", "items": { "type": "string", "description": "使用时间", "format": "date-time" } }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 优惠劵分页 Request VO" }, "CommonResultPageResultCouponRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCouponRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponRespVO": { "required": [ "code", "createTime", "discountType", "id", "name", "status", "takeType", "templateId", "usageAmountScope", "usageCountryScope", "usageRouteScope", "usageWarehouseScope", "usePrice", "userId", "validEndTime", "validStartTime" ], "type": "object", "properties": { "id": { "type": "integer", "description": "优惠劵编号", "format": "int64", "example": 19847 }, "templateId": { "type": "integer", "description": "优惠劵模板编号", "format": "int64", "example": 7488 }, "name": { "type": "string", "description": "优惠劵名", "example": "李四" }, "userId": { "type": "integer", "description": "用户编号", "format": "int64", "example": 8405 }, "usePrice": { "type": "integer", "description": "是否设置满多少金额可用，单位：分", "format": "int32", "example": 8211 }, "validStartTime": { "type": "string", "description": "生效开始时间", "format": "date-time" }, "validEndTime": { "type": "string", "description": "生效结束时间", "format": "date-time" }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32" }, "discountPrice": { "type": "integer", "description": "优惠金额，单位：分", "format": "int32", "example": 18697 }, "discountLimitPrice": { "type": "integer", "description": "折扣上限", "format": "int32", "example": 30802 }, "useOrderId": { "type": "integer", "description": "使用订单号", "format": "int64", "example": 16453 }, "useTime": { "type": "string", "description": "使用时间", "format": "date-time" }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32" }, "usageWarehouseCodes": { "type": "string", "description": "可使用的仓库编码列表" }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32" }, "usageRouteCodes": { "type": "string", "description": "可使用的路线编码列表" }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32" }, "usageCountryCodes": { "type": "string", "description": "可使用的国家编码列表" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "code": { "type": "string", "description": "优惠券券码" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "status": { "type": "integer", "description": "优惠码状态 : 1-未使用,2-已使用,3-已核销,4-已失效", "format": "int32", "example": 1 }, "takeType": { "type": "integer", "description": "领取类型:1 - 用户主动领取,2 - 后台自动发放 , 3-新人券注册自动发放", "format": "int32", "example": 1 }, "validType": { "type": "integer", "description": "优惠券生效类型 : 1-固定日期,2-领取后多少天", "format": "int32", "example": 1 }, "discountType": { "type": "integer", "description": "折扣类型 : 1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 1 }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32" }, "usageAmountCodes": { "type": "string", "description": "可使用的费用类型编码列表" }, "isAllowedStackable": { "type": "boolean", "description": "优惠券是否支持叠加使用" } }, "description": "管理后台 - 优惠劵 Response VO" }, "PageResultCouponRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CouponRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultCouponRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CouponRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponTemplatePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "id": { "type": "integer", "description": "模板编号", "format": "int64", "example": 1 }, "name": { "type": "string", "description": "优惠劵名", "example": "赵六" }, "status": { "type": "integer", "description": "状态", "format": "int32", "example": 2 }, "takeType": { "type": "integer", "description": "领取方式", "format": "int32", "example": 2 }, "usageWarehouseScope": { "type": "integer", "description": "可使用仓库范围:1-不限仓库,2-指定仓库,3-排除指定仓库", "format": "int32" }, "usageRouteScope": { "type": "integer", "description": "可使用路线范围:1-不限路线,2-指定路线,3-排除指定路线", "format": "int32" }, "usageCountryScope": { "type": "integer", "description": "可使用国家范围:1-不限国家,2-指定国家,3-排除指定国家", "format": "int32" }, "usageMerchantScope": { "type": "integer", "description": "可使用商家范围:1-不限商家,2-指定商家,3-排除指定商家", "format": "int32" }, "couponType": { "type": "integer", "description": "优惠劵类型:1-运费券,2-商品券,3-全场券", "format": "int32", "example": 1 }, "usageAmountScope": { "type": "integer", "description": "可使用费用范围:1-不限费用类型,2-指定费用类型,3-排除指定费用类型", "format": "int32" }, "discountType": { "type": "integer", "description": "优惠类型：1-代金卷(满元减)；2-折扣卷(满元折) ", "format": "int32", "example": 2 }, "sceneId": { "type": "integer", "description": "优惠券模板场景ID", "format": "int64", "example": 1 }, "usePrice": { "type": "integer", "description": "使用门槛(单位:分)", "format": "int32", "example": 1000 }, "discountPrice": { "type": "integer", "description": "优惠金额(单位:分)", "format": "int32", "example": 500 }, "discountPercent": { "type": "integer", "description": "折扣百分比", "format": "int32", "example": 50 }, "remark": { "type": "string", "description": "备注", "example": "测试" } }, "description": "管理后台 - 优惠劵模板分页 Request VO" }, "CommonResultPageResultCouponTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCouponTemplateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultCouponTemplateRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CouponTemplateRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CouponTemplateReqVO": { "type": "object", "properties": { "ids": { "type": "array", "description": "ids", "example": "赵六", "items": { "type": "integer", "description": "ids", "format": "int64" } } }, "description": "管理后台 - 优惠劵模板分页 Request VO" }, "CommonResultListCouponTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/CouponTemplateRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultCouponTemplateRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CouponTemplateRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponTemplateScenePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "sceneCode": { "type": "string", "description": "场景编码，例如 NEW_USER-新人券, FESTIVAL_XMAS-圣诞节券" }, "sceneName": { "type": "string", "description": "场景名称，例如 新人专属, 圣诞节专属", "example": "李四" }, "description": { "type": "string", "description": "场景描述/备注", "example": "你说的对" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "remark": { "type": "string", "description": "备注信息", "example": "随便" } }, "description": "管理后台 - 优惠券模板场景分页 Request VO" }, "CommonResultPageResultCouponTemplateSceneRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCouponTemplateSceneRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultCouponTemplateSceneRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CouponTemplateSceneRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultCouponTemplateSceneRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CouponTemplateSceneRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponExchangeLogPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "code": { "type": "string", "description": "兑换码" }, "couponTemplateId": { "type": "integer", "description": "关联的优惠券模板ID", "format": "int64", "example": 3288 }, "userId": { "type": "integer", "description": "使用用户ID", "format": "int64", "example": 25075 }, "usedTime": { "type": "array", "description": "使用时间", "items": { "type": "string", "description": "使用时间", "format": "date-time" } }, "source": { "type": "integer", "description": "兑换码来源(1:后台生成,2:第三方渠道)", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "couponCode": { "type": "string", "description": "关联的优惠券编码" }, "exchangeStatus": { "type": "integer", "description": "兑换状态(1-待兑换,2-兑换成功,3-兑换失败)", "format": "int32", "example": 1 }, "exchangeFailCode": { "type": "string", "description": "兑换失败异常状态码" }, "exchangeFailTime": { "type": "array", "description": "兑换失败时间", "items": { "type": "string", "description": "兑换失败时间", "format": "date-time" } }, "userIp": { "type": "string", "description": "用户IP" }, "countryCode": { "type": "string", "description": "国家编码" }, "localCountryName": { "type": "string", "description": "国家名称" } }, "description": "管理后台 - 优惠券兑换记录分页 Request VO" }, "CommonResultPageResultCouponExchangeLogRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCouponExchangeLogRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponExchangeLogRespVO": { "required": [ "code", "couponCode", "couponTemplateId", "createTime", "exchangeStatus", "id", "source", "usedTime", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "自增ID", "format": "int64", "example": 29117 }, "code": { "type": "string", "description": "兑换码" }, "couponTemplateId": { "type": "integer", "description": "关联的优惠券模板ID", "format": "int64", "example": 3288 }, "userId": { "type": "integer", "description": "使用用户ID", "format": "int64", "example": 25075 }, "usedTime": { "type": "string", "description": "使用时间", "format": "date-time" }, "source": { "type": "integer", "description": "兑换码来源(1:后台生成,2:第三方渠道)", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "couponCode": { "type": "string", "description": "关联的优惠券编码" }, "exchangeStatus": { "type": "integer", "description": "兑换状态(1-待兑换,2-兑换成功,3-兑换失败)", "format": "int32", "example": 1 }, "exchangeFailCode": { "type": "string", "description": "兑换失败异常状态码" }, "exchangeFailReason": { "type": "string", "description": "兑换失败原因", "example": "不香" }, "exchangeFailTime": { "type": "string", "description": "兑换失败时间", "format": "date-time" }, "userIp": { "type": "string", "description": "用户IP" }, "countryCode": { "type": "string", "description": "国家编码" }, "localCountryName": { "type": "string", "description": "国家名称" } }, "description": "管理后台 - 优惠券兑换记录 Response VO" }, "PageResultCouponExchangeLogRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CouponExchangeLogRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultCouponExchangeLogRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CouponExchangeLogRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultPageResultCouponExchangeCodeShortLinkRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCouponExchangeCodeShortLinkRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponExchangeCodeShortLinkRespVO": { "type": "object", "properties": { "id": { "type": "integer", "description": "短链记录ID", "format": "int64" }, "originalUrl": { "type": "string", "description": "原始链接" }, "shortLinkKey": { "type": "string", "description": "短链Key" }, "shortLinkUrl": { "type": "string", "description": "短链完整URL" }, "effective": { "type": "boolean", "description": "是否有效" }, "saveClickRecord": { "type": "boolean", "description": "是否保存点击记录" }, "remark": { "type": "string", "description": "备注" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "rno": { "type": "string", "description": "RNO(从原始链接解析)" }, "environment": { "type": "string", "description": "环境(从原始链接解析)" }, "clickCount": { "type": "integer", "description": "点击量(预留)", "format": "int64" } }, "description": "管理后台 - 兑换码短链投放记录 Response VO" }, "PageResultCouponExchangeCodeShortLinkRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CouponExchangeCodeShortLinkRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CouponExchangeCodePageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "code": { "type": "string", "description": "兑换码" }, "couponTemplateId": { "type": "integer", "description": "关联的优惠券模板ID", "format": "int64", "example": 20218 }, "businessName": { "type": "string" }, "validStart": { "type": "string", "description": "有效期开始时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "有效期结束时间", "format": "date-time" }, "maxUsage": { "type": "integer", "description": "最大使用次数", "format": "int32" }, "usedCount": { "type": "integer", "description": "已使用次数", "format": "int32", "example": 2004 }, "source": { "type": "integer", "description": "兑换码来源(1:后台生成,2:第三方渠道)", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "status": { "type": "integer", "description": "状态(1:未使用,2:已使用,3:已作废)", "format": "int32", "example": 2 }, "sceneCode": { "type": "string", "description": "场景编码" }, "grantMode": { "type": "string", "description": "发放模式: ALL-全部发放, RANDOM_ONE-随机发放一张" } }, "description": "管理后台 - 优惠券兑换码分页 Request VO" }, "CommonResultPageResultCouponExchangeCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultCouponExchangeCodeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CouponExchangeCodeRespVO": { "required": [ "businessName", "code", "couponTemplateId", "couponTemplateIds", "createTime", "id", "maxUsage", "source", "status", "takeLimitCount", "usedCount", "validEnd", "validStart" ], "type": "object", "properties": { "id": { "type": "integer", "description": "自增ID", "format": "int64", "example": 4629 }, "businessName": { "type": "string", "description": "业务名称" }, "code": { "type": "string", "description": "兑换码" }, "couponTemplateId": { "type": "integer", "description": "关联的优惠券模板ID", "format": "int64", "example": 20218 }, "couponTemplateIds": { "type": "string", "description": "关联的优惠券模板IDs", "example": "20218" }, "validStart": { "type": "string", "description": "有效期开始时间", "format": "date-time" }, "validEnd": { "type": "string", "description": "有效期结束时间", "format": "date-time" }, "takeLimitCount": { "type": "integer", "description": "每人限领个数, -1 - 则表示不限制", "format": "int32" }, "maxUsage": { "type": "integer", "description": "最大使用次数", "format": "int32" }, "usedCount": { "type": "integer", "description": "已使用次数", "format": "int32", "example": 2004 }, "source": { "type": "integer", "description": "兑换码来源(1:后台生成,2:第三方渠道)", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "status": { "type": "integer", "description": "状态(1:未使用,2:已使用,3:已作废)", "format": "int32", "example": 2 }, "sceneCode": { "type": "string", "description": "场景编码", "example": "SHIPPING_ESTIMATE" }, "grantMode": { "type": "string", "description": "发放模式: ALL-全部发放, RANDOM_ONE-随机发放一张", "example": "ALL" }, "grantRule": { "type": "string", "description": "发放规则(JSON)" }, "dailyTakeLimitCount": { "type": "integer", "description": "单用户每日限兑次数, -1 不限制", "format": "int32" }, "dailyIpLimitCount": { "type": "integer", "description": "单IP每日限兑次数, -1 不限制", "format": "int32" } }, "description": "管理后台 - 优惠券兑换码 Response VO" }, "PageResultCouponExchangeCodeRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/CouponExchangeCodeRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultCouponExchangeCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/CouponExchangeCodeRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AllianceWalletWithdrawPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "no": { "type": "string", "description": "申请提现单号" }, "userId": { "type": "integer", "description": "申请提现用户ID", "format": "int64", "example": 29058 }, "unionId": { "type": "string", "description": "申请提现会员编号", "example": "28563" }, "receiverAccount": { "type": "string", "description": "申请提现收款账户", "example": "9815" }, "receiverAccountChannel": { "type": "string", "description": "申请提现收款账户渠道" }, "applyAmount": { "type": "integer", "description": "本次申请提现金额(单位:分)", "format": "int32" }, "receivedAmount": { "type": "integer", "description": "提现最终到账金额(单位:分)", "format": "int32" }, "status": { "type": "integer", "description": "提现状态:10-发起提现申请,20-提现成功,30-提现拒绝,40-提现失败", "format": "int32", "example": 1 }, "walletTransactionId": { "type": "integer", "description": "钱包流水ID", "format": "int64", "example": 29636 }, "remark": { "type": "string", "description": "备注信息", "example": "随便" }, "transferRate": { "type": "string", "description": "本次提现转账汇率" }, "transferStatus": { "type": "integer", "description": "财务转账状态:0-待转账,1-已转账,2-转账失败,3-已关闭", "format": "int32", "example": 2 }, "transferAmount": { "type": "integer", "description": "财务转账金额(单位:分)", "format": "int32" }, "transferReceiverAccount": { "type": "string", "description": "财务转账收款账号", "example": "1972" }, "transferReceiverAccountChannel": { "type": "string", "description": "财务转账收款账号渠道" }, "transferRemark": { "type": "string", "description": "财务转账备注", "example": "你猜" }, "reviewStatus": { "type": "integer", "description": "审核状态:0-待审核,1-审核通过,2-审核拒绝", "format": "int32", "example": 2 }, "reviewUserId": { "type": "integer", "description": "审核用户ID", "format": "int64", "example": 24345 }, "reviewRejectReason": { "type": "string", "description": "审核不通过原因", "example": "不对" }, "transferUserId": { "type": "integer", "description": "转账人用户ID", "format": "int64", "example": 28895 }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 推广联盟用户提现记录分页 Request VO" }, "AllianceWalletWithdrawRespVO": { "required": [ "createTime", "id", "unionId", "updateTime", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9572 }, "no": { "type": "string", "description": "申请提现单号" }, "userId": { "type": "integer", "description": "申请提现用户ID", "format": "int64", "example": 29058 }, "unionId": { "type": "string", "description": "申请提现会员编号", "example": "28563" }, "receiverAccount": { "type": "string", "description": "申请提现收款账户", "example": "9815" }, "receiverAccountChannel": { "type": "string", "description": "申请提现收款账户渠道" }, "applyAmount": { "type": "integer", "description": "本次申请提现金额(单位:分)", "format": "int32" }, "receivedAmount": { "type": "integer", "description": "提现最终到账金额(单位:分)", "format": "int32" }, "status": { "type": "integer", "description": "提现状态:10-发起提现申请,20-提现成功,30-提现拒绝,40-提现失败", "format": "int32", "example": 1 }, "walletTransactionId": { "type": "integer", "description": "钱包流水ID", "format": "int64", "example": 29636 }, "remark": { "type": "string", "description": "备注信息", "example": "随便" }, "transferRate": { "type": "string", "description": "本次提现转账汇率" }, "transferStatus": { "type": "integer", "description": "财务转账状态:0-待转账,1-已转账,2-转账失败,3-已关闭", "format": "int32", "example": 2 }, "transferAmount": { "type": "integer", "description": "财务转账金额(单位:分)", "format": "int32" }, "transferReceiverAccount": { "type": "string", "description": "财务转账收款账号", "example": "1972" }, "transferReceiverAccountChannel": { "type": "string", "description": "财务转账收款账号渠道" }, "transferRemark": { "type": "string", "description": "财务转账备注", "example": "你猜" }, "reviewStatus": { "type": "integer", "description": "审核状态:0-待审核,1-审核通过,2-审核拒绝", "format": "int32", "example": 2 }, "reviewUserId": { "type": "integer", "description": "审核用户ID", "format": "int64", "example": 24345 }, "reviewRejectReason": { "type": "string", "description": "审核不通过原因", "example": "不对" }, "transferUserId": { "type": "integer", "description": "转账人用户ID", "format": "int64", "example": 28895 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" }, "transferBankNo": { "type": "string", "description": "财务转账银行单号" }, "transferImageUrls": { "type": "array", "description": "财务转账截图", "items": { "type": "string", "description": "财务转账截图" } }, "transferFailedReason": { "type": "string", "description": "转账失败/异常原因" }, "reviewUpdateTime": { "type": "string", "description": "审核更新时间", "format": "date-time" }, "transferUpdateTime": { "type": "string", "description": "转账更新时间", "format": "date-time" } }, "description": "管理后台 - 推广联盟用户提现记录 Response VO" }, "CommonResultPageResultAllianceWalletWithdrawRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAllianceWalletWithdrawRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAllianceWalletWithdrawRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AllianceWalletWithdrawRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAllianceWalletWithdrawRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AllianceWalletWithdrawRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AlliancePromoterTrendCompareReqVO": { "required": [ "dateRange", "promoterIds" ], "type": "object", "properties": { "promoterIds": { "maxItems": 30, "minItems": 0, "type": "array", "description": "推广者ID列表", "example": [ 1, 2, 3 ], "items": { "type": "integer", "description": "推广者ID列表", "format": "int64" } }, "dateRange": { "type": "array", "description": "时间范围", "items": { "type": "string", "description": "时间范围", "format": "date-time" } } }, "description": "管理后台 - 推广者数据趋势对比 Request VO" }, "AlliancePromoterTrendCompareRespVO": { "type": "object", "properties": { "dates": { "type": "array", "description": "X轴日期列表", "example": [ "2026-02-01", "2026-02-02" ], "items": { "type": "string", "description": "X轴日期列表", "example": "[\"2026-02-01\",\"2026-02-02\"]" } }, "promoters": { "type": "array", "description": "每个推广者的趋势数据", "items": { "$ref": "#/components/schemas/PromoterTrendVO" } } }, "description": "管理后台 - 推广者数据趋势对比 Response VO" }, "CommonResultAlliancePromoterTrendCompareRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AlliancePromoterTrendCompareRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "DailyTrendStatVO": { "type": "object", "properties": { "date": { "type": "string", "description": "日期", "example": "2026-02-01" }, "inviteUserCount": { "type": "integer", "description": "邀请用户数", "format": "int64" }, "daigouOrderCount": { "type": "integer", "description": "代购订单数", "format": "int64" }, "bagOrderCount": { "type": "integer", "description": "包裹订单数", "format": "int64" }, "daigouOrderAmount": { "type": "integer", "description": "代购订单金额（单位：分）", "format": "int64" }, "bagOrderAmount": { "type": "integer", "description": "包裹订单金额（单位：分）", "format": "int64" }, "activeUserCount": { "type": "integer", "description": "激活用户数", "format": "int64" }, "orderRechargeAmount": { "type": "integer", "description": "订单充值金额（单位：分）", "format": "int64" }, "shippingRechargeAmount": { "type": "integer", "description": "运费充值金额（单位：分）", "format": "int64" }, "rechargeAmount": { "type": "integer", "description": "充值总金额（单位：分）", "format": "int64" } }, "description": "管理后台 - 每日趋势统计 VO" }, "PromoterTrendVO": { "type": "object", "properties": { "promoterId": { "type": "integer", "description": "推广者ID", "format": "int64", "example": 1024 }, "nickname": { "type": "string", "description": "推广者昵称", "example": "王五" }, "avatar": { "type": "string", "description": "推广者头像" }, "sda": { "type": "string", "description": "推广者分销码" }, "contact": { "type": "string", "description": "推广者联系方式" }, "unionId": { "type": "string", "description": "推广者会员编号" }, "totalInviteUserCount": { "type": "integer", "description": "时间段内邀请用户总数", "format": "int64" }, "totalDaigouOrderCount": { "type": "integer", "description": "时间段内代购订单总数", "format": "int64" }, "totalBagOrderCount": { "type": "integer", "description": "时间段内包裹订单总数", "format": "int64" }, "totalDaigouOrderAmount": { "type": "integer", "description": "时间段内代购订单总金额（单位：分）", "format": "int64" }, "totalBagOrderAmount": { "type": "integer", "description": "时间段内包裹订单总金额（单位：分）", "format": "int64" }, "totalActiveUserCount": { "type": "integer", "description": "时间段内激活用户总数", "format": "int64" }, "totalOrderRechargeAmount": { "type": "integer", "description": "时间段内订单充值金额（单位：分）", "format": "int64", "example": 100000 }, "totalShippingRechargeAmount": { "type": "integer", "description": "时间段内运费充值金额（单位：分）", "format": "int64", "example": 50000 }, "totalRechargeAmount": { "type": "integer", "description": "时间段内充值总金额（单位：分）", "format": "int64", "example": 150000 }, "dailyStats": { "type": "array", "description": "每日趋势数据", "items": { "$ref": "#/components/schemas/DailyTrendStatVO" } } }, "description": "管理后台 - 推广者趋势数据 VO" }, "PromoterInviteStatisticsReqVO": { "type": "object", "properties": { "unionId": { "type": "string", "description": "微信UnionID", "example": "oxaA11ulr9134MPbhKjXrsp-84-A" }, "invitationCode": { "type": "string", "description": "邀请码", "example": "ABC123" }, "createTime": { "type": "array", "description": "创建时间范围", "items": { "type": "string", "description": "创建时间范围", "format": "date-time" } }, "groupId": { "type": "integer", "description": "分组ID", "format": "int64", "example": 1 } }, "description": "用户 App - 推广者邀请统计查询 Request VO" }, "CommonResultListPromoterInviteStatisticsDTO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/PromoterInviteStatisticsDTO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromoterInviteStatisticsDTO": { "type": "object", "properties": { "invitationCode": { "type": "string" }, "inviteCount": { "type": "integer", "format": "int64" }, "nickname": { "type": "string" }, "userId": { "type": "integer", "format": "int64" }, "unionId": { "type": "string" }, "mark": { "type": "string" } } }, "AlliancePromoterPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 28476 }, "unionId": { "type": "string", "description": "用户唯一ID", "example": "29722" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "sda": { "type": "string", "description": "推广者分销码" }, "promoterLevel": { "type": "integer", "description": "推广者等级(默认1级推广者)", "format": "int32" }, "bonusRate": { "type": "number", "description": "推广佣金奖励比例,填写:0.04" }, "bonusType": { "type": "integer", "description": "佣金类型(1-按成长等级阶梯比例, 2-固定比例佣金)", "format": "int32" }, "status": { "type": "integer", "description": "推广者状态(0-未激活,1-已激活,2-已禁用)", "format": "int32", "example": 2 }, "avatar": { "type": "string", "description": "推广者头像地址" }, "nickname": { "type": "string", "description": "推广者昵称", "example": "王五" }, "contact": { "type": "string", "description": "推广者联系方式" }, "remark": { "type": "string", "description": "推广者备注信息", "example": "你猜" }, "type": { "type": "integer", "description": "推广者类型:0-KOC,1-KOL", "format": "int32" }, "groupId": { "type": "integer", "description": "分组ID", "format": "int64", "example": 1 } }, "description": "管理后台 - 推广联盟推广者信息分页 Request VO" }, "AlliancePromoterRespVO": { "required": [ "bonusType", "createTime", "id", "promoterLevel", "status", "updateTime" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 24588 }, "userId": { "type": "integer", "description": "用户ID", "format": "int64", "example": 28476 }, "unionId": { "type": "string", "description": "用户唯一ID", "example": "29722" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "sda": { "type": "string", "description": "推广者分销码" }, "promoterLevel": { "type": "integer", "description": "推广者等级(默认1级推广者)", "format": "int32" }, "bonusRate": { "type": "number", "description": "推广佣金奖励比例,填写:0.04" }, "bonusType": { "type": "integer", "description": "佣金类型(1-按成长等级阶梯比例, 2-固定比例佣金)", "format": "int32" }, "status": { "type": "integer", "description": "推广者状态(0-未激活,1-已激活,2-已禁用)", "format": "int32", "example": 2 }, "avatar": { "type": "string", "description": "推广者头像地址" }, "nickname": { "type": "string", "description": "推广者昵称", "example": "王五" }, "contact": { "type": "string", "description": "推广者联系方式" }, "remark": { "type": "string", "description": "推广者备注信息", "example": "你猜" }, "type": { "type": "integer", "description": "推广者类型:0-KOC,1-KOL", "format": "int32" }, "balance": { "type": "integer", "description": "当前可提现余额，单位分", "format": "int32" }, "freezeAmount": { "type": "integer", "description": "冻结金额，单位分", "format": "int32" }, "totalWithdrawAmount": { "type": "integer", "description": "累计提现佣金，单位分", "format": "int32" }, "totalBonusAmount": { "type": "integer", "description": "累计奖励佣金，单位分", "format": "int32" }, "totalDaigouOrderCount": { "type": "integer", "description": "代购订单数量", "format": "int64" }, "totalBagOrderCount": { "type": "integer", "description": "累计订单数量", "format": "int64" }, "totalInviteUserCount": { "type": "integer", "description": "累计邀请用户数量", "format": "int64" }, "totalActiveUserCount": { "type": "integer", "description": "累计激活用户数量", "format": "int64" }, "totalDaigouOrderAmount": { "type": "integer", "description": "代购订单销售额，单位分", "format": "int64" }, "totalBagOrderAmount": { "type": "integer", "description": "包裹订单销售额，单位分", "format": "int64" }, "updateTime": { "type": "string", "description": "最后更新时间", "format": "date-time" }, "monthlyRechargeBalance": { "type": "string", "description": "每月余额充值金额" }, "monthlyFreeShippingKg": { "type": "string", "description": "每月免费运输公斤" }, "contractStartTime": { "type": "string", "description": "签约合作时间", "format": "date-time" }, "groupIds": { "type": "array", "description": "绑定的分组ID列表", "items": { "type": "integer", "description": "绑定的分组ID列表", "format": "int64" } } }, "description": "管理后台 - 推广联盟推广者信息 Response VO" }, "CommonResultPageResultAlliancePromoterRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAlliancePromoterRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAlliancePromoterRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AlliancePromoterRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAlliancePromoterRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AlliancePromoterRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AlliancePromoterGrowthLevelPageReqVO": { "required": [ "pageNo", "pageSize", "status" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "level": { "type": "integer", "description": "等级数值，从1开始递增", "format": "int32" }, "levelTitle": { "type": "string", "description": "等级名称，例如 Enthusiast" }, "levelBonusRate": { "type": "number", "description": "分成比例，百分数形式，例如 4.00 表示 4%" }, "levelGrowth": { "type": "integer", "description": "达到该等级所需成长值", "format": "int32" }, "status": { "type": "integer", "description": "等级是否启用：0-启用，1-禁用", "format": "int32", "example": 2 }, "sort": { "type": "integer", "description": "排序值，越小越靠前", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 推广者等级配置分页 Request VO" }, "AlliancePromoterGrowthLevelRespVO": { "required": [ "id", "level", "levelBonusRate", "levelGrowth", "levelTitle", "sort", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 22508 }, "level": { "type": "integer", "description": "等级数值，从1开始递增", "format": "int32" }, "levelTitle": { "type": "string", "description": "等级名称，例如 Enthusiast" }, "levelBonusRate": { "type": "number", "description": "分成比例，百分数形式，例如 4.00 表示 4%" }, "levelGrowth": { "type": "integer", "description": "达到该等级所需成长值", "format": "int32" }, "status": { "type": "integer", "description": "等级是否启用：0-启用，1-禁用", "format": "int32", "example": 2 }, "sort": { "type": "integer", "description": "排序值，越小越靠前", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 推广者等级配置 Response VO" }, "CommonResultPageResultAlliancePromoterGrowthLevelRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAlliancePromoterGrowthLevelRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAlliancePromoterGrowthLevelRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AlliancePromoterGrowthLevelRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultListAlliancePromoterGrowthLevelRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/AlliancePromoterGrowthLevelRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultAlliancePromoterGrowthLevelRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AlliancePromoterGrowthLevelRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AlliancePromoterGroupPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "groupName": { "type": "string", "description": "分组名称", "example": "王五" }, "description": { "type": "string", "description": "分组描述", "example": "你说的对" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 推广者分组信息分页 Request VO" }, "AlliancePromoterGroupRespVO": { "required": [ "createTime", "groupName", "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "分组ID", "format": "int64", "example": 30189 }, "groupName": { "type": "string", "description": "分组名称", "example": "王五" }, "description": { "type": "string", "description": "分组描述", "example": "你说的对" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 推广者分组信息 Response VO" }, "CommonResultPageResultAlliancePromoterGroupRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAlliancePromoterGroupRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAlliancePromoterGroupRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AlliancePromoterGroupRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAlliancePromoterGroupRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AlliancePromoterGroupRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AlliancePromoterGroupRelPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "promoterId": { "type": "integer", "description": "推广者ID", "format": "int64", "example": 8343 }, "groupId": { "type": "integer", "description": "分组ID", "format": "int64", "example": 2657 }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 推广者-分组关联分页 Request VO" }, "AlliancePromoterGroupRelRespVO": { "required": [ "createTime", "groupId", "id", "promoterId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 5734 }, "promoterId": { "type": "integer", "description": "推广者ID", "format": "int64", "example": 8343 }, "groupId": { "type": "integer", "description": "分组ID", "format": "int64", "example": 2657 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 推广者-分组关联 Response VO" }, "CommonResultPageResultAlliancePromoterGroupRelRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAlliancePromoterGroupRelRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAlliancePromoterGroupRelRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AlliancePromoterGroupRelRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAlliancePromoterGroupRelRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AlliancePromoterGroupRelRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AllianceInviteUsersPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "inviteUserSda": { "type": "string", "description": "被邀请者填写的分销码" }, "inviteUserUnionId": { "type": "string", "description": "被邀请者用户唯一编号", "example": "7319" }, "inviteUserId": { "type": "integer", "description": "被邀请者用户ID", "format": "int64", "example": 14524 }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64", "example": 10726 }, "promoterUnionId": { "type": "string", "description": "推广者用户唯一编号", "example": "31588" }, "sda": { "type": "string", "description": "推广者分销码" }, "bagOrderCount": { "type": "integer", "description": "累计提包订单数量(通过定时任务统计)", "format": "int32", "example": 3960 }, "bagOrderStatus": { "type": "boolean", "description": "用户是否发生过提包", "example": false } }, "description": "管理后台 - 推广联盟邀请用户记录分页 Request VO" }, "AllianceInviteUsersRespVO": { "required": [ "avgBagOrderAmount", "bagOrderCount", "bagOrderStatus", "createTime", "id", "inviteUserSda", "inviteUserUnionId", "promoterUserId", "totalBagOrderAmount" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 2060 }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "inviteUserSda": { "type": "string", "description": "被邀请者填写的分销码" }, "inviteUserUnionId": { "type": "string", "description": "被邀请者用户唯一编号", "example": "7319" }, "inviteUserId": { "type": "integer", "description": "被邀请者用户ID", "format": "int64", "example": 14524 }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64", "example": 10726 }, "promoterUnionId": { "type": "string", "description": "推广者用户唯一编号", "example": "31588" }, "sda": { "type": "string", "description": "推广者分销码" }, "bagOrderCount": { "type": "integer", "description": "累计提包订单数量(通过定时任务统计)", "format": "int32", "example": 3960 }, "totalBagOrderAmount": { "type": "integer", "description": "累计提包订单金额", "format": "int32", "example": 3960 }, "avgBagOrderAmount": { "type": "string", "description": "平均提单订单客单价", "example": "3960" }, "bagOrderStatus": { "type": "boolean", "description": "用户是否发生过提包", "example": false }, "promoterUserNickname": { "type": "string", "description": "推广者昵称" }, "inviteUserNickname": { "type": "string", "description": "邀请者昵称" }, "promoterUserAvatar": { "type": "string", "description": "推广者头像" }, "inviteUserAvatar": { "type": "string", "description": "邀请者头像" }, "purchaseOrderCount": { "type": "integer", "description": "代购订单数量", "format": "int32" }, "totalPurchaseOrderAmount": { "type": "integer", "description": "代购订单总额", "format": "int32" }, "avgPurchaseOrderAmount": { "type": "string", "description": "代购订单平均客单价" }, "promoterUserEmail": { "type": "string", "description": "推广者邮箱" }, "inviteUserEmail": { "type": "string", "description": "邀请者邮箱" } }, "description": "管理后台 - 推广联盟邀请用户记录 Response VO" }, "CommonResultPageResultAllianceInviteUsersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAllianceInviteUsersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAllianceInviteUsersRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AllianceInviteUsersRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAllianceInviteUsersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AllianceInviteUsersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "AllianceBagOrdersPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "bagOrderUserUnionId": { "type": "string", "description": "提包订单用户唯一编号", "example": "18117" }, "bagOrderSda": { "type": "string", "description": "提报订单分销码" }, "bagOrderNo": { "type": "string", "description": "提包订单号" }, "bagOrderTotalAmount": { "type": "integer", "description": "提包总支付金额(单位:分)", "format": "int64" }, "bagOrderCreateTime": { "type": "array", "description": "提包时间", "items": { "type": "string", "description": "提包时间", "format": "date-time" } }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "settlementStatus": { "type": "integer", "description": "结算状态: 0-待结算, 1-结算中, 2-已结算", "format": "int32" } }, "description": "管理后台 - 推广联盟提包订单记录分页 Request VO" }, "AllianceBagOrdersRespVO": { "required": [ "bagOrderCreateTime", "bagOrderNo", "bagOrderSda", "bagOrderTotalAmount", "bagOrderTotalCommissionAmount", "bagOrderUserUnionId", "createTime", "id", "updateTime" ], "type": "object", "properties": { "id": { "type": "integer", "description": "编号", "format": "int64", "example": 9735 }, "bagOrderUserUnionId": { "type": "string", "description": "提包订单用户唯一编号", "example": "18117" }, "bagOrderSda": { "type": "string", "description": "提报订单分销码" }, "bagOrderNo": { "type": "string", "description": "提包订单号" }, "bagOrderTotalAmount": { "type": "integer", "description": "提包总支付金额(单位:分)", "format": "int64" }, "bagOrderCreateTime": { "type": "string", "description": "提包时间", "format": "date-time" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" }, "bagOrderPromoterLevel": { "type": "integer", "description": "当前提包订单推广者等级", "format": "int32" }, "bagOrderBonusRate": { "type": "number", "description": "当前提包订单佣金比例" }, "bagOrderExtraBonusRate": { "type": "number", "description": "当前提包订单额外佣金比例" }, "bagOrderBonusAmount": { "type": "integer", "description": "当前提包订单佣金(单位:分)", "format": "int32" }, "bagOrderExtraBonusAmount": { "type": "integer", "description": "当前提包订单额外奖励佣金(单位:分)", "format": "int32" }, "settlementTime": { "type": "string", "description": "佣金结算时间", "format": "date-time" }, "settlementStatus": { "type": "integer", "description": "结算状态: 0-待结算, 1-结算中, 2-已结算, 3-不支持结算", "format": "int32" }, "unsettleReason": { "type": "string", "description": "不支持结算原因，仅当结算状态为3时有值" }, "promoterUserId": { "type": "integer", "description": "推广者用户ID", "format": "int64" }, "promoterUnionId": { "type": "string", "description": "推广者用户编号" }, "bagOrderTotalCommissionAmount": { "type": "integer", "description": "提包总奖励佣金(单位:分)", "format": "int32" } }, "description": "管理后台 - 推广联盟提包订单记录 Response VO" }, "CommonResultPageResultAllianceBagOrdersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultAllianceBagOrdersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultAllianceBagOrdersRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/AllianceBagOrdersRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultAllianceBagOrdersRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/AllianceBagOrdersRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivitySectionPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "sectionCode": { "type": "string", "description": "分区编码，例如 TOP5、HOT_SALE、BANNER_HOME", "example": "HOT_SALE" }, "sectionName": { "type": "string", "description": "分区中文名称，例如 热销商品", "example": "热销商品" }, "sectionType": { "type": "integer", "description": "分区类型：1-商品卡片，2-Banner， 3-商品&banner", "format": "int32", "example": 1 }, "sort": { "type": "integer", "description": "分区排序，值越小越靠前", "format": "int32", "example": 0 }, "merchantCode": { "type": "string", "description": "商家编码，用于区分不同商家促销页", "example": "MERCHANT001" }, "remark": { "type": "string", "description": "备注信息", "example": "这是一个热销商品分区" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 促销页分区配置分页 Request VO" }, "ActivitySectionRespVO": { "required": [ "createTime", "id", "sectionCode", "updateTime" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 31573 }, "sectionCode": { "type": "string", "description": "分区编码，例如 TOP5、HOT_SALE、BANNER_HOME", "example": "HOT_SALE" }, "sectionName": { "type": "string", "description": "分区中文名称，例如 热销商品", "example": "热销商品" }, "sectionType": { "type": "integer", "description": "分区类型：1-商品卡片，2-Banner， 3-商品&banner", "format": "int32", "example": 1 }, "sort": { "type": "integer", "description": "分区排序，值越小越靠前", "format": "int32", "example": 0 }, "merchantCode": { "type": "string", "description": "商家编码，用于区分不同商家促销页", "example": "MERCHANT001" }, "remark": { "type": "string", "description": "备注信息", "example": "这是一个热销商品分区" }, "extraConfig": { "type": "string", "description": "拓展信息" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "管理后台 - 促销页分区配置 Response VO" }, "CommonResultPageResultActivitySectionRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultActivitySectionRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultActivitySectionRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/ActivitySectionRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultListActivitySectionRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ActivitySectionRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "CommonResultActivitySectionRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivitySectionRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivitySectionBatchConfigRespVO": { "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码", "example": "MERCHANT001" }, "sections": { "type": "array", "description": "分区配置列表", "items": { "$ref": "#/components/schemas/SectionConfigItem" } } }, "description": "管理后台 - 促销页分区批量配置 Response VO" }, "CommonResultActivitySectionBatchConfigRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivitySectionBatchConfigRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivitySectionItemPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "sectionId": { "type": "integer", "description": "所属分区ID", "format": "int64", "example": 1 }, "itemType": { "maximum": 4, "minimum": 1, "type": "integer", "description": "内容类型：1-商品，2-banner组件2，3-banner组件3，4-banner组件4", "format": "int32", "example": 1 }, "sort": { "type": "integer", "description": "排序值，值越小越靠前", "format": "int32", "example": 1 }, "merchantCode": { "maxLength": 64, "minLength": 0, "type": "string", "description": "商家编码，方便查询隔离", "example": "MERCHANT_001" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 分区内容项分页 Request VO" }, "ActivitySectionItemRespVO": { "required": [ "createTime", "id", "itemData", "itemType", "sectionId", "updateTime" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 1024 }, "sectionId": { "type": "integer", "description": "所属分区ID", "format": "int64", "example": 1 }, "itemType": { "type": "integer", "description": "内容类型：1-商品，2-banner组件2，3-banner组件3，4-banner组件4", "format": "int32", "example": 1 }, "itemData": { "type": "string", "description": "内容 JSON 数据，结构根据 item_type 而不同" }, "sort": { "type": "integer", "description": "排序值，值越小越靠前", "format": "int32", "example": 1 }, "merchantCode": { "type": "string", "description": "商家编码，方便查询隔离", "example": "MERCHANT_001" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" } }, "description": "管理后台 - 分区内容项 Response VO" }, "CommonResultPageResultActivitySectionItemRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultActivitySectionItemRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultActivitySectionItemRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/ActivitySectionItemRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultActivitySectionItemRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivitySectionItemRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionActivityRegPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "code": { "type": "string", "description": "活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "报名活动名称" }, "description": { "type": "string", "description": "报名说明" }, "startTime": { "type": "array", "description": "报名开始时间", "items": { "type": "string", "description": "报名开始时间", "format": "date-time" } }, "endTime": { "type": "array", "description": "报名结束时间", "items": { "type": "string", "description": "报名结束时间", "format": "date-time" } }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 报名活动主分页 Request VO" }, "CommonResultPageResultPromotionActivityRegRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionActivityRegRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionActivityRegRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionActivityRegRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionActivityRegRespVO": { "required": [ "code", "createTime", "endTime", "id", "name", "startTime", "status" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "code": { "type": "string", "description": "活动编码(大写, 业务唯一)" }, "name": { "type": "string", "description": "报名活动名称" }, "description": { "type": "string", "description": "报名说明" }, "startTime": { "type": "string", "description": "报名开始时间", "format": "date-time" }, "endTime": { "type": "string", "description": "报名结束时间", "format": "date-time" }, "status": { "type": "integer", "description": "状态: 0-草稿, 1-已发布, 2-关闭", "format": "int32" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 报名活动主 Response VO" }, "CommonResultPromotionActivityRegRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionActivityRegRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PromotionActivityRegRecordPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "regActivityId": { "type": "integer", "description": "关联报名活动ID", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "regTime": { "type": "array", "description": "实际报名时间", "items": { "type": "string", "description": "实际报名时间", "format": "date-time" } }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 用户报名记录分页 Request VO" }, "CommonResultPageResultPromotionActivityRegRecordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultPromotionActivityRegRecordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultPromotionActivityRegRecordRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/PromotionActivityRegRecordRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "PromotionActivityRegRecordRespVO": { "required": [ "createTime", "id", "regActivityId", "regTime", "unionId", "userId" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键", "format": "int64" }, "regActivityId": { "type": "integer", "description": "关联报名活动ID", "format": "int64" }, "userId": { "type": "integer", "description": "用户ID", "format": "int64" }, "unionId": { "type": "string", "description": "会员编号(冗余)" }, "regTime": { "type": "string", "description": "实际报名时间", "format": "date-time" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 用户报名记录 Response VO" }, "CommonResultPromotionActivityRegRecordRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PromotionActivityRegRecordRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ShopGoodsPageReqVO": { "required": [ "pageNo", "pageSize", "shopId" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "shopId": { "type": "string", "description": "店铺ID", "example": "123456" }, "keyword": { "type": "string", "description": "搜索关键字", "example": "手机" } }, "description": "管理后台 - 店铺商品分页 Request VO" }, "CommonResultPageResultShopGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultShopGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultShopGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/ShopGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "ShopGoodsRespVO": { "required": [ "itemId", "itemImg", "itemName", "itemUrl", "price" ], "type": "object", "properties": { "itemId": { "type": "string", "description": "商品ID", "example": "123456" }, "itemName": { "type": "string", "description": "商品名称", "example": "iPhone 15 Pro" }, "itemImg": { "type": "string", "description": "商品图片", "example": "https://example.com/image.jpg" }, "itemUrl": { "type": "string", "description": "商品链接", "example": "https://example.com/item/123456" }, "price": { "type": "string", "description": "商品价格", "example": "9999.0" } }, "description": "管理后台 - 店铺商品响应 VO" }, "PurchaseOrderStatsReqVO": { "required": [ "shopIds" ], "type": "object", "properties": { "shopIds": { "type": "array", "description": "店铺ID集合", "example": [ "shop123", "shop456" ], "items": { "type": "string", "description": "店铺ID集合", "example": "[\"shop123\",\"shop456\"]" } }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 商家采购订单统计 Request VO" }, "CommonResultListPurchaseOrderStatsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/PurchaseOrderStatsRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PurchaseOrderStatsRespVO": { "required": [ "avgOrderAmount", "count", "date", "statDate", "totalGoodsAmount" ], "type": "object", "properties": { "statDate": { "type": "string", "description": "统计日期", "format": "date-time" }, "date": { "type": "string", "description": "前端展示日期", "example": "2023-12-11" }, "count": { "type": "integer", "description": "采购订单数量", "format": "int32", "example": 10 }, "totalGoodsAmount": { "type": "integer", "description": "商品总金额-分", "format": "int32", "example": 100000 }, "avgOrderAmount": { "type": "integer", "description": "平均客单价-分", "format": "int32", "example": 10000 }, "itemCount": { "type": "integer", "description": "商品订单数量（order_item条数）", "format": "int32", "example": 25 }, "itemQty": { "type": "integer", "description": "商品总件数（qty求和）", "format": "int32", "example": 50 } }, "description": "管理后台 - 商家采购订单统计 Response VO" }, "ActivityMerchantPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "shopName": { "type": "string", "description": "商品名称", "example": "王五" }, "shopId": { "type": "string", "description": "商家ID", "example": "10348" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "remark": { "type": "string", "description": "备注信息", "example": "随便" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } }, "shopUrl": { "type": "string", "description": "店铺链接", "example": "https://www.iocoder.cn" }, "shopSource": { "type": "string", "description": "店铺来源（如淘宝、京东等）" }, "shopLogo": { "type": "string", "description": "店铺 Logo 图片链接" }, "discountStatus": { "type": "integer", "description": "店铺折扣状态（0-开启，1-关闭）", "format": "int32", "example": 1 } }, "description": "管理后台 - 商家折扣管理分页 Request VO" }, "ActivityMerchantRespVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 16466 }, "shopName": { "type": "string", "description": "商品名称", "example": "王五" }, "shopId": { "type": "string", "description": "商家ID", "example": "10348" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "remark": { "type": "string", "description": "备注信息", "example": "随便" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" }, "updateTime": { "type": "string", "description": "更新时间", "format": "date-time" }, "shopUrl": { "type": "string", "description": "店铺链接", "example": "https://www.iocoder.cn" }, "shopSource": { "type": "string", "description": "店铺来源（如淘宝、京东等）" }, "shopLogo": { "type": "string", "description": "店铺 Logo 图片链接" }, "shopBannerImages": { "type": "string", "description": "店铺 Banner 图（多张，英文逗号分隔）" }, "discountStatus": { "type": "integer", "description": "店铺折扣状态（0-开启，1-关闭）", "format": "int32", "example": 1 }, "merchantSort": { "type": "integer", "description": "商家排序（值越大越靠前）", "format": "int32", "example": 100 }, "merchantDisplayLogo": { "type": "string", "description": "商家对外展示 Logo", "example": "https://example.com/logo.png" }, "merchantDisplayName": { "type": "string", "description": "商家对外展示名称", "example": "NIKE官方旗舰店" }, "discountMode": { "type": "integer", "description": "折扣模式：0-平台折扣（直接计算），1-商家折扣（平台不计算）", "format": "int32", "example": 0 }, "internalShopUrl": { "type": "string", "description": "内部店铺跳转地址", "example": "https://rizzitgo.com/store-product?shopId=123&source=taobao" } }, "description": "管理后台 - 商家折扣管理 Response VO" }, "CommonResultPageResultActivityMerchantRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultActivityMerchantRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultActivityMerchantRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/ActivityMerchantRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "MerchantOrderStatsReqVO": { "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码（为空时查询全部）", "example": "huskyreps" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 根据商家编码统计订单 Request VO" }, "CommonResultListShopOrderStatsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ShopOrderStatsRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ShopOrderStatsRespVO": { "required": [ "avgOrderAmount", "count", "shopId", "shopName", "totalGoodsAmount" ], "type": "object", "properties": { "shopId": { "type": "string", "description": "店铺ID", "example": "shop123" }, "shopName": { "type": "string", "description": "店铺名称", "example": "xxx旗舰店" }, "count": { "type": "integer", "description": "订单数量", "format": "int32", "example": 10 }, "totalGoodsAmount": { "type": "integer", "description": "商品总金额-分", "format": "int32", "example": 100000 }, "avgOrderAmount": { "type": "integer", "description": "平均客单价-分", "format": "int32", "example": 10000 }, "shopLogo": { "type": "string", "description": "店铺Logo" }, "shopSource": { "type": "string", "description": "店铺来源" }, "discountRate": { "type": "integer", "description": "折扣率", "format": "int32", "example": 90 }, "discountStatus": { "type": "integer", "description": "折扣状态（0-开启，1-关闭）", "format": "int32", "example": 0 }, "itemCount": { "type": "integer", "description": "商品订单数量（order_item条数）", "format": "int32", "example": 25 }, "itemQty": { "type": "integer", "description": "商品总件数（qty求和）", "format": "int32", "example": 50 } }, "description": "管理后台 - 店铺订单统计 Response VO" }, "CommonResultActivityMerchantRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivityMerchantRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivityMerchantCodeRespVO": { "required": [ "merchantCode" ], "type": "object", "properties": { "merchantCode": { "type": "string", "description": "商家编码" } }, "description": "管理后台 - 商家编码 Response VO" }, "CommonResultListActivityMerchantCodeRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ActivityMerchantCodeRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivityGoodsPageReqVO": { "required": [ "pageNo", "pageSize" ], "type": "object", "properties": { "pageNo": { "minimum": 1, "type": "integer", "description": "页码，从 1 开始", "format": "int32", "example": 1 }, "pageSize": { "maximum": 1000, "minimum": 1, "type": "integer", "description": "每页条数，最大值为 100", "format": "int32", "example": 10 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "hasDiscount": { "type": "integer", "description": "筛选折扣商品类型：0-查询存在折扣的商品(discountRate!=100)，1-查询没设置折扣的商品(discountRate=100)", "format": "int32", "example": 0 }, "keyword": { "type": "string", "description": "搜索关键词（支持商品标题或本地商品名称模糊搜索）" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格", "example": "20440" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图", "example": "https://www.iocoder.cn" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址", "example": "https://www.iocoder.cn" }, "goodsCategoryCode": { "type": "string", "description": "热销商品分类编码" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "remark": { "type": "string", "description": "备注信息", "example": "你说的对" }, "createTime": { "type": "array", "description": "创建时间", "items": { "type": "string", "description": "创建时间", "format": "date-time" } } }, "description": "管理后台 - 促销活动商品分页 Request VO" }, "ActivityGoodsRespVO": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "主键ID", "format": "int64", "example": 24462 }, "goodsId": { "type": "string", "description": "商品ID", "example": "18812" }, "goodsTitle": { "type": "string", "description": "商品标题" }, "localGoodsTitle": { "type": "string", "description": "本地商品名称" }, "goodsPrice": { "type": "string", "description": "商品价格", "example": "20440" }, "goodsSource": { "type": "integer", "description": "商品来源: 1-淘宝, 2-1688, 3-微店", "format": "int32" }, "goodsPicUrl": { "type": "string", "description": "商品主图", "example": "https://www.iocoder.cn" }, "goodsDetailUrl": { "type": "string", "description": "商品详情地址", "example": "https://www.iocoder.cn" }, "goodsShareUrl": { "type": "string", "description": "商品分享地址", "example": "https://www.iocoder.cn" }, "goodsCategoryCode": { "type": "string", "description": "热销商品分类编码" }, "discountRate": { "type": "integer", "description": "折扣值（例如 90 表示 9 折）", "format": "int32" }, "merchantCode": { "type": "string", "description": "商品归属的商家编码" }, "sort": { "type": "integer", "description": "排序字段，数值越大越靠前", "format": "int32", "example": 100 }, "remark": { "type": "string", "description": "备注信息", "example": "你说的对" }, "createTime": { "type": "string", "description": "创建时间", "format": "date-time" } }, "description": "管理后台 - 促销活动商品 Response VO" }, "CommonResultPageResultActivityGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/PageResultActivityGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "PageResultActivityGoodsRespVO": { "required": [ "list", "total" ], "type": "object", "properties": { "list": { "type": "array", "description": "数据", "items": { "$ref": "#/components/schemas/ActivityGoodsRespVO" } }, "total": { "type": "integer", "description": "总量", "format": "int64" } }, "description": "分页结果" }, "CommonResultActivityGoodsRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "$ref": "#/components/schemas/ActivityGoodsRespVO" }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } }, "ActivityGoodsCategoryRespVO": { "required": [ "goodsCategoryCode", "goodsCount" ], "type": "object", "properties": { "goodsCategoryCode": { "type": "string", "description": "商品分类编码", "example": "ELECTRONICS" }, "goodsCount": { "type": "integer", "description": "该分类下的商品数量", "format": "int64", "example": 10 } }, "description": "管理后台 - 促销活动商品分类 Response VO" }, "CommonResultListActivityGoodsCategoryRespVO": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/ActivityGoodsCategoryRespVO" } }, "msg": { "type": "string" }, "error_detail": { "type": "string" } } } }, "securitySchemes": { "Authorization": { "type": "apiKey", "name": "Authorization", "in": "header" } } }, "x-openapi": { "x-setting": { "customCode": 200, "language": "zh-CN", "enableSwaggerModels": true, "swaggerModelName": "Swagger Models", "enableReloadCacheParameter": false, "enableAfterScript": true, "enableDocumentManage": true, "enableVersion": false, "enableRequestCache": true, "enableFilterMultipartApis": false, "enableFilterMultipartApiMethodType": "POST", "enableHost": false, "enableHostText": "", "enableDynamicParameter": false, "enableDebug": true, "enableFooter": true, "enableFooterCustom": false, "enableSearch": true, "enableOpenApi": true, "enableHomeCustom": false, "enableGroup": true, "enableResponseCode": true }, "x-markdownFiles": [] } }