获取门店团购信息
接口说明
注意事项
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | http://wspacebot.yunfeiwork.com/wspace-openapi/partner/tuangou/queryshopdeal?access_token=ACCESS_TOKEN |
| HTTP Method | POST |
请求参数
请求头
| 参数名 | 参数值 | 必填 |
|---|---|---|
| content-type | application/json | 是 |
Body
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | int | 是 | 页码，默认1， platform=douyin 时此字段无效，可以不传 |
| opPoiId | string | 是 | 门店id，已授权门店查询接口返回的opPoiId |
| platform | string | 否 | 团购平台：meituan=美团，douyin=抖音，kuaishou=快手（如果没传则默认美团） |
| cursor | string | 否 | 抖音翻页专用字段，第一页不传，之后用前一次返回的 nextCursor 传入进行翻页 |
| dealType | string | 否 | 团购类型 1-团购套餐，2-代金券 ( 暂时用于到店餐饮 ) |
请求示例
{
"page": 1, // 美团使用，抖音不需要
"opPoiId": "example",
"platform":"meituan",
"cursor": "前一次返回的 nextCursor", //抖音翻页专用字段，美团不需要
}响应参数
Body
| 参数名 | 类型 | 说明 |
|---|---|---|
| dealId | long | 套餐ID（美团返回） |
| dealGroupId | long | 团购ID（美团返回） |
| skuId | string | 抖音的团购商品ID（抖音返回） |
| thirdOutId | string | 商家平台券ID（抖音门店使用） |
| beginDate | string | 团购开始售卖时间（美团返回） |
| endDate | string | 团购结束售卖时间（美团返回） |
| title | string | （团购）套餐名称 |
| price | double | （团购）套餐价格 |
| marketPrice | double | （团购）套餐原价 |
| receiptBeginDate | string | 团购券开始服务时间（美团返回） |
| receiptEndDate | string | 团购券结束服务时间（美团返回） |
| saleStatus | string | 售卖状态 1-未开始售卖，2-售卖中，3-售卖结束（美团返回）｜ |
| dealGroupStatus | string | 团购状态 1-在售团单 ，2-隐藏单（美团返回） |
| dealType | string | 团购类型 1-团购套餐，2-代金券（美团返回） |
响应示例
{
"code": 200,
"msg": "成功",
"count": 1,
"nextCursor":"5" // 抖音团购翻页字段
"data": [
{
"dealId": 1000,
"dealGroupId": 1000,
"skuId": "1840968xxxx45988" // 抖音的团购商品ID
"thirdOutId": "tc_xjjl1988chunniunai200g*20" // 商家平台券ID（抖音门店使用）
"beginDate": "格式如 2017-05-24 12:00 ，数据精确到分钟。",
"endDate": "格式如 2017-05-24 12:00 ，数据精确到分钟。",
"title": "example",
"price": 100.01,
"marketPrice": 100.01,
"receiptBeginDate": "格式如 2017-05-24 12:00 ，数据精确到分钟。",
"receiptEndDate": "格式如 2017-05-24 12:00 ，数据精确到分钟。",
"saleStatus": 1,
"dealGroupStatus": 1,
"saleChannelName": "example",
"dealType": "1-团购套餐，2-代金券"
}
],
"tid": "f13b05b1bf13b05b1f13b05b1"
}修改于 2026-06-17 03:55:07