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

tmall.servicecenter.spserviceorder.create (服务单创建)

服务单创建

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
service_product_id Number 必须 2813 服务产品id
service_object_type String 必须 50019790 服务对象类型
service_object_name String 可选 平板电视 服务对象类型名称
service_content String 必须 挂装 服务内容
service_properties Json 必须 {"品牌":"海尔","sku屏幕尺寸":"70"} 服务计价json
brand_id Number 可选 30645 品牌id
buyer BuyerDTO 必须 消费者信息
  • └ address_province
  • String
  • 可选
  • 浙江省
  • 买家地址-省
  • └ address_city
  • String
  • 可选
  • 杭州市
  • 买家地址-市
  • └ address_district
  • String
  • 可选
  • 余杭区
  • 买家地址-区
  • └ address_town
  • String
  • 可选
  • 五常街道
  • 买家地址-街道
  • └ address_detail
  • String
  • 可选
  • xxx小区
  • 买家地址-详细地址
  • └ full_address
  • String
  • 可选
  • 浙江省杭州市余杭区五常街道xxx小区
  • 买家地址-完整地址
  • └ location
  • Number
  • 可选
  • 3500
  • 买家地址-地址编码
  • └ buyer_name
  • String
  • 必须
  • xx
  • 买家姓名
  • └ mobile
  • String
  • 必须
  • 177xxxxxxxx
  • 买家手机号
reservation ReservationDTO 可选 预约信息
  • └ reserve_time_start
  • Date
  • 可选
  • 2022-05-01 00:00:00
  • 消费者预约开始时间
  • └ reserve_time_end
  • Date
  • 可选
  • 2022-06-01 00:00:00
  • 消费者预约结束时间
service_count Number 必须 1 数量
out_order_id String 必须 test1234 外部单号
source String 必须 JD 外部渠道
ext_json Json 可选 额外业务信息
memo String 可选 xx 备注

响应参数

名称 类型 示例值 描述
is_success Boolean true 是否成功
display_msg String 系统错误 错误信息
service_order_id Number 1 服务单id
workcard_ids Number [] 工单id列表

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterSpserviceorderCreateRequest req = new TmallServicecenterSpserviceorderCreateRequest();
req.setServiceProductId(2813L);
req.setServiceObjectType("50019790");
req.setServiceObjectName("平板电视");
req.setServiceContent("挂装");
req.setServicePropertiesString("{\"品牌\":\"海尔\",\"sku屏幕尺寸\":\"70\"}");
req.setBrandId(30645L);
TmallServicecenterSpserviceorderCreateRequest.BuyerDTO obj1 = new TmallServicecenterSpserviceorderCreateRequest.BuyerDTO();
obj1.setAddressProvince("浙江省");
obj1.setAddressCity("杭州市");
obj1.setAddressDistrict("余杭区");
obj1.setAddressTown("五常街道");
obj1.setAddressDetail("xxx小区");
obj1.setFullAddress("浙江省杭州市余杭区五常街道xxx小区");
obj1.setLocation(3500L);
obj1.setBuyerName("xx");
obj1.setMobile("177xxxxxxxx");
req.setBuyer(obj1);
TmallServicecenterSpserviceorderCreateRequest.ReservationDTO obj2 = new TmallServicecenterSpserviceorderCreateRequest.ReservationDTO();
obj2.setReserveTimeStart(StringUtils.parseDateTime("2022-05-01 00:00:00"));
obj2.setReserveTimeEnd(StringUtils.parseDateTime("2022-06-01 00:00:00"));
req.setReservation(obj2);
req.setServiceCount(1L);
req.setOutOrderId("test1234");
req.setSource("JD");
req.setExtJsonString("");
req.setMemo("xx");
TmallServicecenterSpserviceorderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_servicecenter_spserviceorder_create_response>
    <is_success>true</is_success>
    <display_msg>系统错误</display_msg>
    <service_order_id>1</service_order_id>
</tmall_servicecenter_spserviceorder_create_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

返回
顶部