退出
热词搜索：
API接口目录

物业业务

物业API
异常码自查工具
suning.hopurch.workord.add 单笔工单创建
￥免费

通过此接口可进行单笔工单的创建。1.社区编码，非ID，必填，社区编码可通过社区信息非分页查询接口“POP-queryCommunityInfo”获取；2.工单类型，必填，0=报修，1=咨询，2=建议，3=投诉；3.内容，必填，填写工单内容文本描述信息，最大长度为255个字符；4.联系人，必填，一般填写工单联系人姓名，最大长度为16个字符；5.联系电话，必填，支持固话、手机，最大长度为13个字符；6.区域类型，必填，0=个人,1=公共；7.区域编码，必填，如果区域类型是个人则传房体编码值，如果区域类型是公共则传区域编码值，房体编码可通过房体信息分页查询接口“POP-queryHouseInfo”获取，区域编码可通过区域信息分页查询接口“POP-queryCommunityAreaInfo”获取；8.工单图片，图片url地址；9.一级业务分类，工单类型为报修的情况下必填，其他类型非必填，0=客服，1=工程，2=安全，3=环境。10.渠道，必填，0=业主APP，1=物管APP，2=现场，3=400电话，4=豆芽，5=微信，6=一碑11.来源，必填，0=报修联系单，1=咨询联系单，2=建议联系单，3=投诉联系单，4=PC创建，5=综合巡检，6=品质核查，7=设施检查

公共参数
请求参数
名称 类型 是否必须 示例值 描述
communityCodeStringY210008社区编码
typeStringY0工单类型，0表示报修，1表示咨询，2表示建议，3表示投诉
contentStringY我们家下水道堵塞，请尽快安排物业人员上门协助维修。工单内容文本描述信息
personStringY张三联系人姓名
telStringY13323456789联系人电话
zoneTypeStringY1区域类型，个人或者公共
zoneCodeStringYf1234567890123456789房体ID或者区域编码，20位长度
bizTypeStringN1一级业务分类，工单类型为报修的情况下必填，其他类型非必填
channelStringY1渠道，0表示业主APP，1表示物管APP，2表示现场，3表示400电话，4表示豆芽，5表示微信，6表示一碑
sourceStringY0来源，0表示报修联系单，1表示咨询联系单，2表示建议联系单，3表示投诉联系单，4表示PC创建，5表示综合巡检，6表示品质核查，7表示设施检查
zoneManagerStringN123456非必填(区域类型为公共，此项必填)
buildCodeStringN1234非必填(区域类型为个人，此项必填)
communityNameStringY花园小区社区名称
memberNoStringY111111111创建工单人员子会员编码，最长15个字符
memberNameStringY张明创建人姓名，最长50个字符
picListStringN
picUrlStringYhttp://1.jpg工单图片(url地址)
picTypeStringY3类型(3工单图片)
响应参数
名称 类型 示例值 描述
workOrderCodeStringBX2100081607080001工单编码
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <addWordOrd>
      <zoneType>1</zoneType>
      <person>张三</person>
      <zoneManager>123456</zoneManager>
      <tel>13323456789</tel>
      <type>0</type>
      <zoneCode>f1234567890123456789</zoneCode>我们家下水道堵塞，请尽快安排物业人员上门协助维修。<communityCode>210008</communityCode>
      <source>0</source>
      <bizType>1</bizType>
      <buildCode>1234</buildCode>
      <communityName>花园小区</communityName>
      <memberName>张明</memberName>
      <channel>1</channel>
      <picList>
        <picUrl>http://1.jpg</picUrl>
        <picType>3</picType>
      </picList>
      <memberNo>111111111</memberNo>
    </addWordOrd>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addWordOrd": {
        "zoneType": "1",
        "person": "张三",
        "zoneManager": "123456",
        "tel": "13323456789",
        "type": "0",
        "zoneCode": "f1234567890123456789",
        "content": "我们家下水道堵塞，请尽快安排物业人员上门协助维修。",
        "communityCode": "210008",
        "source": "0",
        "bizType": "1",
        "buildCode": "1234",
        "communityName": "花园小区",
        "memberName": "张明",
        "channel": "1",
        "picList": {
          "picUrl": "http://1.jpg",
          "picType": "3"
        },
        "memberNo": "111111111"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <addWorkOrd>
      <workOrderCode>BX2100081607080001</workOrderCode>
    </addWorkOrd>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addWorkOrd": {
        "workOrderCode": "BX2100081607080001"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.hopurch.addworkord.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.gd 服务不可用（系统异常） 请联系苏宁技术人员。
biz.hopurch.addworkord.invalid-biz:100 请求参数为空 检查必填项
biz.hopurch.addworkord.invalid-biz:101 请求参数格式错误 检查输入参数格式
biz.hopurch.addworkord.invalid-biz:102 请求编码参数值不存在 检查请求编码参数值
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ