# 券模板明细批量获取
# 接口地址
/marketing/coupon/template/batchQueryDetailByIdList
# 入参
# 字段说明
| 名称 | 类型 | 必填 | 示例 | 描述 |
|---|---|---|---|---|
| idList | Number[] | 是 | [123,456] | 优惠券模板唯一标识列表。单次最多查询 10 张优惠券模板。 |
# JSON示例
{
"paramValues": [
{
"idList": [123,456]
}
]
}
# 出参
# 字段说明
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| total | Number | 128 | 优惠券模板明细的总条数。 |
| list | CouponTemplateDetailFullInfo[] | 优惠券模板明细信息列表。 |
# CouponTemplateDetailFullInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| baseInfo | CouponTemplateInfo | 优惠券模板的基础信息。 | |
| useSceneInfos | CouponTemplateUseSceneInfo[] | 优惠券模板使用场景列表。 | |
| orgInfos | CouponTemplateOrgInfo[] | 优惠券可用门店列表。只有优惠券可用门店范围为部分门店时，该字段才会返回。 | |
| itemInfos | CouponTemplateItemInfo[] | 优惠券可用项目列表。仅当优惠券可用商品为部分商品可用，且指定项目不为空时，该字段才会返回。 | |
| partInfos | CouponTemplatePartInfo[] | 优惠券可用材料列表。仅当优惠券可用商品为部分商品可用，且指定具体材料不为空时，该字段才会返回。 | |
| partBrandInfos | CouponTemplatePartBrandInfo[] | 优惠券可用材料品牌列表。仅当优惠券可用商品为部分商品可用，且指定材料品牌不为空时，该字段才会返回。 | |
| partCategoryInfos | CouponTemplatePartCategoryInfo[] | 优惠券可用材料品牌列表。仅当优惠券可用商品为部分商品可用，且指定材料分类不为空时，该字段才会返回。 |
# CouponTemplateInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| id | Number | 1 | 优惠券模板的唯一标识。 |
| couponName | String | "免费洗车一次" | 优惠券名称。 |
| status | Number | 1 | 优惠券模板的启停用状态。0-停用，1-启用。 |
| couponValue | Number | 100.00 | 优惠券面额。 |
| conditionType | Number | 1 | 使用优惠券是否有门槛金额。0-无门槛，1-有门槛。 |
| conditionValue | Number | 200.00 | 当优惠券有使用门槛时对应的门槛金额。 |
| validityType | Number | 0 | 优惠券有效期类型。0-具体日期，1-领取后的天数。 |
| validityBegin | String | "2023-12-01" | 当优惠券的有效期类型为具体日期时对应的有效期开始时间。 |
| validityEnd | String | "2023-12-31" | 当优惠券的有效期类型为具体日期时对应的有效期结束时间。 |
| validityDays | Number | 7 | 当优惠券的有效期类型为领取后的天数时对应的天数。 |
| orgRangeType | Number | 0 | 优惠券的使用门店范围。0-部分门店，1-全部门店。 |
| goodsRangeType | Number | 0 | 优惠券可用商品范围。0-部分商品，1-全部商品。 |
| takeQuota | Number | 2 | 优惠券每人限领的张数。等于 0 时代表不限领。 |
| totalStock | Number | 999 | 优惠券的发放总量。 |
| couponDesc | String | "仅限一店使用，不与其他优惠同享。最终解释权归我司所有" | 优惠券的使用说明。 |
| idOwnOrg | Number | 16011640498246656021 | 优惠券创建门店的唯一标识。 |
| creationTime | String | "2023-12-19 12:32:18" | 优惠券模板的创建时间。 |
| creator | Number | 16011640498246656021 | 优惠券模板创建人的唯一标识。 |
| modifiedTime | String | "2023-12-19 18:19:20" | 优惠券模板的修改时间。 |
| modifier | Number | 16011640498246656021 | 优惠券模板修改人的唯一标识。 |
# CouponTemplateUseSceneInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| sceneCode | Number | 1 | 优惠券模板使用场景编码。 |
| sceneName | String | "员工推广" | 优惠券模板使用场景名称。 |
# CouponTemplateOrgInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| idOwnOrg | Number | 16011640498246656021 | 优惠券可用门店唯一标识。 |
# CouponTemplateItemInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| idItem | Number | 123456 | 优惠券模板创建门店对应的项目唯一标识。 |
| itemName | String | "标准洗车" | 项目名称。 |
# CouponTemplatePartInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| idPart | Number | 456789 | 优惠券模板创建门店对应的材料唯一标识。 |
| partName | String | "金美孚 0w20 4L" | 材料名称。 |
# CouponTemplatePartBrandInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| idBrand | Number | 456123 | 材料品牌的唯一标识。 |
| brandName | String | "美孚" | 材料品牌名称。 |
# CouponTemplatePartCategoryInfo
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| idCategory | Number | 16011640498246656021 | 材料一级分类唯一标识。 |
| categoryName | String | "汽车养护" | 材料一级分类名称。 |
| idSubCategory | Number | 16011640498246656022 | 材料二级分类唯一标识。 |
| subCategoryName | String | "玻璃水" | 材料二级分类名称。 |
# JSON示例
{
"code": 200,
"data": {
"total": 2,
"list": [
{
"baseInfo": {
"modifiedTime": "2024-01-09 16:02:11",
"couponName": "测试网关 0109",
"orgRangeType": 1,
"creationTime": "2024-01-09 16:02:11",
"modifier": 15839547086166036531,
"remark": "",
"validityBegin": "2024-01-09",
"isDeleted": 0,
"couponDesc": "我是使用说明撒娇侃大山解封了我都觉得是我发的",
"id": 53233,
"idOwnOrg": 15870306745529592604,
"creator": 15839547086166036531,
"takeQuota": 0,
"validityEnd": "2024-01-31",
"withholdStock": 0,
"goodsRangeType": 0,
"couponValue": 88.88,
"validityType": 0,
"totalStock": 999,
"conditionValue": 125.0,
"conditionType": 1,
"remainStock": 999,
"status": 0
},
"partCategoryInfos": [
{
"idSubCategory": 15447222031817140871,
"categoryName": "保养配件",
"idCategory": 15447222031817140834,
"subCategoryName": "刹车片"
}
],
"partInfos": [],
"orgInfos": [],
"itemInfos": [
{
"itemName": "更换火花塞(新)",
"idItem": 15447222031817750530
}
],
"useSceneInfos": [],
"partBrandInfos": []
},
{
"baseInfo": {
"modifiedTime": "2024-02-20 14:16:15",
"couponName": "全量字段测试",
"orgRangeType": 1,
"creationTime": "2024-02-20 14:16:15",
"modifier": 15839547086166036531,
"remark": "",
"validityBegin": "2024-02-20",
"isDeleted": 0,
"couponDesc": "但是发烧 V 社个 V 社地方公司的",
"id": 53234,
"idOwnOrg": 15870306745529592604,
"creator": 15839547086166036531,
"takeQuota": 0,
"validityEnd": "2024-03-31",
"withholdStock": 0,
"goodsRangeType": 0,
"couponValue": 13.14,
"validityType": 0,
"goodsAllStandard": 1,
"totalStock": 998,
"conditionValue": 82.8,
"conditionType": 1,
"remainStock": 998,
"status": 0
},
"partCategoryInfos": [],
"partInfos": [
{
"idPart": 15447222031817967556,
"partName": "拽猫反光车贴喵子车贴1"
}
],
"orgInfos": [],
"itemInfos": [
{
"itemName": "更换火花塞(新)",
"idItem": 15447222031817750530
}
],
"useSceneInfos": [
{
"sceneCode": 1,
"sceneName": "员工推广"
}
],
"partBrandInfos": []
}
],
"empty": false
},
"message": "SUCCESS"
}