taobao.promotion.coupon.apply (优惠券领取)

优惠券领取

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
seller_id String 必须 AAHub-fwAAgOrLpFIt-YhaME 卖家id
spread_id String 必须 AAG2b-f0AAgOrLpFIt9A4oDm 传播id

响应参数

名称 类型 示例值 描述
error_msg String 卖家没有订购优惠券的服务 失败详细描述
apply_result Boolean true 领取结果,领取成功为true,否则为false
invoke_result Boolean true 接口调用结果,调用成功为true,否则为false
result_code String isv.error-unauthorized 调用错误码,只有调用失败的时候才会有

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PromotionCouponApplyRequest req = new PromotionCouponApplyRequest();
req.setSellerId("AAHub-fwAAgOrLpFIt-YhaME");
req.setSpreadId("AAG2b-f0AAgOrLpFIt9A4oDm");
PromotionCouponApplyResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<promotion_coupon_apply_response>
    <error_msg>卖家没有订购优惠券的服务</error_msg>
    <apply_result>true</apply_result>
    <invoke_result>true</invoke_result>
    <result_code>isv.error-unauthorized</result_code>
</promotion_coupon_apply_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>

错误码解释

错误码 错误描述 解决方案
isv.error-unauthorized 卖家没有订购优惠券的服务 通知卖家订购淘宝官方优惠券服务
isv.coupon-not-found 优惠券信息不存在 检查卖家id和券传播id
isv.coupon-invalid-or-deleted 优惠券失效或者已经删除 换一个有效的券
isv.coupon-not-bind 没有绑定该优惠券 到选券平台选定该优惠券
isv.coupon-apply-fail 优惠券领取失败 系统业务限制,一般换个买家即可
isp.couponApply-service-unavailable 系统繁忙,请稍后重试 系统繁忙,请稍后重试
isv.parameter-invalid 领券参数异常 请检查卖家id,券传播id等参数
isv.coupon-total-count-exceed-limit 优惠券已领完 换一张券,重新领取
isv.apply-single-count-exceed-limit 已达到优惠券限领张数 如果是同一个卖家,换一张券;如果是同一张券,换一个买家
isv.apply-one-seller-count-exceed-limit 领取单个卖家的券数量达到上限 换一个卖家
isv.apply-not-support 该张优惠券不支持领取 换一张支持领取的券
isv.apply-ownself-coupon 不能领取自己的优惠券 换买家
isv.coupon-amout-too-much 优惠券总金额过大 换一张券重新领取
isv.coupon-channel-not-match 优惠券渠道不匹配 请选择自己渠道的优惠券

API工具

如何获得此API

FAQ

返回
顶部