猫酷开放平台

# 消费

# 消费数据通知

TIP

消费数据通知接口，用于线下pos将消费数据的相关信息传入，后期匹配用户与消费数据的关系，进行自动积分。

接口地址：https://openapi10.mallcoo.cn/Consume/v1/Data/Inform/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 交易ID（唯一订单ID）
TradeTime DateTime 是 消费时间（开始时间，格式：yyyy-MM-dd HH:mm:ss）
Amount double 是 消费金额
McShopID long 否 消费商户，该商户在猫酷系统中的唯一编号（与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 消费商户，该商户在商场CRM系统中的唯一编号（与McShopID、DevShopID任其选一必填）
DevShopID string 否 消费商户，该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（与McShopID、CrmShopID任其选一必填）
TradeSerialNo string 否 交易流水号,非必填，若商场消费积分判重时需要此字段，则必须传入
PosID string 否 pos机编号,非必填，若商场消费积分判重时需要此字段，则必须传入
PayType enum 否 支付方式（详见支付方式枚举字典）

# 调用示例


{ 
	"TransID":"4545454515",
	"TradeTime": "2017-06-16 12:45:23",
	"Amount": 100,
	"McShopID": 1000053,
	"CrmShopID": "",
	"DevShopID": "",
	"TradeSerialNo": "",
	"PosID": ""
}
1
2
3
4
5
6
7
8
9
10
11
12

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述

# 返回示例


 {
    "Code": 1,
    "Message": "成功"
}
1
2
3
4
5
6



# 消费数据通知V2

TIP

消费数据通知接口，用于线下pos将消费数据的相关信息传入，后期匹配用户与消费数据的关系，进行自动积分。

接口地址：https://openapi10.mallcoo.cn/Consume/v2/Data/Inform/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
TransID string 是 交易ID（唯一订单ID）
TradeTime DateTime 是 消费时间（开始时间，格式：yyyy-MM-dd HH:mm:ss）
PayAmount double 是 消费金额
McShopID long 否 消费商户，该商户在猫酷系统中的唯一编号（与CrmShopID、DevShopID任其选一必填）
CrmShopID string 否 消费商户，该商户在商场CRM系统中的唯一编号（与McShopID、DevShopID任其选一必填）
DevShopID string 否 消费商户，该商户在本开发者中的唯一编号，若使用此编号，则需提前将商户对应编号导入猫酷系统（与McShopID、CrmShopID任其选一必填）
TradeSerialNo string 否 交易流水号,非必填，若商场消费积分判重时需要此字段，则必须传入
PosID string 否 pos机编号,非必填，若商场消费积分判重时需要此字段，则必须传入
TotalAmount double 否 订单总金额=支付金额+优惠金额
PromotionAmount double 否 优惠金额，默认为0
ConsumePromotionList List<ConsumePromotion> 否 优惠明细列表
ConsumePayList List<ConsumePay> 否 支付明细列表
# ConsumePromotion
枚举 枚举值 描述
PromotionType enum 是
RuleNo string 否
No double 否
Amount double 是
Desc string 否
# ConsumePay
枚举 枚举值 描述
PayType enum 是
PayNo string 否
Amount double 是
# 调用示例

{ 
	"TransID":"4545454515",
	"TradeTime": "2017-06-16 12:45:23",
	"Amount": 100,
	"McShopID": 1000053,
	"CrmShopID": "",
	"DevShopID": "",
	"TradeSerialNo": "",
	"PosID": "",
    "TotalAmount":1000,
    "PromotionAmount":500,
    "ConsumePromotionList":[
        {
            "PromotionType":6,
            "RuleNo":"RNO123",
            "No":"No123456",
            "Desc":"Desc",
            "Amount":200
        },
        {
            "PromotionType":1,
            "RuleNo":"RNO123123",
            "No":"No123456789",
            "Desc":"Desc",
            "Amount":300
        }
    ],
    "ConsumePayList":[
        {
            "PayType":12,
            "Amount":200,
            "PayNo":"PNO123456"
        },
        {
            "PayType":6,
            "Amount":300,
            "PayNo":"PNO123456987"
        },
        {
            "PayType":1,
            "Amount":500,
            "PayNo":"PNO1234569874546"
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Message string 是 返回状态描述

# 返回示例


 {
    "Code": 1,
    "Message": "成功"
}
1
2
3
4
5
6



# 通过OpenUserid查询会员消费列表

TIP

通过OpenUserID查询会员的消费记录列表

接口地址：https://openapi10.mallcoo.cn/Return/v1/Consume/Records/ByOpenUserID/ (opens new window)
请求类型：POST
数据格式：application/json; charset=utf-8
参数类型：JSON

# 接口调用参数

名称 数据类型 必填 说明
OpenUserid string 是 用户在当前【开发者账号+项目（集团）】下的唯一标识(相当于用户ID)
StartTime DateTime 否 消费开始时间
EndTime DateTime 否 消费结束时间
PagingID int 否 分页记录ID（现在只支持”下一页“分页形式，第一页传0，获取下一页时传入该值）
PageSize int 否 每页数量（可填1-100，不填默认10）

# 调用示例


{ 
	"OpenUserid": "f43e9069383bb4dc",
	"StartTime":"2019-04-12 10:23:20",
	"EndTime":"2019-08-20 10:23:20",
	"PageSize": 10,
	"PagingID": 0
}
1
2
3
4
5
6
7
8
9

# 返回结果

名称 数据类型 必填 说明
Code int 是 状态码
Data Json 是 返回数据
Message string 是 返回状态描述
# Data
名称 数据类型 必填 说明
ConsumeList List<ConsumeInfoModel> 是 消费信息集合
Count long 是 总数（符合查询条件的数据）
PagingID long 是 分页记录ID（现在只支持”下一页“分页形式，第一页传0，获取下一页时传入该值）
# ConsumeInfoModel
名称 数据类型 必填 说明
McShopID long 是 该商户在猫酷系统中的唯一编号
ShopName String 是 消费商家名称
CrmShopID string 是 该商户在商场CRM系统中的唯一编号
Amount Double 是 消费金额
TradeSerialNo string 否 交易流水号
TradeTime DateTime 是 消费时间
# 返回示例

{
	"Code": 1,
	"Data": {
		"PagingID": 828,
		"Count": 8,
		"ConsumeList": [{
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/05/06 18:40:21"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/05/06 16:52:12"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/05/06 15:44:54"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/04/22 10:25:14"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/04/19 19:25:52"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/04/19 18:22:39"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 500.0,
			"TradeSerialNo": null,
			"TradeTime": "2019/04/19 18:21:19"
		}, {
			"McShopID": 1000035,
			"ShopName": "阿迪达斯",
			"CrmShopID": "mydiycode",
			"Amount": 4080.0,
			"TradeSerialNo": "15658954752658794445",
			"TradeTime": "2017/04/13 15:30:55"
		}]
	},
	"Message": null,
	"Extension": []
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
Last Updated: 2019/12/16 下午2:50:17

← 退货 →