家政服务运营监测管理系统接口规范.docx
《家政服务运营监测管理系统接口规范.docx》由会员分享,可在线阅读,更多相关《家政服务运营监测管理系统接口规范.docx(23页珍藏版)》请在冰点文库上搜索。
![家政服务运营监测管理系统接口规范.docx](https://file1.bingdoc.com/fileroot1/2023-7/6/10256d61-87bb-40e7-b1ce-b6d2944d0462/10256d61-87bb-40e7-b1ce-b6d2944d04621.gif)
家政服务运营监测管理系统接口规范
家政服务运营监测管理系统接口规范
一、监控数据上报接口
(一)接口访问。
访问地址:
ice/monitorService?
wsdl
(二)接口定义。
1.WSDL定义元素说明
user:
用户信息
参数定义
参数类型
描述
username
String
用户名
password
String
密码,MD5加密
dailyMonitoring:
每日监控数据
参数定义
参数类型
描述
dataList
complexType:
dailyMonitoringDetail
上报数据
reportDate
dataTime
上报数据所属时间
User
complexType:
user
用户信息
dailyMonitoringDetail:
每日监控数据内容
参数定义
参数类型
描述
serviceIndex
lng
服务类型(详见家政服务类型表)
callVolumn
int
电话呼入量,不能为空,数据长度8
networkConsults
int
网络咨询量,不能为空,数据长度8
dispatchAmonut
int
派单量,不能为空,数据长度8
dispatchRate
decimal
派单率,不能为空,不能大于100
计算公式:
派单量/(电话呼入量+网络咨询量)
Complain:
投诉数据
参数定义
参数类型
描述
dataList
complexType:
complainDetail
上报数据
reportDate
dataTime
上报数据日期,不能为空
User
complexType:
user
用户信息
complainDetail:
投诉数据内容
参数定义
参数类型
描述
complainIndex
Long
投诉类型,不能为空(详见投诉类型表)
complaints
Int
投诉量,不能为空,数据长度8
familyArchivesReport:
服务家庭档案上报数据
参数定义
参数类型
描述
dataList
complexType:
familyArchives
家庭档案数据
user
complexType:
user
用户信息
familyArchives:
服务家庭信息
参数定义
参数类型
描述
address
String
家庭地址,不能为空
attendantList
complexType:
familyArchivesAttendant
派单人员信息,不能为空
contactMan
String
联系人,不能为空
income
Decimal
本次服务价格,不能为空(单位:
元)
requirement
String
家庭需求:
多个类型之间逗号隔开,不能为空,类型编码详见家政服务类型表
Satisfaction
Short
满意度,不能为空
serviceEndDate
dateTime
服务结束时间,不能为空
serviceStartDate
dateTime
服务开始时间,不能为空
tel
String
联系电话,不能为空
familyArchivesAttendant:
派单服务员信息
参数定义
参数类型
描述
attendantName
String
服务人员姓名(不能为空)
entpCode
String
家政企业组织机构编码(不能为空)
entpName
String
家政企业名称(不能为空)
idCard
String
身份证号码(不能为空)
serviceType
string
多个类型之间逗号隔开(详见家政服务类型表)
2.操作上传每日监测数据uploadDailyMonitoring
上传每日监测数据。
每一个上报数据日期的数据只能上报一次。
数据格式为:
dailyMonitoring。
返回状态值如下:
状态
输出值
描述
数据上传成功
1
数据上传成功
数据上传失败
500
用户名或密码错误
505
数据未保存、该日期数据重复
600
上报日期错误
601
上报数据错误,上报数据服务类型不在基础表内
602
上报数据重复,上报数据服务类型重复
603
电话呼入量格式错误
604
网络咨询量格式错误
605
派单量格式错误
606
派单率格式错误
3.操作上传投诉数据uploadComplain
上传投诉数据。
每一个上报数据日期的数据只能上报一次。
数据格式为:
Complain。
返回状态值如下:
状态
输出值
描述
数据上传成功
1
数据上传成功
数据上传失败
500
用户名或密码错误
505
数据未保存、数据重复
600
上报日期错误
611
内部数据错误,上报数据投诉类型不在基础表内
612
内部数据重复,上报数据投诉类型重复
613
投诉量错误
4.操作上传家庭档案数据uploadFamilyArchives
上传家庭档案数据。
家庭档案以每次派单信息为单位批量上报,家庭档案数据包含派单家庭基本信息、本次服务总体满意度和派单服务员信息。
数据格式为:
familyArchivesReport。
返回状态值如下:
状态
输出值
描述
数据上传成功
1
数据上传成功
数据上传失败
500
用户名或密码错误
501
上报数据集为空
620
服务家庭信息中联系电话为空,或数据长度大于20
621
服务家庭信息中联系电话为空,或数据长度大于60
622
本次服务价格为空
623
联系人为空
624
家庭需求为空
625
满意度为空或不在基础表内
626
服务开始时间为空
627
服务结束时间为空
628
家庭需求类型错误
630
派单服务人员信息不全
631
服务类型错误
二、业务数据上报接口
(一)接口访问。
访问地址:
ice/businessService?
wsdl
(二)接口定义。
1.WSDL定义元素说明
user:
用户信息
参数定义
参数类型
描述
username
String
用户名
password
String
密码,MD5加密
entpReport:
企业信息
参数定义
参数类型
描述
dataList
complexType:
entpMain
上报数据
User
complexType:
user
用户信息
entpMain:
企业详细信息
参数定义
参数类型
描述
entpName
String
企业名称,不能为空,最大数据长度200个字符
orgCode
string
组织机构代码,不能为空,最大数据长度40个字符
PIndex
Long
行政区划(详见行政区划和户籍所在地编码),不能为空
serviceType
String
服务类型,多个类型之间逗号隔开(详见家政服务类型表),不能为空
businessArea
decimal
经营面积,不能为空
capital
decimal
注册资金,不能为空
corporation
string
企业法人代表,不能为空,最大数据长度20
entpKind
byte
企业性质(详见企业性质表)
entpSize
Byte
企业类型(详见企业类型表)
foundedDate
dateTime
成立时间,不能为空
franchises
Short
全国门店数,不能为空,最大数据精度4
operationType
Byte
经营方式(详见企业经营方式表),不能为空
server
int
服务人员人数,不能为空
street
String
营业地址,不能为空
Tax
Decimal
年纳税额,不能为空
tel
string
联系电话,不能为空
turnover
decimal
年营业额,不能为空
worker
int
管理人员人数,不能为空
stafferInfoReport:
服务人员信息上报
参数定义
参数类型
描述
dataList
complexType:
stafferInfo
上报数据
User
complexType:
user
用户信息
entpCode
string
就业企业组织机构编码,不能为空
entpName
string
就业企业名称,不能为空
stafferInfo:
服务人员信息
参数定义
参数类型
描述
stafferName
string
服务人员姓名,不能为空
idCard
string
身份证号码,不能为空
serviceType
string
服务类型,多个类型之间逗号隔开(详见家政服务类型表),不能为空
degree
byte
学历,不能为空
averageIncome
decimal
平均月收入,不能为空
currentPIndex
long
户籍所在地(详见行政区划和户籍所在地编码),不能为空
employmentEndDate
dateTime
合同结束时间,不能为空
employmentStartDate
dateTime
合同开始时间,不能为空
insuranceType
string
保险类型(详见保险类型表),不能为空
trainingDuration
string
培训时长,不能为空,单位:
月
2.操作上传加盟网络中心的家政企业信息ploadEntpReport
上传加盟网络中心的家政企业信息。
上传的家政企业信息如果没有在系统中录入则执行录入操作,已录入的执行更新操作。
数据格式为:
entpReport。
返回状态值如下:
状态
输出值
描述
数据上传成功
1
数据上传成功
数据上传失败
500
用户名或密码错误
501
上报数据集为空
507
企业信息无权限修改。
640
企业名称为空,或数据长度大于200
641
组织机构代码为空,或数据长度大于40
642
服务类型为空,或数据不在家政服务类型表中
643
行政区划为空
644
企业法人代表为空,或数据长度大于20
645
管理人员人数为空,或数据长度大于6
646
服务人员人数为空,或数据长度大于6
647
营业地址为空,或数据整数精度大于4
648
经营面积为空,或数据长度大于20
649
联系电话为空,或数据长度大于40
650
成立时间为空
651
注册资金为空,或数据整数精度大于12
652
年营业额为空,或数据整数精度大于12
653
年纳税额为空,或数据整数精度大于12
654
企业性质为空,或数据不在企业性质表中
655
企业类型为空,或数据不在企业类型表中
656
经营方式为空,或数据不在企业经营方式表中
657
全国门店数为空,或数据长度大于4
3.操作上传家政企业的服务人员信息uploadStaffeInfo
上传家政企业的服务人员信息。
以家政企业为单位上传家政服务人员信息。
数据格式为:
stafferInfoReport。
返回状态值如下:
状态
输出值
描述
数据上传成功
1
数据上传成功
数据上传失败
500
用户名或密码错误
501
上报数据集为空
660
服务人员姓名为空
661
服务人员身份证验证失败
662
服务类型为空,或数据不在家政服务类型表中
663
合同开始时间为空
664
合同结束时间为空
665
培训时长为空,或数据长度大于4
666
保险类型为空,或数据不在保险类型表中
667
户籍所在地为空
668
平均月收入为空,或数据整数精度大于6
三、基础数据及参数说明
基础表
家政服务类型表
键
值
描述
家政服务员
1
母婴护理师
2
养老护理师
3
育婴师
4
其他
5
投诉类型表
键
值
描述
服务质量
1000
服务态度
2000
价格
3000
其他
4000
性别表
键
值
描述
男
1
女
2
文化程度表
键
值
描述
初中及以下
1
高中
2
大专
3
本科
4
硕士
5
博士
6
年龄类型
键
值
描述
18岁以下
0
18岁至25岁
1
26岁至30岁
2
31岁至35岁
3
36岁至40岁
4
41岁至45岁
5
46岁至50岁
6
51岁以上
7
企业类型
键
值
描述
大型
1
中型
2
小型
3
企业性质
键
值
描述
国营企业
1
私营企业
2
三资企业
3
个体经营户
4
其他
5
企业经营方式
键
值
描述
直营
1
加盟
2
二者都有
3
总体满意度
键
值
描述
非常满意
0
基本满意
1
不满意
2
保险类型
键
值
描述
社会保险
1
商业保险
2
二者都有
3
二者都无
4
行政区划和户籍所在地编码参照国家统计局最新县及县以上行政区划代码(截至2012年10月31日)()
四、注意事项
本接口采用SOAP1.1协议标准,为保证数据传输效率和数据校验的准确性,批量传输的信息不应该大于1M。
本接口的定义将随着全国家政服务监测平台需求的变更加以变动,原则上在不作特殊说明的情况下,本文档的后续版本兼容历史版本。
如存在特殊情况下的接口变更造成企业端的调整将以电话或邮件的形式向企业沟通说明。
参数中的XML文件编码使用UTF-8。
五、样例数据
(一)上传每日监测数据。
xmlversion="1.0"?
>
Envelopexmlns:
S="">
Body>
uploadDailyMonitoringxmlns:
ns2="">
100
100
0.5
100
1
20
10
0.25
20
2
30
18
0.30
30
3
2013-04-12T03:
08:
21.257+08:
00
hfjzwl
670B14728AD9902AECBA32E22FA4F6BD
uploadDailyMonitoring>
Body>
Envelope>
(二)上传家政企业的服务人员信息。
xmlversion="1.0"?
>
Envelopexmlns:
S="">
Body>
uploadComplainxmlns:
ns2="">
hfjzwl
670B14728AD9902AECBA32E22FA4F6BD
2013-04-13T03:
29:
11.023+08:
00
1000
20
2000
16
3000
14
uploadComplain>
Body>
Envelope>
(三)上传家庭档案数据。
xmlversion="1.0"?
>
Envelopexmlns:
S="">
Body>
uploadFamilyArchivesxmlns:
ns2="">
地址1
联系
1200
1,2,3,4,5
0
2013-04-16T04:
07:
52.606+08:
00
2013-04-16T04:
07:
52.606+08:
00
服务人员1
-4
企业1
1,3
服务人员2
-4
企业1
4,5
hfjzwl
670B14728AD9902AECBA32E22FA4F6BD
uploadFamilyArchives>
Body>
Envelope>
(四)上传加盟网络中心的家政企业信息。
xmlversion="1.0"?
>
Envelopexmlns:
S="">
Body>
uploadEntpReportxmlns:
ns2="">
hfjzwl
670B14728AD9902AECBA32E22FA4F6BD
-4
测试企业1
1,2,3,4
1000.2
1000.2
1
2
2013-04-15T07:
21:
52.098+08:
00
2
2
340102
100
地址
10030.2
12
10002.2
20
-9