|
@@ -0,0 +1,452 @@
|
|
|
|
+金地OA同步接口文档
|
|
|
|
+SHR提供人事单据接口给OA调用,包含入职、转正、调动、离职单据对接。
|
|
|
|
+数据流图:
|
|
|
|
+
|
|
|
|
+ 入职
|
|
|
|
+A)服务名称
|
|
|
|
+ 接口url
|
|
|
|
+
|
|
|
|
+http://10.0.64.221:6888/shr/shr/msf/service.do?method=callService&serviceName= saveEmpEnrollBizBillService
|
|
|
|
+ 服务名
|
|
|
|
+saveEmpEnrollBizBillService
|
|
|
|
+ 协议
|
|
|
|
+HTTP
|
|
|
|
+ 请求方式
|
|
|
|
+Post
|
|
|
|
+B)请求参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+personName
|
|
|
|
+员工姓名(必填)
|
|
|
|
+
|
|
|
|
+personNumber
|
|
|
|
+员工编码(必填)
|
|
|
|
+
|
|
|
|
+position
|
|
|
|
+入职职位编码(必填)
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+jobLevel
|
|
|
|
+入职职级编码
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+createPerson
|
|
|
|
+申请人编码(必填)
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+createDate
|
|
|
|
+申请时间
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+empType
|
|
|
|
+入职员工用工状态编码
|
|
|
|
+默认 试用员工
|
|
|
|
+idCard
|
|
|
|
+身份证号码(选填)
|
|
|
|
+身份证号码和护照号码二者必须传一个
|
|
|
|
+passport
|
|
|
|
+护照号码(选填)
|
|
|
|
+身份证号码和护照号码二者必须传一个
|
|
|
|
+cardAddress
|
|
|
|
+身份证地址(必填)
|
|
|
|
+
|
|
|
|
+gender
|
|
|
|
+性别(必填)
|
|
|
|
+男1 女2
|
|
|
|
+bizData
|
|
|
|
+入职日期(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+probation
|
|
|
|
+试用期(月)
|
|
|
|
+
|
|
|
|
+isEnrollAgain
|
|
|
|
+是否在入职(选填)
|
|
|
|
+0 是 1 否
|
|
|
|
+oldNub
|
|
|
|
+再次入职应用原员工编码(选填)
|
|
|
|
+再次入职时必填
|
|
|
|
+oldDep
|
|
|
|
+原组织(选填)
|
|
|
|
+再次入职时必填
|
|
|
|
+oldPtion
|
|
|
|
+原职位(选填)
|
|
|
|
+再次入职时必填
|
|
|
|
+affType
|
|
|
|
+变动类型编码
|
|
|
|
+默认 雇佣入职(0101)
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+hrBizDefine
|
|
|
|
+变动操作
|
|
|
|
+默认 雇佣入职(SHR01)
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+varReason
|
|
|
|
+变动原因
|
|
|
|
+默认 公开招聘的其他人员(RZ08)
|
|
|
|
+telNum
|
|
|
|
+电话号码(必填)
|
|
|
|
+
|
|
|
|
+nation
|
|
|
|
+民族
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+naPlace
|
|
|
|
+籍贯
|
|
|
|
+
|
|
|
|
+email
|
|
|
|
+电子邮件
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+jobStrDate
|
|
|
|
+参加工作日期
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+globAlr
|
|
|
|
+国际区号
|
|
|
|
+
|
|
|
|
+bank
|
|
|
|
+银行名称
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+accountNum
|
|
|
|
+银行卡号
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+province
|
|
|
|
+开户省
|
|
|
|
+
|
|
|
|
+city
|
|
|
|
+开户市
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+accName
|
|
|
|
+账户名称
|
|
|
|
+
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+oaUserName
|
|
|
|
+oa用户名(必填)
|
|
|
|
+用于双方系统对接
|
|
|
|
+C)返回参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+msg
|
|
|
|
+返回信息
|
|
|
|
+成功返回success,失败返回报错信息
|
|
|
|
+msgType
|
|
|
|
+状态
|
|
|
|
+成功为1,失败为0
|
|
|
|
+fnumber
|
|
|
|
+单据编码
|
|
|
|
+
|
|
|
|
+ 转正
|
|
|
|
+ 服务名称
|
|
|
|
+ 接口url
|
|
|
|
+
|
|
|
|
+http://10.0.64.221:6888/shr/shr/msf/service.do?method=callService&serviceName= saveEmpHireBizBillService
|
|
|
|
+ 服务名
|
|
|
|
+saveEmpHireBizBillService
|
|
|
|
+ 协议
|
|
|
|
+HTTP
|
|
|
|
+ 请求方式
|
|
|
|
+Post
|
|
|
|
+B)请求参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+personNumber
|
|
|
|
+员工工号(必填)
|
|
|
|
+
|
|
|
|
+createPerson
|
|
|
|
+制单人工号(必填)
|
|
|
|
+
|
|
|
|
+rankPosition
|
|
|
|
+转正职级职位编码(非必填)
|
|
|
|
+
|
|
|
|
+createDate
|
|
|
|
+制单时间(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+bizDate
|
|
|
|
+转正日期(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+description
|
|
|
|
+备注(非必填)
|
|
|
|
+
|
|
|
|
+employeeType
|
|
|
|
+用工类型编码(非必填)
|
|
|
|
+不填 默认为正式员工(
|
|
|
|
+grade
|
|
|
|
+考核成绩(非必填)
|
|
|
|
+
|
|
|
|
+jobGrade
|
|
|
|
+转正后职等编码(非必填)
|
|
|
|
+
|
|
|
|
+summary
|
|
|
|
+工作总结(非必填)
|
|
|
|
+
|
|
|
|
+defineInfoNumber
|
|
|
|
+变动操作编码(非必填)
|
|
|
|
+不填默认为 转正操作
|
|
|
|
+actionReasonInfoNumber
|
|
|
|
+变动类型编码(非必填)
|
|
|
|
+不填默认为 转正类型
|
|
|
|
+C)返回参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+msg
|
|
|
|
+返回信息
|
|
|
|
+成功返回success,失败返回报错信息
|
|
|
|
+msgType
|
|
|
|
+状态
|
|
|
|
+成功为1,失败为0
|
|
|
|
+fnumber
|
|
|
|
+单据编码
|
|
|
|
+
|
|
|
|
+ 员工用工状态校验
|
|
|
|
+A)请求地址
|
|
|
|
+ 接口url
|
|
|
|
+
|
|
|
|
+http://10.0.64.221:6888/shr/shr/msf/service.do?method=callService&serviceName=getPersonEmpHireBizBillInfoServiceEx
|
|
|
|
+ 服务名
|
|
|
|
+getPersonEmpHireBizBillInfoServiceEx
|
|
|
|
+ 协议
|
|
|
|
+HTTP
|
|
|
|
+ 请求方式
|
|
|
|
+Post
|
|
|
|
+
|
|
|
|
+B)请求参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+personNumber
|
|
|
|
+员工工号(必填)
|
|
|
|
+
|
|
|
|
+C)返回参数描述
|
|
|
|
+ 参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+ applier
|
|
|
|
+employeeType
|
|
|
|
+number
|
|
|
|
+
|
|
|
|
+用工关系编码
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+name
|
|
|
|
+
|
|
|
|
+用工关系名称
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+id
|
|
|
|
+
|
|
|
|
+用工关系id
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+number
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+工号
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+name
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+员工名称
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+id
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+员工id
|
|
|
|
+
|
|
|
|
+entrys
|
|
|
|
+person
|
|
|
|
+employeeType
|
|
|
|
+number
|
|
|
|
+用工关系编码
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+name
|
|
|
|
+用工关系名称
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+id
|
|
|
|
+用工关系id
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+number
|
|
|
|
+
|
|
|
|
+工号
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+name
|
|
|
|
+
|
|
|
|
+员工名称
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+id
|
|
|
|
+
|
|
|
|
+员工id
|
|
|
|
+
|
|
|
|
+D)参考样例
|
|
|
|
+ {
|
|
|
|
+ "applier": {
|
|
|
|
+ "employeeType": {
|
|
|
|
+ "number": "001",
|
|
|
|
+ "name": "正式员工",
|
|
|
|
+ "name_l2": "正式员工",
|
|
|
|
+ "name_l3": "正式員工",
|
|
|
|
+ "id": "00000000-0000-0000-0000-000000000001A29E85B3"
|
|
|
|
+ },
|
|
|
|
+ "number": "20062995",
|
|
|
|
+ "name": "李友光",
|
|
|
|
+ "name_l2": "李友光",
|
|
|
|
+ "id": "TYwXK1yxSCWW0CIXg/qyIIDvfe0="
|
|
|
|
+ },
|
|
|
|
+ "entrys": [
|
|
|
|
+ {
|
|
|
|
+ "person": {
|
|
|
|
+ "employeeType": {
|
|
|
|
+ "number": "001",
|
|
|
|
+ "name": "正式员工",
|
|
|
|
+ "name_l2": "正式员工",
|
|
|
|
+ "name_l3": "正式員工",
|
|
|
|
+ "id": "00000000-0000-0000-0000-000000000001A29E85B3"
|
|
|
|
+ },
|
|
|
|
+ "number": "20062995",
|
|
|
|
+ "name": "李友光",
|
|
|
|
+ "name_l2": "李友光",
|
|
|
|
+ "id": "TYwXK1yxSCWW0CIXg/qyIIDvfe0="
|
|
|
|
+ }
|
|
|
|
+ }
|
|
|
|
+ ]
|
|
|
|
+ }
|
|
|
|
+ 调动
|
|
|
|
+ 请求地址
|
|
|
|
+ 接口url
|
|
|
|
+
|
|
|
|
+http://10.0.64.221:6888/shr/shr/msf/service.do?method=callService&serviceName=saveFluctuationBizBillService
|
|
|
|
+ 服务名
|
|
|
|
+saveFluctuationBizBillService
|
|
|
|
+ 协议
|
|
|
|
+HTTP
|
|
|
|
+ 请求方式
|
|
|
|
+Post
|
|
|
|
+
|
|
|
|
+B)请求参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+personNumber
|
|
|
|
+员工工号(必填)
|
|
|
|
+
|
|
|
|
+createPerson
|
|
|
|
+制单人工号(必填)
|
|
|
|
+
|
|
|
|
+createDate
|
|
|
|
+制单时间(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+positionName
|
|
|
|
+调动职位名称(必填)
|
|
|
|
+
|
|
|
|
+bizDate
|
|
|
|
+调动日期(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+description
|
|
|
|
+备注(非必填)
|
|
|
|
+
|
|
|
|
+variationReasonInfoNumber
|
|
|
|
+变动原因编码
|
|
|
|
+(非必填,默认为晋升)
|
|
|
|
+
|
|
|
|
+transferWorkplace
|
|
|
|
+调岗后工作地点
|
|
|
|
+
|
|
|
|
+orgUnitNumber
|
|
|
|
+调动部门编码
|
|
|
|
+--------------------------------------------------------------------------------
|
|
|
|
+
|
|
|
|
+C)返回参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+msg
|
|
|
|
+返回信息
|
|
|
|
+成功返回success,失败返回报错信息
|
|
|
|
+msgType
|
|
|
|
+状态
|
|
|
|
+成功为1,失败为0
|
|
|
|
+fnumber
|
|
|
|
+单据编码
|
|
|
|
+
|
|
|
|
+ 离职
|
|
|
|
+ 请求地址
|
|
|
|
+ 接口url
|
|
|
|
+
|
|
|
|
+http://10.0.64.221:6888/shr/shr/msf/service.do?method=callService&serviceName=saveResignBizBillService
|
|
|
|
+ 服务名
|
|
|
|
+saveResignBizBillService
|
|
|
|
+ 协议
|
|
|
|
+HTTP
|
|
|
|
+ 请求方式
|
|
|
|
+Post
|
|
|
|
+B)参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+personNumber
|
|
|
|
+员工工号(必填)
|
|
|
|
+
|
|
|
|
+createPerson
|
|
|
|
+制单人工号(必填)
|
|
|
|
+
|
|
|
|
+createDate
|
|
|
|
+制单时间(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+bizDate
|
|
|
|
+离职日期(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+description
|
|
|
|
+备注(非必填)
|
|
|
|
+
|
|
|
|
+actionReasonInfoNumber
|
|
|
|
+变动类型编码
|
|
|
|
+(非必填,默认为主动离职)
|
|
|
|
+
|
|
|
|
+variationReasonInfoNumber
|
|
|
|
+变动原因编码
|
|
|
|
+(非必填,默认为合同/协议到期员工不续签)
|
|
|
|
+
|
|
|
|
+leftCompanyDate
|
|
|
|
+最后工作日(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+forbidUserDate
|
|
|
|
+禁用用户日期(必填)
|
|
|
|
+格式:yyyy-MM-dd
|
|
|
|
+
|
|
|
|
+C)返回参数描述
|
|
|
|
+参数
|
|
|
|
+参数名称
|
|
|
|
+描述
|
|
|
|
+msg
|
|
|
|
+返回信息
|
|
|
|
+成功返回success,失败返回报错信息
|
|
|
|
+msgType
|
|
|
|
+状态
|
|
|
|
+成功为1,失败为0
|
|
|
|
+fnumber
|
|
|
|
+单据编码
|
|
|
|
+
|
|
|
|
+
|
|
|
|
+
|