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

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

taobao.vmarket.eticket.send (商家电子凭证发码成功回调接口)

外部商家成功发码回调接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 1531341313221 订单编号
verify_codes String 必须 abc:7,a12:2,bbb:1 发送成功的验证码及可验证次数的列表,码和可验证次数用英文冒号分隔,多个码之间用英文逗号分隔,所有字符都为英文半角
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);
VmarketEticketSendRequest req = new VmarketEticketSendRequest();
req.setOrderId(1531341313221L);
req.setVerifyCodes("abc:7,a12:2,bbb:1");
req.setToken("ca2bf41f1910a9c359370ebf87caeafd");
req.setCodemerchantId(2054573190L);
req.setQrImages("111.png,222.png");
VmarketEticketSendResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmarket_eticket_send_response>
    <ret_code>1</ret_code>
</vmarket_eticket_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>

错误码解释

错误码 错误描述 解决方案
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-service-unavailable:op-failed 服务异常 重新调用
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-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-send-error:code-num-not-match 码数量不正确 检查传递的码参数总的可核销次数与淘宝订单的购买数量是否一致
isv.eticket-service-unavailable:order-is-processing 订单并发操作并发限制 等待一段时间后调用
isv.eticket-send-error:code-alreay-send 订单已经发码成功 已经发码成功,不要重复调用
isv.eticket-privilege-error:no-upload-qrimage-rights 码商没有上传二维码图片权限 请先开通二维码上传权限
isv.eticket-qrimage-error:num-error 码商二维码图片数量不对 请保持与码一一对应
isv.eticket-vertical-error:vertical-error 订单数据获取异常 重试
isv.eticket-confirm-send: 确认发货失败 重试

API工具

如何获得此API

FAQ

返回
顶部