文档中心 > API类目 > 天猫服务平台

alibaba.servicecenter.spserviceorder.query (服务供应链服务单查询)

服务供应链服务单查询,服务商通过此接口拉取用户的购买的服务信息,以此为依据为用户提供安装维修等服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
status_codes String 可选 effect,closed,finish 状态码,可传多个
current_page Number 可选 1
  • 默认值:1
  • 查询第几页,默认1
    page_size Number 可选 50
  • 默认值:50
  • 每页大小,默认50,最大50
    gmt_modified_end Date 可选 2019-09-05 15:40:02 服务单修改时间(时间段15分钟以内)(包含时分秒)
    gmt_modified_start Date 可选 2019-09-05 15:52:02 服务单修改时间(包含时分秒)
    master_parent_biz_order_id Number 可选 13432432444908880 实物主订单id(消费者在淘宝订单里看到的订单号)
    sp_service_order_id Number 可选 178990 服务单id

    响应参数

    名称 类型 示例值 描述
    result FulfilplatformResult 请求结果
    • result_data
    • PagedResult
    • 分页数据
    • data_list
    • SpServiceorderDTO []
    • 工单列表
    • └ refund_service_count
    • Number
    • 0
    • 取消的份数
    • master_trade_order
    • MasterTradeOrderDTO
    • 实物子订单信息
    • └ seller_nick
    • String
    • 某某旗舰店
    • 卖家名称
    • └ order_id
    • Number
    • 13432432444908881
    • 实物子订单id
    • └ auction_title
    • String
    • 测试商品普通手机
    • 商品名称
    • └ attribute
    • String
    • {"品牌":"Hegii/恒洁","机型":"HC0162PT","sn":"sn1,sn2"}
    • 商品属性(json格式)
    • └ shop_name
    • String
    • 某某旗舰店
    • 卖家店铺名称
    • └ auction_id
    • Number
    • 2300949681961
    • 商品id
    • └ buy_amount
    • Number
    • 2
    • 购买数量
    • └ price
    • Number
    • 100
    • 商家价格
    • └ parent_biz_order_id
    • String
    • 13432432444908880
    • 实物主订单id
    • └ brand_id
    • String
    • 11813
    • 品牌id
    • └ sku_desc
    • String
    • 颜色:红色
    • sku描述
    • └ spu_id
    • Number
    • 234324
    • spu_id
    • └ sku_id
    • Number
    • 33271975982
    • sku_id
    • └ category_id
    • Number
    • 147495201
    • 类目id
    • └ outer_id_sku
    • String
    • demo
    • 商家编码
    • service_definition
    • ServiceDefinitionDTO
    • 服务定义
    • └ service_code
    • String
    • suiping_insurance
    • 服务编码
    • └ display_name
    • String
    • 碎屏服务
    • 服务名称
    • └ biz_code
    • String
    • serviceByInsurance
    • 业务编码
    • buyer
    • BuyerDTO
    • 买家信息
    • └ address_province
    • String
    • 浙江省
    • └ address_detail
    • String
    • 文一西路969号4号楼小邮局
    • 详细地址
    • └ buyer_nick
    • String
    • tbtest002
    • 买家淘宝账号
    • └ phone
    • String
    • demo
    • 买家电话
    • └ mobile
    • String
    • 12345678901
    • 买家手机号
    • └ location
    • Number
    • 330110
    • 地区编码
    • └ address_district
    • String
    • 余杭区
    • └ buyer_name
    • String
    • test
    • 买家姓名
    • └ address_town
    • String
    • demo
    • 街道
    • └ address_city
    • String
    • 杭州市
    • └ used_service_count
    • Number
    • 1
    • 已使用份数
    • fee_list
    • FeeInfo []
    • 费用信息
    • └ amount
    • String
    • 1200
    • 金额单价(分)
    • └ from_role_code
    • String
    • platform
    • 出资方code
    • └ to_role_id
    • Number
    • 65753805
    • 收款方的id
    • └ item_code
    • String
    • TEST_PROPRIETARY_TEST_PROPRIETARY_SPLIT_SERVICE_FEE_FC_BILL
    • 费用项科目code
    • └ from_role_id
    • Number
    • 123
    • 出资方id
    • └ to_role_code
    • String
    • tp
    • 收款方的code
    • └ left_service_count
    • Number
    • 1
    • 剩余的份数
    • service_trade_order
    • ServiceTradeOrderDTO
    • 服务子订单信息
    • └ seller_nick
    • String
    • 无忧购旗舰店
    • 卖家名称
    • └ auction_id
    • Number
    • 2300949969273
    • 商品id
    • └ order_id
    • Number
    • 1100337392038150500
    • 服务子订单id
    • └ auction_title
    • String
    • 轮胎安装
    • 商品名称
    • └ price
    • Number
    • 160
    • 商品价格
    • └ parent_biz_order_id
    • Number
    • 23432432444908880
    • 服务主订单id
    • └ attribute
    • String
    • {"refundType":"afterEffect"}
    • 服务订单属性(json格式)
    • └ shop_name
    • String
    • 无忧购旗舰店
    • 卖家店铺名称
    • └ sku_desc
    • String
    • 碎屏一年
    • sku描述
    • └ category_id
    • Number
    • 147495201
    • 类目id
    • └ sku_id
    • Number
    • 234324
    • sku_id
    • └ outer_id_sku
    • String
    • 234f55gf
    • 商家编码
    • └ purchase_price_unit
    • Number
    • 12000
    • 服务采购价
    • └ service_count
    • Number
    • 2
    • 服务的总份数
    • └ gmt_expire
    • String
    • 2020-07-28 00:00:00
    • 服务过期时间
    • └ gmt_modified
    • String
    • 2020-03-04 09:33:18
    • 服务单修改时间
    • └ gmt_create
    • String
    • 2019-07-27 15:27:37
    • 服务单创建时间
    • └ gmt_effect
    • String
    • 2019-07-27 15:26:47
    • 服务单有效期开始时间
    • └ sp_serviceorder_id
    • Number
    • 1134005
    • 服务单id
    • └ using_service_count
    • Number
    • 0
    • 正在使用中的次数
    • └ status_code
    • String
    • finish
    • 状态编码:create(创建)、effect(生效)、closed(关闭)、finish(完成)
    • └ total_page_count
    • Number
    • 1
    • 总页数
    • └ page_size
    • Number
    • 20
    • 每页大小
    • └ total_count
    • Number
    • 1
    • 总记录数
    • └ success
    • Boolean
    • true
    • 是否成功
    • └ msg_info
    • String
    • demo
    • 错误描述
    • └ msg_code
    • String
    • demo
    • 错误码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaServicecenterSpserviceorderQueryRequest req = new AlibabaServicecenterSpserviceorderQueryRequest();
    req.setStatusCodes("effect,closed,finish");
    req.setCurrentPage(1L);
    req.setPageSize(50L);
    req.setGmtModifiedEnd(StringUtils.parseDateTime("2019-09-05 15:40:02"));
    req.setGmtModifiedStart(StringUtils.parseDateTime("2019-09-05 15:52:02"));
    req.setMasterParentBizOrderId(13432432444908880L);
    req.setSpServiceOrderId(178990L);
    AlibabaServicecenterSpserviceorderQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_servicecenter_spserviceorder_query_response>
        <result>
            <result_data>
                <data_list>
                    <sp_serviceorder_d_t_o>
                        <refund_service_count>0</refund_service_count>
                        <master_trade_order>
                            <seller_nick>某某旗舰店</seller_nick>
                            <order_id>13432432444908881</order_id>
                            <auction_title>测试商品普通手机</auction_title>
                            <attribute>{&quot;品牌&quot;:&quot;Hegii/恒洁&quot;,&quot;机型&quot;:&quot;HC0162PT&quot;,&quot;sn&quot;:&quot;sn1,sn2&quot;}</attribute>
                            <shop_name>某某旗舰店</shop_name>
                            <auction_id>2300949681961</auction_id>
                            <buy_amount>2</buy_amount>
                            <price>100</price>
                            <parent_biz_order_id>13432432444908880</parent_biz_order_id>
                            <brand_id>11813</brand_id>
                            <sku_desc>颜色:红色</sku_desc>
                            <spu_id>234324</spu_id>
                            <sku_id>33271975982</sku_id>
                            <category_id>147495201</category_id>
                            <outer_id_sku>demo</outer_id_sku>
                        </master_trade_order>
                        <service_definition>
                            <service_code>suiping_insurance</service_code>
                            <display_name>碎屏服务</display_name>
                            <biz_code>serviceByInsurance</biz_code>
                        </service_definition>
                        <buyer>
                            <address_province>浙江省</address_province>
                            <address_detail>文一西路969号4号楼小邮局</address_detail>
                            <buyer_nick>tbtest002</buyer_nick>
                            <phone>demo</phone>
                            <mobile>12345678901</mobile>
                            <location>330110</location>
                            <address_district>余杭区</address_district>
                            <buyer_name>test</buyer_name>
                            <address_town>demo</address_town>
                            <address_city>杭州市</address_city>
                        </buyer>
                        <used_service_count>1</used_service_count>
                        <fee_list>
                            <fee_info>
                                <amount>1200</amount>
                                <from_role_code>platform</from_role_code>
                                <to_role_id>65753805</to_role_id>
                                <item_code>TEST_PROPRIETARY_TEST_PROPRIETARY_SPLIT_SERVICE_FEE_FC_BILL</item_code>
                                <from_role_id>123</from_role_id>
                                <to_role_code>tp</to_role_code>
                            </fee_info>
                        </fee_list>
                        <left_service_count>1</left_service_count>
                        <service_trade_order>
                            <seller_nick>无忧购旗舰店</seller_nick>
                            <auction_id>2300949969273</auction_id>
                            <order_id>1100337392038150500</order_id>
                            <auction_title>轮胎安装</auction_title>
                            <price>160</price>
                            <parent_biz_order_id>23432432444908880</parent_biz_order_id>
                            <attribute>{&quot;refundType&quot;:&quot;afterEffect&quot;}</attribute>
                            <shop_name>无忧购旗舰店</shop_name>
                            <sku_desc>碎屏一年</sku_desc>
                            <category_id>147495201</category_id>
                            <sku_id>234324</sku_id>
                            <outer_id_sku>234f55gf</outer_id_sku>
                            <purchase_price_unit>12000</purchase_price_unit>
                        </service_trade_order>
                        <service_count>2</service_count>
                        <gmt_expire>2020-07-28 00:00:00</gmt_expire>
                        <gmt_modified>2020-03-04 09:33:18</gmt_modified>
                        <gmt_create>2019-07-27 15:27:37</gmt_create>
                        <gmt_effect>2019-07-27 15:26:47</gmt_effect>
                        <sp_serviceorder_id>1134005</sp_serviceorder_id>
                        <using_service_count>0</using_service_count>
                        <status_code>finish</status_code>
                    </sp_serviceorder_d_t_o>
                </data_list>
                <total_page_count>1</total_page_count>
                <page_size>20</page_size>
                <total_count>1</total_count>
            </result_data>
            <success>true</success>
            <msg_info>demo</msg_info>
            <msg_code>demo</msg_code>
        </result>
    </alibaba_servicecenter_spserviceorder_query_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

    返回
    顶部