注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 电子物流API

taobao.vmarket.eticket.auth.consume (核销放行的核销接口)

针对O2O电子凭证核销放行业务,为满足码商能够核销淘宝码而开放的核销接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
verify_code String 必须 abc 核销的码,只支持单个码,多个码核销需要多次调用
operatorid String 必须 2054573190 核销方的ID,如果是普通码商必须传入机具ID,如果是私有码商家(即原有的信任商家)可默认传入私有码商ID
consume_num Number 必须 1 核销份数
serial_num String 必须 abc 自定义核销流水号,需要小于等于100个字符(a-zA-Z0-9_)
storeid String 可选 45133HJHN 网点ID,网点授权核销时,必须传入;其他核销方式可不传

响应参数

名称 类型 示例值 描述
ret_code Number 1 1:可以进行核销码操作
item_title String 诺基亚N73 商品标题
order_id Number 1111111111 订单ID
taobao_sid Number 1243456 淘宝卖家ID
seller_nick String 李四 淘宝卖家旺旺名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmarketEticketAuthConsumeRequest req = new VmarketEticketAuthConsumeRequest();
req.setVerifyCode("abc");
req.setOperatorid("2054573190");
req.setConsumeNum(1L);
req.setSerialNum("abc");
req.setStoreid("45133HJHN");
VmarketEticketAuthConsumeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmarket_eticket_auth_consume_response>
    <ret_code>1</ret_code>
    <item_title>诺基亚N73</item_title>
    <order_id>1111111111</order_id>
    <taobao_sid>1243456</taobao_sid>
    <seller_nick>李四</seller_nick>
</vmarket_eticket_auth_consume_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.missing-parameter:code 缺少码参数 调用接口的时候必须传递码参数
isv.eticket-order-not-found:invalid-orderid 传递的核销凭证码不存对应的订单 传递正确的核销凭证
isv.eticket-order-status-error:invalid-order-status 码对应的订单状态校验失败 此码对应的订单状态不允许进行核销码操作
isv.eticket-privilege-error:order-not-belongto-seller 商家家没有权限操作这个码 检查用户是否有这个权限及正确性
isv.eticket-code-not-found:invalid-code 电子凭证平台中找不到要核销的码 检查码的有效性
isv.eticket-code-status-invalid:invalid-code-status 码状态验证失败,不允许进行核销操作 检查码是否已经使用过
isv.eticket-service-unavailable:op-failed 服务异常 重新调用
isv.eticket-code-error:code-not-in-valid-time 要验证的码不再有效期范围内 请在正确的有效期内进行核销
isv.eticket-order-consume-num:consume-num-invalid 核销次数错误 检查是否输入了错误的核销次数:如0,-1,-3等非正整数
isv.eticket-order-consume-num:consume-num-overflow 请求核销次数大于该码的实际剩余可核销次数 不允许进行验码
isv.eticket-invalid-parameter:invalid-posid 普通码商没传递机具ID 或 传递了错误的posid(如posid=0);私有码商(即信任商家)默认没有传入商家ID 传递正确的关联网点的机具ID
isv.eticket-seller-error:invalid-eticket-seller appkey对应的用户没有入驻电子凭证平台 检查appkey对应的用户是否正确并且确认已经成功签署或补签过电子交易凭证入驻协议
isv.eticket-error-for-validate:some-validation-is-not-pass 一些通用校验没通过 请传递相关正确的参数
isv.eticket-service-unavailable:order-is-processing 订单并发操作并发限制 等待一段时间后调用
isv.eticket-consume-error:code-not-available 该码不能进行核销 检查code参数
isv.eticket-invalid-parameter:invalid-consume-serial-num 自定义核销流水号格式错误 必须是a-zA-Z0-9_的字母组成,长度不能超过100,不能以tbeticketsn_开头
isv.eticket-invalid-parameter:duplicate-consume-serial-num 重复的自定义核销流水号 每次核销都必须使用唯一的核销流水号

API工具

如何获得此API

FAQ

返回
顶部