---
url: "https://pay.weixin.qq.com/doc/v3/merchant/4012460489.md"
title: "条件查询批次列表"
doc_id: 4012460489
---

>更新时间：2025.03.25

通过此接口可查询多个批次的信息，包括批次的配置信息以及批次概况数据。

接口频率： 不区分来源 1000/s 单ip 500/s

接口耗时： 1S

幂等规则： 接口支持幂等重入




## 接口说明

支持商户：【普通商户】

请求方式：【GET】 `/v3/marketing/favor/stocks`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考[签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D)生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Query 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| offset | integer | true | 【分页页码】页码从0开始，默认第0页 |
| limit | integer | true | 【分页大小】分页大小，最大10 |
| stock_creator_mchid | string(20) | true | 【创建批次的商户号】批次创建方商户号。<br>校验规则：接口传入的批次号需由stock\_creator\_mchid所创建。 |
| create_start_time | string(64) | false | 【起始时间】 起始创建时间，遵循[rfc3339](https://datatracker.ietf.org/doc/html/rfc3339)标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。<br>校验规则：get请求，参数在 url中，需要进行 url 编码传递 |
| create_end_time | string(664) | false | 【终止时间】 终止创建时间，遵循[rfc3339](https://datatracker.ietf.org/doc/html/rfc3339)标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日 13点29分35秒。<br>校验规则：get请求，参数在 url中，需要进行 url 编码传递 |
| status | string(12) | false | 【批次状态】 批次状态，枚举值：<br>unactivated：未激活<br>audit：审核中<br>running：运行中<br>stoped：已停止<br>paused：暂停发放 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| total_count | integer | true | 【批次总数】 经过条件筛选，查询到的批次总数量。 |
| data | array[object] | false | 【批次详情】 批次详情 |
| data.stock_id | string | true | 【批次号】 微信为每个代金券批次分配的唯一id。 |
| data.stock_creator_mchid | string | true | 【批次创建方商户号】 微信为创建方商户分配的商户号 |
| data.stock_name | string | true | 【批次名称】 批次名称 |
| data.status | string | true | 【批次状态】 批次状态，枚举值：<br>unactivated：未激活<br>audit：审核中<br>running：运行中<br>stoped：已停止<br>paused：暂停发放 |
| data.create_time | string | true | 【创建时间】 批次创建时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| data.description | string | true | 【使用说明】 批次描述信息 |
| data.stock_use_rule | object | false | 【满减券/消费金批次使用规则】 满减券或消费金批次特定信息。 |
| data.stock_use_rule.max_coupons | integer | true | 【发放总上限】 最大发券数 |
| data.stock_use_rule.max_amount | integer | true | 【总预算】 总消耗金额，单位：分。 |
| data.stock_use_rule.max_amount_by_day | integer | true | 【单天发放上限金额】 单天最高消耗金额，单位：分。 |
| data.stock_use_rule.fixed_normal_coupon | object | false | 【固定面额批次特定信息】 固定面额发券或消费金批次特定信息。 |
| data.stock_use_rule.fixed_normal_coupon.coupon_amount | integer | true | 【面额】 面额，单位：分。 |
| data.stock_use_rule.fixed_normal_coupon.transaction_minimum | integer | true | 【门槛】 使用券金额门槛，单位：分。 |
| data.stock_use_rule.max_coupons_per_user | integer | true | 【单个用户可领个数】 单个用户可领个数 |
| data.stock_use_rule.coupon_type | string | false | 【券或消费金类型】 券或消费金类型<br>枚举值：<br>NORMAL：满减券<br>CUT\_TO：减至券 |
| data.stock_use_rule.goods_tag | array[string] | false | 【订单优惠标记】 订单优惠标记 (该字段暂未开放返回)<br>特殊规则：单个优惠标记的字符长度为【1，128】,条目个数限制为【1，50】。 |
| data.stock_use_rule.trade_type | array[string] | false | 【指定支付模式】 默认不限制，枚举值：<br>MICROAPP：小程序支付<br>APPPAY：APP支付<br>PPAY：免密支付<br>CARD：付款码支付<br>FACE：人脸支付<br>OTHER：（公众号、扫码等）<br>可选取值<br><ul><li>`MICROAPP`:  小程序支付</li><li>`APPPAY`:  APP支付</li><li>`PPAY`:  免密支付</li><li>`CARD`:  刷卡支付</li><li>`FACE`:  人脸支付</li><li>`OTHER`:  其他支付，公众号、扫码等</li></ul> |
| data.stock_use_rule.combine_use | boolean | false | 【是否可叠加其他优惠】 枚举值：<br>true：是<br>false：否 |
| data.stock_use_rule.fixed_discount_coupon | object | false | 【固定折扣特定信息】 |
| data.stock_use_rule.fixed_discount_coupon.discount_amount_max | integer | true | 【最高折扣金额】 最高折扣金额，单位分 |
| data.stock_use_rule.fixed_discount_coupon.discount_percent | integer | true | 【折扣百分比】 折扣百分比，例如88-八八折 |
| data.stock_use_rule.fixed_discount_coupon.transaction_minimum | integer | false | 【门槛】 使用券金额门槛，单位分 |
| data.available_begin_time | string | true | 【可用开始时间】 可用开始时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| data.available_end_time | string | true | 【可用结束时间】 可用结束时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| data.distributed_coupons | integer | true | 【已发券或消费金数量】 已发券或消费金数量 |
| data.no_cash | boolean | true | 【是否无资金流】 是否无资金流。枚举值：<br>ture：是<br>false：否 |
| data.start_time | string | false | 【激活批次的时间】 批次激活开启时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| data.stop_time | string | false | 【终止批次的时间】 批次永久停止时间，遵循 [rfc3339](https://datatracker.ietf.org/doc/html/rfc3339) 标准格式，格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.sss表示时分秒毫秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.120+08:00表示，北京时间2015年5月20日 13点29分35秒。 |
| data.cut_to_message | object | false | 【减至批次特定信息】 单品优惠特定信息 |
| data.cut_to_message.single_price_max | integer | true | 【可用优惠的商品最高单价】 可用优惠的商品最高单价，单位：分。 |
| data.cut_to_message.cut_to_price | integer | true | 【减至后的优惠单价】 减至后的优惠单价，单位：分。 |
| data.singleitem | boolean | true | 【是否单品优惠】 枚举值：<br>true：是<br>false：否 |
| data.stock_type | string | true | 【批次类型】 批次类型<br>枚举值：<br>NORMAL：代金券批次<br>DISCOUNT\_CUT：立减与折扣<br>OTHER：其他 |
| data.card_id | string | false | 【卡包ID】 微信卡包ID |
| data.business_type | string | false | 【业务类型】 细分业务类型，仅有当business\_type=MULTIUSE时，才会返回，枚举值：<br>MULTIUSE：消费金<br>可选取值<br><ul><li>`MULTIUSE`:  消费金类型</li></ul> |
| data.available_region_list | array[object] | false | 【消费金可用地域】 消费金可用地域列表，仅有当business\_type=MULTIUSE时，才会返回 |
| data.available_region_list.type | string | false | 【类型】 消费金可用地域的类型，COUNTRY表示国家级别可用，PROVINCE表示省级可用，CITY表示市级可用，DISTRICT表示区级可用。<br>可选取值<br><ul><li>`PROVINCE`:  地域信息精确到省级</li><li>`CITY`:  地域信息精确到市级</li><li>`DISTRICT`:  地域信息精确到区级</li><li>`COUNTRY`:  地域信息精确到国家级</li></ul> |
| data.available_region_list.province | string | false | 【省】 消费金可用省 |
| data.available_region_list.city | string | false | 【市】 消费金可用 |
| data.available_region_list.district | string | false | 【区】 消费金可用区 |
| data.available_region_list.country | string | false | 【国家】 消费金可用国家 |
| data.available_industry_list | array[string] | false | 【消费金可用行业】 消费金可用行业列表，仅有当business\_type=MULTIUSE时，才会返回 |
| limit | integer | true | 【分页大小】 分页大小，最大10 |
| offset | integer | true | 【分页页码】 页码从0开始，默认第0页 |
## 错误码

### 公共错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | APPID\_MCHID\_NOT\_MATCH | 商户号与AppID不匹配 | 请绑定调用接口的商户号和AppID后重试 |
| 400 | INVALID\_REQUEST | OpenID与AppID不匹配 | 请使用AppID下的OpenID |
| 400 | INVALID\_REQUEST | 活动已结束或未激活 | 请检查批次状态 |
| 400 | INVALID\_REQUEST | 非法的商户号 | 请检查商户号是否正确 |
| 400 | MCH\_NOT\_EXISTS | 商户号不合法 | 请输入正确的商户号 |
| 400 | PARAM\_ERROR | 回调URL不能为空 | 请填写回调URL |
| 400 | PARAM\_ERROR | 回调商户不能为空 | 请填写回调商户 |
| 400 | PARAM\_ERROR | 券ID必填 | 请填写券ID |
| 400 | PARAM\_ERROR | AppID必填 | 请输入AppID |
| 400 | PARAM\_ERROR | OpenID必填 | 请输入OpenID |
| 400 | PARAM\_ERROR | 页大小超过阈值 | 请不要超过最大的页大小 |
| 400 | PARAM\_ERROR | 输入时间格式错误 | 请输入正确的时间格式 |
| 400 | PARAM\_ERROR | 批次号必填 | 请输入批次号 |
| 400 | PARAM\_ERROR | 商户号必填 | 请输入商户号 |
| 400 | PARAM\_ERROR | 非法的批次状态 | 请检查批次状态 |
| 403 | NOT\_ENOUGH | 批次预算不足 | 请补充预算 |
| 403 | REQUEST\_BLOCKED | 调用商户无权限 | 请开通产品权限后再调用该接口 |
| 403 | REQUEST\_BLOCKED | 商户无权发券 | 调用接口的商户号无权发券，请检查是否是自己的批次或是已授权的批次。 |
| 403 | REQUEST\_BLOCKED | 批次不支持跨商户发券 | 该批次未做跨商户号的授权，请授权后再发放 |
| 403 | REQUEST\_BLOCKED | 用户被限领拦截 | 用户领取已经达到上限，请调高上限或停止发放。 |
| 403 | USER\_ACCOUNT\_ABNORMAL | 用户非法 | 该用户账号异常，无法领券。商家可联系微信支付或让用户联系微信支付客服处理。 |
| 404 | RESOURCE\_NOT\_EXISTS | 批次不存在 | 请检查批次ID是否正确 |
| 429 | FREQUENCY\_LIMITED | 请求过于频繁 | 稍后重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012460489-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012460489-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/merchant/4012460489-go.md)


应答示例

> 200 OK

```
{
  "total_count" : 10,
  "data" : [
    {
      "stock_id" : "9836588",
      "stock_creator_mchid" : "123456",
      "stock_name" : "微信支付批次",
      "status" : "paused",
      "create_time" : "2015-05-20T13:29:35.120+08:00",
      "description" : "微信支付营销",
      "stock_use_rule" : {
        "max_coupons" : 100,
        "max_amount" : 5000,
        "max_amount_by_day" : 400,
        "fixed_normal_coupon" : {
          "coupon_amount" : 100,
          "transaction_minimum" : 100
        },
        "max_coupons_per_user" : 3,
        "coupon_type" : "NORMAL",
        "goods_tag" : [
          "123456"
        ],
        "trade_type" : [
          "MICROAPP"
        ],
        "combine_use" : true,
        "fixed_discount_coupon" : {
          "discount_amount_max" : 100,
          "discount_percent" : 88,
          "transaction_minimum" : 100
        }
      },
      "available_begin_time" : "2015-05-20T13:29:35.120+08:00",
      "available_end_time" : "2015-05-20T13:29:35.120+08:00",
      "distributed_coupons" : 100,
      "no_cash" : true,
      "start_time" : "2015-05-20T13:29:35.120+08:00",
      "stop_time" : "2015-05-20T13:29:35.120+08:00",
      "cut_to_message" : {
        "single_price_max" : 100,
        "cut_to_price" : 80
      },
      "singleitem" : true,
      "stock_type" : "NORMAL",
      "card_id" : "pX2-vjoeC94Nn-r2g5GjDwkfFH7E",
      "business_type" : "MULTIUSE",
      "available_region_list" : [
        {
          "type" : "PROVINCE",
          "province" : "广东省",
          "city" : "深圳市",
          "district" : "南山区",
          "country" : "中国大陆"
        }
      ],
      "available_industry_list" : [
        "餐饮"
      ]
    }
  ],
  "limit" : 8,
  "offset" : 1
}

```
