groupbuy - 团购买家业务接口
- api/marketing/groupbuy/get GET 获取团购信息
- api/marketing/groupbuy/getorder GET 获取团购订单信息
- api/marketing/groupbuy/getorderlist GET 获取团购订单列表
- api/marketing/groupbuy/getdelivertypelist GET 获取配送方式列表
- api/marketing/groupbuy/getorderstatuslist GET 获取订单状态列表
- api/marketing/groupbuy/getgroupbuyingvisitor GET 获取访客列表
- api/marketing/groupbuy/sharegroupbuying POST 分享团购
- api/marketing/groupbuy/visitgroupbuying POST 访问团购
- api/marketing/groupbuy/createorder POST 新增团购订单
- api/marketing/groupbuy/deleteorder POST 删除团购订单
- api/marketing/groupbuy/closeorder POST 关闭团购订单
- api/marketing/groupbuy/orderreceive POST 订单确认收货
- api/marketing/groupbuy/orderpay POST 支付
- api/marketing/groupbuy/orderrepay POST 重新支付
- api/marketing/groupbuy/checkorderpay POST 获取团购订单支付结果
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| address | string | 地址 |
| createTime | date | 创建时间 |
| deliverType | string | 1:自提; 2:快递 |
| description | string | 描述 |
| endTime | date | 结束时间 |
| id | integer | id |
| imagePath | string | 图片路径 |
| imageUrl | [...] | 图片Url |
| inUse | boolean | 是否启用 |
| lBS | string | 坐标 |
| name | string | 名称 |
| orderCount | integer | 订单数量 |
| orders | [...] | 团购订单 |
| ┆- address | string | 地址 |
| ┆- code | string | 订单编号 |
| ┆- createTime | date | 下单时间 |
| ┆- deliverCode | string | 取货码 |
| ┆- deliverType | string | 1:自提; 2:快递 |
| ┆- deliverTypeName | string | 配送方式名称 |
| ┆- groupBuyingId | integer | 团购Id |
| ┆- groupBuyingName | string | 团购名称 |
| ┆- id | integer | id |
| ┆- lBS | string | 坐标 |
| ┆- money | decimal number | 金额 |
| ┆- payTime | date | 支付时间 |
| ┆- phone | string | 电话 |
| ┆- productName | string | 商品名称 |
| ┆- qty | integer | 数量 |
| ┆- remark | string | 备注 |
| ┆- sequence | integer | 序号 |
| ┆- shopId | integer | 门店Id |
| ┆- shopName | string | 门店 |
| ┆- spec | string | 规格 |
| ┆- status | string | 0:未支付; 1:已支付; 2:已退款; 3:已发货; 4:已完成; 5:已过期; 6:已关闭; 7:支付失败; 8:已确认 |
| ┆- statusName | string | 状态名称 |
| ┆- userId | integer | 购买人Id |
| ┆- userName | string | 购买人名称 |
| ┆- userOpenId | string | 购买人OpenId |
| ┆- userProfile | string | 购买人头像 |
| orderUsers | [...] | 购买人 |
| ┆- id | integer | id |
| ┆- name | string | 名称 |
| ┆- openId | string | OpenId |
| ┆- profile | string | 头像 |
| payedCount | integer | 已购数量 |
| phone | string | 电话 |
| price | decimal number | 单价 |
| productCode | string | 商品编码 |
| productId | integer | 商品Id |
| productName | string | 商品名称 |
| shopId | integer | 门店Id |
| shopName | string | 门店 |
| spec | string | 规格 |
| startTime | date | 开始时间 |
| stock | integer | 库存 |
| userId | integer | 创建人Id |
| userName | string | 创建人名称 |
| visitTimes | integer | 访问次数 |
响应示例
application/json, text/json
{
"imageUrl": [
"",
""
],
"shopId": 1,
"shopName": "",
"name": "",
"description": "",
"startTime": "2026-01-15 10:11:10",
"endTime": "2026-01-15 10:11:10",
"deliverType": 1,
"address": "",
"lbs": "",
"phone": "",
"inUse": true,
"productId": 11,
"productName": "",
"productCode": "",
"imagePath": "",
"price": 15.0,
"spec": "",
"stock": 17,
"payedCount": 18,
"orderCount": 19,
"visitTimes": 20,
"userId": 21,
"userName": "",
"createTime": "2026-01-15 10:11:10",
"orders": [
{
"shopId": 1,
"shopName": "",
"groupBuyingId": 3,
"groupBuyingName": "",
"code": "",
"sequence": 6,
"status": 0,
"statusName": "",
"userId": 8,
"userOpenId": "",
"userName": "",
"userProfile": "",
"deliverType": 1,
"deliverTypeName": "",
"address": "",
"lbs": "",
"phone": "",
"remark": "",
"productName": "",
"spec": "",
"qty": 19,
"money": 20.0,
"payTime": "2026-01-15 10:11:10",
"deliverCode": "",
"createTime": "2026-01-15 10:11:10",
"id": 24
},
{
"shopId": 1,
"shopName": "",
"groupBuyingId": 3,
"groupBuyingName": "",
"code": "",
"sequence": 6,
"status": 0,
"statusName": "",
"userId": 8,
"userOpenId": "",
"userName": "",
"userProfile": "",
"deliverType": 1,
"deliverTypeName": "",
"address": "",
"lbs": "",
"phone": "",
"remark": "",
"productName": "",
"spec": "",
"qty": 19,
"money": 20.0,
"payTime": "2026-01-15 10:11:10",
"deliverCode": "",
"createTime": "2026-01-15 10:11:10",
"id": 24
}
],
"orderUsers": [
{
"openId": "",
"name": "",
"profile": "",
"id": 4
},
{
"openId": "",
"name": "",
"profile": "",
"id": 4
}
],
"id": 24
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| address | string | 地址 |
| code | string | 订单编号 |
| createTime | date | 下单时间 |
| deliverCode | string | 取货码 |
| deliverType | string | 1:自提; 2:快递 |
| deliverTypeName | string | 配送方式名称 |
| groupBuyingId | integer | 团购Id |
| groupBuyingName | string | 团购名称 |
| id | integer | id |
| lBS | string | 坐标 |
| money | decimal number | 金额 |
| payTime | date | 支付时间 |
| phone | string | 电话 |
| productName | string | 商品名称 |
| qty | integer | 数量 |
| remark | string | 备注 |
| sequence | integer | 序号 |
| shopId | integer | 门店Id |
| shopName | string | 门店 |
| spec | string | 规格 |
| status | string | 0:未支付; 1:已支付; 2:已退款; 3:已发货; 4:已完成; 5:已过期; 6:已关闭; 7:支付失败; 8:已确认 |
| statusName | string | 状态名称 |
| userId | integer | 购买人Id |
| userName | string | 购买人名称 |
| userOpenId | string | 购买人OpenId |
| userProfile | string | 购买人头像 |
响应示例
application/json, text/json
{
"shopId": 1,
"shopName": "",
"groupBuyingId": 3,
"groupBuyingName": "",
"code": "",
"sequence": 6,
"status": 0,
"statusName": "",
"userId": 8,
"userOpenId": "",
"userName": "",
"userProfile": "",
"deliverType": 1,
"deliverTypeName": "",
"address": "",
"lbs": "",
"phone": "",
"remark": "",
"productName": "",
"spec": "",
"qty": 19,
"money": 20.0,
"payTime": "2026-01-15 10:11:10",
"deliverCode": "",
"createTime": "2026-01-15 10:11:10",
"id": 24
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| keyword | string | |
| pageIndex | integer | |
| pageSize | integer | |
| status | integer | |
| userId | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | [...] | |
| ┆- address | string | 地址 |
| ┆- code | string | 订单编号 |
| ┆- createTime | date | 下单时间 |
| ┆- deliverCode | string | 取货码 |
| ┆- deliverType | string | 1:自提; 2:快递 |
| ┆- deliverTypeName | string | 配送方式名称 |
| ┆- groupBuyingId | integer | 团购Id |
| ┆- groupBuyingName | string | 团购名称 |
| ┆- id | integer | id |
| ┆- lBS | string | 坐标 |
| ┆- money | decimal number | 金额 |
| ┆- payTime | date | 支付时间 |
| ┆- phone | string | 电话 |
| ┆- productName | string | 商品名称 |
| ┆- qty | integer | 数量 |
| ┆- remark | string | 备注 |
| ┆- sequence | integer | 序号 |
| ┆- shopId | integer | 门店Id |
| ┆- shopName | string | 门店 |
| ┆- spec | string | 规格 |
| ┆- status | string | 0:未支付; 1:已支付; 2:已退款; 3:已发货; 4:已完成; 5:已过期; 6:已关闭; 7:支付失败; 8:已确认 |
| ┆- statusName | string | 状态名称 |
| ┆- userId | integer | 购买人Id |
| ┆- userName | string | 购买人名称 |
| ┆- userOpenId | string | 购买人OpenId |
| ┆- userProfile | string | 购买人头像 |
| pageIndex | integer | |
| pageSize | integer | |
| sumData | {...} | |
| ┆- address | string | 地址 |
| ┆- code | string | 订单编号 |
| ┆- createTime | date | 下单时间 |
| ┆- deliverCode | string | 取货码 |
| ┆- deliverType | string | 1:自提; 2:快递 |
| ┆- deliverTypeName | string | 配送方式名称 |
| ┆- groupBuyingId | integer | 团购Id |
| ┆- groupBuyingName | string | 团购名称 |
| ┆- id | integer | id |
| ┆- lBS | string | 坐标 |
| ┆- money | decimal number | 金额 |
| ┆- payTime | date | 支付时间 |
| ┆- phone | string | 电话 |
| ┆- productName | string | 商品名称 |
| ┆- qty | integer | 数量 |
| ┆- remark | string | 备注 |
| ┆- sequence | integer | 序号 |
| ┆- shopId | integer | 门店Id |
| ┆- shopName | string | 门店 |
| ┆- spec | string | 规格 |
| ┆- status | string | 0:未支付; 1:已支付; 2:已退款; 3:已发货; 4:已完成; 5:已过期; 6:已关闭; 7:支付失败; 8:已确认 |
| ┆- statusName | string | 状态名称 |
| ┆- userId | integer | 购买人Id |
| ┆- userName | string | 购买人名称 |
| ┆- userOpenId | string | 购买人OpenId |
| ┆- userProfile | string | 购买人头像 |
| totalCount | integer |
响应示例
application/json, text/json
请求参数
无.
响应参数
响应示例
application/json, text/json
[
{
"key": 1,
"value": ""
},
{
"key": 1,
"value": ""
}
]
请求参数
无.
响应参数
响应示例
application/json, text/json
[
{
"key": 1,
"value": ""
},
{
"key": 1,
"value": ""
}
]
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| groupBuyingId | integer | |
| userId | integer |
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| name | string | 名称 |
| openId | string | OpenId |
| profile | string | 头像 |
响应示例
application/json, text/json
[
{
"openId": "",
"name": "",
"profile": "",
"id": 4
},
{
"openId": "",
"name": "",
"profile": "",
"id": 4
}
]
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| mainId | integer | 团购分享Id |
| userId | integer | 访问用户Id |
请求示例
application/json, text/json
{
"mainId": 1,
"userId": 2,
"id": 3
}
响应参数
无.
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| address | string | 地址 |
| deliverType | string | 1:自提; 2:快递 |
| groupBuyingId | integer | 团购Id |
| id | integer | id |
| money | decimal number | 金额 |
| phone | string | 电话 |
| qty | integer | 数量 |
| remark | string | 备注 |
| userId | integer | 购买人Id |
请求示例
application/json, text/json
{
"groupBuyingId": 1,
"userId": 2,
"deliverType": 1,
"address": "",
"phone": "",
"remark": "",
"qty": 6,
"money": 7.0,
"id": 8
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | integer | |
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"data": 1,
"status": 200,
"message": ""
}
请求参数
| 无 |
|---|
请求示例
application/json, text/json
{}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 无 |
|---|
请求示例
application/json, text/json
{}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 无 |
|---|
请求示例
application/json, text/json
{}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| orderId | integer | 团购Id |
| timeStamp | string | 时间戳(客户端时间,yyyy-MM-dd HH:mm:ss) |
请求示例
application/json, text/json
{
"orderId": 1,
"timeStamp": "",
"id": 3
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | {...} | |
| ┆- nonceStr | string | 随机字符串 |
| ┆- paySign | string | 签名 |
| ┆- prePayId | string | 预支付交易会话标识 |
| ┆- signType | string | 签名算法 |
| ┆- timeStamp | string | 时间戳,从 1970 年 1 月 1 日 00:00:00 至今的秒数,即当前的时间 |
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"data": {
"prePayId": "",
"nonceStr": "",
"signType": "",
"paySign": "",
"timeStamp": ""
},
"status": 200,
"message": ""
}
请求参数
| 名称 | 类型 | 描述 |
|---|---|---|
| id | integer | id |
| orderId | integer | 团购Id |
| timeStamp | string | 时间戳(客户端时间,yyyy-MM-dd HH:mm:ss) |
请求示例
application/json, text/json
{
"orderId": 1,
"timeStamp": "",
"id": 3
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| data | {...} | |
| ┆- nonceStr | string | 随机字符串 |
| ┆- paySign | string | 签名 |
| ┆- prePayId | string | 预支付交易会话标识 |
| ┆- signType | string | 签名算法 |
| ┆- timeStamp | string | 时间戳,从 1970 年 1 月 1 日 00:00:00 至今的秒数,即当前的时间 |
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"data": {
"prePayId": "",
"nonceStr": "",
"signType": "",
"paySign": "",
"timeStamp": ""
},
"status": 200,
"message": ""
}
请求参数
| 无 |
|---|
请求示例
application/json, text/json
{}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| message | string | 附加信息 |
| status | string | 200:成功; 500:内部错误; 601:卡不可用; 602:卡不存在; 603:卡挂失; 604:卡作废; 605:卡余额不足; 606:卡付款码超时; 607:积分不足; 608:礼品不可用; 701:支付成功; 702:支付确认失败; 703:支付状态未知; 704:付款码超时; 801:流水号重复; 901:未日结; 902:日结进行中; 903:日结中断; 904:日结完成; 905:日结金额发生变化; 1001:无法购买; 1002:已售罄; 1003:支付超时 |
响应示例
application/json, text/json
{
"status": 200,
"message": ""
}