注意：以下文档只适用于TOP接口，请谨慎使用！
注意：以下文档只适用于TOP接口，请谨慎使用！
商家验码之前的调用接口，用来同步到最新的订单状态并判断是否可以进行验码操作
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| 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 | 当前码剩余可核销数量 |
1 2 3 4 5 6 7 8 9 10 | 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()); |
1 2 3 4 5 6 7 8 9 10 11 | <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> |
1 2 3 4 5 6 | <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 |
