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

taobao.weike.eservice.schedule.get (客服排班信息查询接口)

客服排班信息查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_id Number 可选 2000001238800160396 订单ID,orderId、sellerNick、spNick三者不能同时为Null
seller_nick String 可选 福摩:1号 商家子账号昵称,orderId、sellerNick、spNick三者不能同时为Null
sp_nick String 可选 客服管家:1号 服务商子账号昵称,orderId、sellerNick、spNick三者不能同时为Null
start_date Date 必须 2016-08-16 00:00:00 起始日期,起始日期和结束日期跨度不能超过31天
end_date Date 必须 2016-08-20 00:00:00 结束日期,起始日期和结束日期跨度不能超过31天

响应参数

名称 类型 示例值 描述
result CsSchedulingWrapper 排班信息查询结果
  • └ total_count
  • Number
  • 1
  • 排班记录条数(按天计算)
  • cs_schedulings
  • CsScheduling []
  • 按天排班信息
  • └ date
  • Date
  • 2016-08-16 00:00:00
  • 排班日期
  • └ string_date
  • String
  • 2016-08-16
  • 排班日期字符串
  • schedulings
  • Scheduling []
  • 一天内排班信息
  • └ start_time
  • Date
  • 2016-08-16 09:30:00
  • 排班起始时间
  • └ end_time
  • Date
  • 2016-08-16 10:30:00
  • 排班结束时间
  • └ seller_nick
  • String
  • 福摩:1号
  • 商家子账号
  • └ sp_nick
  • String
  • 客服管家:1号
  • 服务商子账号
  • └ state
  • Number
  • 1
  • 排班记录状态,1表示生效,-1表示失效
  • └ state_des
  • String
  • 生效
  • 排班记录状态描述
  • └ order_id
  • Number
  • 2000001238800160396
  • 订单ID
  • └ modified_time
  • Date
  • 2016-08-16 10:30:00
  • 排班记录更新时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WeikeEserviceScheduleGetRequest req = new WeikeEserviceScheduleGetRequest();
req.setOrderId(2000001238800160396L);
req.setSellerNick("福摩:1号");
req.setSpNick("客服管家:1号");
req.setStartDate(StringUtils.parseDateTime("2016-08-16 00:00:00"));
req.setEndDate(StringUtils.parseDateTime("2016-08-20 00:00:00"));
WeikeEserviceScheduleGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<weike_eservice_schedule_get_response>
    <result>
        <total_count>1</total_count>
        <cs_schedulings>
            <cs_scheduling>
                <date>2016-08-16 00:00:00</date>
                <string_date>2016-08-16</string_date>
                <schedulings>
                    <scheduling>
                        <start_time>2016-08-16 09:30:00</start_time>
                        <end_time>2016-08-16 10:30:00</end_time>
                        <seller_nick>福摩:1号</seller_nick>
                        <sp_nick>客服管家:1号</sp_nick>
                        <state>1</state>
                        <state_des>生效</state_des>
                    </scheduling>
                </schedulings>
                <order_id>2000001238800160396</order_id>
                <modified_time>2016-08-16 10:30:00</modified_time>
            </cs_scheduling>
        </cs_schedulings>
    </result>
</weike_eservice_schedule_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>

错误码解释

错误码 错误描述 解决方案
isv.param-input-null 输入参数为Null 检查是否有必选参数未填
isv.param-input-no-db-record 根据输入的参数查询不到记录 检查参数是否有误
isv.order-account-different 订单和授权的服务商账号不一致 检查订单ID和授权的服务商账号是否对应
isp.service-invalid 服务端执行发生错误 联系技术支持解决
isv.order-type-nonsupport 不支持该订单类型 检查订单类型是否是客服外包服务订单

API工具

如何获得此API

FAQ

返回
顶部