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

tmall.fuwu.homedecoration.seller.workcard.list (天猫家装服务商家工单查询接口)

天猫家装服务商家工单查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
seller_nick String 必须 测试商家 店铺名称
workcard_id Number 可选 123654 工单号
order_id Number 可选 45645678978 单号(主订单号、实物子订单号、服务主订单号、服务子订单号)
create_start_time String 可选 2023-02-24 10:00:00 工单创建开始时间
create_end_time String 可选 2023-02-24 10:15:00 工单创建结束时间
update_start_time String 可选 2023-10-24 10:15:00 工单更新开始时间
update_end_time String 可选 2023-11-01 10:15:00 工单更新结束时间
page_num Number 可选 1
  • 默认值:1
  • 当前页数
    page_size Number 可选 10
  • 默认值:10
  • 每页大小

    响应参数

    名称 类型 示例值 描述
    result Result 请求结果
    • data
    • PageModel
    • 分页数据
    • data_source
    • WorkcardVO []
    • 工单信息
    • └ workcard_id
    • Number
    • 12345645
    • 工单号
    • └ parent_order_id
    • Number
    • 4565646464
    • 主订单号
    • └ biz_order_id
    • Number
    • 879789789789
    • 实物子订单号
    • └ product_id
    • Number
    • 78978978978
    • 商品ID
    • └ product_name
    • String
    • 测试商品
    • 商品名称
    • └ outer_sku_id
    • String
    • D-5646dfg6
    • outer sku id
    • └ sku_name
    • String
    • 测试商品-黑色-大
    • sku名称
    • └ install_amount
    • Number
    • 1
    • 安装数量
    • └ supplier_nick
    • String
    • 测试服务商
    • 服务商名称
    • └ worker_nick
    • String
    • 测试工人
    • 安装师傅姓名
    • └ worker_phone
    • String
    • 12345678987
    • 安装师傅电话
    • └ service_order_id
    • Number
    • 56464654654
    • 服务订单号
    • └ status
    • String
    • 创建
    • 工单状态
    • └ create_start_time
    • String
    • 2023-02-24 10:15:00
    • 工单创建时间
    • └ door_time
    • String
    • 2023-02-25 09:00:00
    • 上门时间
    • └ finish_work_time
    • String
    • 完工时间 2023-02-25 10:00:00
    • 完工时间
    • └ auction_sku_id
    • Number
    • 13146876486465
    • 实物 sku id
    • └ out_order_id
    • String
    • 13146876486465
    • 外单id
    • └ service_type
    • String
    • 安装服务
    • 服务类型
    • └ page_index
    • Number
    • 1
    • 页码
    • └ page_size
    • Number
    • 10
    • 每页大小
    • └ total
    • Number
    • 10086
    • 数据量
    • └ success
    • Boolean
    • true
    • 成功标志位
    • └ error_code
    • String
    • null
    • 错误码
    • └ error_msg
    • String
    • null
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallFuwuHomedecorationSellerWorkcardListRequest req = new TmallFuwuHomedecorationSellerWorkcardListRequest();
    req.setSellerNick("测试商家");
    req.setWorkcardId(123654L);
    req.setOrderId(45645678978L);
    req.setCreateStartTime("2023-02-24 10:00:00");
    req.setCreateEndTime("2023-02-24 10:15:00");
    req.setUpdateStartTime("2023-10-24 10:15:00");
    req.setUpdateEndTime("2023-11-01 10:15:00");
    req.setPageNum(1L);
    req.setPageSize(10L);
    TmallFuwuHomedecorationSellerWorkcardListResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_fuwu_homedecoration_seller_workcard_list_response>
        <result>
            <data>
                <data_source>
                    <workcard_v_o>
                        <workcard_id>12345645</workcard_id>
                        <parent_order_id>4565646464</parent_order_id>
                        <biz_order_id>879789789789</biz_order_id>
                        <product_id>78978978978</product_id>
                        <product_name>测试商品</product_name>
                        <outer_sku_id>D-5646dfg6</outer_sku_id>
                        <sku_name>测试商品-黑色-大</sku_name>
                        <install_amount>1</install_amount>
                        <supplier_nick>测试服务商</supplier_nick>
                        <worker_nick>测试工人</worker_nick>
                        <worker_phone>12345678987</worker_phone>
                        <service_order_id>56464654654</service_order_id>
                        <status>创建</status>
                        <create_start_time>2023-02-24 10:15:00</create_start_time>
                        <door_time>2023-02-25 09:00:00</door_time>
                        <finish_work_time>完工时间	2023-02-25 10:00:00</finish_work_time>
                        <auction_sku_id>13146876486465</auction_sku_id>
                        <out_order_id>13146876486465</out_order_id>
                        <service_type>安装服务</service_type>
                    </workcard_v_o>
                </data_source>
                <page_index>1</page_index>
                <page_size>10</page_size>
                <total>10086</total>
            </data>
            <success>true</success>
            <error_code>null</error_code>
            <error_msg>null</error_msg>
        </result>
    </tmall_fuwu_homedecoration_seller_workcard_list_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

    返回
    顶部