文档中心 > API类目 > 以旧换新-国补

taobao.smp.zfbt.sn.historylock.get (政府补贴查询历史SN占用流水日志)

1、本接口主要是查询单个SN在淘宝平台的历史占用流水记录,如果同一个SN被多笔订单占用过,会返回多个交易单单号对应占用记录。 2、同一笔交易单仅返回最新一次占用记录; 3、返回结果会过滤出当前商家所属订单; 4、isOccupyByOther为true表示当前订单被其他商家占用过,可以联系行业小二协助查询;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sn_lock_flow_log_query_request SnLockFlowLogQueryRequest 必须 业务请求
  • └ sn_code
  • String
  • 必须
  • SN123123
  • sn码

响应参数

名称 类型 示例值 描述
data TopSnLockFlowLogRespond 业务响应对象
  • sn_lock_flow_logs
  • SnLockFlowLogs []
  • 占用订单流水
  • └ sn_code
  • String
  • SN123123
  • 占用的sn码
  • └ seller_id
  • String
  • 2217389112799
  • 订单对应卖家id
  • └ lock_time
  • String
  • 2025-04-03 11:15:17
  • 占用时间
  • └ biz_order_id
  • String
  • 4279992300051873800
  • 淘宝交易主单号
  • └ gov_lock_result
  • Boolean
  • true
  • 占用结果
  • └ sub_biz_order_id
  • String
  • 4279992300051873800
  • 淘宝交易子单号
  • └ lock_source
  • String
  • CONSIGN
  • 占用场景:OUTBOUND(出库) \CONSIGN(发货)\MANUAL(人工)
  • └ imei_codes
  • String []
  • 占用的imei码
  • └ gov_ori_resp
  • String
  • {"resultData":{"code":"SUCCESS","data":{"instResultDesc":"请求业务处理成功","instResultCode":"0000000000"},"msg":"请求业务处理成功","res":{"instResultDesc":"请求业务处理成功","subCode":"000001","instResultCode":"0000000000","mappedInstResultCode":"SUCCESS","subMsg":"占用失败,重复占用","mappedInstResultDesc":"请求业务处理成功"},"respCode":"000001","respMsg":"占用失败,重复占用wq","success":true},"success":false}
  • 占用政府原始响应报文
  • └ code
  • String
  • ZFBTSN.000004E
  • 占用错误码
  • └ message
  • String
  • 商家朋友您好,此订单您回传的SN码/IMEI码已不可使用,请更换SN码/IMEI码,重新操作回传。
  • 占用错误信息
  • └ is_occupy_by_other
  • Boolean
  • false
  • 是否被其它商家订单占用

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SmpZfbtSnHistorylockGetRequest req = new SmpZfbtSnHistorylockGetRequest();
SmpZfbtSnHistorylockGetRequest.SnLockFlowLogQueryRequest obj1 = new SmpZfbtSnHistorylockGetRequest.SnLockFlowLogQueryRequest();
obj1.setSnCode("SN123123");
req.setSnLockFlowLogQueryRequest(obj1);
SmpZfbtSnHistorylockGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<smp_zfbt_sn_historylock_get_response>
    <data>
        <sn_lock_flow_logs>
            <sn_lock_flow_logs>
                <sn_code>SN123123</sn_code>
                <seller_id>2217389112799</seller_id>
                <lock_time>2025-04-03 11:15:17</lock_time>
                <biz_order_id>4279992300051873800</biz_order_id>
                <gov_lock_result>true</gov_lock_result>
                <sub_biz_order_id>4279992300051873800</sub_biz_order_id>
                <lock_source>CONSIGN</lock_source>
                <gov_ori_resp>{&quot;resultData&quot;:{&quot;code&quot;:&quot;SUCCESS&quot;,&quot;data&quot;:{&quot;instResultDesc&quot;:&quot;请求业务处理成功&quot;,&quot;instResultCode&quot;:&quot;0000000000&quot;},&quot;msg&quot;:&quot;请求业务处理成功&quot;,&quot;res&quot;:{&quot;instResultDesc&quot;:&quot;请求业务处理成功&quot;,&quot;subCode&quot;:&quot;000001&quot;,&quot;instResultCode&quot;:&quot;0000000000&quot;,&quot;mappedInstResultCode&quot;:&quot;SUCCESS&quot;,&quot;subMsg&quot;:&quot;占用失败,重复占用&quot;,&quot;mappedInstResultDesc&quot;:&quot;请求业务处理成功&quot;},&quot;respCode&quot;:&quot;000001&quot;,&quot;respMsg&quot;:&quot;占用失败,重复占用wq&quot;,&quot;success&quot;:true},&quot;success&quot;:false}</gov_ori_resp>
                <code>ZFBTSN.000004E</code>
                <message>商家朋友您好,此订单您回传的SN码/IMEI码已不可使用,请更换SN码/IMEI码,重新操作回传。</message>
            </sn_lock_flow_logs>
        </sn_lock_flow_logs>
        <is_occupy_by_other>false</is_occupy_by_other>
    </data>
</smp_zfbt_sn_historylock_get_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部