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

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

taobao.vmarket.eticket.resend (外部合作商家重发电子凭证回调接口)

外部合作商家重发电子凭证回调接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 1231223333 订单编号
verify_codes String 必须 abc:7,a12:2,bbb:1 重新发送的验证码及可验证次数的列表,多个码之间用英文逗号分割,需要包含此订单所有可用的码(如果订单总的有10个码,可用的是5个,那么这里设置的是5个可用的码)
token String 必须 ca2bf41f1910a9c359370ebf87caeafd 安全验证token,回传淘宝发通知时发过来的token串
codemerchant_id Number 可选 2054573190 码商ID,如果是码商,必须传,如果是信任卖家,不需要传
qr_images String 可选 111.png,222.png 不需要上传二维码图片的码商请不要传,需要传入二维码的码商请先调用taobao.vmarket.eticket.qrcode.upload接口,将返回的img_filename文件名称作为参数(如果二维码不变的话,也可将将发码时传入二维码文件名作为参数传入),多个文件名用逗号隔开且与参数verify_codes按从左到有的顺序一一对应。

响应参数

名称 类型 示例值 描述
ret_code Number 1 0:失败,1:成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmarketEticketResendRequest req = new VmarketEticketResendRequest();
req.setOrderId(1231223333L);
req.setVerifyCodes("abc:7,a12:2,bbb:1");
req.setToken("ca2bf41f1910a9c359370ebf87caeafd");
req.setCodemerchantId(2054573190L);
req.setQrImages("111.png,222.png");
VmarketEticketResendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmarket_eticket_resend_response>
    <ret_code>1</ret_code>
</vmarket_eticket_resend_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:codes 缺少码参数 调用接口的时候必须传递码参数
isv.eticket-order-not-found:invalid-orderid 传递的订单ID参数找不到对应的电子凭证订单信息 传递正确的订单ID参数
isv.eticket-order-status-error:invalid-order-status 此状态的订单不允许进行重发操作 此状态的订单不允许进行重发操作,需要先将订单状态更新成已经发货或者交易成功状态才能进行重发操作
isv.eticket-privilege-error:order-not-belongto-seller 订单不属于用户授权登录的卖家,卖家没有权限操作这个订单 检查用户授权是否有效,并且授权的用户是否和订单所属的店铺的用户一致
isv.eticket-code-error:invalid-code-format 码格式不对 请确认是否是api文档上的格式:codeone:2,codetow:1,codethree:3
isv.eticket-order-available-num:not-matched 总的可核销次数与淘宝订单的购买数量不符 检查传递的码参数
isv.missing-parameter:token 缺少token参数 传递token参数
isv.eticket-token-error:invalid-token 错误的token 使用正确的token
isv.eticket-available-num-error:available-num-used-up 当前订单的可用码的总的可核销次数已经用完 不可重发
isv.eticket-invalid-code-merchant:invalid-code-merchant 码商身份校验不通过 传递正确的码商ID
isv.eticket-seller-error:invalid-eticket-seller 信任卖家身份校验不通过 请确认已经成功签署或补签过电子交易凭证入驻协议
isv.eticket-error-for-validate:some-validation-is-not-pass 一些通用校验没通过 请传递相关的正确参数
isv.eticket-resend-error:code-num-not-match 码数量不对 检查传递的码参数总的可核销次数与淘宝订单的剩余可用数量是否一致
isv.eticket-service-unavailable:order-is-processing 订单并发操作并发限制 等待一段时间后调用
isv.eticket-resend-error:no-can-resend-code 没有可以重发的码 停止调用
isv.eticket-privilege-error:no-upload-qrimage-rights 码商没有上传二维码图片权限 请先开通二维码上传权限
isv.eticket-qrimage-error:num-error 码商二维码图片数量不对 请保持与码一一对应

API工具

如何获得此API

FAQ

返回
顶部