江门市建筑工程用工实名信息化监管系统接入标准

目录

3.1新增班组 18

3.2添加班组工人 20

3.3班组工人进退场 21

3.4班组工人进退场结果 22

3.5添加分账计划 22

3.6添加拨付款记录 23

3.7添加工资款记录 24

3.7添加工资发放记录 25

3.8添加公司银行卡账号 26

3.9添加项目事件 27

4.1 测试环境 28

4.2 结果码对照表 28

4.3 工种代码表 28

4.4 银行代码表 28

4.5调用示例 29

4.6注意事项 31

一、引言

1.1编写目的

为加强江门市建筑工程用工实名信息化监管系统对工人实名信息、工人考勤数据、分账管理及工资发放信息等统一管理，解决已有用工实名信息化管理系统与监管系统对接问题，实现数据实时对接和交换，特编写本接入标准供施工企业相关技术人员对接。

1.2适用范围

本文档的适用对象为接入江门市建筑工程用工实名信息化监管系统的施工企业或信息科技公司的技术开发人员、日常维护人员。

1.3简称和术语

江门市建筑工程用工实名信息化监管系统：以下简称“监管系统”。

施工企业：指依法取得施工企业资质证书，在本市从事建设施工活动的施工总承包企业、专业承包企业和劳务分包企业。

信息科技公司：指有资质开发并承包商业化实名制管理系统的信息科技公司。

1.4通信时效

● 为实现数据实时对接和交换（参数要求：数据响应时长≤10s），建设主管部门将委托监管系统研发单位对各项目使用的实名管理系统进行检验，达到实时性要求。

二、开发规范

2.1通信协议

● 采用HTTP（或HTTPS）协议进行请求和响应的处理。接口请求采用GET/POST方式。接口响应返回JSON格式的数据。

● 由“监管系统”提供企业实名制、工资分账、考勤等功能的接口地址。

● 接口请求URL地址：详见接口说明。

● 接口未注明处均使用UTF-8编码。

● HTTP（或HTTPS）请求参数均为字符串。

● 接口请求需进行签名，详见2.2通信安全一节。

2.2通信安全

为保证数据传输过程中的数据真实性，我们需要对数据进行数字签名，在接收签名数据之后进行签名校验。

“监管系统”会为施工企业的每个工程分配唯一的接入编号Token和Key。

签名机制如下：

● 传参时，传入参数数据皆为Json格式数据。

● 传入参数中，需要传入Token，Date，Sign，RequestJson。Token为项目唯一接入编号。Date为请求时间戳，格式为日期格式YYYY-MM-DD HH:MM:SS。Sign为加密字符串，Sign=MD5(Token+Key+Date)。RequestJson为具体请求操作的数据。具体传参请参考文档调用示例。

● 敏感信息如：班组编号、身份证图片路径、身份证号、银行卡号、社保号需要加密传输，使用DES加密，加密Key等于接入密钥，加密后的字节码转为16进制编码的字符串。算法：密文=HEX(DES(idcard, key))，Des的Mode=CipherMode.CBC。如：身份证号：5113011990010181111，接入密钥Key：B9B8035F，密文：92360DBDD975690CB7D1220983974476EE4E69B33A5BC357

三、接口文档

● 所有接口响应的返回信息均以JSON字符串形式返回，可以使用JSON工具包对其进行解析。

● 返回信息具体字段参照接口说明中的响应参数，以下以举例：

处理成功：

{"rstCode":0,"rstMsg":"处理成功"}

处理失败：

{"rstCode":1,"rstMsg":"签名错误"}

● 返回结果码对照见附录4.2结果码对照表。

3.1新增班组

接口说明

请求参数

响应参数