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

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

taobao.vmarket.eticket.beforeconsume (电子凭证验码前置确认)

商家验码之前的调用接口,用来同步到最新的订单状态并判断是否可以进行验码操作

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 必须 1231223333 需要验码的电子凭证订单ID
verify_code String 必须 abc 需要验的码
token String 必须 ca2bf41f1910a9c359370ebf87caeafd 安全验证token,需要和发码通知中的token一致
codemerchant_id Number 可选 2054573190 码商ID,是码商的话必须传递,如果是信任卖家不需要传
posid String 可选 1111111111 操作员身份ID,如果是码商必须传,如果是信任卖家不需要传
mobile String 可选 1234 手机号码后四位,没有特殊说明请不要传

响应参数

名称 类型 示例值 描述
ret_code Number 1 1:可以进行核销码操作
valid_ends Date 2000-01-01 00:00:00 有效期结束时间
valid_start Date 2000-01-01 00:00:00 有效期开始时间
left_num Number 0 当前订单剩余可核销数量
left_amount String 1.00 扩展字段,暂时预留为0,没有任何意义
item_title String 诺基亚N73 商品标题
order_id Number 1111111111 订单ID
item_type Number 0 扩展字段,暂时预留为0,没有任何意义
code_left_num Number 1 当前码剩余可核销数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
VmarketEticketBeforeconsumeRequest req = new VmarketEticketBeforeconsumeRequest();
req.setOrderId(1231223333L);
req.setVerifyCode("abc");
req.setToken("ca2bf41f1910a9c359370ebf87caeafd");
req.setCodemerchantId(2054573190L);
req.setPosid("1111111111");
req.setMobile("1234");
VmarketEticketBeforeconsumeResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<vmarket_eticket_beforeconsume_response>
    <ret_code>1</ret_code>
    <valid_ends>2000-01-01 00:00:00</valid_ends>
    <valid_start>2000-01-01 00:00:00</valid_start>
    <left_num>0</left_num>
    <left_amount>1.00</left_amount>
    <item_title>诺基亚N73</item_title>
    <order_id>1111111111</order_id>
    <item_type>0</item_type>
    <code_left_num>1</code_left_num>
</vmarket_eticket_beforeconsume_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.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:code-not-in-valid-time 要验证的码不在有效期范围内 不允许进行验码
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-invalid-posid:invalid-pos-for-codemerchant posid参数校验失败 检查传递的posid是否和码商做了绑定
isv.eticket-consume-error:code-not-available 该码不能进行核销 检查code参数
isv.eticket-service-unavailable:op-failed 服务异常 重新调用
isv.eticket-order-posID:posid-not-bind 未绑定机具ID 码商后台绑定机具ID

API工具

如何获得此API

FAQ

返回
顶部