# 卡实体明细查询

# 接口地址

/marketing/card/entity/detail/batch

# 入参

# 字段说明

名称	类型	必填	示例	描述
idEntityList	Number[]	是	[10907434497483825000, 11715748705813418008]	卡实体 ID 列表。单次最多查询 10 张卡实体。

# JSON示例

{
    "paramValues": [
        {
            "idEntityList": [10907434497483825000,11715748705813418008]
        }
    ]
}

# 出参

# 字段说明

名称	类型	示例	描述
total	Number	10	返回的卡实体条数
list	CardEntityDetailGatewayInfo[]		返回的卡实体列表

# CardEntityDetailGatewayInfo

名称	类型	示例	描述
pkId	Number	15446577379572653837	卡实体标识，唯一
idTemplate	Number	15446577379572653835	卡模板标识
memberCardNo	String	"431213"	卡号
name	String	"白金VIP卡"	卡名称
idCustomer	Number	15446577379572210585	持卡客户标识
customerName	String	"王三"	持卡客户姓名
idBuyer	Number	15446577379572210575	购卡客户标识
buyerName	String	王六"	购卡客户姓名
carList	Object[]	[{"carNo":"湘AS67J6","idCar":"10546443564022913115"}]	适用车辆列表
cellPhone	String	"18383383888"	持卡客户手机号
receiveAmount	Number	3.0	实收金额
favourableMoney	Number	0.0	赠送金额
amount	Number	3.0	剩余面额
realAmount	Number	3.0	剩余实额
usable	Number	1	卡状态。枚举值如下： 0(已使用)，1(可用)，2(待开卡)，3(已取消)，4(已过期)，5(已退卡)，6(待激活)
permanent	Number	0	是否永久有效。枚举值如下： 1(永久有效)，0(非永久有效)
validate	Number	12	有效期时间段（月）注：permanent=0时，validate为有效期；permanent=1时，validate字段无意义
endDate	String	"2024-08-24 23:59:59"	截止日期
useType	Number	0	适用范围。枚举值如下： 0(单店)，1(连锁)
cardType	String	"HYK"	卡类型。枚举值如下： HYK(套餐卡), CZK(储值卡)
idOwnOrg	Number	15446577379557047906	开卡门店标识
idEmployee	Number	15446577379557059944	服务顾问标识
activeDate	String	"2020-04-04"	开卡日期（开卡收款的日期）
realActiveDate	String	"2020-04-05"	激活日期（开卡激活的日期）
modifiedTime	String	"2020-04-05 10:23:54"	卡实体修改时间，格式：yyyy-MM-dd HH:mm:ss
creationTime	String	"2020-04-05 10:23:54"	卡实体修改时间，格式：yyyy-MM-dd HH:mm:ss
vipMoney	Number	60.00	会员价
discount	Number	1.0	卡折扣率
memo	String	"享受工时7折，材料0.95折，免费代办年审"	卡说明
channelType	Number	1	可用渠道类型列表。枚举值如下： 1(线下)，2(天猫)，3(微信)，4(汽车超人)
grossProfit	Number	2.00	预收毛利
isDel	Number	0	删除标识。枚举值如下： 0(未删除)，1(已删除)
applicableOrgList	Number[]	[11240984669917090066]	适用门店 ID 列表，当 useType = 0 该字段有值
packageCardEntityExtraInfo	PackageCardEntityGatewayInfo		套餐卡实体特有的信息，如项目材料套餐等，当 cardType = HYK 时该字段有值
valueCardEntityExtraInfo	ValueCardEntityGatewayInfo		储值卡实体特有的信息，如业务分类折扣等，当 cardType = CZK 时该字段有值

# PackageCardEntityGatewayInfo

名称	类型	描述
packageCardEntitySvcInfoList	PackageCardEntitySvcGatewayInfo[]	套餐卡实体项目信息列表
packageCardEntityPartInfoList	PackageCardEntityPartGatewayInfo[]	套餐卡实体材料信息列表
packageCardEntityPackInfoList	PackageCardEntityPackGatewayInfo[]	套餐卡实体套餐信息列表

# PackageCardEntitySvcGatewayInfo

名称	类型	示例	描述
id	Number	2648730	行主键
idService	Number	131239086	项目 ID
serviceName	String	"刹车系统养护"	项目名称
number	Number	5	项目次数
amount	Number	25.00	金额
discount	Number	1.000000	折扣率
discountAmount	Number	25.00	折扣价
unusedNumber	Number	5	未用次数
usedNumber	Number	0	已用次数
workHourPrice	Number	5.00	工时费
workHour	Number	5.00	工时
infiniteFlag	Number	0	是否无限, 0:否 1:无限
labelId	Number	442313	业务分类 ID
permanent	Number	0	是否永久有效，1 代表永久有效 0 非永久有效
endDate	String	"2024-04-05 10:23:54"	卡内当前项目有效期截止日期，格式：yyyy-MM-dd HH:mm:ss
idOwnOrg	Number	15870306745529521103	操作门店

# PackageCardEntityPartGatewayInfo

名称	类型	示例	描述
id	Number	301663	行主键
idPart	Number	132062843	材料 ID
partName	String	"后刹车片"	材料名称
number	Number	1.00	次数
amount	Number	100.00	金额
discount	Number	1.000000	折扣率
discountAmount	Number	100.00	折扣价
unusedNumber	Number	1.00	未用次数
usedNumber	Number	0.00	已用次数
unit	String	"个"	材料单位
price	Number	100.00	材料单价
labelId	Number	442313	业务分类 ID
permanent	Number	1	是否永久有效，1 代表永久有效 0 非永久有效
endDate	String	"2038-01-01 03:14:06"	卡内当前材料有效期截止日期，格式：yyyy-MM-dd HH:mm:ss
idOwnOrg	Number	15870306745529521103	操作门店

# PackageCardEntityPackGatewayInfo

名称	类型	示例	描述
id	Number	74926	行主键
idPackage	Number	16062035043349962795	套餐 ID
packageName	String	"测试套餐"	套餐名称
number	Number	3	次数
amount	Number	25200.00	金额
discount	Number	0.952857	折扣率
discountAmount	Number	24012.00	折扣价
unusedNumber	Number	3	未用次数
usedNumber	Number	0	已用次数
price	Number	8400.00	套餐单价
permanent	Number	0	是否永久有效，1 代表永久有效 0 非永久有效
endDate	String	"2024-04-05 10:23:54"	卡内当前套餐有效期截止日期，格式：yyyy-MM-dd HH:mm:ss
idOwnOrg	Number	15870306745529521103	操作门店
packageCardEntityPackSvcInfoList	PackageCardEntityPackSvcGatewayInfo[]		套餐内项目列表
packageCardEntityPackPartInfoList	PackageCardEntityPackPartGatewayInfo[]		套餐内材料列表

# PackageCardEntityPackSvcGatewayInfo

名称	类型	示例	描述
id	Number	177969	行主键
idService	Number	131237833	项目 ID
serviceName	String	"去污打蜡（新）"	项目名称
amount	Number	50.00	工时费
discount	Number	0.100000	折扣率
discountAmount	Number	5.00	折扣价
price	Number	10.00	工时单价
workHour	Number	5.00	工时
labelId	Number	442314	业务分类 ID
idOwnOrg	Number	15870306745529521103	操作门店

# PackageCardEntityPackPartGatewayInfo

名称	类型	示例	描述
id	Number	142689	行主键
idPart	Number	129785874	材料 ID
partName	String	"机油滤清器"	材料名称
number	Number	10.00	次数
amount	Number	10.00	材料费
discount	Number	0.500000	折扣率
discountAmount	Number	5.00	折扣材料费
unit	String	"只"	材料单位
price	Number	1.00	材料单价
labelId	Number	442313	业务分类 ID
idOwnOrg	Number	15870306745529521103	操作门店

# ValueCardEntityGatewayInfo

名称	类型	示例	描述
businessScopeType	Number	0	适用业务分类限制：0 部分可用，1 全部可用
valueCardEntityBusinessInfoList	ValueCardEntityBusinessGatewayInfo[]		储值卡实体业务分类信息列表，当 businessScopeType = 0 时该字段有值
valueCardEntityBusinessDiscountInfoList	ValueCardEntityBusinessDiscountGatewayInfo[]		储值卡实体业务分类折扣信息列表
valueCardEntitySkuDiscountInfoList	ValueCardEntitySkuDiscountGatewayInfo[]		储值卡实体 SKU 折扣信息列表

# ValueCardEntityBusinessGatewayInfo

名称	类型	示例	描述
id	Number	2965	行主键
labelId	Number	442317	业务分类 ID
businessType	Number	0	业务分类类型：0 项目，1 材料

# ValueCardEntityBusinessDiscountGatewayInfo

名称	类型	示例	描述
id	Number	1851	行主键
labelId	Number	442317	业务分类 ID
businessType	Number	0	业务分类类型：0 项目，1 材料
discount	Number	0.50	折扣：(0-1] 之间，支持 2 位小数

# ValueCardEntitySkuDiscountGatewayInfo

名称	类型	示例	描述
id	Number	943	行主键
skuId	Number	15447222031817836625	SKU ID
skuType	Number	0	SKU 类型：0 项目，1 材料
discountType	Number	1	SKU 折扣类型：0 折扣，1 固定价
discount	Number	35.00	折扣：(0-1] 之间，支持 2 位小数

# JSON示例

{
  "code": 200,
  "message": "OK",
  "data": {
    "total": "2",
    "list": [
      {
        "pkId": "16004712454873419789",
        "idTemplate": "16003613848342892622",
        "memberCardNo": "",
        "name": "08.21测试储值卡sku1",
        "idCustomer": "16004710303665229852",
        "customerName": "08.24测试用户",
        "idBuyer": "16004710303665229852",
        "buyerName": "08.24测试用户",
        "carList": [
          {
            "idCar": "15875772549183840346",
            "carNo": "苏ZXW0902"
          },
          {
            "idCar": "15763779814340706312",
            "carNo": "苏SS1121"
          }
        ],
        "cellPhone": "13123732132",
        "receiveAmount": "60.00",
        "favourableMoney": "40.00",
        "amount": "50.00",
        "realAmount": "30.000000",
        "usable": 1,
        "permanent": 0,
        "validate": 12,
        "endDate": "2024-08-24 23:59:59",
        "useType": 1,
        "cardType": "CZK",
        "idOwnOrg": "15870306745529521102",
        "idEmployee": "15519724471253496667",
        "activeDate": "2023-08-24 11:52:12",
        "realActiveDate": "2023-08-24 11:52:12",
        "modifiedTime": "2023-08-24 14:39:36",
        "creationTime": "2023-08-24 11:52:08",
        "vipMoney": "60.00",
        "discount": "0.600000",
        "memo": "08.21测试储值卡sku",
        "channelType": 1,
        "grossProfit": null,
        "isDel": 0,
        "applicableOrgList": null,
        "packageCardEntityExtraInfo": null,
        "valueCardEntityExtraInfo": {
          "businessScopeType": 0,
          "valueCardEntityBusinessInfoList": [
            {
              "id": 2965,
              "labelId": "442317",
              "businessType": 0
            },
            {
              "id": 2966,
              "labelId": "442318",
              "businessType": 0
            },
            {
              "id": 2967,
              "labelId": "442319",
              "businessType": 0
            },
            {
              "id": 2968,
              "labelId": "442320",
              "businessType": 0
            }
          ],
          "valueCardEntityBusinessDiscountInfoList": [
            {
              "id": 1851,
              "labelId": "442317",
              "businessType": 0,
              "discount": "0.50"
            },
            {
              "id": 1852,
              "labelId": "442317",
              "businessType": 1,
              "discount": "0.50"
            }
          ],
          "valueCardEntitySkuDiscountInfoList": [
            {
              "id": "943",
              "skuId": "15447222031817836625",
              "skuType": 0,
              "discountType": 1,
              "discount": "35.00"
            },
            {
              "id": "944",
              "skuId": "15447222031817836628",
              "skuType": 0,
              "discountType": 1,
              "discount": "45.00"
            },
            {
              "id": "945",
              "skuId": "15447222031817751068",
              "skuType": 0,
              "discountType": 0,
              "discount": "1.00"
            }
          ]
        }
      },
      {
        "pkId": "16072541442072911967",
        "idTemplate": "16062035379506651159",
        "memberCardNo": null,
        "name": "测试套餐卡zxy",
        "idCustomer": "16062785805889839192",
        "customerName": "张老三",
        "idBuyer": "16062785805889839192",
        "buyerName": "张老三",
        "carList": null,
        "cellPhone": "19944455555",
        "receiveAmount": "24339.50",
        "favourableMoney": "1390.50",
        "amount": "25730.00",
        "realAmount": "24339.500000",
        "usable": 1,
        "permanent": 1,
        "validate": null,
        "endDate": "2038-01-01 03:14:06",
        "useType": 0,
        "cardType": "HYK",
        "idOwnOrg": "15870306745529521103",
        "idEmployee": "15519724471253496523",
        "activeDate": "2024-02-27 16:01:18",
        "realActiveDate": "2024-02-27 16:01:18",
        "modifiedTime": "2024-02-27 16:01:18",
        "creationTime": "2024-02-27 16:00:19",
        "vipMoney": "24339.50",
        "discount": "0.945958",
        "memo": "",
        "channelType": 1,
        "grossProfit": null,
        "isDel": 0,
        "applicableOrgList": [
          15870306745529521103,
          15870306745529521102
        ],
        "packageCardEntityExtraInfo": {
          "packageCardEntitySvcInfoList": [
            {
              "id": "2648730",
              "idService": "131239086",
              "serviceName": "11111",
              "number": 5,
              "amount": "25.00",
              "discount": "1.000000",
              "discountAmount": "25.00",
              "unusedNumber": 5,
              "usedNumber": 0,
              "workHourPrice": "5.00",
              "workHour": "5.00",
              "infiniteFlag": 0,
              "labelId": 442313,
              "permanent": 1,
              "endDate": "2038-01-01 03:14:06",
              "idOwnOrg": "15870306745529521103"
            },
            {
              "id": "2648731",
              "idService": "132288620",
              "serviceName": "套餐卡项目2",
              "number": 1,
              "amount": "400.00",
              "discount": "0.500000",
              "discountAmount": "200.00",
              "unusedNumber": 1,
              "usedNumber": 0,
              "workHourPrice": "400.00",
              "workHour": "2.00",
              "infiniteFlag": 0,
              "labelId": 442313,
              "permanent": 1,
              "endDate": "2038-01-01 03:14:06",
              "idOwnOrg": "15870306745529521103"
            }
          ],
          "packageCardEntityPartInfoList": [
            {
              "id": "301663",
              "idPart": "132062843",
              "partName": "拽猫反光车贴喵子车贴3",
              "unit": "个",
              "number": "10.00",
              "price": "0.00",
              "amount": "0.00",
              "discount": "0.000000",
              "unusedNumber": "10.00",
              "usedNumber": "0.00",
              "discountAmount": "0.00",
              "labelId": 442318,
              "permanent": 1,
              "endDate": "2038-01-01 03:14:06",
              "idOwnOrg": "15870306745529521103"
            },
            {
              "id": "301664",
              "idPart": "131075392",
              "partName": "zxy前刹车片 有消音片",
              "unit": "个",
              "number": "1.00",
              "price": "100.00",
              "amount": "100.00",
              "discount": "1.000000",
              "unusedNumber": "1.00",
              "usedNumber": "0.00",
              "discountAmount": "100.00",
              "labelId": 442313,
              "permanent": 1,
              "endDate": "2038-01-01 03:14:06",
              "idOwnOrg": "15870306745529521103"
            },
            {
              "id": "301665",
              "idPart": "129785874",
              "partName": "机油滤清器",
              "unit": "只",
              "number": "5.00",
              "price": "1.00",
              "amount": "5.00",
              "discount": "0.500000",
              "unusedNumber": "5.00",
              "usedNumber": "0.00",
              "discountAmount": "2.50",
              "labelId": 442313,
              "permanent": 1,
              "endDate": "2038-01-01 03:14:06",
              "idOwnOrg": "15870306745529521103"
            }
          ],
          "packageCardEntityPackInfoList": [
            {
              "id": "74926",
              "packageName": "测试套餐",
              "idPackage": "16062035043349962795",
              "number": 3,
              "price": "8400.00",
              "amount": "25200.00",
              "discount": "0.952857",
              "discountAmount": "24012.00",
              "unusedNumber": 3,
              "usedNumber": 0,
              "permanent": 1,
              "endDate": "2038-01-01 03:14:06",
              "idOwnOrg": "15870306745529521103",
              "packageCardEntityPackSvcInfoList": [
                {
                  "id": "177969",
                  "idService": "131237833",
                  "serviceName": "去污打蜡（新）",
                  "workHour": "5.00",
                  "price": "10.00",
                  "amount": "50.00",
                  "discount": "0.100000",
                  "discountAmount": "5.00",
                  "labelId": 442314,
                  "idOwnOrg": "15870306745529521103"
                },
                {
                  "id": "177970",
                  "idService": "131237805",
                  "serviceName": "1111",
                  "workHour": "4.00",
                  "price": "10.00",
                  "amount": "40.00",
                  "discount": "1.000000",
                  "discountAmount": "40.00",
                  "labelId": 442317,
                  "idOwnOrg": "15870306745529521103"
                }
              ],
              "packageCardEntityPackPartInfoList": [
                {
                  "id": "142689",
                  "idPart": "129785874",
                  "partName": "机油滤清器",
                  "unit": "只",
                  "number": "10.00",
                  "price": "1.00",
                  "amount": "10.00",
                  "discount": "0.500000",
                  "discountAmount": "5.00",
                  "labelId": 442313,
                  "idOwnOrg": "15870306745529521103"
                },
                {
                  "id": "142691",
                  "idPart": "131061342",
                  "partName": "前减震器修包",
                  "unit": "套",
                  "number": "100.00",
                  "price": "74.00",
                  "amount": "7400.00",
                  "discount": "1.000000",
                  "discountAmount": "7400.00",
                  "labelId": 442312,
                  "idOwnOrg": "15870306745529521103"
                }
              ]
            }
          ]
        },
        "valueCardEntityExtraInfo": null
      }
    ]
  }
}

← 客户开通储值卡卡单据列表 →