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

文档中心 > API类目 > 电子凭证平台

taobao.vmarket.eticket.reverse (电子凭证冲正接口)

电子凭证平台冲正接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 1231223333 进行验码的电子凭证订单的订单ID
reverse_code String 必须 abc 冲正的码,只支持单个码
reverse_num Number 必须 1 冲正份数(必须是和被冲正的核销记录的份数一致)
consume_secial_num String 必须 1231223333 需要冲正的核销记录对应核销流水号(对应的核销操作时候传递的自定义流水号)
verify_codes String 可选 cde:1,ac:2 所有冲正后需要重新生成的码和对应的次数。码和次数之间用英文冒号分隔,多个码之间用英文逗号分隔。如果冲正后不需要重新生成码,留空
token String 必须 ca2bf41f1910a9c359370ebf87caeafd 安全验证token,需要和该订单发码通知中的token一致
codemerchant_id Number 可选 2054573190 码商ID,是码商的话必须传递,如果是信任卖家不要传
posid String 可选 20111958201 机具id,如果是码商必须传,如果是信任卖家不要传
qr_images String 可选 111.png,222.png,333 不需要上传二维码图片或者冲正后不需要变更码的请不要传,需要传入二维码的码商请先调用taobao.vmarket.eticket.qrcode.upload接口,将返回的img_filename文件名称作为参数,多个文件名用逗号隔开且与参数verify_codes按从左到有的顺序一一对应。

响应参数

名称 类型 示例值 描述
ret_code Number 0 0:失败,1:成功
left_num Number 1 整个订单的剩余可核销数量
item_title String 诺基亚N73 宝贝标题

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmarketEticketReverseRequest req = new VmarketEticketReverseRequest();
req.setOrderId(1231223333L);
req.setReverseCode("abc");
req.setReverseNum(1L);
req.setConsumeSecialNum("1231223333");
req.setVerifyCodes("cde:1,ac:2");
req.setToken("ca2bf41f1910a9c359370ebf87caeafd");
req.setCodemerchantId(2054573190L);
req.setPosid("20111958201");
req.setQrImages("111.png,222.png,333");
VmarketEticketReverseResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmarket_eticket_reverse_response>
    <ret_code>0</ret_code>
    <left_num>1</left_num>
    <item_title>诺基亚N73</item_title>
</vmarket_eticket_reverse_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 传递的订单ID参数找不到对应的电子凭证订单信息 传递正确的订单ID参数
isv.missing-parameter:token 缺少token参数 传递正确的token参数
isv.eticket-token-error:invalid-token 无效的token参数 传递正确的token参数
isv.eticket-seller-error:invalid-eticket-seller 码商/信任卖家没有入驻 入驻淘宝电子凭证平台
isv.eticket-privilege-error:order-not-belongto-seller 订单不属于用户授权登录的卖家/码商,卖家/码商没有权限操作这个订单 检查用户授权是否生效,并且授权的用户是否和订单所属的店铺的用户/绑定的码商一致
isv.eticket-invalid-posid:invalid-pos-for-codemerchant 无效的posid 检查posid是否在哎码商后台绑定
isv.eticket-code-error:invalid-code-format 需要重新生成的码的格式不正确 检查码的格式
isv.eticket-available-num-error:available-num-used-up 没有可用的码 检查是否有可用的码
isv.eticket-order-available-num:not-matched 可用码数量和重发数量不一致 检查重发的数量和可用码数量
isv.eticket-service-unavailable:op-failed 冲正失败 参考具体的错误信息处理
isv.eticket-service-unavailable:order-is-processing 订单并发操作并发限制 等待一段时间后调用
isv.eticket-reverse-error:invalid-serial-num 无效的核销流水号 检查核销流水号是否正确
isv.eticket-reverse-error:consume-serial-num-not-found 找不到对应的核销流水号 检查核销流水号是否正确
isv.eticket-service-unavailable:reverse-time-expire 过了可冲正的时间 停止调用冲正接口
isv.eticket-reverse-error:invalid-reverse-parameter 参数校验失败 检查调用的参数是否正确
isv.eticket-reverse-error:invalid-reverse-record 找不到冲正记录或者当前记录无法冲正 检查调用的参数是否正确
isv.eticket-reverse-error:invalid-reverse-operator 无权冲正该记录 检查要冲正的核销记录的发起方和冲正发起方是否一致,如果是码商调用该接口,需要检查posid是否一致
isv.eticket-reverse-error:reverse-num-not-match 冲正数量校验失败 检查冲正的数量和对应要冲正的核销记录的数量是否一致
isv.eticket-reverse-error:invalid-order-status-for-reverse 当前状态的订单不允许冲正 稍后重试
isv.eticket-privilege-error:no-upload-qrimage-rights 码商没有上传二维码图片权限 请先开通二维码上传权限
isv.eticket-qrimage-error:num-error 码商二维码图片数量不对 请保持与码一一对应

API工具

如何获得此API

FAQ

返回
顶部