登录

您的位置 : 文档中心 -> API信息

中间平台-EHR > 新增员工派工信息封装接口（客服模块-拆分接口,中间库）-小块灵

系统级别输入参数

参数名称 说明
appkey 客户端标识 (由fesco技术部提供给调用方一对appkey与appsecret)
sign 调用方签名后的字符串
format （json/jsonp)如果该参数不传递,默认返回json
timeStamp 时间戳（毫秒值，1534225991898）
methodName 方法名

接口概述
开发者 商臣君
方法名 csmgr.createOfferInfoXkl
说明 北京本地执行的，接口预派；
全国的，接口进行预派，业务员在新系统进行人工委派；
1、 ofo需要将必填字段传给核心系统；
2、 返回参数为：执行结果（成功，失败）；唯一号（成功时返回）；错误原因（失败时返回）
3、 对于预派后产生审批流的或其他不成功原因时，需要给ofo返回具体失败原因；
4、 委托社保开始时间/委托公积金开始日期 的起做月份不能早于入职日期的月份且不能晚于入职日期月份的一个月。

注意：入参不得传入“”或null，错误示例：“birthDate”=“”、“birthDate”=“null”、“birthDate”=null

应用级输入参数

名称 类型 是否必须 描述 示例值 默认值
jsonList {} 是 应用级别参数对象Json序列化后的字符串 { }
└ conAcceId Long 是 合同附件ID 189733
└ insPkgId Long 否 社保地方标准组合id 14128305
└ idCardNo String 是 证件号码 严格按照各个类型的证件号码格式控制
└ empName String 是 雇员姓名 雇员姓名
中国籍员工必须输入中文。含有数字、字母均为非法数据。
└ exactCerType Integer 是 精准证件类型 证件类型字典码： CARD_TYPE
1=身份证
2=军官证
32=中华人民共和国港澳居民居住证
33=中华人民共和国台湾居民居住证
23=外国人永久居留身份证
24=中国护照
25=外国护照
extraEmpMsgList [] 否 附加证件信息 第二证件，不提供可不传。
例如：对于港澳人员，北京社保要求提供「中华人民共和国港澳居民居住证」。北京公积金要求提供「港澳居民来往内地通行证」
（后续随着政策调整可能会变动）
└ country Integer 是 国家/地区 字典码：GM_COUNTRY
例如：156=中国
344=中国香港
446=中国澳门
158=中国台湾
└ isForeigner Integer 是 是否外籍人 是否外籍人：YES_NO。
若为外籍人且业务上有所区分，则必须严格填写，用以区分那一个产品进具体合同附件
└ empDuties Integer 否 职务 字典码：ES_SEND_JOB
└ email String 否 邮箱 邮箱地址，格式须为xxx@xxx.xxx
└ sex Integer 是 性别 字典码：SEX
1=男性
2=女性
证件为身份证时会与证件号码校验
└ nation Integer 否 民族 字典码 GM_NATION
1=汉族
社保执行地为北京时必填
└ contractType Integer 是 联系方式 字典码：CONTACT_WAY
固话=1
手机=3
└ conTel String 是 联系电话 固定电话或手机电话
└ insEmpPhone String 否 参保人手机 含社保产品且「社保增加类型」为转入时，参保人手机必填
└ payFeesPerType Integer 否 缴费人员类别 字典码：PAY_FEES_PER_CATE
含社保产品且派往北京时必填，其余地区可不填
└ insAddType Integer 否 社保增加类型 含社保产品且派往北京时必填，其余地区可不填
1 新参统
2 转入
不做社保产品时，也不可传此参数。
└ perPkgType Integer 否 人员组成类型 字典码：PER_PKG_TYPE
成本中心=3
└ perPkgId String 否 人员组成 选择人员组成类型后选择人员组成
传入对应人员组成编号/ID
└ birthDate String 否 出生年月 外籍人时必填 YYYY-MM-DD
└ empInsideNo String 否 员工内部编号 企业内部员工编号
└ isgraduateRecv Integer 是 是否毕业生接收 字典码：YES_NO
默认传否（0）		 0
└ isUseCb Integer 是 是否做中行卡 字典码：YES_NO
默认传否（0）		 0
└ isScTax Integer 是 是否按劳务费计税 字典码：YES_NO
默认传否（0）		 0
└ isBjgradu Integer 是 北京接收毕业生类型 字典码：ENT_TYPE
默认传非毕业生（3）		 3
└ isForeignerTax Integer 是 是否按外籍人计税 字典码：YES_NO
默认传否（0）		 0
└ isgraduate Integer 是 是否使用进京指标 字典码：YES_NO
默认传否（0）		 0
└ labWayType Integer 是 用工方式 字典码：WAY_LAB_TYPE
默认值（2）客户用工（委托）		 2
└ offerAreaId Integer 是 委派地区 须传入地区ID
可通过地区接口获取
└ repoDate String 是 入职日期 入职日期 YYYY-MM-DD
与订单开始日期不可相差30天
例如：入职日期=2019-11-01，订单日期的范围须在「2019-10-02」与「2019-12-01」之间
└ orderBeginDate String 是 订单开始日期 订单开始日期，默认为入职日期YYYY-MM-DD
须与社保服务内容中开始日期，或公积金服务内容中开始日期至少一项一致。
csOfferDetDtoList [] 否 非代收代付服务内容 服务费、福利产品
目前未用到，不用传输。
csOfferDetInsDtoList [] 否 社保服务内容 无社保可不用传输此属性及子属性
csOfferDetAccuDtoList [] 否 公积金服务内容 无公积金可不用传输此属性及子属性
└ remark String 否 备注
└ contulSalary Double 否 合同约定工资薪金，社保执行地是北京时必填 100000.05
└ lconPeriodType Integer 否 劳动合同类型，社保执行地是北京且是客户用工时必填 字典码：ES_LCON_PERIOD_TYPE
1=有固定期限
2=无固定期限
3=以完成一定的工作为期限
└ signDate TimeStamp 否 劳动合同签署日期，非管控户且社保执行地是北京且用工方式为客户用工时必填 格式为：YYYY-MM-DD
2020-01-01
└ custLconBeginDate TimeStamp 否 劳动合同开始日期，所有社保账户，社保执行地是北京且用工方式为客户用工时必填 格式为：YYYY-MM-DD
2020-01-01
└ custLconEndDate TimeStamp 否 劳动合同结束日期，管控户，社保执行地是北京且用工方式为客户用工时必填；非管控户，劳动合同类型为固定期限且社保执行地是北京且用工方式为客户用工时必填 格式为：YYYY-MM-DD
2020-10-31
└ job Integer 否 岗位，社保执行地是北京时，必填 字典码：CS_BJ_INS_ADDED_JOB
1=管理、专业技术岗
2=非管理、非专业技术岗
└ empType Integer 否 员工类型，管控户，社保执行地是北京且社保账户非通州分单立户时，必填，管控户的其它情况自动赋值默认值；非管控户时非必填且不会赋默认值 字典码：EMP_TYPE
1=本单位员工
2=劳务派遣员工
3=劳务外包员工
└ version Double 否 版本号，后续使用 1.1
└ isElecLcon Integer 否 是否已签订电子劳动合同 字典码：YES_OR_NO
0 = 否
1 = 是
社保执行地=北京时必填
└ hshdRegProvnc Long 否 户籍所在省份 示例： 752254。注意：户籍所在省份（hshdRegProvnc）、户籍所有城市（hshdRegCity）、户籍详细地址（hshdRegAddr），三个字段要填都填，要不填都不填。
└ hshdRegCity Long 否 户籍所在城市 示例：755803。注意：户籍所在省份（hshdRegProvnc）、户籍所有城市（hshdRegCity）、户籍详细地址（hshdRegAddr），三个字段要填都填，要不填都不填。
└ hshdRegAddr String 否 户籍详细地址 示例：大望路1号院。注意：户籍所在省份（hshdRegProvnc）、户籍所有城市（hshdRegCity）、户籍详细地址（hshdRegAddr），三个字段要填都填，要不填都不填。
└ cerEffectDateBegin TimeStamp 否 身份证有效期起始日 2021-05-01
└ cerEffectDateEnd TimeStamp 否 身份证有效期截至日 根据证件有效期起与身份证校验办理身份证年龄,校验证件有效期限，期限为16岁一下5年、16岁-25岁10年、26岁-45岁20年、46及其以上为长期如果为空校验是否为办证年龄46岁及其以上，闰年2月29对应非闰年3月1日 ，证件截止日期不能小于当前日期。 示例为日期类型：2025-05-07
└ identity Integer 否 个人身份（三险） 社保执行地为北京时，必填，字典值【IDENTITY】。
需要与劳动合同信息中的“岗位”联动，必须先选择“岗位”后，才可以选择个人身份（三险）字段：
a．岗位：为“管理、专业技术岗”时，个人身份选项分别为“专业技术人员”、“企业管理人员”；
b．岗位：为“非管理、非专业技术岗”时，个人身份选项为“职员”、“工人”；
└ householdType Integer 否 户口性质（三险） 社保执行地为北京时，必填，字典码【HOUSEHOLD_TYPE】

返回结果

名称 类型 描述
code String 0为成功，FW为失败
errorMsg String 失败原因
successResult {} 成功数据
errorResult {} 错误数据集合
status String 1为中间库成功，2为新系统成功，3为新系统失败（新系统业务处理异常，不插入中间库）
piCallRecId String 中间表主键id（根据中间表主键id查询返回正确业务数据的json串）
errorStack String 错误堆栈

调用示列

错误码

错误编码 错误描述 错误原因 解决方案

API工具

开发指南

系统级别参数 加密规则 注意事项 错误返回

解决方案

系统级别参数 加密规则 注意事项 错误返回

支持中心

系统级别参数 加密规则 注意事项 错误返回

联系我们

400-8000-800

产品咨询：010-85692930

FESCO官方

FESCO服务

京ICP证 060795号　　京ICP备 09062339号　　人才市场中介服务许可证 编号：RC0101149　　京公网安备 11010502030629号
版权所有 北京外企人力资源服务有限公司