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

taobao.smp.zfbt.sn.service.get (商家通过运单号查询国补SN服务状态)

商家通过运单号查询国补SN服务状态

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sn_service_query_request SnServiceQueryRequest 必须 业务请求对象
  • └ cp_code
  • String
  • 必须
  • SF
  • 配品牌
  • └ mail_no
  • String
  • 必须
  • SF12345567
  • 运单号
  • └ service_code
  • String
  • 必须
  • GBYJ
  • 服务编码,国补验机服务查询填GBYJ

响应参数

名称 类型 示例值 描述
data TopSnServiceDTO data
  • └ fulfill_service_send_time
  • String
  • 2025-04-07 11:52:27
  • 履行下发服务时间
  • └ fulfill_service_reject_time
  • String
  • 2025-04-07 11:52:27
  • 履行服务拒单时间
  • └ sn_code
  • String
  • 10CF2M0E8J001BS
  • sn编码
  • └ pic_rule_id
  • String
  • 110028
  • 国补验机分省规则ID
  • └ service_code
  • String
  • GBYJ
  • 服务编码
  • └ fulfill_service_time_out
  • String
  • 00:01:36
  • 未响应时长(hh:mm:ss)
  • └ fulfill_service_error_msg
  • String
  • 未查找到运单信息,请核实
  • 异常拒单原因
  • └ category_name
  • String
  • 手机
  • 淘系一级类目名称
  • └ seller_id
  • String
  • 883737303
  • 店铺id
  • └ service_status
  • String
  • 执行成功
  • 服务状态:初始化(未接单)、已接单 、已完成 、拒单
  • └ fulfill_service_complete_time
  • String
  • 2025-04-08 12:07:53
  • 履行服务完单时间
  • └ leaf_cate_id
  • Number
  • 1512
  • 淘系叶子类目id
  • └ brand_name
  • String
  • vivo
  • 商品品牌名称
  • picture_opt_req_infos
  • PictureOptReqInfos []
  • 国补验机标准(list)- 仅分省订单有
  • └ pic_type
  • String
  • DEVICE_STARTUP_SN_IMEI
  • 图片类型编码
  • └ pic_std
  • String
  • A00027
  • 图片作业标准编码
  • └ picture_urls
  • String []
  • 验机服务回传图片URL链接
  • └ act_division_id
  • String
  • 441500
  • 活动所属区域(最小区划id)
  • └ imei_codes
  • String []
  • imei码
  • └ leaf_cate_name
  • String
  • 手机
  • 淘系叶子类目名称
  • └ need_gbyj
  • Boolean
  • true
  • 是否需要上门验机服务
  • └ fulfill_service_accept_time
  • String
  • 2025-04-07 11:52:27
  • 履行服务接单时间
  • └ biz_order_id
  • String
  • 4291943294839716036
  • 淘宝交易主单号
  • └ brand_id
  • Number
  • 91621
  • 商品品牌id
  • └ sub_biz_order_id
  • String
  • 4291943294839716036
  • 淘宝交易子单号
  • └ category_id
  • Number
  • 1512
  • 淘系一级类目id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SmpZfbtSnServiceGetRequest req = new SmpZfbtSnServiceGetRequest();
SmpZfbtSnServiceGetRequest.SnServiceQueryRequest obj1 = new SmpZfbtSnServiceGetRequest.SnServiceQueryRequest();
obj1.setCpCode("SF");
obj1.setMailNo("SF12345567");
obj1.setServiceCode("GBYJ");
req.setSnServiceQueryRequest(obj1);
SmpZfbtSnServiceGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<smp_zfbt_sn_service_get_response>
    <data>
        <fulfill_service_send_time>2025-04-07 11:52:27</fulfill_service_send_time>
        <fulfill_service_reject_time>2025-04-07 11:52:27</fulfill_service_reject_time>
        <sn_code>10CF2M0E8J001BS</sn_code>
        <pic_rule_id>110028</pic_rule_id>
        <service_code>GBYJ</service_code>
        <fulfill_service_time_out>00:01:36</fulfill_service_time_out>
        <fulfill_service_error_msg>未查找到运单信息,请核实</fulfill_service_error_msg>
        <category_name>手机</category_name>
        <seller_id>883737303</seller_id>
        <service_status>执行成功</service_status>
        <fulfill_service_complete_time>2025-04-08 12:07:53</fulfill_service_complete_time>
        <leaf_cate_id>1512</leaf_cate_id>
        <brand_name>vivo</brand_name>
        <picture_opt_req_infos>
            <picture_opt_req_infos>
                <pic_type>DEVICE_STARTUP_SN_IMEI</pic_type>
                <pic_std>A00027</pic_std>
            </picture_opt_req_infos>
        </picture_opt_req_infos>
        <act_division_id>441500</act_division_id>
        <leaf_cate_name>手机</leaf_cate_name>
        <need_gbyj>true</need_gbyj>
        <fulfill_service_accept_time>2025-04-07 11:52:27</fulfill_service_accept_time>
        <biz_order_id>4291943294839716036</biz_order_id>
        <brand_id>91621</brand_id>
        <sub_biz_order_id>4291943294839716036</sub_biz_order_id>
        <category_id>1512</category_id>
    </data>
</smp_zfbt_sn_service_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

返回
顶部