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

tmall.servicecenter.workcard.reserve (工单预约)

服务工单更新通用接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
workcard_id Number 可选 123 工单id
type Number 可选 2
  • 默认值:2
  • 请求来源类型
    reserve_time_start Date 可选 2019-05-10 10:00:00 服务开始时间
    reserve_time_end Date 可选 2019-05-10 12:00:00 服务结束时间
    worker_mobile String 可选 18800000000 工人手机号
    reserve_remark String 可选 这是备注 预约备注信息
    worker_name String 可选 张三 工人姓名
    attributes String 可选 {"id":10} 扩展信息
    action String 可选 reserve_evaluate 存在多个不同预约节点时需要回传。用于区分具体是哪个预约节点,例如预约上门鉴定和预约上门取件
    fulfil_type String 可选 in_store,at_home 履约类型,上门或者到店
    service_store_code String 可选 sdfdsfdf 门店编码
    service_store_name String 可选 sdfdsfdf 门店名称
    fulfil_task_id Number 可选 1234 核销单id
    reason_code Number 可选 1234 原因code
    reason_desc String 可选 时间不符合 原因desc

    响应参数

    名称 类型 示例值 描述
    result Result . 调用结果
    • └ success
    • Boolean
    • true
    • 是否成功
    • └ msg_code
    • String
    • 123
    • 错误码
    • └ msg_info
    • String
    • xxx
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallServicecenterWorkcardReserveRequest req = new TmallServicecenterWorkcardReserveRequest();
    req.setWorkcardId(123L);
    req.setType(2L);
    req.setReserveTimeStart(StringUtils.parseDateTime("2019-05-10 10:00:00"));
    req.setReserveTimeEnd(StringUtils.parseDateTime("2019-05-10 12:00:00"));
    req.setWorkerMobile("18800000000");
    req.setReserveRemark("这是备注");
    req.setWorkerName("张三");
    req.setAttributes("{\"id\":10}");
    req.setAction("reserve_evaluate");
    req.setFulfilType("in_store,at_home");
    req.setServiceStoreCode("sdfdsfdf");
    req.setServiceStoreName("sdfdsfdf");
    req.setFulfilTaskId(1234L);
    req.setReasonCode(1234L);
    req.setReasonDesc("时间不符合");
    TmallServicecenterWorkcardReserveResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_servicecenter_workcard_reserve_response>
        <result>
            <success>true</success>
            <msg_code>123</msg_code>
            <msg_info>xxx</msg_info>
        </result>
    </tmall_servicecenter_workcard_reserve_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

    返回
    顶部