淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
updater	String	必须	api调用者		api调用者
buyer_id	Number	可选	12345678		买家id
effect_date	Number	可选	12345678		服务生效时间：工单类型为合同工单时，必选！
workcard_id	Number	必须	12345678		工单id
expire_date	Number	可选	12345678		服务失效时间：工单类型为合同工单时，必选！
status	byte	必须	1		目前仅支持5种状态的反馈：3=授理， 10=拒绝，4=执行，5=成功，11=失败。（所有状态列表： -1：初始化 0：生成 1：生效 2：申请 3：受理 4：执行 5：成功 9：结算 10：拒绝 11：失败 12 ：撤销 13：暂停 19：终止）
update_date	Number	必须	12345678		更新时间
type	byte	必须	1		工单类型： 2（合同）或者 1(任务）
comments	String	可选	comments	最大长度：256	备注,256个字符以内
address	String	可选	浙江省杭州市西湖区 xxx街道	最大长度：50	任务类工单，预约或者上门地址
contact_name	String	可选	苍师傅	最大长度：50	任务执行，预约联系人
contact_phone	String	可选	138xxx	最大长度：20	任务执行，预约联系人电话
service_date	Number	可选	1465902848		服务预约时间
complete_date	Number	可选	1465902848		服务完成时间
service_voucher_pics	String	可选	https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg	最大长度：1024	服务凭证上传的图片URL链接，多个以;隔开
attribute	String	可选	;reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;	最大长度：1024	属性定义。例如无忧退货服务，K-V对定义，每对KV用“;”分割，“:”号左边是key右边是value，value如果有多个则以“,”分割。 reasons : 原因，可能有多个 succeedCount : 取件成功个数 failedCount : 取件失败个数 cancelCount : 取件取消个数 totalCount : 总取件个数，totalCount= succeedCount + failedCount + cancelCount
service_center_code	String	可选	1234abc	最大长度：50	服务商网点内部编码
service_center_name	String	可选	某某服务网点	最大长度：50	服务商网点名字
service_fee	Number	可选	3000		单元是分
is_visit	Boolean	可选	true		是否上门
before_service_memo	String	可选	维修前故障		说明
after_service_memo	String	可选	维修后说明		说明
phone_imei	String	可选	13839155112		手机号码
sub_status	Number	可选	30		服务子状态：30 表示“服务已申请（上门）” 31表示“服务改约（上门）” 400表示“服务结果（待件上门）” 410表示“服务结果（拖机维修）” 411表示“服务结果（换机）” 420表示“服务结果（上门不可维修）”
service_center_manager_phone	String	可选	13888888888		网点负责人联系电话
service_center_manager_name	String	可选	张三		网点负责人
service_center_address	String	可选	浙江省杭州市余杭区文一西路960号		网点地址
work_card_install_detail_list	WorkCardInstallDetail []	可选		最大列表长度：20	一个工单可能包含多件商品，比如空调可能有两台，录入每天机器的安装情况
└ sn String 可选 32d3f5,234sd 机器条码，如果有多个机器码，用英文逗号","隔开 └ status Number 可选 5 机器安装状态(1未完成；20暂不安装；5完成；12取消) └ img_urls String 可选 http://sfdf2.png,http://2342df.pgn 安装图片，多个图片链接用英文逗号","隔开 └ memo String 可选商品安装完成，消费者很满意备注 └ accessory_info String 可选名称1:数量1;名称2:数量2 辅材项目 └ install_fee String 可选收费类型1:金额;收费类型2:金额收费金额
service_fee_detail	String	可选	{ "安装辅材费": { "加长铜管": 500, "外机支架": 1000 }, "辅助项目费": { "高空作业费": 5000, "打孔费（砖墙）": 2000 }, "其他类型费用": { "xx类型1": 1000, "xx类型2": 2000 }, "特殊场景费用": { "xx场景1": 500, "xx场景2": 1000 }, "安装服务费": { "上门服务费": 1000 } }		json string。费用单位为分
express_code	String	可选	AAXX12123		物流单号
express_company	String	可选	韵达		物流公司名字

名称	类型	示例值	描述
value	Boolean	true	是否执行成功
rs	Boolean	true	返回结果
error_msg_info	String	demo	错误信息
error_code_value	String	123	错误码

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterWorkcardStatusUpdateRequest req = new TmallServicecenterWorkcardStatusUpdateRequest();
req.setUpdater("api调用者");
req.setBuyerId(12345678L);
req.setEffectDate(12345678L);
req.setWorkcardId(12345678L);
req.setExpireDate(12345678L);
req.setStatus("1");
req.setUpdateDate(12345678L);
req.setType("1");
req.setComments("comments");
req.setAddress("浙江省 杭州市 西湖区 xxx街道");
req.setContactName("苍师傅");
req.setContactPhone("138xxx");
req.setServiceDate(1465902848L);
req.setCompleteDate(1465902848L);
req.setServiceVoucherPics("https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg");
req.setAttribute(";reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;");
req.setServiceCenterCode("1234abc");
req.setServiceCenterName("某某服务网点");
req.setServiceFee(3000L);
req.setIsVisit(true);
req.setBeforeServiceMemo("维修前故障");
req.setAfterServiceMemo("维修后说明");
req.setPhoneImei("13839155112");
req.setSubStatus(30L);
req.setServiceCenterManagerPhone("13888888888");
req.setServiceCenterManagerName("张三");
req.setServiceCenterAddress("浙江省杭州市余杭区文一西路960号");
List<TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetail> list2 = new ArrayList<TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetail>();
TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetail obj3 = new TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetail();
list2.add(obj3);
obj3.setSn("32d3f5,234sd");
obj3.setStatus(5L);
obj3.setImgUrls("http://sfdf2.png,http://2342df.pgn");
obj3.setMemo("商品安装完成，消费者很满意");
obj3.setAccessoryInfo("名称1:数量1;名称2:数量2");
obj3.setInstallFee("收费类型1:金额;收费类型2:金额");
req.setWorkCardInstallDetailList(list2);
req.setServiceFeeDetail("{   \"安装辅材费\": {     \"加长铜管\": 500,     \"外机支架\": 1000   },   \"辅助项目费\": {     \"高空作业费\": 5000,     \"打孔费（砖墙）\": 2000   },   \"其他类型费用\": {     \"xx类型1\": 1000,     \"xx类型2\": 2000   },   \"特殊场景费用\": {     \"xx场景1\": 500,     \"xx场景2\": 1000   },   \"安装服务费\": {     \"上门服务费\": 1000   } }");
req.setExpressCode("AAXX12123");
req.setExpressCompany("韵达");
TmallServicecenterWorkcardStatusUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallServicecenterWorkcardStatusUpdateRequest req = new TmallServicecenterWorkcardStatusUpdateRequest();
req.Updater = "api调用者";
req.BuyerId = 12345678L;
req.EffectDate = 12345678L;
req.WorkcardId = 12345678L;
req.ExpireDate = 12345678L;
req.Status = "1";
req.UpdateDate = 12345678L;
req.Type = "1";
req.Comments = "comments";
req.Address = "浙江省 杭州市 西湖区 xxx街道";
req.ContactName = "苍师傅";
req.ContactPhone = "138xxx";
req.ServiceDate = 1465902848L;
req.CompleteDate = 1465902848L;
req.ServiceVoucherPics = "https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg";
req.Attribute = ";reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;";
req.ServiceCenterCode = "1234abc";
req.ServiceCenterName = "某某服务网点";
req.ServiceFee = 3000L;
req.IsVisit = true;
req.BeforeServiceMemo = "维修前故障";
req.AfterServiceMemo = "维修后说明";
req.PhoneImei = "13839155112";
req.SubStatus = 30L;
req.ServiceCenterManagerPhone = "13888888888";
req.ServiceCenterManagerName = "张三";
req.ServiceCenterAddress = "浙江省杭州市余杭区文一西路960号";
List<TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetailDomain> list2 = new List<TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetailDomain>();
TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetailDomain obj3 = new TmallServicecenterWorkcardStatusUpdateRequest.WorkCardInstallDetailDomain();
list2.Add(obj3);
obj3.Sn = "32d3f5,234sd";
obj3.Status = 5L;
obj3.ImgUrls = "http://sfdf2.png,http://2342df.pgn";
obj3.Memo = "商品安装完成，消费者很满意";
obj3.AccessoryInfo = "名称1:数量1;名称2:数量2";
obj3.InstallFee = "收费类型1:金额;收费类型2:金额";
req.WorkCardInstallDetailList_ = list2;
req.ServiceFeeDetail = "{   \"安装辅材费\": {     \"加长铜管\": 500,     \"外机支架\": 1000   },   \"辅助项目费\": {     \"高空作业费\": 5000,     \"打孔费（砖墙）\": 2000   },   \"其他类型费用\": {     \"xx类型1\": 1000,     \"xx类型2\": 2000   },   \"特殊场景费用\": {     \"xx场景1\": 500,     \"xx场景2\": 1000   },   \"安装服务费\": {     \"上门服务费\": 1000   } }";
req.ExpressCode = "AAXX12123";
req.ExpressCompany = "韵达";
TmallServicecenterWorkcardStatusUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallServicecenterWorkcardStatusUpdateRequest;
$req->setUpdater("api调用者");
$req->setBuyerId("12345678");
$req->setEffectDate("12345678");
$req->setWorkcardId("12345678");
$req->setExpireDate("12345678");
$req->setStatus("1");
$req->setUpdateDate("12345678");
$req->setType("1");
$req->setComments("comments");
$req->setAddress("浙江省 杭州市 西湖区 xxx街道");
$req->setContactName("苍师傅");
$req->setContactPhone("138xxx");
$req->setServiceDate("1465902848");
$req->setCompleteDate("1465902848");
$req->setServiceVoucherPics("https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg");
$req->setAttribute(";reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;");
$req->setServiceCenterCode("1234abc");
$req->setServiceCenterName("某某服务网点");
$req->setServiceFee("3000");
$req->setIsVisit("true");
$req->setBeforeServiceMemo("维修前故障");
$req->setAfterServiceMemo("维修后说明");
$req->setPhoneImei("13839155112");
$req->setSubStatus("30");
$req->setServiceCenterManagerPhone("13888888888");
$req->setServiceCenterManagerName("张三");
$req->setServiceCenterAddress("浙江省杭州市余杭区文一西路960号");
$work_card_install_detail_list = new WorkCardInstallDetail;
$work_card_install_detail_list->sn="32d3f5,234sd";
$work_card_install_detail_list->status="5";
$work_card_install_detail_list->img_urls="http://sfdf2.png,http://2342df.pgn";
$work_card_install_detail_list->memo="商品安装完成，消费者很满意";
$work_card_install_detail_list->accessory_info="名称1:数量1;名称2:数量2";
$work_card_install_detail_list->install_fee="收费类型1:金额;收费类型2:金额";
$req->setWorkCardInstallDetailList(json_encode($work_card_install_detail_list));
$req->setServiceFeeDetail("{   \"安装辅材费\": {     \"加长铜管\": 500,     \"外机支架\": 1000   },   \"辅助项目费\": {     \"高空作业费\": 5000,     \"打孔费（砖墙）\": 2000   },   \"其他类型费用\": {     \"xx类型1\": 1000,     \"xx类型2\": 2000   },   \"特殊场景费用\": {     \"xx场景1\": 500,     \"xx场景2\": 1000   },   \"安装服务费\": {     \"上门服务费\": 1000   } }");
$req->setExpressCode("AAXX12123");
$req->setExpressCompany("韵达");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=tmall.servicecenter.workcard.status.update' \
-d 'partner_id=apidoc' \
-d 'session=423d7a18-f3f9-4eae-9f0a-d96cb068315e' \
-d 'sign=8F60CE7D3B648098CE2F12458F6FF185' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-10+17%3A52%3A43' \
-d 'v=2.0' \
-d 'address=%E6%B5%99%E6%B1%9F%E7%9C%81+%E6%9D%AD%E5%B7%9E%E5%B8%82+%E8%A5%BF%E6%B9%96%E5%8C%BA+xxx%E8%A1%97%E9%81%93' \
-d 'after_service_memo=%E7%BB%B4%E4%BF%AE%E5%90%8E%E8%AF%B4%E6%98%8E' \
-d 'attribute=%3Breasons%3A1%2C2%2C3%3BsucceedCount%3A1%3BfailedCount%3A2%3BcancelCount%3A2%3BtotalCount%3A5%3B' \
-d 'before_service_memo=%E7%BB%B4%E4%BF%AE%E5%89%8D%E6%95%85%E9%9A%9C' \
-d 'buyer_id=12345678' \
-d 'comments=comments' \
-d 'complete_date=1465902848' \
-d 'contact_name=%E8%8B%8D%E5%B8%88%E5%82%85' \
-d 'contact_phone=138xxx' \
-d 'effect_date=12345678' \
-d 'expire_date=12345678' \
-d 'express_code=AAXX12123' \
-d 'express_company=%E9%9F%B5%E8%BE%BE' \
-d 'is_visit=true' \
-d 'phone_imei=13839155112' \
-d 'service_center_address=%E6%B5%99%E6%B1%9F%E7%9C%81%E6%9D%AD%E5%B7%9E%E5%B8%82%E4%BD%99%E6%9D%AD%E5%8C%BA%E6%96%87%E4%B8%80%E8%A5%BF%E8%B7%AF960%E5%8F%B7' \
-d 'service_center_code=1234abc' \
-d 'service_center_manager_name=%E5%BC%A0%E4%B8%89' \
-d 'service_center_manager_phone=13888888888' \
-d 'service_center_name=%E6%9F%90%E6%9F%90%E6%9C%8D%E5%8A%A1%E7%BD%91%E7%82%B9' \
-d 'service_date=1465902848' \
-d 'service_fee=3000' \
-d 'service_fee_detail=%7B+++%5C%22%E5%AE%89%E8%A3%85%E8%BE%85%E6%9D%90%E8%B4%B9%5C%22%3A+%7B+++++%5C%22%E5%8A%A0%E9%95%BF%E9%93%9C%E7%AE%A1%5C%22%3A+500%2C+++++%5C%22%E5%A4%96%E6%9C%BA%E6%94%AF%E6%9E%B6%5C%22%3A+1000+++%7D%2C+++%5C%22%E8%BE%85%E5%8A%A9%E9%A1%B9%E7%9B%AE%E8%B4%B9%5C%22%3A+%7B+++++%5C%22%E9%AB%98%E7%A9%BA%E4%BD%9C%E4%B8%9A%E8%B4%B9%5C%22%3A+5000%2C+++++%5C%22%E6%89%93%E5%AD%94%E8%B4%B9%EF%BC%88%E7%A0%96%E5%A2%99%EF%BC%89%5C%22%3A+2000+++%7D%2C+++%5C%22%E5%85%B6%E4%BB%96%E7%B1%BB%E5%9E%8B%E8%B4%B9%E7%94%A8%5C%22%3A+%7B+++++%5C%22xx%E7%B1%BB%E5%9E%8B1%5C%22%3A+1000%2C+++++%5C%22xx%E7%B1%BB%E5%9E%8B2%5C%22%3A+2000+++%7D%2C+++%5C%22%E7%89%B9%E6%AE%8A%E5%9C%BA%E6%99%AF%E8%B4%B9%E7%94%A8%5C%22%3A+%7B+++++%5C%22xx%E5%9C%BA%E6%99%AF1%5C%22%3A+500%2C+++++%5C%22xx%E5%9C%BA%E6%99%AF2%5C%22%3A+1000+++%7D%2C+++%5C%22%E5%AE%89%E8%A3%85%E6%9C%8D%E5%8A%A1%E8%B4%B9%5C%22%3A+%7B+++++%5C%22%E4%B8%8A%E9%97%A8%E6%9C%8D%E5%8A%A1%E8%B4%B9%5C%22%3A+1000+++%7D+%7D' \
-d 'service_voucher_pics=https%3A%2F%2Fimg.daily.taobaocdn.net%2Fimgextra%2Fi4%2F2076226464%2FTB2fdRaXeFhieJjyzdKXXcWypXa_%21%212076226464-0-service_platform_picture.jp%3Bhttps%3A%2F%2Fimg.daily.taobaocdn.net%2Fimgextra%2Fi2%2F2076226464%2FTB2l0RaXeFhieJjyzdKXXcWypXa_%21%212076226464-0-service_platform_picture.jpg' \
-d 'status=1' \
-d 'sub_status=30' \
-d 'type=1' \
-d 'update_date=12345678' \
-d 'updater=api%E8%B0%83%E7%94%A8%E8%80%85' \
-d 'work_card_install_detail_list=null' \
-d 'workcard_id=12345678'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TmallServicecenterWorkcardStatusUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.updater="api调用者"
req.buyer_id=12345678
req.effect_date=12345678
req.workcard_id=12345678
req.expire_date=12345678
req.status="1"
req.update_date=12345678
req.type="1"
req.comments="comments"
req.address="浙江省 杭州市 西湖区 xxx街道"
req.contact_name="苍师傅"
req.contact_phone="138xxx"
req.service_date=1465902848
req.complete_date=1465902848
req.service_voucher_pics="https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg"
req.attribute=";reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;"
req.service_center_code="1234abc"
req.service_center_name="某某服务网点"
req.service_fee=3000
req.is_visit=true
req.before_service_memo="维修前故障"
req.after_service_memo="维修后说明"
req.phone_imei="13839155112"
req.sub_status=30
req.service_center_manager_phone="13888888888"
req.service_center_manager_name="张三"
req.service_center_address="浙江省杭州市余杭区文一西路960号"
req.work_card_install_detail_list=""
req.service_fee_detail="{   \"安装辅材费\": {     \"加长铜管\": 500,     \"外机支架\": 1000   },   \"辅助项目费\": {     \"高空作业费\": 5000,     \"打孔费（砖墙）\": 2000   },   \"其他类型费用\": {     \"xx类型1\": 1000,     \"xx类型2\": 2000   },   \"特殊场景费用\": {     \"xx场景1\": 500,     \"xx场景2\": 1000   },   \"安装服务费\": {     \"上门服务费\": 1000   } }"
req.express_code="AAXX12123"
req.express_company="韵达"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"tmall.servicecenter.workcard.status.update");
add_param(pRequest,"updater","api调用者");
add_param(pRequest,"buyer_id","12345678");
add_param(pRequest,"effect_date","12345678");
add_param(pRequest,"workcard_id","12345678");
add_param(pRequest,"expire_date","12345678");
add_param(pRequest,"status","1");
add_param(pRequest,"update_date","12345678");
add_param(pRequest,"type","1");
add_param(pRequest,"comments","comments");
add_param(pRequest,"address","浙江省 杭州市 西湖区 xxx街道");
add_param(pRequest,"contact_name","苍师傅");
add_param(pRequest,"contact_phone","138xxx");
add_param(pRequest,"service_date","1465902848");
add_param(pRequest,"complete_date","1465902848");
add_param(pRequest,"service_voucher_pics","https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg");
add_param(pRequest,"attribute",";reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;");
add_param(pRequest,"service_center_code","1234abc");
add_param(pRequest,"service_center_name","某某服务网点");
add_param(pRequest,"service_fee","3000");
add_param(pRequest,"is_visit","true");
add_param(pRequest,"before_service_memo","维修前故障");
add_param(pRequest,"after_service_memo","维修后说明");
add_param(pRequest,"phone_imei","13839155112");
add_param(pRequest,"sub_status","30");
add_param(pRequest,"service_center_manager_phone","13888888888");
add_param(pRequest,"service_center_manager_name","张三");
add_param(pRequest,"service_center_address","浙江省杭州市余杭区文一西路960号");
add_param(pRequest,"work_card_install_detail_list","数据结构JSON示例");
add_param(pRequest,"service_fee_detail","{   \"安装辅材费\": {     \"加长铜管\": 500,     \"外机支架\": 1000   },   \"辅助项目费\": {     \"高空作业费\": 5000,     \"打孔费（砖墙）\": 2000   },   \"其他类型费用\": {     \"xx类型1\": 1000,     \"xx类型2\": 2000   },   \"特殊场景费用\": {     \"xx场景1\": 500,     \"xx场景2\": 1000   },   \"安装服务费\": {     \"上门服务费\": 1000   } }");
add_param(pRequest,"express_code","AAXX12123");
add_param(pRequest,"express_company","韵达");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('tmall.servicecenter.workcard.status.update', {
	'updater':'api调用者',
	'buyer_id':'12345678',
	'effect_date':'12345678',
	'workcard_id':'12345678',
	'expire_date':'12345678',
	'status':'1',
	'update_date':'12345678',
	'type':'1',
	'comments':'comments',
	'address':'浙江省 杭州市 西湖区 xxx街道',
	'contact_name':'苍师傅',
	'contact_phone':'138xxx',
	'service_date':'1465902848',
	'complete_date':'1465902848',
	'service_voucher_pics':'https://img.daily.taobaocdn.net/imgextra/i4/2076226464/TB2fdRaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jp;https://img.daily.taobaocdn.net/imgextra/i2/2076226464/TB2l0RaXeFhieJjyzdKXXcWypXa_!!2076226464-0-service_platform_picture.jpg',
	'attribute':';reasons:1,2,3;succeedCount:1;failedCount:2;cancelCount:2;totalCount:5;',
	'service_center_code':'1234abc',
	'service_center_name':'某某服务网点',
	'service_fee':'3000',
	'is_visit':'true',
	'before_service_memo':'维修前故障',
	'after_service_memo':'维修后说明',
	'phone_imei':'13839155112',
	'sub_status':'30',
	'service_center_manager_phone':'13888888888',
	'service_center_manager_name':'张三',
	'service_center_address':'浙江省杭州市余杭区文一西路960号',
	'work_card_install_detail_list':'数据结构JSON示例',
	'service_fee_detail':'{   \"安装辅材费\": {     \"加长铜管\": 500,     \"外机支架\": 1000   },   \"辅助项目费\": {     \"高空作业费\": 5000,     \"打孔费（砖墙）\": 2000   },   \"其他类型费用\": {     \"xx类型1\": 1000,     \"xx类型2\": 2000   },   \"特殊场景费用\": {     \"xx场景1\": 500,     \"xx场景2\": 1000   },   \"安装服务费\": {     \"上门服务费\": 1000   } }',
	'express_code':'AAXX12123',
	'express_company':'韵达'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_servicecenter_workcard_status_update_response>
    <value>true</value>
    <rs>true</rs>
    <error_msg_info>demo</error_msg_info>
    <error_code_value>123</error_code_value>
</tmall_servicecenter_workcard_status_update_response>

{
    "tmall_servicecenter_workcard_status_update_response":{
        "value":true,
        "rs":true,
        "error_msg_info":"demo",
        "error_code_value":"123"
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.missing-parameter:workcardId-or-type-or-status-or-updateDate-or-buyerId-or-workCardStatusDO	以下字段均不能为空(workcardId,type,status,updateDate,buyerId,workCardStatusDO)	以下字段均不能为空(workcardId,type,status,updateDate,buyerId,workCardStatusDO)
isv.invalid-parameter:the type of workcard is not legitimate	工单类型不合法	工单类型不合法，目前只有合同类和任务类
isv.invalid-parameter:contract and accept service,effectDate and expireDate can not be null	合同类的工单，并且是服务商受理了的工单，EffectDate，ExpireDate 均不能为空	合同类的工单，并且是服务商受理了的工单，EffectDate，ExpireDate 均不能为空
isv.invalid-permission:no permission	工单是不是这个服务提供商的	非法操作
isv.invalid-parameter:the status of workcard is not legitimate	关于工单的其他状态的反馈，暂时不支持	关于工单的其他状态的反馈，暂时不支持
isp.servtpservice-service-error: hsf error	内部错误	内部错误，联系isp
isv.invalid-parameter:the type of workcard illegal	工单类型不合法	工单类型不合法，目前只有合同类和任务类
isv.invalid-parameter:the status of workcard illegal	关于工单的其他状态的反馈，暂时不支持	关于工单的其他状态的反馈，暂时不支持
isp.servtpservice-service-error: backend system busy, please retry later	系统繁忙,请稍后再试	系统繁忙,请稍后再试
isv.invalid-parameter: pre status not executed	状态错误，该工单前置状态未回传	请阅读api，按照受理，执行中，执行完成的顺序回传工单执行状态
isv.invalid-parameter: the length of comment must less than 256	参数错误，备注字段(comments)长度不能超过256个字符	参数错误，备注字段(comments)长度不能超过256个字符
isv.missing-parameter:workcardId-or-type-or-status-or-updateDate-or-workCardStatusDO	以下字段均不能为空(workcardId,type,status,updateDate,workCardStatusDO)	以下字段均不能为空(workcardId,type,status,updateDate,workCardStatusDO)
isp.service-unavailable	服务不可用	请稍后重试

API测试工具错误码查询工具 SDK下载

天猫服务商品API

tmall.servicecenter.workcard.status.update (服务商反馈服务的执行情况)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ