文档中心 > API类目 > 天猫服务商品API

tmall.servicecenter.workcard.push (推送服务工单信息)

服务商家推送工单信息到天猫。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
attributes String 可选 ;k1=v1;k2=v2; 属性列表。使用半角分号隔开,字符串前后都需要有半角分号
desc String 可选 xx服务旗舰店初始化工单推送 描述
biz_order_id Number 必须 123456 淘宝交易订单号
service_reserve_time String 可选 2015-10-10 21:00:00 服务预约安装时间
service_reserve_address String 可选 xx省xx市xx区xx镇 街道地址 服务预约安装地址。四级地址与街道地址用空格隔开
status String 必须 1 0=初始化, 3=授理, 10=拒绝 ,4=执行 ,5=成功,11=失败

响应参数

名称 类型 示例值 描述
workcard_result ResultBase 返回结果
  • └ value
  • Number
  • 123
  • └ error_code
  • Number
  • 123
  • 错误码
  • └ error_msg
  • String
  • demo
  • 错误信息
  • └ success
  • Boolean
  • false
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterWorkcardPushRequest req = new TmallServicecenterWorkcardPushRequest();
req.setAttributes(";k1=v1;k2=v2;");
req.setDesc("xx服务旗舰店初始化工单推送");
req.setBizOrderId(123456L);
req.setServiceReserveTime("2015-10-10 21:00:00");
req.setServiceReserveAddress("xx省xx市xx区xx镇 街道地址");
req.setStatus("1");
TmallServicecenterWorkcardPushResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_servicecenter_workcard_push_response>
    <workcard_result>
        <value>123</value>
        <error_code>123</error_code>
        <error_msg>demo</error_msg>
        <success>false</success>
    </workcard_result>
</tmall_servicecenter_workcard_push_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.invalid-operation 非法操作 请检查是否有权限推送该条数据
isv.invalid-parameter:invalid biz_order_id 参数不合法。订单号不正确。 检查订单号是否正确
isp.remote-service-error 远程服务异常 稍后重试或者联系淘宝开发平台接口人

API工具

如何获得此API

FAQ

返回
顶部