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

tmall.servicecenter.workcard.query (工单查询接口)

工单查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
service_store_id Number 可选 123 门店/网点id
identify_code String 可选 123456789 核销码
id Number 可选 123456 工单id
gmt_create_start Date 可选 2019-02-24 10:00:00 工单创建开始时间
gmt_create_end Date 可选 2019-02-24 10:15:00 工单创建结束时间,必须与工单创建开始时间一起传入,且间隔不超过15分钟
biz_order_id Number 可选 1234567 淘宝交易订单号。主订单或子订单均可
current_page Number 可选 1
  • 默认值:1
  • 当前页数
    page_size Number 可选 50
  • 默认值:50
  • 每页大小
    need_workcard_operation Boolean 可选 true 是否查询操作记录信息

    响应参数

    名称 类型 示例值 描述
    result Result 请求结果
    • result_data
    • Paged
    • 分页数据
    • data_list
    • WorkcardDTO []
    • 工单列表
    • └ attributes
    • String
    • {}
    • 额外属性
    • └ gmt_sign_in
    • Date
    • 1550669060000
    • 签到时间
    • └ used_service_count
    • Number
    • 0
    • 使用次数
    • service_trade_order
    • ServiceTradeOrder
    • 服务订单数据
    • └ category_id
    • Number
    • 123
    • 服务商品的类目
    • └ outer_id_sku
    • String
    • 123
    • 服务商品的商家编码
    • └ sku_desc
    • String
    • 颜色:红色
    • 服务商品的sku描述
    • └ seller_nick
    • String
    • 汽车卖家1
    • 服务商品的卖家昵称
    • └ shop_name
    • String
    • 汽车卖家1
    • 服务商品的店铺名
    • └ sku_id
    • Number
    • 123
    • 服务商品的sku id
    • └ auction_id
    • Number
    • 23234234
    • 服务商品的id
    • └ auction_title
    • String
    • 服务商品标题
    • 服务商品的标题
    • └ attributes
    • String
    • {"key":"value"}
    • 服务商品额外属性
    • └ gmt_pay
    • Date
    • 1550656308000
    • 付款时间
    • └ purchase_price_unit
    • Number
    • 900
    • 服务商品的采购价。单位为分
    • └ order_id
    • Number
    • 1312322222
    • 订单id
    • └ buy_amount
    • Number
    • 5
    • 购买数量
    • └ auction_pic
    • String
    • xx.png
    • 商品图片
    • └ gmt_reserve_end
    • Date
    • 1550669060000
    • 预约结束时间
    • └ gmt_modify
    • Date
    • 1550669060000
    • 修改时间
    • └ service_count
    • Number
    • 1
    • 工单服务总次数
    • └ gmt_cancel
    • Date
    • 1550669060000
    • 取消时间
    • └ status_code
    • String
    • create
    • 工单状态编码
    • └ id
    • Number
    • 3203003
    • 工单id
    • └ reserve_fail_desc
    • String
    • xxx
    • 预约失败描述
    • └ left_service_count
    • Number
    • 1
    • 剩余次数
    • └ parent_biz_order_id
    • Number
    • 1213132343232
    • 主订单号
    • └ reserve_fail_code
    • Number
    • 123
    • 预约失败编码
    • buyer
    • Buyer
    • 买家信息
    • └ phone
    • String
    • 12345678
    • 座机
    • └ address_city
    • String
    • 杭州市
    • 二级地址
    • └ location
    • Number
    • 330110005
    • 地址编码
    • └ address_district
    • String
    • 余杭区
    • 三级地址
    • └ address_detail
    • String
    • 文一西路99999号
    • 详细地址
    • └ buyer_name
    • String
    • 测试买家
    • 姓名
    • └ email
    • String
    • 12345678@xxx.com
    • 邮箱
    • └ address
    • String
    • 浙江省 杭州市 余杭区 五常街道 文一西路99999号
    • 拼装好的地址
    • └ zip_code
    • String
    • 123456
    • 邮编
    • └ buyer_nick
    • String
    • tbtest1063
    • 买家昵称
    • └ address_town
    • String
    • 五常街道
    • 四级地址
    • └ address_province
    • String
    • 浙江省
    • 一级地址
    • └ mobile
    • String
    • 123123123123
    • 手机号
    • └ open_uid
    • String
    • AAA
    • open_uid
    • service_provider
    • ServiceProvider
    • 服务提供者
    • └ tp_nick
    • String
    • tbtest1063
    • 服务商昵称
    • └ tp_id
    • Number
    • 65753805
    • 服务商id
    • └ worker_mobile
    • String
    • 123456
    • 工人手机号
    • └ service_store_code
    • String
    • abc
    • 门店/网点编码
    • └ worker_name
    • String
    • xxx
    • 工人姓名
    • └ worker_id
    • Number
    • 123
    • 工人id
    • └ service_store_id
    • Number
    • 331
    • 门店/网点id
    • └ service_store_name
    • String
    • xxx
    • 门店/网点名称
    • └ fulfil_type_code
    • String
    • in_store
    • 服务履约类型
    • └ gmt_identify
    • Date
    • 1550669060000
    • 核销时间
    • └ gmt_create
    • Date
    • 1550656481000
    • 创建时间
    • └ gmt_reserve_start
    • Date
    • 1550669060000
    • 预约时间开始
    • master_trade_order
    • MasterTradeOrder
    • 实物订单信息
    • └ category_id
    • Number
    • 12
    • 类目id
    • └ spu_id
    • Number
    • 12312
    • spu id
    • └ gmt_arrival
    • Date
    • 1550669060000
    • 签收时间
    • └ brand_id
    • Number
    • 13123
    • 品牌id
    • └ gmt_expect_arrival
    • Date
    • 1550669060000
    • 预计签收时间
    • └ outer_id_sku
    • String
    • 123
    • 商家编码
    • └ sku_desc
    • String
    • 颜色:红色
    • sku描述
    • └ price
    • Number
    • 1200
    • 价格。单位为分
    • └ seller_nick
    • String
    • 汽车卖家1
    • 卖家昵称
    • └ shop_name
    • String
    • 汽车卖家1
    • 店铺名
    • └ sku_id
    • Number
    • 123
    • sku id
    • └ auction_id
    • Number
    • 123123
    • 商品id
    • └ auction_title
    • String
    • 实物商品标题
    • 商品标题
    • └ attributes
    • String
    • {"key":"value"}
    • 商品额外属性
    • └ gmt_shipped
    • Date
    • 1550669060000
    • 发货时间
    • └ gmt_pay
    • Date
    • 1550656308000
    • 付款时间
    • └ order_id
    • Number
    • 12343
    • 订单id
    • └ buy_amount
    • Number
    • 5
    • 购买数量
    • └ outer_id_p
    • String
    • 12345
    • 商品编码
    • └ parent_order_id
    • Number
    • 123456
    • 实物主订单号
    • service_definition
    • ServiceDefinition
    • 服务定义
    • └ biz_code
    • String
    • car_accessory_install
    • 业务类型
    • └ service_code
    • String
    • 轮胎安装
    • 服务类型
    • └ buyer_expect_date
    • Date
    • 买家期望服务时间
    • 买家期望服务时间
    • fee_list
    • FeeInfo []
    • 费用信息
    • 费用信息
    • └ from_role_code
    • String
    • platform
    • 费用信息
    • └ amount
    • Number
    • 200
    • 费用信息
    • └ sequence
    • Number
    • 1
    • 核销/工单完结请求中直接带回该字段
    • └ sp_service_order_id
    • Number
    • 12345
    • 服务单id
    • memo_list
    • MemoDTO []
    • 工单备注
    • └ content
    • String
    • 备注测试
    • 备注内容
    • └ time
    • Date
    • 2022-03-15 17:57:20
    • 备注创建时间
    • workcard_operation_info
    • WorkcardOperationDTO []
    • 操作记录信息
    • └ gmt_modify
    • Date
    • 2022-03-15 17:57:20
    • 修改时间
    • └ attribute_map
    • String
    • {}
    • 操作属性扩展字段
    • └ gmt_create
    • Date
    • 2022-03-15 17:57:20
    • 创建时间
    • └ operator
    • String
    • system
    • 操作人
    • └ action
    • String
    • 创建
    • 动作描述
    • └ operator_type
    • Number
    • 1
    • 操作人类型,1:买家,2:服务商,3:网点
    • └ total_page_count
    • Number
    • 1
    • 总页数
    • └ total_count
    • Number
    • 1
    • 总数
    • └ page_size
    • Number
    • 20
    • 每页大小
    • └ msg_code
    • String
    • xxx
    • 错误码
    • └ msg_info
    • String
    • xxx
    • 错误信息
    • └ success
    • Boolean
    • true
    • 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallServicecenterWorkcardQueryRequest req = new TmallServicecenterWorkcardQueryRequest();
    req.setServiceStoreId(123L);
    req.setIdentifyCode("123456789");
    req.setId(123456L);
    req.setGmtCreateStart(StringUtils.parseDateTime("2019-02-24 10:00:00"));
    req.setGmtCreateEnd(StringUtils.parseDateTime("2019-02-24 10:15:00"));
    req.setBizOrderId(1234567L);
    req.setCurrentPage(1L);
    req.setPageSize(50L);
    req.setNeedWorkcardOperation(true);
    TmallServicecenterWorkcardQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_servicecenter_workcard_query_response>
        <result>
            <result_data>
                <data_list>
                    <workcard_d_t_o>
                        <attributes>{}</attributes>
                        <gmt_sign_in>1550669060000</gmt_sign_in>
                        <used_service_count>0</used_service_count>
                        <service_trade_order>
                            <category_id>123</category_id>
                            <outer_id_sku>123</outer_id_sku>
                            <sku_desc>颜色:红色</sku_desc>
                            <seller_nick>汽车卖家1</seller_nick>
                            <shop_name>汽车卖家1</shop_name>
                            <sku_id>123</sku_id>
                            <auction_id>23234234</auction_id>
                            <auction_title>服务商品标题</auction_title>
                            <attributes>{&quot;key&quot;:&quot;value&quot;}</attributes>
                            <gmt_pay>1550656308000</gmt_pay>
                            <purchase_price_unit>900</purchase_price_unit>
                            <order_id>1312322222</order_id>
                            <buy_amount>5</buy_amount>
                            <auction_pic>xx.png</auction_pic>
                        </service_trade_order>
                        <gmt_reserve_end>1550669060000</gmt_reserve_end>
                        <gmt_modify>1550669060000</gmt_modify>
                        <service_count>1</service_count>
                        <gmt_cancel>1550669060000</gmt_cancel>
                        <status_code>create</status_code>
                        <id>3203003</id>
                        <reserve_fail_desc>xxx</reserve_fail_desc>
                        <left_service_count>1</left_service_count>
                        <parent_biz_order_id>1213132343232</parent_biz_order_id>
                        <reserve_fail_code>123</reserve_fail_code>
                        <buyer>
                            <phone>12345678</phone>
                            <address_city>杭州市</address_city>
                            <location>330110005</location>
                            <address_district>余杭区</address_district>
                            <address_detail>文一西路99999号</address_detail>
                            <buyer_name>测试买家</buyer_name>
                            <email>12345678@xxx.com</email>
                            <address>浙江省 杭州市 余杭区 五常街道 文一西路99999号</address>
                            <zip_code>123456</zip_code>
                            <buyer_nick>tbtest1063</buyer_nick>
                            <address_town>五常街道</address_town>
                            <address_province>浙江省</address_province>
                            <mobile>123123123123</mobile>
                            <open_uid>AAA</open_uid>
                        </buyer>
                        <service_provider>
                            <tp_nick>tbtest1063</tp_nick>
                            <tp_id>65753805</tp_id>
                            <worker_mobile>123456</worker_mobile>
                            <service_store_code>abc</service_store_code>
                            <worker_name>xxx</worker_name>
                            <worker_id>123</worker_id>
                            <service_store_id>331</service_store_id>
                            <service_store_name>xxx</service_store_name>
                        </service_provider>
                        <fulfil_type_code>in_store</fulfil_type_code>
                        <gmt_identify>1550669060000</gmt_identify>
                        <gmt_create>1550656481000</gmt_create>
                        <gmt_reserve_start>1550669060000</gmt_reserve_start>
                        <master_trade_order>
                            <category_id>12</category_id>
                            <spu_id>12312</spu_id>
                            <gmt_arrival>1550669060000</gmt_arrival>
                            <brand_id>13123</brand_id>
                            <gmt_expect_arrival>1550669060000</gmt_expect_arrival>
                            <outer_id_sku>123</outer_id_sku>
                            <sku_desc>颜色:红色</sku_desc>
                            <price>1200</price>
                            <seller_nick>汽车卖家1</seller_nick>
                            <shop_name>汽车卖家1</shop_name>
                            <sku_id>123</sku_id>
                            <auction_id>123123</auction_id>
                            <auction_title>实物商品标题</auction_title>
                            <attributes>{&quot;key&quot;:&quot;value&quot;}</attributes>
                            <gmt_shipped>1550669060000</gmt_shipped>
                            <gmt_pay>1550656308000</gmt_pay>
                            <order_id>12343</order_id>
                            <buy_amount>5</buy_amount>
                            <outer_id_p>12345</outer_id_p>
                            <parent_order_id>123456</parent_order_id>
                        </master_trade_order>
                        <service_definition>
                            <biz_code>car_accessory_install</biz_code>
                            <service_code>轮胎安装</service_code>
                        </service_definition>
                        <buyer_expect_date>买家期望服务时间</buyer_expect_date>
                        <fee_list>
                            <fee_info>
                                <from_role_code>platform</from_role_code>
                                <amount>200</amount>
                            </fee_info>
                        </fee_list>
                        <sequence>1</sequence>
                        <sp_service_order_id>12345</sp_service_order_id>
                        <memo_list>
                            <memo_d_t_o>
                                <content>备注测试</content>
                                <time>2022-03-15 17:57:20</time>
                            </memo_d_t_o>
                        </memo_list>
                        <workcard_operation_info>
                            <workcard_operation_d_t_o>
                                <gmt_modify>2022-03-15 17:57:20</gmt_modify>
                                <attribute_map>{}</attribute_map>
                                <gmt_create>2022-03-15 17:57:20</gmt_create>
                                <operator>system</operator>
                                <action>创建</action>
                                <operator_type>1</operator_type>
                            </workcard_operation_d_t_o>
                        </workcard_operation_info>
                    </workcard_d_t_o>
                </data_list>
                <total_page_count>1</total_page_count>
                <total_count>1</total_count>
                <page_size>20</page_size>
            </result_data>
            <msg_code>xxx</msg_code>
            <msg_info>xxx</msg_info>
            <success>true</success>
        </result>
    </tmall_servicecenter_workcard_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

    返回
    顶部