修改商品券批次

1curl -X PATCH \
2  https://api.mch.weixin.qq.com/brand/marketing/product-coupon/product-coupons/1000000013/stocks/1000000013001 \
3  -H "Authorization: WECHATPAY-BRAND-SHA256-RSA2048 brand_id=\"XXXX\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: PUB_KEY_ID_XXXX"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "store_scope" : "ALL",
9    "out_request_no" : "12345_20250101_A3489"
10  }'
11

1package com.java.demo;
2
3import com.java.utils.WXPayBrandUtility; // 引用微信支付工具库，参考：https://pay.weixin.qq.com/doc/brand/4015826861
4
5import com.google.gson.annotations.SerializedName;
6import com.google.gson.annotations.Expose;
7import okhttp3.MediaType;
8import okhttp3.OkHttpClient;
9import okhttp3.Request;
10import okhttp3.RequestBody;
11import okhttp3.Response;
12
13import java.io.IOException;
14import java.io.UncheckedIOException;
15import java.security.PrivateKey;
16import java.security.PublicKey;
17import java.util.ArrayList;
18import java.util.HashMap;
19import java.util.List;
20import java.util.Map;
21
22/**
23 * 修改商品券批次
24 */
25public class UpdateStock {
26  private static String HOST = "https://api.mch.weixin.qq.com";
27  private static String METHOD = "PATCH";
28  private static String PATH = "/brand/marketing/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}";
29
30  public static void main(String[] args) {
31    // TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/brand/4015415289
32    UpdateStock client = new UpdateStock(
33      "xxxxxxxx",                    // 品牌ID，是由微信支付系统生成并分配给每个品牌方的唯一标识符，品牌ID获取方式参考 https://pay.weixin.qq.com/doc/brand/4015415289
34      "1DDE55AD98Exxxxxxxxxx",         // 品牌API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015407570
35      "/path/to/apiclient_key.pem",     // 品牌API证书私钥文件路径，本地文件路径
36      "PUB_KEY_ID_xxxxxxxxxxxxx",      // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015453439
37      "/path/to/wxp_pub.pem"           // 微信支付公钥文件路径，本地文件路径
38    );
39
40    UpdateStockRequest request = new UpdateStockRequest();
41    request.outRequestNo = "12345_20250101_A3489";
42    request.productCouponId = "1000000013";
43    request.stockId = "1000000013001";
44    request.storeScope = StockStoreScope.ALL;
45    try {
46      StockEntity response = client.run(request);
47        // TODO: 请求成功，继续业务逻辑
48        System.out.println(response);
49    } catch (WXPayBrandUtility.ApiException e) {
50        // TODO: 请求失败，根据状态码执行不同的逻辑
51        e.printStackTrace();
52    }
53  }
54
55  public StockEntity run(UpdateStockRequest request) {
56    String uri = PATH;
57    uri = uri.replace("{product_coupon_id}", WXPayBrandUtility.urlEncode(request.productCouponId));
58    uri = uri.replace("{stock_id}", WXPayBrandUtility.urlEncode(request.stockId));
59    String reqBody = WXPayBrandUtility.toJson(request);
60
61    Request.Builder reqBuilder = new Request.Builder().url(HOST + uri);
62    reqBuilder.addHeader("Accept", "application/json");
63    reqBuilder.addHeader("Wechatpay-Serial", wechatPayPublicKeyId);
64    reqBuilder.addHeader("Authorization", WXPayBrandUtility.buildAuthorization(brand_id, certificateSerialNo,privateKey, METHOD, uri, reqBody));
65    reqBuilder.addHeader("Content-Type", "application/json");
66    RequestBody requestBody = RequestBody.create(MediaType.parse("application/json; charset=utf-8"), reqBody);
67    reqBuilder.method(METHOD, requestBody);
68    Request httpRequest = reqBuilder.build();
69
70    // 发送HTTP请求
71    OkHttpClient client = new OkHttpClient.Builder().build();
72    try (Response httpResponse = client.newCall(httpRequest).execute()) {
73      String respBody = WXPayBrandUtility.extractBody(httpResponse);
74      if (httpResponse.code() >= 200 && httpResponse.code() < 300) {
75        // 2XX 成功，验证应答签名
76        WXPayBrandUtility.validateResponse(this.wechatPayPublicKeyId, this.wechatPayPublicKey,
77            httpResponse.headers(), respBody);
78
79        // 从HTTP应答报文构建返回数据
80        return WXPayBrandUtility.fromJson(respBody, StockEntity.class);
81      } else {
82        throw new WXPayBrandUtility.ApiException(httpResponse.code(), respBody, httpResponse.headers());
83      }
84    } catch (IOException e) {
85      throw new UncheckedIOException("Sending request to " + uri + " failed.", e);
86    }
87  }
88
89  private final String brand_id;
90  private final String certificateSerialNo;
91  private final PrivateKey privateKey;
92  private final String wechatPayPublicKeyId;
93  private final PublicKey wechatPayPublicKey;
94
95  public UpdateStock(String brand_id, String certificateSerialNo, String privateKeyFilePath, String wechatPayPublicKeyId, String wechatPayPublicKeyFilePath) {
96    this.brand_id = brand_id;
97    this.certificateSerialNo = certificateSerialNo;
98    this.privateKey = WXPayBrandUtility.loadPrivateKeyFromPath(privateKeyFilePath);
99    this.wechatPayPublicKeyId = wechatPayPublicKeyId;
100    this.wechatPayPublicKey = WXPayBrandUtility.loadPublicKeyFromPath(wechatPayPublicKeyFilePath);
101  }
102
103  public static class UpdateStockRequest {
104    @SerializedName("out_request_no")
105    public String outRequestNo;
106  
107    @SerializedName("product_coupon_id")
108    @Expose(serialize = false)
109    public String productCouponId;
110  
111    @SerializedName("stock_id")
112    @Expose(serialize = false)
113    public String stockId;
114  
115    @SerializedName("remark")
116    public String remark;
117  
118    @SerializedName("usage_rule_display_info")
119    public UsageRuleDisplayInfo usageRuleDisplayInfo;
120  
121    @SerializedName("coupon_display_info")
122    public CouponDisplayInfo couponDisplayInfo;
123  
124    @SerializedName("notify_config")
125    public NotifyConfig notifyConfig;
126  
127    @SerializedName("store_scope")
128    public StockStoreScope storeScope;
129  }
130  
131  public static class StockEntity {
132    @SerializedName("product_coupon_id")
133    public String productCouponId;
134  
135    @SerializedName("stock_id")
136    public String stockId;
137  
138    @SerializedName("remark")
139    public String remark;
140  
141    @SerializedName("coupon_code_mode")
142    public CouponCodeMode couponCodeMode;
143  
144    @SerializedName("coupon_code_count_info")
145    public CouponCodeCountInfo couponCodeCountInfo;
146  
147    @SerializedName("stock_send_rule")
148    public StockSendRule stockSendRule;
149  
150    @SerializedName("single_usage_rule")
151    public SingleUsageRule singleUsageRule;
152  
153    @SerializedName("usage_rule_display_info")
154    public UsageRuleDisplayInfo usageRuleDisplayInfo;
155  
156    @SerializedName("coupon_display_info")
157    public CouponDisplayInfo couponDisplayInfo;
158  
159    @SerializedName("notify_config")
160    public NotifyConfig notifyConfig;
161  
162    @SerializedName("store_scope")
163    public StockStoreScope storeScope;
164  
165    @SerializedName("sent_count_info")
166    public StockSentCountInfo sentCountInfo;
167  
168    @SerializedName("state")
169    public StockState state;
170  
171    @SerializedName("deactivate_request_no")
172    public String deactivateRequestNo;
173  
174    @SerializedName("deactivate_time")
175    public String deactivateTime;
176  
177    @SerializedName("deactivate_reason")
178    public String deactivateReason;
179  }
180  
181  public static class UsageRuleDisplayInfo {
182    @SerializedName("coupon_usage_method_list")
183    public List<CouponUsageMethod> couponUsageMethodList = new ArrayList<CouponUsageMethod>();
184  
185    @SerializedName("mini_program_appid")
186    public String miniProgramAppid;
187  
188    @SerializedName("mini_program_path")
189    public String miniProgramPath;
190  
191    @SerializedName("app_path")
192    public String appPath;
193  
194    @SerializedName("usage_description")
195    public String usageDescription;
196  
197    @SerializedName("coupon_available_store_info")
198    public CouponAvailableStoreInfo couponAvailableStoreInfo;
199  }
200  
201  public static class CouponDisplayInfo {
202    @SerializedName("code_display_mode")
203    public CouponCodeDisplayMode codeDisplayMode;
204  
205    @SerializedName("background_color")
206    public String backgroundColor;
207  
208    @SerializedName("entrance_mini_program")
209    public EntranceMiniProgram entranceMiniProgram;
210  
211    @SerializedName("entrance_official_account")
212    public EntranceOfficialAccount entranceOfficialAccount;
213  
214    @SerializedName("entrance_finder")
215    public EntranceFinder entranceFinder;
216  }
217  
218  public static class NotifyConfig {
219    @SerializedName("notify_appid")
220    public String notifyAppid;
221  }
222  
223  public enum StockStoreScope {
224    @SerializedName("NONE")
225    NONE,
226    @SerializedName("ALL")
227    ALL,
228    @SerializedName("SPECIFIC")
229    SPECIFIC
230  }
231  
232  public enum CouponCodeMode {
233    @SerializedName("WECHATPAY")
234    WECHATPAY,
235    @SerializedName("UPLOAD")
236    UPLOAD,
237    @SerializedName("API_ASSIGN")
238    API_ASSIGN
239  }
240  
241  public static class CouponCodeCountInfo {
242    @SerializedName("total_count")
243    public Long totalCount;
244  
245    @SerializedName("available_count")
246    public Long availableCount;
247  }
248  
249  public static class StockSendRule {
250    @SerializedName("max_count")
251    public Long maxCount;
252  
253    @SerializedName("max_count_per_day")
254    public Long maxCountPerDay;
255  
256    @SerializedName("max_count_per_user")
257    public Long maxCountPerUser;
258  }
259  
260  public static class SingleUsageRule {
261    @SerializedName("coupon_available_period")
262    public CouponAvailablePeriod couponAvailablePeriod;
263  
264    @SerializedName("normal_coupon")
265    public NormalCouponUsageRule normalCoupon;
266  
267    @SerializedName("discount_coupon")
268    public DiscountCouponUsageRule discountCoupon;
269  
270    @SerializedName("exchange_coupon")
271    public ExchangeCouponUsageRule exchangeCoupon;
272  }
273  
274  public static class StockSentCountInfo {
275    @SerializedName("total_count")
276    public Long totalCount;
277  
278    @SerializedName("today_count")
279    public Long todayCount;
280  }
281  
282  public enum StockState {
283    @SerializedName("AUDITING")
284    AUDITING,
285    @SerializedName("SENDING")
286    SENDING,
287    @SerializedName("PAUSED")
288    PAUSED,
289    @SerializedName("STOPPED")
290    STOPPED,
291    @SerializedName("DEACTIVATED")
292    DEACTIVATED
293  }
294  
295  public enum CouponUsageMethod {
296    @SerializedName("OFFLINE")
297    OFFLINE,
298    @SerializedName("MINI_PROGRAM")
299    MINI_PROGRAM,
300    @SerializedName("APP")
301    APP,
302    @SerializedName("PAYMENT_CODE")
303    PAYMENT_CODE
304  }
305  
306  public static class CouponAvailableStoreInfo {
307    @SerializedName("description")
308    public String description;
309  
310    @SerializedName("mini_program_appid")
311    public String miniProgramAppid;
312  
313    @SerializedName("mini_program_path")
314    public String miniProgramPath;
315  }
316  
317  public enum CouponCodeDisplayMode {
318    @SerializedName("INVISIBLE")
319    INVISIBLE,
320    @SerializedName("BARCODE")
321    BARCODE,
322    @SerializedName("QRCODE")
323    QRCODE
324  }
325  
326  public static class EntranceMiniProgram {
327    @SerializedName("appid")
328    public String appid;
329  
330    @SerializedName("path")
331    public String path;
332  
333    @SerializedName("entrance_wording")
334    public String entranceWording;
335  
336    @SerializedName("guidance_wording")
337    public String guidanceWording;
338  }
339  
340  public static class EntranceOfficialAccount {
341    @SerializedName("appid")
342    public String appid;
343  }
344  
345  public static class EntranceFinder {
346    @SerializedName("finder_id")
347    public String finderId;
348  
349    @SerializedName("finder_video_id")
350    public String finderVideoId;
351  
352    @SerializedName("finder_video_cover_image_url")
353    public String finderVideoCoverImageUrl;
354  }
355  
356  public static class CouponAvailablePeriod {
357    @SerializedName("available_begin_time")
358    public String availableBeginTime;
359  
360    @SerializedName("available_end_time")
361    public String availableEndTime;
362  
363    @SerializedName("available_days")
364    public Long availableDays;
365  
366    @SerializedName("wait_days_after_receive")
367    public Long waitDaysAfterReceive;
368  
369    @SerializedName("weekly_available_period")
370    public FixedWeekPeriod weeklyAvailablePeriod;
371  
372    @SerializedName("irregular_available_period_list")
373    public List<TimePeriod> irregularAvailablePeriodList;
374  }
375  
376  public static class NormalCouponUsageRule {
377    @SerializedName("threshold")
378    public Long threshold;
379  
380    @SerializedName("discount_amount")
381    public Long discountAmount;
382  }
383  
384  public static class DiscountCouponUsageRule {
385    @SerializedName("threshold")
386    public Long threshold;
387  
388    @SerializedName("percent_off")
389    public Long percentOff;
390  }
391  
392  public static class ExchangeCouponUsageRule {
393    @SerializedName("threshold")
394    public Long threshold;
395  
396    @SerializedName("exchange_price")
397    public Long exchangePrice;
398  }
399  
400  public static class FixedWeekPeriod {
401    @SerializedName("day_list")
402    public List<WeekEnum> dayList;
403  
404    @SerializedName("day_period_list")
405    public List<PeriodOfTheDay> dayPeriodList;
406  }
407  
408  public static class TimePeriod {
409    @SerializedName("begin_time")
410    public String beginTime;
411  
412    @SerializedName("end_time")
413    public String endTime;
414  }
415  
416  public enum WeekEnum {
417    @SerializedName("MONDAY")
418    MONDAY,
419    @SerializedName("TUESDAY")
420    TUESDAY,
421    @SerializedName("WEDNESDAY")
422    WEDNESDAY,
423    @SerializedName("THURSDAY")
424    THURSDAY,
425    @SerializedName("FRIDAY")
426    FRIDAY,
427    @SerializedName("SATURDAY")
428    SATURDAY,
429    @SerializedName("SUNDAY")
430    SUNDAY
431  }
432  
433  public static class PeriodOfTheDay {
434    @SerializedName("begin_time")
435    public Long beginTime;
436  
437    @SerializedName("end_time")
438    public Long endTime;
439  }
440  
441}
442

1package main
2
3import (
4	"bytes"
5	"demo/wxpay_brand_utility" // 引用微信支付工具库，参考 https://pay.weixin.qq.com/doc/brand/4015826866
6	"encoding/json"
7	"fmt"
8	"net/http"
9	"net/url"
10	"strings"
11	"time"
12)
13
14func main() {
15	// TODO: 请准备商户开发必要参数，参考：https://pay.weixin.qq.com/doc/brand/4015415289
16	config, err := wxpay_brand_utility.CreateBrandConfig(
17		"xxxxxxxx",                   // 品牌ID，是由微信支付系统生成并分配给每个品牌方的唯一标识符，品牌ID获取方式参考 https://pay.weixin.qq.com/doc/brand/4015415289
18		"1DDE55AD98Exxxxxxxxxx",      // 品牌API证书序列号，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015407570
19		"/path/to/apiclient_key.pem", // 品牌API证书私钥文件路径，本地文件路径
20		"PUB_KEY_ID_xxxxxxxxxxxxx",   // 微信支付公钥ID，如何获取请参考 https://pay.weixin.qq.com/doc/brand/4015453439
21		"/path/to/wxp_pub.pem",       // 微信支付公钥文件路径，本地文件路径
22	)
23	if err != nil {
24		fmt.Println(err)
25		return
26	}
27
28	request := &UpdateStockRequest{
29		OutRequestNo:    wxpay_brand_utility.String("12345_20250101_A3489"),
30		ProductCouponId: wxpay_brand_utility.String("1000000013"),
31		StockId:         wxpay_brand_utility.String("1000000013001"),
32		StoreScope:      STOCKSTORESCOPE_ALL.Ptr(),
33	}
34
35	response, err := UpdateStock(config, request)
36	if err != nil {
37		fmt.Printf("请求失败: %+v\n", err)
38		// TODO: 请求失败，根据状态码执行不同的处理
39		return
40	}
41
42	// TODO: 请求成功，继续业务逻辑
43	fmt.Printf("请求成功: %+v\n", response)
44}
45
46func UpdateStock(config *wxpay_brand_utility.BrandConfig, request *UpdateStockRequest) (response *StockEntity, err error) {
47	const (
48		host   = "https://api.mch.weixin.qq.com"
49		method = "PATCH"
50		path   = "/brand/marketing/product-coupon/product-coupons/{product_coupon_id}/stocks/{stock_id}"
51	)
52
53	reqUrl, err := url.Parse(fmt.Sprintf("%s%s", host, path))
54	if err != nil {
55		return nil, err
56	}
57	reqUrl.Path = strings.Replace(reqUrl.Path, "{product_coupon_id}", url.PathEscape(*request.ProductCouponId), -1)
58	reqUrl.Path = strings.Replace(reqUrl.Path, "{stock_id}", url.PathEscape(*request.StockId), -1)
59	reqBody, err := json.Marshal(request)
60	if err != nil {
61		return nil, err
62	}
63	httpRequest, err := http.NewRequest(method, reqUrl.String(), bytes.NewReader(reqBody))
64	if err != nil {
65		return nil, err
66	}
67	httpRequest.Header.Set("Accept", "application/json")
68	httpRequest.Header.Set("Wechatpay-Serial", config.WechatPayPublicKeyId())
69	httpRequest.Header.Set("Content-Type", "application/json")
70	authorization, err := wxpay_brand_utility.BuildAuthorization(config.BrandId(), config.CertificateSerialNo(), config.PrivateKey(), method, reqUrl.RequestURI(), reqBody)
71	if err != nil {
72		return nil, err
73	}
74	httpRequest.Header.Set("Authorization", authorization)
75
76	client := &http.Client{}
77	httpResponse, err := client.Do(httpRequest)
78	if err != nil {
79		return nil, err
80	}
81	respBody, err := wxpay_brand_utility.ExtractResponseBody(httpResponse)
82	if err != nil {
83		return nil, err
84	}
85	if httpResponse.StatusCode >= 200 && httpResponse.StatusCode < 300 {
86		// 2XX 成功，验证应答签名
87		err = wxpay_brand_utility.ValidateResponse(
88			config.WechatPayPublicKeyId(),
89			config.WechatPayPublicKey(),
90			&httpResponse.Header,
91			respBody,
92		)
93		if err != nil {
94			return nil, err
95		}
96		response := &StockEntity{}
97		if err := json.Unmarshal(respBody, response); err != nil {
98			return nil, err
99		}
100
101		return response, nil
102	} else {
103		return nil, wxpay_brand_utility.NewApiException(
104			httpResponse.StatusCode,
105			httpResponse.Header,
106			respBody,
107		)
108	}
109}
110
111type UpdateStockRequest struct {
112	OutRequestNo         *string               `json:"out_request_no,omitempty"`
113	ProductCouponId      *string               `json:"product_coupon_id,omitempty"`
114	StockId              *string               `json:"stock_id,omitempty"`
115	Remark               *string               `json:"remark,omitempty"`
116	UsageRuleDisplayInfo *UsageRuleDisplayInfo `json:"usage_rule_display_info,omitempty"`
117	CouponDisplayInfo    *CouponDisplayInfo    `json:"coupon_display_info,omitempty"`
118	NotifyConfig         *NotifyConfig         `json:"notify_config,omitempty"`
119	StoreScope           *StockStoreScope      `json:"store_scope,omitempty"`
120}
121
122func (o *UpdateStockRequest) MarshalJSON() ([]byte, error) {
123	type Alias UpdateStockRequest
124	a := &struct {
125		ProductCouponId *string `json:"product_coupon_id,omitempty"`
126		StockId         *string `json:"stock_id,omitempty"`
127		*Alias
128	}{
129		// 序列化时移除非 Body 字段
130		ProductCouponId: nil,
131		StockId:         nil,
132		Alias:           (*Alias)(o),
133	}
134	return json.Marshal(a)
135}
136
137type StockEntity struct {
138	ProductCouponId      *string               `json:"product_coupon_id,omitempty"`
139	StockId              *string               `json:"stock_id,omitempty"`
140	Remark               *string               `json:"remark,omitempty"`
141	CouponCodeMode       *CouponCodeMode       `json:"coupon_code_mode,omitempty"`
142	CouponCodeCountInfo  *CouponCodeCountInfo  `json:"coupon_code_count_info,omitempty"`
143	StockSendRule        *StockSendRule        `json:"stock_send_rule,omitempty"`
144	SingleUsageRule      *SingleUsageRule      `json:"single_usage_rule,omitempty"`
145	UsageRuleDisplayInfo *UsageRuleDisplayInfo `json:"usage_rule_display_info,omitempty"`
146	CouponDisplayInfo    *CouponDisplayInfo    `json:"coupon_display_info,omitempty"`
147	NotifyConfig         *NotifyConfig         `json:"notify_config,omitempty"`
148	StoreScope           *StockStoreScope      `json:"store_scope,omitempty"`
149	SentCountInfo        *StockSentCountInfo   `json:"sent_count_info,omitempty"`
150	State                *StockState           `json:"state,omitempty"`
151	DeactivateRequestNo  *string               `json:"deactivate_request_no,omitempty"`
152	DeactivateTime       *time.Time            `json:"deactivate_time,omitempty"`
153	DeactivateReason     *string               `json:"deactivate_reason,omitempty"`
154}
155
156type UsageRuleDisplayInfo struct {
157	CouponUsageMethodList    []CouponUsageMethod       `json:"coupon_usage_method_list,omitempty"`
158	MiniProgramAppid         *string                   `json:"mini_program_appid,omitempty"`
159	MiniProgramPath          *string                   `json:"mini_program_path,omitempty"`
160	AppPath                  *string                   `json:"app_path,omitempty"`
161	UsageDescription         *string                   `json:"usage_description,omitempty"`
162	CouponAvailableStoreInfo *CouponAvailableStoreInfo `json:"coupon_available_store_info,omitempty"`
163}
164
165type CouponDisplayInfo struct {
166	CodeDisplayMode         *CouponCodeDisplayMode   `json:"code_display_mode,omitempty"`
167	BackgroundColor         *string                  `json:"background_color,omitempty"`
168	EntranceMiniProgram     *EntranceMiniProgram     `json:"entrance_mini_program,omitempty"`
169	EntranceOfficialAccount *EntranceOfficialAccount `json:"entrance_official_account,omitempty"`
170	EntranceFinder          *EntranceFinder          `json:"entrance_finder,omitempty"`
171}
172
173type NotifyConfig struct {
174	NotifyAppid *string `json:"notify_appid,omitempty"`
175}
176
177type StockStoreScope string
178
179func (e StockStoreScope) Ptr() *StockStoreScope {
180	return &e
181}
182
183const (
184	STOCKSTORESCOPE_NONE     StockStoreScope = "NONE"
185	STOCKSTORESCOPE_ALL      StockStoreScope = "ALL"
186	STOCKSTORESCOPE_SPECIFIC StockStoreScope = "SPECIFIC"
187)
188
189type CouponCodeMode string
190
191func (e CouponCodeMode) Ptr() *CouponCodeMode {
192	return &e
193}
194
195const (
196	COUPONCODEMODE_WECHATPAY  CouponCodeMode = "WECHATPAY"
197	COUPONCODEMODE_UPLOAD     CouponCodeMode = "UPLOAD"
198	COUPONCODEMODE_API_ASSIGN CouponCodeMode = "API_ASSIGN"
199)
200
201type CouponCodeCountInfo struct {
202	TotalCount     *int64 `json:"total_count,omitempty"`
203	AvailableCount *int64 `json:"available_count,omitempty"`
204}
205
206type StockSendRule struct {
207	MaxCount        *int64 `json:"max_count,omitempty"`
208	MaxCountPerDay  *int64 `json:"max_count_per_day,omitempty"`
209	MaxCountPerUser *int64 `json:"max_count_per_user,omitempty"`
210}
211
212type SingleUsageRule struct {
213	CouponAvailablePeriod *CouponAvailablePeriod   `json:"coupon_available_period,omitempty"`
214	NormalCoupon          *NormalCouponUsageRule   `json:"normal_coupon,omitempty"`
215	DiscountCoupon        *DiscountCouponUsageRule `json:"discount_coupon,omitempty"`
216	ExchangeCoupon        *ExchangeCouponUsageRule `json:"exchange_coupon,omitempty"`
217}
218
219type StockSentCountInfo struct {
220	TotalCount *int64 `json:"total_count,omitempty"`
221	TodayCount *int64 `json:"today_count,omitempty"`
222}
223
224type StockState string
225
226func (e StockState) Ptr() *StockState {
227	return &e
228}
229
230const (
231	STOCKSTATE_AUDITING    StockState = "AUDITING"
232	STOCKSTATE_SENDING     StockState = "SENDING"
233	STOCKSTATE_PAUSED      StockState = "PAUSED"
234	STOCKSTATE_STOPPED     StockState = "STOPPED"
235	STOCKSTATE_DEACTIVATED StockState = "DEACTIVATED"
236)
237
238type CouponUsageMethod string
239
240func (e CouponUsageMethod) Ptr() *CouponUsageMethod {
241	return &e
242}
243
244const (
245	COUPONUSAGEMETHOD_OFFLINE      CouponUsageMethod = "OFFLINE"
246	COUPONUSAGEMETHOD_MINI_PROGRAM CouponUsageMethod = "MINI_PROGRAM"
247	COUPONUSAGEMETHOD_APP          CouponUsageMethod = "APP"
248	COUPONUSAGEMETHOD_PAYMENT_CODE CouponUsageMethod = "PAYMENT_CODE"
249)
250
251type CouponAvailableStoreInfo struct {
252	Description      *string `json:"description,omitempty"`
253	MiniProgramAppid *string `json:"mini_program_appid,omitempty"`
254	MiniProgramPath  *string `json:"mini_program_path,omitempty"`
255}
256
257type CouponCodeDisplayMode string
258
259func (e CouponCodeDisplayMode) Ptr() *CouponCodeDisplayMode {
260	return &e
261}
262
263const (
264	COUPONCODEDISPLAYMODE_INVISIBLE CouponCodeDisplayMode = "INVISIBLE"
265	COUPONCODEDISPLAYMODE_BARCODE   CouponCodeDisplayMode = "BARCODE"
266	COUPONCODEDISPLAYMODE_QRCODE    CouponCodeDisplayMode = "QRCODE"
267)
268
269type EntranceMiniProgram struct {
270	Appid           *string `json:"appid,omitempty"`
271	Path            *string `json:"path,omitempty"`
272	EntranceWording *string `json:"entrance_wording,omitempty"`
273	GuidanceWording *string `json:"guidance_wording,omitempty"`
274}
275
276type EntranceOfficialAccount struct {
277	Appid *string `json:"appid,omitempty"`
278}
279
280type EntranceFinder struct {
281	FinderId                 *string `json:"finder_id,omitempty"`
282	FinderVideoId            *string `json:"finder_video_id,omitempty"`
283	FinderVideoCoverImageUrl *string `json:"finder_video_cover_image_url,omitempty"`
284}
285
286type CouponAvailablePeriod struct {
287	AvailableBeginTime           *string          `json:"available_begin_time,omitempty"`
288	AvailableEndTime             *string          `json:"available_end_time,omitempty"`
289	AvailableDays                *int64           `json:"available_days,omitempty"`
290	WaitDaysAfterReceive         *int64           `json:"wait_days_after_receive,omitempty"`
291	WeeklyAvailablePeriod        *FixedWeekPeriod `json:"weekly_available_period,omitempty"`
292	IrregularAvailablePeriodList []TimePeriod     `json:"irregular_available_period_list,omitempty"`
293}
294
295type NormalCouponUsageRule struct {
296	Threshold      *int64 `json:"threshold,omitempty"`
297	DiscountAmount *int64 `json:"discount_amount,omitempty"`
298}
299
300type DiscountCouponUsageRule struct {
301	Threshold  *int64 `json:"threshold,omitempty"`
302	PercentOff *int64 `json:"percent_off,omitempty"`
303}
304
305type ExchangeCouponUsageRule struct {
306	Threshold     *int64 `json:"threshold,omitempty"`
307	ExchangePrice *int64 `json:"exchange_price,omitempty"`
308}
309
310type FixedWeekPeriod struct {
311	DayList       []WeekEnum       `json:"day_list,omitempty"`
312	DayPeriodList []PeriodOfTheDay `json:"day_period_list,omitempty"`
313}
314
315type TimePeriod struct {
316	BeginTime *string `json:"begin_time,omitempty"`
317	EndTime   *string `json:"end_time,omitempty"`
318}
319
320type WeekEnum string
321
322func (e WeekEnum) Ptr() *WeekEnum {
323	return &e
324}
325
326const (
327	WEEKENUM_MONDAY    WeekEnum = "MONDAY"
328	WEEKENUM_TUESDAY   WeekEnum = "TUESDAY"
329	WEEKENUM_WEDNESDAY WeekEnum = "WEDNESDAY"
330	WEEKENUM_THURSDAY  WeekEnum = "THURSDAY"
331	WEEKENUM_FRIDAY    WeekEnum = "FRIDAY"
332	WEEKENUM_SATURDAY  WeekEnum = "SATURDAY"
333	WEEKENUM_SUNDAY    WeekEnum = "SUNDAY"
334)
335
336type PeriodOfTheDay struct {
337	BeginTime *int64 `json:"begin_time,omitempty"`
338	EndTime   *int64 `json:"end_time,omitempty"`
339}
340