alibaba.wdk.coupon.template.update (优惠券模版修改)

优惠券模版修改

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_coupon_template_operate_request CouponTemplateOperateRequest 可选 请求
  • coupon_template
  • CouponTemplate
  • 必须
  • 券模版
  • apply_limit_config
  • CouponTemplateApplyLimitConfig
  • 必须
  • 领取限制
  • └ apply_end_time
  • Date
  • 可选
  • 2019-12-31 23:59:59
  • 优惠券最后能领取时间(超过这个时间,优惠券不能领取)
  • └ coupon_daily_lmt
  • Number
  • 可选
  • 1
  • 优惠券每日限领数(-1表示不限制)
  • └ coupon_total_lmt
  • Number
  • 必须
  • 1000
  • 优惠券总数(-1表示不限制)
  • └ personal_daily_lmt
  • Number
  • 可选
  • 1
  • 每人每日限领(-1表示不限制)
  • └ personal_lmt
  • Number
  • 可选
  • 1
  • 个人总领取限制数量(-1表示不限制)
  • └ apply_start_time
  • Date
  • 可选
  • 2019-12-31 23:59:59
  • 优惠券最早能领取时间(在这时间之前,优惠券不能领取)
  • common_config
  • CouponTemplateCommonConfig
  • 必须
  • 基础信息
  • └ apply_channels
  • String []
  • 可选
  • darunfa
  • 申请渠道 anonymousOffline
  • └ description
  • String
  • 必须
  • 全场8折
  • 优惠券活动描述
  • └ status
  • Number
  • 可选
  • 1
  • 模板状态 NORMAL(1, "有效"), DELETE(-1, "删除"), ENDING(0, "结束领取"), NOUSE(-2, "无效"), WDK_COUPON_DRAFT(-999, "草稿"),
  • └ title
  • String
  • 必须
  • 超市8折
  • 优惠券名称
  • └ type
  • Number
  • 必须
  • 6
  • 优惠券类型 FIX_PRICE(6,"fixPrice","新减至券,即一口价券"), FULL_AMOUNT_REDUCE(11, "fullAmountReduce", "满元减券"), FULL_AMOUNT_DISCOUNT(12, "fullAmountDiscount", "满元折券"), FULL_COUNT_REDUCE(13, "fullCountReduce", "满件减券"), FULL_COUNT_DISCOUNT(14, "fullCountDiscount", "满件折券"), VOUCHER(15, "voucher", "抵用券"),
  • └ send_type
  • String
  • 可选
  • anonymous
  • 优惠券发放方式 ANONYMOUS("anonymous","匿名券"), REGISTERED("registered","记名券"),
  • condition_config
  • CouponTemplateConditionConfig
  • 可选
  • 生效条件
  • └ amount
  • Number
  • 可选
  • 100
  • 门槛金额
  • └ amount_at
  • Boolean
  • 可选
  • false
  • 是否生效满元条件
  • └ categories
  • String []
  • 可选
  • 23123
  • 生效类目
  • └ count
  • Number
  • 可选
  • 1
  • 门槛件数
  • └ count_at
  • Boolean
  • 可选
  • false
  • 是否生效满件条件
  • └ only_member_self
  • Boolean
  • 可选
  • false
  • 是否限制本人使用
  • └ range_type
  • Number
  • 可选
  • 1
  • 券的使用范围 COUPON_RANGE_STORE(1, "rangeShop", "店铺券"), COUPON_RANGE_ITEM(2, "rangeItem", "商品券"), COUPON_RANGE_CATEGORY(3, "rangeCategory", "品类券"), COUPON_RANGE_SELLER(307,"rangeSeller", "卖家券"),
  • └ shop_ids
  • String []
  • 可选
  • 23123
  • 生效门店
  • └ terminals
  • String []
  • 可选
  • 1
  • 生效终端: 1.app 2.pos
  • user_crowd_config
  • CouponTemplateUserCrowdConfig
  • 可选
  • 人群信息
  • └ merchant_customize_crowd_name
  • String
  • 可选
  • DRFMem
  • 商家自定义人群
  • └ platform_crowd_name
  • String
  • 可选
  • HEMAX
  • 平台人群
  • └ max_use_count_per_order
  • Number
  • 可选
  • 12
  • 单笔订单最大可用张数
  • └ merchant_categories
  • String []
  • 可选
  • 601
  • 生效商家类目
  • discount_config
  • CouponTemplateDiscountConfig
  • 可选
  • 优惠效果
  • └ decrease
  • Boolean
  • 可选
  • false
  • 是否减钱
  • └ decrease_money
  • Number
  • 可选
  • 100
  • 减钱金额
  • └ discount
  • Boolean
  • 可选
  • false
  • 是否打折
  • └ discount_rate
  • Number
  • 可选
  • 10
  • 打折额度
  • └ fix_price_amount
  • Number
  • 可选
  • 1000
  • 优惠后的固定价格
  • └ fix_price
  • Boolean
  • 可选
  • false
  • 是否固定价格
  • └ id
  • Number
  • 可选
  • 1
  • 模板表主键 创建时为空
  • investment_config
  • CouponTemplateInvestmentConfig
  • 可选
  • 出资人配置
  • investment_info_list
  • InvestmentInfo []
  • 可选
  • 出资人配置
  • └ investor
  • String
  • 可选
  • caoding
  • 出资人
  • └ investor_ratio
  • Number
  • 可选
  • 2000
  • 出资比例 2000 = 20%
  • option_config
  • CouponTemplateOptionConfig
  • 可选
  • 其他配置--拓展信息
  • └ out_coupon_template_id
  • String
  • 可选
  • 11111
  • 外部优惠券模板id
  • └ out_coupon_type
  • String
  • 可选
  • qwer
  • 外部优惠券类型
  • └ logo_url
  • String
  • 可选
  • http://taobao.com
  • 优惠券logo url
  • └ picture_url
  • String
  • 可选
  • http://taobao.com
  • 券图片
  • └ purchase_id
  • Number
  • 可选
  • 1001
  • 采买者id
  • └ contract_instance_id
  • Number
  • 可选
  • 100100331414
  • 合同id
  • participate_config
  • CouponTemplateParticipateConfig
  • 可选
  • 参与者
  • participate_list
  • LogicGroup []
  • 可选
  • 参与者列表
  • └ number
  • Number
  • 可选
  • 1
  • 参与者分组序号
  • └ wdk_group_name
  • String
  • 可选
  • 换购
  • 五道口参与者名称
  • └ logic_group_type
  • Number
  • 可选
  • 1
  • 逻辑分组类型 COMMON(1, "普通分组"), EXCHANGE(2, "换购分组"), BUY_GIFT(3, "买赠分组"), EXCHANGE_TJ_OVERLAY(4, "特价换购叠加分组"),
  • └ source_id
  • Number
  • 可选
  • 1
  • ump模板ID
  • time_limit_config
  • CouponTemplateTimeLimitConfig
  • 可选
  • 实例有效时间配置
  • └ end_valid_time
  • Date
  • 可选
  • 2019-12-31 23:59:59
  • 优惠券结束时间
  • └ start_valid_time
  • Date
  • 可选
  • 2019-12-31 23:59:59
  • 优惠券开始时间
  • └ valid_time_type
  • Number
  • 可选
  • 1
  • 优惠券有效时间类型 RANGE(1,"开始/结束时间"), DURATION(2,"固定时长"),
  • └ validity_period
  • Number
  • 可选
  • 1000
  • 优惠券有效时长,单位为秒(固定有效时长的优惠券)
  • └ validity_start_interval
  • Number
  • 可选
  • 7200
  • 优惠券有效开始时长,单位为秒(优惠券领取后X天开始有效)
  • └ validity_end_interval
  • Number
  • 可选
  • 14400
  • 优惠券有效结束时长,单位为秒(优惠券领取后X-Y天有效的Y)
  • └ uuid
  • String
  • 可选
  • 113131212
  • 优惠券模版uuid
  • └ unique_id
  • String
  • 可选
  • 4123123
  • 幂等id
  • compatible_config
  • CouponTemplateCompatibleConfig
  • 可选
  • 兼容历史逻辑配置
  • └ valid_till_night
  • Number
  • 可选
  • 1
  • 是否要求优惠券在一天的23:59:59失效 1表示最后一秒失效
  • └ application_type
  • String
  • 可选
  • pointCoupon
  • 优惠券应用类型 pointCoupon:积分券
  • user_info
  • UserInfo
  • 可选
  • 用户信息
  • └ source
  • String
  • 可选
  • 1
  • 来源
  • └ user_id
  • Number
  • 可选
  • 1
  • 用户id
  • └ user_name
  • String
  • 可选
  • 1
  • 用户名称

响应参数

名称 类型 示例值 描述
result ApiResult 结果
  • └ err_code
  • String
  • 参数异常
  • 错误码
  • └ err_msg
  • String
  • 参数异常
  • 错误信息
  • └ model
  • String
  • 返回
  • └ success
  • Boolean
  • false
  • 成功标志

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkCouponTemplateUpdateRequest req = new AlibabaWdkCouponTemplateUpdateRequest();
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateOperateRequest obj1 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateOperateRequest();
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplate obj2 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplate();
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateApplyLimitConfig obj3 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateApplyLimitConfig();
obj3.setApplyEndTime(StringUtils.parseDateTime("2019-12-31 23:59:59"));
obj3.setCouponDailyLmt(1L);
obj3.setCouponTotalLmt(1000L);
obj3.setPersonalDailyLmt(1L);
obj3.setPersonalLmt(1L);
obj3.setApplyStartTime(StringUtils.parseDateTime("2019-12-31 23:59:59"));
obj2.setApplyLimitConfig(obj3);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateCommonConfig obj4 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateCommonConfig();
obj4.setApplyChannels("darunfa");
obj4.setDescription("全场8折");
obj4.setStatus(1L);
obj4.setTitle("超市8折");
obj4.setType(6L);
obj4.setSendType("anonymous");
obj2.setCommonConfig(obj4);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateConditionConfig obj5 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateConditionConfig();
obj5.setAmount(100L);
obj5.setAmountAt(false);
obj5.setCategories("23123");
obj5.setCount(1L);
obj5.setCountAt(false);
obj5.setOnlyMemberSelf(false);
obj5.setRangeType(1L);
obj5.setShopIds("23123");
obj5.setTerminals("1");
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateUserCrowdConfig obj6 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateUserCrowdConfig();
obj6.setMerchantCustomizeCrowdName("DRFMem");
obj6.setPlatformCrowdName("HEMAX");
obj5.setUserCrowdConfig(obj6);
obj5.setMaxUseCountPerOrder(12L);
obj5.setMerchantCategories("601");
obj2.setConditionConfig(obj5);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateDiscountConfig obj7 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateDiscountConfig();
obj7.setDecrease(false);
obj7.setDecreaseMoney(100L);
obj7.setDiscount(false);
obj7.setDiscountRate(10L);
obj7.setFixPriceAmount(1000L);
obj7.setFixPrice(false);
obj2.setDiscountConfig(obj7);
obj2.setId(1L);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateInvestmentConfig obj8 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateInvestmentConfig();
List<AlibabaWdkCouponTemplateUpdateRequest.InvestmentInfo> list10 = new ArrayList<AlibabaWdkCouponTemplateUpdateRequest.InvestmentInfo>();
AlibabaWdkCouponTemplateUpdateRequest.InvestmentInfo obj11 = new AlibabaWdkCouponTemplateUpdateRequest.InvestmentInfo();
list10.add(obj11);
obj11.setInvestor("caoding");
obj11.setInvestorRatio(2000L);
obj8.setInvestmentInfoList(list10);
obj2.setInvestmentConfig(obj8);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateOptionConfig obj12 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateOptionConfig();
obj12.setOutCouponTemplateId("11111");
obj12.setOutCouponType("qwer");
obj12.setLogoUrl("http://taobao.com");
obj12.setPictureUrl("http://taobao.com");
obj12.setPurchaseId(1001L);
obj12.setContractInstanceId(100100331414L);
obj2.setOptionConfig(obj12);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateParticipateConfig obj13 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateParticipateConfig();
List<AlibabaWdkCouponTemplateUpdateRequest.LogicGroup> list15 = new ArrayList<AlibabaWdkCouponTemplateUpdateRequest.LogicGroup>();
AlibabaWdkCouponTemplateUpdateRequest.LogicGroup obj16 = new AlibabaWdkCouponTemplateUpdateRequest.LogicGroup();
list15.add(obj16);
obj16.setNumber(1L);
obj16.setWdkGroupName("换购");
obj16.setLogicGroupType(1L);
obj13.setParticipateList(list15);
obj2.setParticipateConfig(obj13);
obj2.setSourceId(1L);
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateTimeLimitConfig obj17 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateTimeLimitConfig();
obj17.setEndValidTime(StringUtils.parseDateTime("2019-12-31 23:59:59"));
obj17.setStartValidTime(StringUtils.parseDateTime("2019-12-31 23:59:59"));
obj17.setValidTimeType(1L);
obj17.setValidityPeriod(1000L);
obj17.setValidityStartInterval(7200L);
obj17.setValidityEndInterval(14400L);
obj2.setTimeLimitConfig(obj17);
obj2.setUuid("113131212");
obj2.setUniqueId("4123123");
AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateCompatibleConfig obj18 = new AlibabaWdkCouponTemplateUpdateRequest.CouponTemplateCompatibleConfig();
obj18.setValidTillNight(1L);
obj18.setApplicationType("pointCoupon");
obj2.setCompatibleConfig(obj18);
obj1.setCouponTemplate(obj2);
AlibabaWdkCouponTemplateUpdateRequest.UserInfo obj19 = new AlibabaWdkCouponTemplateUpdateRequest.UserInfo();
obj19.setSource("1");
obj19.setUserId(1L);
obj19.setUserName("1");
obj1.setUserInfo(obj19);
req.setParamCouponTemplateOperateRequest(obj1);
AlibabaWdkCouponTemplateUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_wdk_coupon_template_update_response>
    <result>
        <err_code>参数异常</err_code>
        <err_msg>参数异常</err_msg>
        <model>空</model>
        <success>false</success>
    </result>
</alibaba_wdk_coupon_template_update_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部