针对O2O电子凭证核销放行业务，为满足码商能够核销淘宝码而开放的核销接口
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| verify_code | String | 必须 | abc | 核销的码，只支持单个码，多个码核销需要多次调用 | |
| operatorid | String | 必须 | 2054573190 | 核销方的ID，如果是普通码商必须传入机具ID,如果是私有码商家（即原有的信任商家）可默认传入私有码商ID | |
| consume_num | Number | 必须 | 1 | 核销份数 | |
| serial_num | String | 必须 | abc | 自定义核销流水号，需要小于等于100个字符(a-zA-Z0-9_) | |
| storeid | String | 可选 | 45133HJHN | 网点ID,网点授权核销时，必须传入；其他核销方式可不传 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| ret_code | Number | 1 | 1:可以进行核销码操作 |
| item_title | String | 诺基亚N73 | 商品标题 |
| order_id | Number | 1111111111 | 订单ID |
| taobao_sid | Number | 1243456 | 淘宝卖家ID |
| seller_nick | String | 李四 | 淘宝卖家旺旺名称 |
1 2 3 4 5 6 7 8 9 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);VmarketEticketAuthConsumeRequest req = new VmarketEticketAuthConsumeRequest();req.setVerifyCode("abc");req.setOperatorid("2054573190");req.setConsumeNum(1L);req.setSerialNum("abc");req.setStoreid("45133HJHN");VmarketEticketAuthConsumeResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 | <vmarket_eticket_auth_consume_response> <ret_code>1</ret_code> <item_title>诺基亚N73</item_title> <order_id>1111111111</order_id> <taobao_sid>1243456</taobao_sid> <seller_nick>李四</seller_nick></vmarket_eticket_auth_consume_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.missing-parameter:code | 缺少码参数 | 调用接口的时候必须传递码参数 |
| isv.eticket-order-not-found:invalid-orderid | 传递的核销凭证码不存对应的订单 | 传递正确的核销凭证 |
| isv.eticket-order-status-error:invalid-order-status | 码对应的订单状态校验失败 | 此码对应的订单状态不允许进行核销码操作 |
| isv.eticket-privilege-error:order-not-belongto-seller | 商家家没有权限操作这个码 | 检查用户是否有这个权限及正确性 |
| isv.eticket-code-not-found:invalid-code | 电子凭证平台中找不到要核销的码 | 检查码的有效性 |
| isv.eticket-code-status-invalid:invalid-code-status | 码状态验证失败，不允许进行核销操作 | 检查码是否已经使用过 |
| isv.eticket-service-unavailable:op-failed | 服务异常 | 重新调用 |
| isv.eticket-code-error:code-not-in-valid-time | 要验证的码不再有效期范围内 | 请在正确的有效期内进行核销 |
| isv.eticket-order-consume-num:consume-num-invalid | 核销次数错误 | 检查是否输入了错误的核销次数：如0，-1，-3等非正整数 |
| isv.eticket-order-consume-num:consume-num-overflow | 请求核销次数大于该码的实际剩余可核销次数 | 不允许进行验码 |
| isv.eticket-invalid-parameter:invalid-posid | 普通码商没传递机具ID 或 传递了错误的posid(如posid=0)；私有码商（即信任商家）默认没有传入商家ID | 传递正确的关联网点的机具ID |
| isv.eticket-seller-error:invalid-eticket-seller | appkey对应的用户没有入驻电子凭证平台 | 检查appkey对应的用户是否正确并且确认已经成功签署或补签过电子交易凭证入驻协议 |
| isv.eticket-error-for-validate:some-validation-is-not-pass | 一些通用校验没通过 | 请传递相关正确的参数 |
| isv.eticket-service-unavailable:order-is-processing | 订单并发操作并发限制 | 等待一段时间后调用 |
| isv.eticket-consume-error:code-not-available | 该码不能进行核销 | 检查code参数 |
| isv.eticket-invalid-parameter:invalid-consume-serial-num | 自定义核销流水号格式错误 | 必须是a-zA-Z0-9_的字母组成，长度不能超过100，不能以tbeticketsn_开头 |
| isv.eticket-invalid-parameter:duplicate-consume-serial-num | 重复的自定义核销流水号 | 每次核销都必须使用唯一的核销流水号 |