文档中心 > API类目 > 天猫新零售

tmall.nrt.newcoupon.send (券发放接口)

券发放接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nrt_coupon_send_dto NrtCouponSendDto 必须 发券dto
  • └ open_id
  • String
  • 必须
  • YXXdfdsdfow
  • 加密后淘系ID
  • └ coupon_type
  • Number
  • 必须
  • 1
  • 券类型,247:品类券,276:门店券,357:门店通用券
  • └ biz_code
  • String
  • 必须
  • YXX
  • 业务code
  • └ extra
  • String
  • 可选
  • 扩展字段
  • {"key","value"}
  • └ channel
  • String
  • 必须
  • app
  • 渠道
  • └ out_id
  • String
  • 必须
  • 11111
  • 幂等ID
  • └ uuid
  • String
  • 必须
  • fsdfsfee1f2
  • 券code

响应参数

名称 类型 示例值 描述
result Result 系统自动生成
  • └ code
  • String
  • 0
  • 错误码
  • model
  • SendCouponResponse
  • null
  • 发券结果对象
  • └ discount
  • Number
  • 10
  • 面额
  • └ start_fee
  • Number
  • 100
  • 门槛
  • └ coupon_name
  • String
  • 测试券
  • 券名称
  • └ coupon_template_id
  • Number
  • 12345
  • 券模板ID
  • └ coupon_instance_id
  • Number
  • 12344
  • 券实例ID
  • └ end_time
  • Number
  • 123345
  • 结束时间
  • └ start_time
  • Number
  • 123345
  • 开始时间
  • └ message
  • String
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallNrtNewcouponSendRequest req = new TmallNrtNewcouponSendRequest();
TmallNrtNewcouponSendRequest.NrtCouponSendDto obj1 = new TmallNrtNewcouponSendRequest.NrtCouponSendDto();
obj1.setOpenId("YXXdfdsdfow");
obj1.setCouponType(1L);
obj1.setBizCode("YXX");
obj1.setExtra("扩展字段");
obj1.setChannel("app");
obj1.setOutId("11111");
obj1.setUuid("fsdfsfee1f2");
req.setNrtCouponSendDto(obj1);
TmallNrtNewcouponSendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_nrt_newcoupon_send_response>
    <result>
        <code>0</code>
        <model>
            <discount>10</discount>
            <start_fee>100</start_fee>
            <coupon_name>测试券</coupon_name>
            <coupon_template_id>12345</coupon_template_id>
            <coupon_instance_id>12344</coupon_instance_id>
            <end_time>123345</end_time>
            <start_time>123345</start_time>
        </model>
        <message></message>
    </result>
</tmall_nrt_newcoupon_send_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

返回
顶部