失效商品券批次

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/partner/product-coupon/product-coupons/1000000013/stocks/1000000013001/deactivate \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_request_no" : "de_34657_20250101_123456",
8    "deactivate_reason" : "批次信息有误，重新创建",
9    "brand_id" : "120344"
10  }'
11

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

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