广东省建筑工人管理服务信息平台数据接口标准(V1.3版)
发布单位:广东省住房和城乡建设厅
发布时间:2022年8月
目 录
编 制 说 明
本数据接口标准根据住房和城乡建设部主编的《全国建筑工人管理服务信息平台数据对接方案》(V1.2.1版本)进行编制,本接口标准将根据《全国建筑工人管理服务信息平台数据对接方案》的更新情况和我省实名制管理需要,适时进行修改。
本数据接口标准与《全国建筑工人管理服务信息平台数据对接方案》(V1.2.1版本)相比,根据“广东省建筑工人管理服务信息平台”的管理需要,做了如下调整:
一、上传、修改项目信息接口的输入参数增加了“软/硬件供应商名称”;
二、上传、修改项目信息接口的输入参数增加了“场所ID”;
三、上传、修改项目信息接口的输入参数增加了“项目所属部门”;
四、增加“新开工项目密钥办理信息”接口标准(本接口仅为市级实名制管理系统向“广东省建筑工人管理服务信息平台”同步数据使用)。
除以上四点外,接口调用方式、签名算法、字段命名、接口方法命名等均与《全国建筑工人管理服务信息平台数据对接方案》(V1.2.1版本)保持一致。
本数据接口标准为广东省“一地接入、全省通用”的统一标准,地市用工实名制管理系统应根据本数据接口标准,规范本地市的用工实名制管理系统数据与项目实名制数据的对接接口。同时,地市用工实名制管理系统与广东省建筑工人管理服务信息平台的数据交互也将同步更新。
接口提供方(API Provider):接口的定义和实现者,为接口调用方提供接口合法访问的授权。
接口调用方(API Client):接口的调用者,需要从接口提供方获得所需接口合法访问的授权。
接口端点(API Endpoint):接口的 Http 资源入口,由一个 Http URL 所表示,代表了一个或由参数确定的多个接口的集合。
POST 格式为:POST <API Endpoint> 参数列表。
参数列表格式为:参数名 1=参数值 1&参数名 2=参数值 2……。
请求标准参数
参数名称 | 参数说明 |
method | 由接口提供方指定的接口标识符。 |
version | 由接口提供方指定的接口版本。注:Endpoint+ method+version 决定了接口的语义。 |
appid | 由接口提供方分配给接口调用方的身份标识符。 |
format | 接口返回结果类型:json |
timestamp | 调用方时间戳,格式为“4 位年+2 位月+2 位日+2 位小时(24 小时制)+2 位分+2 位秒”,用于接口提供方判断调用方的时间,通常约定调用请求的时间戳与接口提供方收到请求的时间差在约定的范围内。 |
nonce | 随机数,由调用方生成,在约定的调用时差范围内不可重复。 |
sign | 签名,按照签名生成算法计算得来。 |
data | 具体的接口方法中的参数实体信息(对象需要转换成 JSON String) |
敏感信息(银行卡号,证件号码等)需要加密传输,请使用 AES 加密,算法
说明:
算法密钥=接入密钥KEY, 编码=UTF8,加密模式(CipherMode)=CBC,填充模式(PaddingMode)=PKCS7, 数据块大小(BlockSize)=128,
算法的初始化向量(IV)= 接入密钥KEY 的前 16 位字符,加密后的字节数组转为 Base64 字符串,需要加密的字段会在字段备注中添
加‘AES’标记。算法:密文=Base64(AES(info, KEY))。
例如:
RequestBody: method=employee.create&format=json&version=1.0&appid=appcode123&tim estamp=20160614133300&nonce=321431&sign=23697537dc822216fdded329361f4
311ea9f&data={"phone": ["12345678","87654321"],"name": "zhangsan","age":
100,"address": {"country": "china","province": "chengdu"},"married": false}
统一返回参数结构
参数名称 | 参数说明 |
code | 处理结果编码(参考下面的“标准错误代码定义”) |
message | 处理结果消息 |
data | 接口处理完毕返回的数据(请参见具体接口的返回信息)。 |
返回的 Json 格式:
{"code":"0","message":"","data":{"phone":["12345678","87654321"],"name":
"zhangsan"}}
标准 Code 代码定义
0: 正确
-1: 请求参数错误
-2: 签名校验错误
-3: 无 API 访问权限
-4: IP 校验错误-5: 访问超过限制
注:标准错误码小于 0,大于 0 的错误码由各接口根据接口语义自行定义
接口参数签名方法
(1)第一步:拼接参数字符串
将除 sign 以外的请求参数(包括标准参数,除非有特别说明)按照参数名称的字典升序排列,然后按此顺序,将“参数名=参数值”用“&”符号连接。
示例:
appid=appcode123&data={"phone":["12345678","87654321"],"name": "zhangsan","age":30,"address":{"country":"china","province":"chengdu"},"married":f alse}&format=json&method=employee.create&nonce=11223344×tamp=20160
614133300&version=2.0
注意事项:
1)data 参数必须转换为 JSON 格式的字符串。
2)仅对接口定义中声明且请求参数列表中包含的参数(包括空值)进行签名。
3)参数值不作去除空格。
(2)第二步:在拼接参数字符串后再拼接&appsecret,如&appsecret=df23hlir85353;appsecret 即密钥,由广东省建筑工人管理服务信息平台技术支持人员提供。
示例:
appid=appcode123&data={"phone":["12345678","87654321"],"name":
"zhangsan","age":100,"address":{"country":"china","province":"chengdu"},"married"
:false}&format=json&method=employee.create&nonce=11223344×tamp=2016
0614133300&version=2.0&appsecret=df23hlir85353gfgd86775jjdh6322
(3)第三步:将上一步的获得的字符串全部转换为小写。再进行 SHA256 加密(SHA256 64 位),生成的字符串就是验签数据 sign。注意:SHA256 加密哈希值请转换为 16 进制表示。
OpenAPI 对验签数据 sign 进行校验时不区分大小写。
访问频率限制
OpenAPI 对访问过于频繁等情况做了屏蔽处理,针对同一调用方(API Client) 访问同一方法这一级别可以做如下限制: 访问时间间隔不能少于 1 秒,且不允许并发(即上一次访问还没有返回结果就开始下一次访问);具体访问限制参数可配置,会根据上线后实际业务数据量和访问频率做优化调整。
异步处理接口是指调用之后不会立即返回处理结果,而是返回响应体字段 requestSerialCode供后续查询使用。可通过异步接口调用结果查询进行结果查询,其返回内容可参考每一接口的异步处理结果响应体字段部分, 若异步处理结果响应体字段部分没有任何内容,则表明该异步处理不返回任何额外信息,仅需关注异步处理状态即可;上传/修改接口都是异步处理接口。
同步处理接口是指调用之后立即返回处理结果,查询接口都是同步处理口;
返回的内容在每一查询接口的‘响应体字段’中进行描述。
图片及附件支持 Base64上传
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Corp.Upload | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传企业基本信息 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
corpCode | String | 是 | 企业统一社会信用代码或者组织机构代码 | |
corpName | String | 是 | 企业名称 | |
corpType | String | 否 | 单位性质。参考企业登记注册类型字典表 | |
licenseNum | String | 否 | 工商营业执照注册号 | |
areaCode | String | 是 | 企业注册地区编码。参考行政区划字典表 | |
address | String | 否 | 企业营业地址 | |
zipCode | String | 否 | 邮政编码 | |
legalMan | String | 否 | 法定代表人姓名 | |
legalManDuty | String | 否 | 法定代表人职务 | |
legaManProTitle | String | 否 | 法定代表人职称 | |
legalManIDCardT ype | String | 否 | 法定代表人证件类型。参考人员证件类型字典表 | |
legalManIDCardNumber | String | 否 | 法定代表人证件号码。AES | |
regCapital | decimal | 否 | 注册资本(万元) | |
factRegCapital | decimal | 否 | 实收资本(万元) | |
capitalCurrencyTy pe | String | 否 | 注册资本币种。参考币种字典表 | |
registerDate | String | 是 | 注册日期,格式 yyyy-MM-dd | |
establishDate | String | 否 | 成立日期,格式 yyyy-MM-dd | |
officePhone | String | 否 | 办公电话 | |
faxNumber | String | 否 | 传真号码 | |
linkman | String | 否 | 联系人姓名 | |
linkTel | String | 否 | 联系人办公电话 | |
String | 否 | 企业联系邮箱 | ||
website | String | 否 | 企业网址 | |
remark | String | 否 | 企业备注 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCode | String | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
名称 | 名称 | 名称 | 名称 | |
请求体格式示例 | ||||
{ "requestSerialCode":"20180914009893", "registerDate": "2017-09-04", "corpCode": "91350100315****147", "corpName": "0810-劳务分包 01", "corpType": "100", "licenseNum": "", "areaCode": "350423", "address": "**县**花园**幢**室", "zipCode": "", "legalMan": "张三", "legalManDuty": "董事长", "legaManProTitle": "教授", "legalManIDCardType": "01", "legalManIDCardNumber": "MiJ2Z/CxijInCyQf8MRMuo6ComKGao4eW/GMbSnseds=", "regCapital": 1.9, "factRegCapital": 1.9, "capitalCurrencyType": "", "establishDate": "2017-08-01", "officePhone": "028-********", "faxNumber": "", "linkMan": "张三", "linkPhone": "1589098****", "email": "t@126.com", "webSite": "http://www.baidu.com", "remark": "备注" } | ||||
响应体格式示例 | ||||
{ "data": { "requestSerialCode": null }, "code": "0", "message": "调用成功" } |
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Corp.Query | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 查询企业信息 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过100 | |
corpName | string | 否 | 企业名称,与统一社会代码必传一个 | |
corpCode | string | 否 | 统一社会代码,如果无统一社会信用代码,则用组织机构代码,与企业名称必传一个 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
totalCount | int | 是 | 记录总数 | |
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过100 | |
rows | array | 是 | 记录集合。JSON 数组 | |
rows 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
corpCode | string | 是 | 企业统一社会信用代码或者组织机构代码 | |
corpName | string | 是 | 企业名称 | |
corpType | string | 否 | 单位性质。参考企业登记注册类型字典表 | |
licenseNum | string | 否 | 工商营业执照注册号 | |
areaCode | string | 是 | 企业注册地区编码。参考行政区划字典表 | |
address | string | 否 | 企业营业地址 | |
zipCode | string | 否 | 邮政编码 | |
legalMan | string | 否 | 法定代表人姓名 | |
legalManDuty | string | 否 | 法定代表人职务 | |
legaManProTit le | string | 否 | 法定代表人职称 | |
legalManIDCa rdType | string | 否 | 法定代表人证件类型。参考人员证件类型字典表 | |
legalManIDCa rdNumber | string | 否 | 法定代表人证件号码。AES | |
regCapital | decimal | 否 | 注册资本(万元) | |
factRegCapital | decimal | 否 | 实收资本(万元) | |
capitalCurrenc yType | string | 否 | 注册资本币种。参考币种字典表 | |
registerDate | string | 是 | 注册日期,格式 yyyy-MM-dd | |
establishDate | string | 否 | 成立日期,格式 yyyy-MM-dd | |
officePhone | string | 否 | 办公电话 | |
faxNumber | string | 否 | 传真号码 | |
linkman | string | 否 | 联系人姓名 | |
linkTel | string | 否 | 联系人办公电话 | |
string | 否 | 企业联系邮箱 | ||
website | string | 否 | 企业网址 | |
remark | string | 否 | 企业备注 | |
请求体格式示例 | ||||
响应体格式示例 | ||||
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Project.Add | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传项目信息(地市自建平台) | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
contractorCorpCode | string | 是 | 总承包单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
contractorCorpName | string | 是 | 总承包单位名称 | |
name | string | 是 | 项目名称 | |
description | string | 否 | 项目简介 | |
category | string | 是 | 项目分类。参见项目分类字典表 | |
buildCorpName | string | 否 | 建设单位名称 | |
buildCorpCode | string | 否 | 建设单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
builderLicenses | array | 是 | 施工许可证。JSON 数组 | |
buildPlanNum | string | 否 | 建设用地规划许可证编号。AES | |
prjPlanNum | string | 否 | 建设工程规划许可证编号。AES | |
areaCode | string | 是 | 项目所在地。参考行政区划字典表 | |
invest | decimal | 否 | 总投资,单位:(万元) | |
buildingArea | decimal | 否 | 总面积,单位:平方米 | |
buildingLength | decimal | 否 | 总长度,单位:米 | |
startDate | string | 否 | 开工日期,精确到天,格式: yyyy-MM-dd | |
completeDate | string | 否 | 竣工日期,精确到天,格式: yyyy-MM-dd | |
linkMan | string | 否 | 联系人姓名 | |
linkPhone | string | 否 | 联系人办公电话 | |
prjStatus | string | 是 | 项目状态。参考项目状态字典表 | |
lat | decimal | 否 | WGS84 纬度 | |
lng | decimal | 否 | WGS84 经度 | |
address | string | 否 | 项目地点 | |
approvalNum | string | 否 | 立项文号 | |
approvalLevelNum | string | 否 | 立项级别。参考立项级别字典表 | |
prjSize | string | 否 | 建设规模。参考建设规模字典表 | |
propertyNum | string | 否 | 建设性质。参考建设性质分类字典表 | |
functionNum | string | 否 | 工程用途。参考工程用途字典表 | |
nationNum | string | 否 | 国籍或地区。参考国籍及地区字典表 | |
supplierName | string | 是 | 软/硬件供应商名称 | |
placeId | string | 是 | 场所ID | |
projectDepartment | string | 否 | 项目所属部门 | |
contractAmount | decimal | 是 | 合同金额。单位:(万元) | |
builderLicenses 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
prjName | string | 是 | 工程名称 | |
builderLicenseNum | string | 是 | 施工许可证编号。AES | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCode | string | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
请求体格式示例 | ||||
响应体格式示例 | ||||
接口信息 | |||
Endpoint | http://{host}/webapi/v2.0 | ||
Method | Project.Update | ||
Version | 2.0 | ||
返回方式 | 响应体(JSON) | ||
接口说明 | 修改项目信息 | ||
输入参数 | |||
名称 | 类型 | 是否必需 | 备注 |
projectCode | string | 是 | 项目编码 |
name | string | 是 | 项目名称 |
description | string | 否 | 项目简介 |
category | string | 是 | 项目分类。参见项目分类字典表 |
buildCorpName | string | 否 | 建设单位名称 |
buildCorpCode | string | 否 | 建设单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 |
builderLicenses | array | 是 | 施工许可证。JSON 数组 |
buildPlanNum | string | 否 | 建设用地规划许可证编号。AES |
prjPlanNum | string | 否 | 建设工程规划许可证编号。AES |
areaCode | string | 是 | 项目所在地。参考行政区划字典表 |
invest | decimal | 否 | 总投资,单位:(万元) |
buildingArea | decimal | 否 | 总面积,单位:平方米 |
buildingLength | decimal | 否 | 总长度,单位:米 |
startDate | string | 否 | 开工日期,精确到天,格式 yyyy-MM-dd |
completeDate | string | 否 | 竣工日期,精确到天,格式 yyyy-MM-dd |
linkman | string | 否 | 联系人姓名 |
linkPhone | string | 否 | 联系人办公电话 |
prjStatus | string | 是 | 项目状态。参考项目状态字典表 |
lat | decimal | 否 | WGS84 纬度 |
lng | decimal | 否 | WGS84 经度 |
address | string | 否 | 项目地点 |
approvalNum | string | 否 | 立项文号 |
approvalLevelNum | string | 否 | 立项级别。参考立项级别字典表 |
prjSize | string | 否 | 建设规模。参考建设规模字典表 |
propertyNum | string | 否 | 建设性质。参考建设性质分类字典表 |
functionNum | string | 否 | 工程用途。参考工程用途字典表 |
nationNum | Int | 否 | 国籍或地区。参考国籍及地区字典表 |
supplierName | string | 是 | 软/硬件供应商名称 |
placeId | string | 是 | 场所ID |
projectDepartment | string | 否 | 项目所属部门 |
contractAmount | decimal | 是 | 合同金额。单位:(万元) |
builder Licenses数组内对象字段 | |||
名称 | 类型 | 是否必需 | 备注 |
prjName | string | 是 | 工程名称 |
builderLicenseNum | string | 是 | 施工许可证编号:AES |
响应体字段 | |||
名称 | 类型 | 是否必需 | 备注 |
requestSerialCode | string | 是 | 请求序列编码 |
异步处理结果响应体字段 | |||
请求体格式示例 | |||
响应体格式示例 | |||
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Project.GovQuery | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 按区域查询项目 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
pageIndex | int | 是 | 指定页号,以0 为起始数字,表示第1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过100 | |
projectCode | string | 否 | 项目编码,精确匹配 | |
projectName | string | 否 | 项目名称,模糊匹配 | |
areaCode | string | 是 | 项目区域编码,自建平台只能查询自己辖区的区域编码 | |
响应体字段 | ||||
totalCount | int | 记录总数 | ||
pageIndex | int | 指定页号,以0 为起始数字,表示第1 页 | ||
pageSize | int | 每页记录数,最多不能超过 100 | ||
rows | array | 记录集合。JSON 数组 | ||
rows 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
contractorCorpCode | string | 是 | 总承包单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
contractorCorpName | string | 是 | 总承包单位名称 | |
name | string | 是 | 项目名称 | |
description | string | 否 | 项目简介 | |
category | string | 是 | 项目分类。参见项目分类字典表 | |
buildCorpName | string | 否 | 建设单位名称 | |
buildCorpCode | string | 否 | 建设单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
builderLicenses | array | 是 | 施工许可证。JSON 数组 | |
buildPlanNum | string | 否 | 建设用地规划许可证编号。AES | |
prjPlanNum | string | 否 | 建设工程规划许可证编号。AES | |
areaCode | string | 是 | 项目所在地。参考行政区划字典表 | |
Invest | decimal | 否 | 总投资,单位:(万元) | |
buildingArea | decimal | 否 | 总面积,单位:平方米 | |
buildingLength | decimal | 否 | 总长度,单位:米 | |
startDate | string | 否 | 开工日期,精确到天,格式 yyyy-MM-dd | |
completeDate | string | 否 | 竣工日期,精确到天,格式 yyyy-MM-dd | |
linkman | string | 否 | 联系人姓名 | |
linkPhone | string | 否 | 联系人办公电话 | |
prjStatus | string | 是 | 项目状态。参考项目状态字典表 | |
lat | decimal | 否 | WGS84 纬度 | |
lng | decimal | 否 | WGS84 经度 | |
Address | string | 否 | 项目地点 | |
approvalNum | string | 否 | 立项文号 | |
approvalLevelNum | string | 否 | 立项级别。参考立项级别字典表 | |
prjSize | string | 否 | 建设规模。参考建设规模字典表 | |
propertyNum | string | 否 | 建设性质。参考建设性质分类字典表 | |
functionNum | string | 否 | 工程用途。参考工程用途字典表 | |
nationNum | int | 否 | 国籍或地区。参考国籍及地区字典表 | |
responsiblePersonName | string | 否 | 项目实名制负责人名称 | |
responsiblePersonPhone | string | 否 | 项目实名制负责人电话 | |
responsiblePersonEmail | string | 否 | 项目实名制负责人邮箱 | |
mohurdProjectNum | string | 否 | 项目在四库一平台的项目编码 | |
builderLicenses 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
prjName | string | 是 | 工程名称 | |
builderLicenseNum | string | 是 | 施工许可证编号。AES | |
请求体格式示例 | ||||
{ "pageIndex": 0, "pageSize": 10, "projectCode": "", "projectName": "", "areaCode": "510101" } | ||||
响应体格式示例 | ||||
{ "data": { "totalCount": 1, "pageIndex": 0, "pageSize": 1, "rows": [ { "projectCode": "", "contractorCorpCode": "", "contractorCorpName": "", "responsiblePersonName": null, "responsiblePersonPhone": null, "responsiblePersonEmail": null, | ||||
"mohurdProjectNum": null, "name": "", "description": null, "category": "", "buildCorpName": null, "buildCorpCode": null, "buildPlanNum": null, "prjPlanNum": null, "areaCode": "", "invest": null, "buildingArea": null, "buildingLength": null, "startDate": "", "completeDate": "", "linkMan": null, "linkPhone": null, "prjStatus": "", "lng": null, "lat": null, "address": null, "approvalNum": null, "approvalLevelNum": null, "prjSize": null, "propertyNum": null, "functionNum": null, "nationNum": null, "responsiblePersonName": "", "responsiblePersonPhone": "", "responsiblePersonEmail": "", "mohurdProjectNum": "", "builderLicenses": [ { "prjName": "", "builderLicenseNum": "" } ] } ] }, "code": "0", "message": "调用成功" | ||||
} | ||||
所有管理人员纳入参建单位下的【项目管理部】中进行管理,系统已为现有的参建单位初始化了【项目管理部】。
对新上传参建单位时,系统为该参建单位创建【项目管理部】,并返回项目管理部的编号。所有管理人员相关信息上传时都需要【项目管理部】的编号。
注:【项目管理部】可以理解为特殊类型的班组。
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | ProjectSubContractor.Add | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传项目参建单位 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | |
entryTime | string | 否 | 进场时间。格式 yyyy-MM-dd HH:mm:ss | |
exitTime | string | 否 | 退场时间。格式 yyyy-MM-dd HH:mm:ss | |
bankInfos | array | 否 | 发放工资的银行。JSON 数组 | |
pmName | string | 否 | 项目经理名称 | |
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | |
pmIDCardNumber | string | 否 | 项目经理证件号码。AES | |
pmPhone | string | 否 | 项目经理电话 | |
bankInfos 数组对象相关字段 | ||||
bankCode | string | 是 | 银行代码。参考银行代码字典表 | |
bankName | string | 是 | 银行支行名称 | |
bankNumber | string | 是 | 银行卡号。AES | |
bankLinkNumber | string | 是 | 银行联号 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCode | string | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
{ "data": { "requestSerialCode": "subcontractor-add-20200927170402-5-0002", "result": "{\"pmCode\":\"121764692\",\"memo\":\"项目管理部代码,上传管理人员及管理人员考勤时使用!\"}", "status": 20 }, "code": "0", "message": "调用成功" } | ||||
请求体格式示例 | ||||
{ "projectCode": "4419002018*******6", "corpCode": "12510823FHFA****57", "corpType": "006", "entryTime": "2018-08-21 12:13:14", | ||||
"exitTime": "2018-08-31 05:16:17", "bankInfos": [{ "bankCode": "103", "bankName": "绿色**", "bankNumber": "QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=", "bankLinkNumber": "4532********" }], "pmName": "张三", "pmIDCardType": "01", "pmIDCardNumber": "UQIJxmqlHruG7haaaIs99Avx/iaLczTEODMnsAXeUQk=", "pmPhone": "1398175****" } | ||||
响应体格式示例 | ||||
{ "requestSerialCode": " projectsubcontractor-add-2018082917-0001" } |
接口信息 | |||||
Endpoint | http://{host}/webapi/v2.0 | ||||
Method | ProjectSubContractor.Update | ||||
Version | 2.0 | ||||
返回方式 | 响应体(JSON) | ||||
接口说明 | 修改项目参建单位信息 | ||||
输入参数 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | ||
corpName | string | 是 | 企业名称 | ||
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | ||
entryTime | string | 否 | 进场时间。格式 yyyy-MM-dd HH:mm:ss | ||
exitTime | string | 否 | 退场时间。格式 yyyy-MM-dd HH:mm:ss | ||
bankInfos | array | 否 | 发放工资的银行。JSON 数组 | ||
pmName | string | 否 | 项目经理名称 | ||
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | ||
pmIDCardNumber | string | 否 | 项目经理证件号码。AES | ||
pmPhone | string | 否 | 项目经理电话 | ||
bankInfos 数组对象相关字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
bankCode | string | 是 | 银行代码。参考银行代码字典表 | ||
bankName | string | 是 | 银行支行名称 | ||
bankNumber | string | 是 | 银行卡号。AES | ||
bankLinkNumber | string | 是 | 银行联号 | ||
响应体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
requestSerialCode | string | 是 | 请求序列编码 | ||
异步处理结果响应体字段 | |||||
{ "data": { "requestSerialCode": "projectsubcontractor-update-2018082917-0001", "result": null, "status": 20 }, "code": "0", "message": "调用成功" } | |||||
请求体格式示例 | |||||
{ "projectCode": " 441900201808310***", "corpCode": "12510823FHFAMRW***", "corpType": "006", "entryTime": "2018-08-21 12:13:14", "exitTime": "2018-08-31 05:16:17", "bankInfos": [{ "bankCode": "103", "bankName": "绿色***", "bankNumber": "QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=", "bankLinkNumber": "453226789***" }], "pmName": "张三", "pmIDCardType": "01", "pmIDCardNumber": "UQIJxmqlHruG7haaaIs99Avx/iaLczTEODMnsAXeUQk=", "pmPhone": "132********" } | |||||
响应体格式示例 | |||||
{ "requestSerialCode": " projectsubcontractor-update-2018082917-0001" } |
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | ProjectSubContractor.Query | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 查询项目参建单位信息 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
pageIndex | int | 是 | 指定页号,以0 为起始数字,表示第1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过50 | |
projectCode | string | 是 | 项目编码 | |
corpCode | string | 否 | 统一社会代码,如果无统一社会用 代码,则用组织机构代码 | |
corpName | string | 否 | 企业名称 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
totalCount | int | 是 | 记录总数 | |
pageIndex | int | 是 | 指定页号,以0 为起始数字,表示第1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过50 | |
rows | array | 是 | 记录集合。JSON 数组 | |
rows 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
corpName | string | 是 | 企业名称 | |
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | |
entryTime | string | 否 | 进场时间。格式 yyyy-MM-dd HH:mm:ss | |
exitTime | string | 否 | 退场时间。格式 yyyy-MM-dd HH:mm:ss | |
bankInfos | array | 否 | 发放工资的银行。JSON 数组 | |
pmName | string | 否 | 项目经理名称 | |
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | |
pmIDCardNumber | string | 否 | 项目经理证件号码。AES | |
pmPhone | string | 否 | 项目经理电话 | |
bankInfos 数组对象相关字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
bankCode | string | 是 | 银行代码。参考银行代码字典表 | |
bankName | string | 是 | 银行支行名称 | |
bankNumber | string | 是 | 银行卡号。AES | |
bankLinkNumber | string | 是 | 银行联号 | |
请求体格式示例 | ||||
{ "projectCode": "", "corpCode": "", "corpName": "", "pageIndex": 1, "pageSize": 1 } | ||||
响应体格式示例 | ||||
{ "rows": [{ "projectCode": "", "corpCode": "", "corpName": "", "corpType": "001", "entryTime": "2018-08-31T00:00:00", "exitTime": "2018-08-31T00:00:00", "payMode": "", "pmName": "", "pmIDCardType": null, "pmIDCardNumber": "", "pmPhone": "", "bankInfos": [{ "bankCode": "", "bankName": "", "bankNumber": "", "bankLinkNumber": "" }] }], "pageCount": 1, "pageIndex": 1, "pageSize": 1 } |
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Team.Add | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传班组信息 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
corpCode | string | 是 | 班组所在企业统一社会信用代码 | |
teamName | string | 是 | 班组名称,同一个项目下面不能重复 | |
responsiblePersonName | string | 否 | 责任人姓名,班组所在企业负责人 | |
responsiblePersonPhone | string | 否 | 责任人联系电话 | |
responsiblePersonIDCardType | string | 否 | 责任人证件类型。参考人员证件类型字典表 | |
responsiblePersonIDNumber | string | 否 | 责任人证件号码。AES | |
Remark | string | 否 | 备注 | |
entryTime | string | 否 | 进场日期,yyyy-MM-dd | |
exitTime | string | 否 | 退场日期,yyyy-MM-dd | |
entryAttachments | array | 否 | 进场附件,有进场日期时,此字段必填。JSON 数组。附件总数不超过 5 个 | |
exitAttachments | array | 否 | 退场附件,有退场日期时,此字段必填。JSON 数组。附件总数不超过 5 个 | |
entryAttachments, exitAttachments 数组内对象字段 | ||||
Name | string | 是 | 附件名称 | |
Data | string | 是 | 附件 Base64 字符串,不超过 1M | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCode | string | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
teamSysNo | int | 是 | 班组编号 | |
请求体格式示例 | ||||
{ "entryAttachments": [ ], "exitAttachments": [ ], "entryTime": "2018-08-23", "exitTime": "2018-08-24", "projectCode": "5101042018*******5", "corpCode": "91440300618874367T", "teamName": "武平****有限公司", "responsiblePersonName": "张三", "responsiblePersonPhone": "136********", "responsiblePersonIDCardType": "01", "responsiblePersonIDNumber":"44010*************", "remark": "test"} | ||||
响应体格式示例 | ||||
{ "requestSerialCode": " team-add-2018082917-0001" } | ||||
异步返回结果示例 | ||||
{ "data": { "requestSerialCode": "team-add-2018082917-0001", "result": "{teamSysno:99628}", "status": 20 }, "code": "0", "message": "调用成功" } |
接口信息 | |||
Endpoint | http://{host}/webapi/v2.0 | ||
Method | Team.Update | ||
Version | 2.0 | ||
返回方式 | 响应体(JSON) | ||
接口说明 | 修改班组信息 | ||
输入参数 | |||
名称 | 类型 | 是否必需 | 备注 |
teamSysNo | int | 是 | 班组编号 |
teamName | string | 是 | 班组名称 |
responsiblePersonName | string | 否 | 责任人姓名,班组所在企业负责人 |
responsiblePersonPhone | string | 否 | 责任人联系电话 |
responsiblePersonIDCardType | string | 否 | 责任人证件类型。参考人员证件类型字典表 |
responsiblePersonIDNumber | string | 否 | 责任人证件号码。AES |
Remark | string | 否 | 备注 |
entryTime | string | 否 | 进场日期,yyyy-MM-dd |
exitTime | string | 否 | 退场日期,yyyy-MM-dd |
entryAttachments | array | 否 | 进场附件,有进场日期时,此字段必填。JSON 数组。附件总数不超过 5 个 |
exitAttachments | array | 否 | 退场附件,有退场日期时,此字段必填。JSON 数组。附件总数不超过 5 个 |
entryAttachments, exitAttachments 数组内对象字段 | |||
name | string | 是 | 附件名称 |
data | string | 是 | 附件 Base64 字符串,不超过1M |
响应体字段 | |||
名称 | 类型 | 是否必需 | 备注 |
requestSerialCode | string | 是 | 请求序列编码 |
异步处理结果响应体字段 | |||
请求体格式示例 | |||
{ "teamSysNo": 1, "responsiblePersonName": "", "responsiblePersonPhone": "", "responsiblePersonIDCardType": "", "responsiblePersonIDNumber": "", | |||
"remark": "", "entryAttachments": [ ], "exitAttachments": [ ], "entryTime": "", "exitTime": "" } | |||
响应体格式示例 | |||
{ "requestSerialCode": " team-update-2018083010-0021" } | |||
异步返回结果示例 | |||
{ "data": { "requestSerialCode": "team-update-2018083010-0021", "result": null, "status": 0 }, "code": "0", "message": "调用成功" } |
接口信息 | |||||||
Endpoint | http://{host}/webapi/v2.0 | ||||||
Method | Team.Query | ||||||
Version | 2.0 | ||||||
返回方式 | 响应体(JSON) | ||||||
接口说明 | 查询班组信息 | ||||||
输入参数 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | ||||
pageSize | int | 是 | 每页记录数,最多不能超过 100 | ||||
teamSysNo | int | 否 | 班组编号 | ||||
projectCode | string | 是 | 项目编码 | ||||
teamName | string | 否 | 班组名称 | ||||
corpCode | string | 否 | 班组所在企业统一社会信用代码 | ||||
corpName | string | 否 | 班组所在企业名称 | ||||
pm | bool | 否 | 是否是项目管理部 | ||||
响应体字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
totalCount | int | 是 | 记录总数 | ||||
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | ||||
pageSize | int | 是 | 每页记录数,最多不能超过 100 | ||||
rows | array | 是 | 记录集合。JSON 数组 | ||||
rows 数组内对象字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
teamSysNo | int | 是 | 班组编号 | ||||
projectCode | string | 是 | 项目编码 | ||||
corpCode | string | 是 | 班组所在企业统一社会信用代码 | ||||
corpName | string | 是 | 班组所在企业名称 | ||||
teamName | string | 是 | 班组名称 | ||||
teamLeaderName | string | 否 | 班组长姓名 | ||||
teamLeaderPhone | string | 否 | 班组长联系方式 | ||||
teamLeaderIDCardType | String | 否 | 班组长证件类型。参考人员证件类型字典表 | ||||
teamLeaderIDNumber | String | 否 | 班组长证件号码。AES | ||||
responsiblePersonName | String | 否 | 责任人姓名,班组所在企业负责人 | ||||
responsiblePersonPhone | String | 否 | 责任人联系电话 | ||||
responsiblePersonIDCardType | String | 否 | 责任人证件类型。参考人员证件类型字典表 | ||||
responsiblePersonIDNumber | String | 否 | 责任人证件号码。AES | ||||
remark | String | 否 | 备注 | ||||
entryTime | String | 否 | 进场日期yyyy-MM-dd HH:mm:ss | ||||
exitTime | String | 否 | 退场日期 yyyy-MM-dd HH:mm:ss | ||||
entryAttachments | Array | 否 | 进场附件。JSON 数组对象 | ||||
exitAttachments | Array | 否 | 退场附件。JSON 数组对象 | ||||
Pm | Bool | 是 | 是否是项目管理部 | ||||
entryAttachments, exitAttachments 数组内对象字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
Name | String | 是 | 附件名称 | ||||
url | String | 是 | 附件 Url | ||||
请求体格式示例 | |||||||
{ "pageIndex": 0, "pageSize": 10, "projectCode": "4419002018*******6" } | |||||||
响应体格式示例 | |||||||
{ "data": { "rows": [{ "teamSysNo": 99669, "teamLeaderName": "", "teamLeaderPhone": null, "teamLeaderIDCardType": 0, "teamLeaderIDNumber": "", "entryAttachments": [{ "name": "001", "url": "nlabor/attachment/Original/2018/0831/4c4ec249-2f33-4f72-9bea-6e68bc37a621.jpeg " }], "exitAttachments": [{ "name": "002", "url": "nlabor/attachment/Original/2018/0831/a04276eb-182d-4dad-84dd-a48939d07062.jp eg" }], "entryTime": "2018-08-23", "exitTime": "2018-08-24", "requestSerialCode": null, "projectCode": null, "corpCode": "9135082******3305F", "corpName": "武平****有限公司", "teamName": "****-劳务分包班组 14", "responsiblePersonName": "张三", "responsiblePersonPhone": "135********", "responsiblePersonIDCardType": null, "responsiblePersonIDNumber": "3101011989*******8", "remark": "备注内容" }, { "teamSysNo": 99668, "teamLeaderName": "", "teamLeaderPhone": null, "teamLeaderIDCardType": 0, "teamLeaderIDNumber": "", "entryAttachments": [{ "name": "001", "url": "nlabor/attachment/Original/2018/0831/e43efbf3-9df6-453b-badf-1b9fc56292de.jpeg " }], "exitAttachments": [{ "name": "002", "url": "nlabor/attachment/Original/2018/0831/9418d357-24f7-4cd8-b068-c269382c362d.jpe g" }], "entryTime": "2018-08-23", "exitTime": "2018-08-24", "requestSerialCode": null, "projectCode": null, "corpCode": "9135082******3305F ", "corpName": "****有限公司", "teamName": "****-劳务分包班组 13", "responsiblePersonName": "*张三", "responsiblePersonPhone": ""135********", "responsiblePersonIDCardType": null, "responsiblePersonIDNumber": "3101011989*******8", "remark": "****送佛牌" }, { "teamSysNo": 99667, "teamLeaderName": "", "teamLeaderPhone": null, "teamLeaderIDCardType": 0, "teamLeaderIDNumber": "", "entryAttachments": [{ "name": "001", "url": "nlabor/attachment/Original/2018/0831/16d9dd7d-b6c1-498d-8b3f-2cc636d293e8.jpe g" }], "exitAttachments": [{ "name": "002", "url": "nlabor/attachment/Original/2018/0831/0a225746-bad7-4678-9d7e-c04caf74b0d6.jpe g" }], "entryTime": "2018-08-23", "exitTime": "2018-08-24", "requestSerialCode": null, "projectCode": null, "corpCode": "9135082******3305F ", "corpName": "武平******有限公司", "teamName": "****-劳务分包班组12", "responsiblePersonName": "张三", "responsiblePersonPhone": "136********", "responsiblePersonIDCardType": null, "responsiblePersonIDNumber": "3101011989*******8", "remark": "备注内容" }], "pageCount": 3, "pageIndex": 0, "pageSize": 10 }, "code": "0", "message": "调用成功" } |
请注意以下字段的使用:
⚫teamSysNo:在上传管理人员(workRole=10)时
◼应使用该管理人员所在参建单位中的项目管理部编码(项目管理部为上传参建单位时创建并返回的)作为teamSysNo(班组编号)的值。
◼workType(工种)将强制为:管理人员(900)。
◼manageType(管理岗位)不能为空,且manageType必须根据单位的参建类型取值,取值范围详见管理岗位字典表。
⚫teamSysNo:在上传建筑工人(workRole=20)时,workType(工种)不能是管理人员(900),也不能上传到项目管理部班组(即TeamSysNo不能是pmCode)。
接口信息 | |||||||||
Endpoint | http://{host}/webapi/v2.0 | ||||||||
Method | ProjectWorker.Add | ||||||||
Version | 2.0 | ||||||||
返回方式 | 响应体(JSON) | ||||||||
接口说明 | 上传项目工人信息 | ||||||||
请求体字段 | |||||||||
名称 | 类型 | 是否必需 | 备注 | ||||||
projectCode | string | 是 | 平台为项目分配的接入编号 | ||||||
corpCode | string | 是 | 所在企业统一社会信用代码 | ||||||
teamSysNo | int | 是 | 班组编号,工人类型为管理人员时,请使用单位的项目管理部编号:pmCode | ||||||
workerList | array | 是 | 人员列表数据,JSON 数组,数量不能超过 5 | ||||||
workerList 对象 | |||||||||
名称 | 类型 | 是否必需 | 备注 | ||||||
workerName | string | 是 | 工人姓名 | ||||||
isTeamLeader | int | 是 | 是否班组长。参考是否字典表 | ||||||
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | ||||||
idCardNumber | string | 是 | 证件号码。AES | ||||||
workType | string | 是 | 当前工种。参考工人工种字典表 | ||||||
workRole | int | 是 | 工人类型。参考工人类型字典表 | ||||||
manageType | string | 否 | 管理岗位,工人类型为管理人员时,管理岗位为必填。 参考管理岗位字典表。 | ||||||
issueCardDate | string | 否 | 发卡时间。格式 yyyy-MM-dd | ||||||
issueCardPic | string | 否 | 办卡采集相片。不超过 50KB 的 Base64 字符串 | ||||||
cardNumber | string | 否 | 考勤卡号 | ||||||
payRollBankCardNumber | string | 否 | 发放工资银行卡号。AES | ||||||
payRollBankName | string | 否 | 发放工资银行名称 | ||||||
bankLinkNumber | string | 否 | 发放工资卡银行联号。 | ||||||
payRollTopBankCode | string | 否 | 发放工资卡银行。参考银行代码字典表 | ||||||
hasBuyInsurance | int | 否 | 是否购买工伤或意外伤害保险。参考是否字典表 | ||||||
Nation | string | 是 | 民族。身份证上民族信息,如:汉,回,藏等 | ||||||
Address | string | 是 | 住址 | ||||||
headImage | string | 是 | 头像。不超过50KB的Base64 字符串 | ||||||
politicsType | string | 是 | 政治面貌。参考政治面貌字典表 | ||||||
joinedTime | string | 否 | 加入工会时间。如果加入工 会,此字段必填;格式 yyyy-MM-dd | ||||||
cellPhone | string | 是 | 手机号码 | ||||||
cultureLevelType | string | 是 | 文化程度。参考文化程度字典表 | ||||||
Specialty | string | 否 | 特长 | ||||||
hasBadMedicalHistory | int | 否 | 是否有重大病史。参考是否字典表 | ||||||
urgentLinkMan | string | 否 | 紧急联系人姓名 | ||||||
urgentLinkManPhone | string | 否 | 紧急联系方式 | ||||||
workDate | string | 否 | 开始工作日期。格式: yyyy-MM-dd | ||||||
maritalStatus | string | 否 | 婚姻状况。参考婚姻状况字典表 | ||||||
grantOrg | string | 是 | 发证机关 | ||||||
positiveIDCardImage | string | 否 | 正面照。不超过 500KB 的 BASE64 字符串 | ||||||
negativeIDCardImage | string | 否 | 反面照。不超过 500KB 的 BASE64 字符串 | ||||||
startDate | string | 否 | 证件有效期开始日期。格式 yyyy-MM-dd | ||||||
expiryDate | string | 否 | 证件有效期结束日期。格式 yyyy-MM-dd | ||||||
响应体字段 | |||||||||
名称 | 类型 | 是否必需 | 备注 | ||||||
requestSerialCode | string | 是 | 请求序列编码 | ||||||
异步处理结果响应体字段 | |||||||||
请求体格式示例 | |||||||||
响应体格式示例 | |||||||||
请注意以下字段的使用:
⚫teamSysNo:在上传管理人员(workRole=10)时 ◼应使用该管理人员所在参建单位中的项目管理部编码(项目管理部为上传参建单位时创建并返回的)作为teamSysNo(班组编号)的值。
◼workType(工种)将强制为:管理人员(900)。
◼manageType(管理岗位)不能为空,且manageType必须根据单位的参建类型取值,取值范围详见管理岗位字典表。
⚫teamSysNo:在上传建筑工人(workRole=20)时,workType(工种)不能是管理人员(900),也不能上传到项目管理部班组(即TeamSysNo不能是pmCode)。
⚫
接口信息 | |||||||
Endpoint | http://{host}/webapi/v2.0 | ||||||
Method | ProjectWorker.Update | ||||||
Version | 2.0 | ||||||
返回方式 | 响应体(JSON) | ||||||
接口说明 | 修改人员基本信息 | ||||||
输入参数 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
projectCode | string | 是 | 项目编码 | ||||
corpCode | string | 是 | 企业统一社会信用代码。班组所在所属企业统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | ||||
corpName | string | 是 | 企业名称 | ||||
teamName | string | 是 | 班组名称 | ||||
teamSysNo | int | 是 | 班组编号,工人类型为管理人员时,请使用单位的项目管理部编号:pmCode | ||||
workerName | string | 是 | 工人姓名 | ||||
isTeamLeader | int | 是 | 是否班组长。参考是否字典表 | ||||
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | ||||
idCardNumber | string | 是 | 证件号码。AES | ||||
workType | string | 是 | 当前工种。参考工人工种字典表 | ||||
workRole | int | 是 | 工人类型。参考工人类型字典表 | ||||
manageType | string | 否 | 管理岗位,工人类型为管理人员时,管理岗位为必填。 | ||||
issueCardDate | string | 否 | 发卡时间。格式:yyyy-MM-dd | ||||
issueCardPic | string | 否 | 办卡采集相片。不超过50KB 的 Base64 字符串 | ||||
cardNumber | string | 否 | 考勤卡号 | ||||
payRollBankCardNumber | string | 否 | 发放工资银行卡号。AES | ||||
payRollBankName | string | 否 | 发放工资银行名称 | ||||
bankLinkNumber | string | 否 | 工资卡银行联号。 | ||||
payRollTopBankCode | string | 否 | 工资卡银行。参考银行代码字典表 | ||||
hasBuyInsurance | int | 否 | 是否购买工伤或意外伤害保险。参考是否字典表 | ||||
Nation | string | 是 | 民族。身份证上民族信息,如:汉,回,藏等 | ||||
Address | string | 是 | 住址 | ||||
headImage | string | 是 | 头像。不超过 50KB 的Base64 字符串 | ||||
politicsType | string | 否 | 政治面貌。参考政治面貌字典表 | ||||
joinedTime | string | 否 | 加入工会时间。格式yyyy-MM-dd | ||||
cellPhone | string | 是 | 手机号码 | ||||
cultureLevelType | string | 否 | 文化程度。参考文化程度字典表 | ||||
Specialty | string | 否 | 特长 | ||||
hasBadMedicalHistory | int | 否 | 是否有重大病史。参考是否字典表 | ||||
urgentLinkMan | string | 否 | 紧急联系人姓名 | ||||
urgentLinkManPhone | string | 否 | 紧急联系方式 | ||||
workDate | string | 否 | 开始工作日期。格式yyyy-MM-dd | ||||
maritalStatus | string | 否 | 婚姻状况。参考婚姻状况字典表 | ||||
grantor | string | 是 | 发证机关 | ||||
positiveIDCardImage | string | 否 | 正面照。不超过 500KB 的BASE64 字符串 | ||||
negativeIDCardImage | string | 否 | 反面照。不超过 500KB 的BASE64 字符串 | ||||
startDate | string | 否 | 证件有效期开始日期。格式 yyyy-MM-dd | ||||
expiryDate | string | 否 | 证件有效期结束日期。格式 yyyy-MM-dd | ||||
响应体字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
requestSerialCode | string | 是 | 请求序列编码 | ||||
异步处理结果响应体字段 | |||||||
请求体格式示例 | |||||||
接口信息 | |||||
Endpoint | http://{host}/webapi/v2.0 | ||||
Method | ProjectWorker.Query | ||||
Version | 2.0 | ||||
返回方式 | 响应体(JSON) | ||||
接口说明 | 分页查询人员基本信息列表 | ||||
请求体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | ||
pageSize | int | 是 | 每页记录数,最多不能超过 50 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 否 | 工人所在企业统一社会信用代码 | ||
corpName | string | 否 | 工人所在企业名称 | ||
teamSysNo | int | 否 | 班组编号 | ||
idCardType | string | 否 | 证件类型。参考人员证件类型字典表 | ||
idCardNumber | string | 否 | 证件号码。AES | ||
响应体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
totalCount | int | 是 | 总页数 | ||
pageSize | int | 是 | 每页显示个数 | ||
pageIndex | int | 是 | 当前页码 | ||
rows | array | 是 | 记录集合。JSON 数组 | ||
rows 数组内对象字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 是 | 工人所在企业统一社会信用代码。如果无统一社会信用代码,则为组织机构代码 | ||
corpName | string | 是 | 企业名称 | ||
teamName | string | 是 | 班组名称 | ||
teamSysNo | int | 是 | 班组编号 | ||
workerName | string | 是 | 工人姓名 | ||
isTeamLeader | int | 是 | 是否班组长。参考是否字典表 | ||
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | ||
idCardNumber | string | 是 | 证件号码。AES | ||
workType | string | 是 | 工种。参考工人工种字典表 | ||
workRole | int | 是 | 工人类型。参考工人类型字典表 | ||
manageType | string | 否 | 管理岗位,工人类型为管理人员时,管理岗位为必填。 | ||
entryTime | string | 否 | 进场时间 | ||
exitTime | string | 否 | 退场时间 | ||
entryAttachmentUrl | string | 否 | 进场确认附件资源地址 | ||
exitAttachmentUrl | string | 否 | 退场确认附件资源地址 | ||
issueCardDate | datetime | 否 | 发卡时间。格式:yyyy-MM-dd | ||
issueCardPicUrl | string | 否 | 办卡采集相片资源地址 | ||
cardNumber | string | 否 | 考勤卡号 | ||
payRollBankCardNumber | string | 否 | 发放工资银行卡号。AES | ||
payRollBankName | string | 否 | 发放工资银行名称 | ||
payRollTopBankName | string | 否 | 发放工资总行名称 | ||
bankLinkNumber | string | 否 | 工资卡银行联号。 | ||
payRollTopBankCode | string | 否 | 工资卡银行。参考银行代码字典表 | ||
hasContract | int | 是 | 是否有劳动合同。参考是否字典表 | ||
hasBuyInsurance | int | 否 | 是否购买工伤或意外伤害保险。参考是否字典表 | ||
请求体格式示例 | |||||
响应体格式示例 | |||||
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | WorkerEntryExit.Add | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 批量导入项目工人进/退场信息 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
corpCode | string | 是 | 工人所属企业统一社会信用编码 | |
teamSysNo | int | 是 | 班组编号 | |
workerList | array | 是 | 人员列表数据,JSON 数组,数量不能超过 50 | |
workerList 对象 | ||||
名称 | 类型 | 是否必需 | 备注 | |
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | |
idCardNumber | string | 是 | 证件号码。AES | |
date | string | 是 | 进退场日期,yyyy-MM-dd | |
type | int | 是 | 类型。参考工人进退场类型字典表 | |
voucher | string | 否 | 凭证扫描件。不超过 50KB 的 Base64 字符串 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCode | string | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
请求体格式示例 | ||||
{ "projectCode": "项目编码", "corpCode": "企业统一社会信用编码", "teamSysNo": 班组编号, "workerList": [ | ||||
{ "idCardType": "01", "idCardNumber": "身份证加密字符串", "date": "进退场日期 yyyy-MM-dd", "type": 类型, "voucher": "凭证扫描件。不超过 2M 的 Base64 字符串" } ] } | ||||
响应体格式示例 | ||||
{ "data": { "requestSerialCode": "workerentryexit-add-2018083118-0003" }, "code": "0", "message": "调用成功" } |
接口信息 | |||||
Endpoint | http://{host}/webapi/v2.0 | ||||
Method | WorkerEntryExit.Query | ||||
Version | 2.0 | ||||
返回方式 | 响应体(JSON) | ||||
接口说明 | 分页查询项目工人进/退场信息 | ||||
请求体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | ||
pageSize | int | 是 | 每页记录数,最多不能超过 100 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 否 | 工人所属企业统一社会信用编码 | ||
corpName | string | 否 | 工人所属企业名称 | ||
idCardtype | string | 否 | 证件类型 | ||
idCardNumber | string | 否 | 证件号码。AES | ||
teamSysNo | int | 否 | 班组编号 | ||
响应体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
totalCount | int | 是 | 总页数 | ||
pageSize | int | 是 | 每页显示个数 | ||
pageIndex | int | 是 | 当前页码 | ||
rows | array | 是 | 记录集合。 JSON 数组 | ||
rows 数组内对象字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 是 | 工人所属企业统一社会信用编码 | ||
corpName | string | 是 | 工人所属企业名称 | ||
teamSysNo | int | 是 | 班组编号 | ||
teamName | string | 是 | 班组名称 | ||
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | ||
idCardNumber | string | 是 | 证件号码。AES | ||
date | string | 是 | 进退场日期 | ||
type | int | 是 | 类型。参考工人进退场类型字典表 | ||
voucher | string | 否 | 凭证扫描件资源地址 | ||
请求体格式示例 | |||||
响应体格式示例 | |||||
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | WorkerContract.Add | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传工人合同信息 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 项目编码 | |
contractList | array | 是 | 合同列表数据,JSON 数组,数量不能超过 5 | |
contractList 对象 | ||||
名称 | 类型 | 是否必需 | 备注 | |
corpCode | string | 是 | 工人所属企业统一社会信用编码 | |
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | |
idCardNumber | string | 是 | 证件号码。AES | |
contractPeriodType | int | 是 | 合同期限类型。参考合同期限类型字典表 | |
startDate | string | 是 | 生效日期,yyyy-MM-dd | |
endDate | string | 是 | 失效日期,yyyy-MM-dd | |
Unit | int | 否 | 计量单位。参考计量单位类型字典表 | |
unitPrice | decimal | 否 | 计量单价。根据结算方式,对应的单价,单位:元 | |
attachments | array | 是 | 合同附件。JSON 数组。不超过 2 个 | |
attachments 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
name | string | 是 | 附件名称 | |
data | string | 是 | 附件 Base64 字符串,不超过1M | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCode | string | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
请求体格式示例 | ||||
{ "projectCode": "项目编码", "contractList": [ { "corpCode": "企业统一社会信用编码", | ||||
"idCardType": "01", "idCardNumber": "身份证加密字符串", "contractPeriodType": 1, "startDate": "合同开始时间:2018-01-01", "endDate": "合同结束时间:2018-01-01", "unit": 计量单位编码, "unitPrice": 计量单价, "attachments": [ { "name": "附件名称", "data": "附件 Base64 字符串,不超过 2M" } ] } ] } | ||||
响应体格式示例 | ||||
{ "data": { "requestSerialCode": "workercontract-add-2018083118-0004" }, "code": "0", "message": "调用成功" } |
接口信息 | |||||
Endpoint | http://{host}/webapi/v2.0 | ||||
Method | WorkerContract.Query | ||||
Version | 2.0 | ||||
返回方式 | 响应体(JSON) | ||||
接口说明 | 分页查询项目工人合同信息 | ||||
请求体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | ||
pageSize | int | 是 | 每页记录数,最多不能超过 100 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 否 | 工人所属企业统一社会信用编码 | ||
corpName | string | 否 | 工人所属企业名称 | ||
idCardType | string | 否 | 证件类型。参考人员证件类型字典表 | ||
IdCardNumber | string | 否 | 证件号码。AES | ||
响应体字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
totalCount | int | 是 | 总页数 | ||
pageSize | int | 是 | 返回的最大数据量,每页显示个数 | ||
pageIndex | int | 是 | 返回的第几页的数据,当前页码 | ||
rows | array | 是 | 记录集合。JSON 数组 | ||
rows 数组内对象字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
projectCode | string | 是 | 项目编码 | ||
corpCode | string | 是 | 工人所属企业统一社会信用编码 | ||
corpName | string | 是 | 工人所属企业名称 | ||
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | ||
idCardNumber | string | 是 | 证件号码。AES | ||
contractPeriodType | int | 是 | 合同期限类型。参考合同期限类型字典表 | ||
startDate | string | 是 | 生效日期 | ||
endDate | string | 是 | 失效日期 | ||
unit | int | 否 | 计量单位。参考计量单位类型字典表 | ||
unitPrice | decimal | 否 | 计量单价。根据结算方式,对应的单价,单位:元 | ||
attachments | array | 是 | 合同文件。JSON 数组 | ||
attachments 数组内对象字段 | |||||
名称 | 类型 | 是否必需 | 备注 | ||
name | string | 是 | 附件名称 | ||
url | string | 是 | 附件资源地址 | ||
请求体格式示例 | |||||
响应体格式示例 | |||||
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | WorkerAttendance.Add | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传工人考勤 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | String | 是 | 平台为项目分配的接入编号 | |
teamSysNo | Int | 是 | 平台生成的班组编号 | |
dataList | Array | 是 | 考勤列表。JSON 数组,数组长度不超过 20 | |
dataList 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
idCardType | String | 是 | 证件类型。参考人员证件类型字典表 | |
idCardNumber | String | 是 | 证件号码。AES | |
date | String | 是 | 刷卡时间,yyyy-MM-dd HH:mm:ss | |
Int | 是 | 刷卡进出方向。参考工人进退场类型字典表 | ||
image | String | 否 | 刷卡近照。Base64 字符串,不超过 50KB | |
channel | String | 否 | 通道的名称 | |
attendType | Int | 否 | 通行方式。参考工人通行方式字典表 | |
lng | Decimal | 否 | WGS84 经度 | |
lat | Decimal | 否 | WGS84 纬度 | |
temperature | Decimal | 否 | 工人体温,35-99 范围数字,最长支持两位小数 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
requestSerialCo de | String | 是 | 请求序列编码 | |
异步处理结果响应体字段 | ||||
正常无异步响应结果,出错返回错误原因 | ||||
请求体格式示例 | ||||
{ "projectCode": "项目编码", "teamSysNo": 1, "dataList": [ { "image": "BASE64 图片", "idCardType": "证件类型", "idCardNumber": "证件号码", "date": "考勤时间,格式: 2018-12-12 12:12:12", "direction": "考勤方向", "channel": "通道", "attendType": "", "lng": "经度", "lat": "维度" } ] } | ||||
响应体格式示例 | ||||
{ "data": { "requestSerialCode": "workderattendance-add-2018082817-0024" }, "code": "0", "message": "调用成功" } |
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Attendance.Query | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 查询工人考勤 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过 100 | |
projectCode | string | 是 | 平台为项目分配的接入编号 | |
date | string | 是 | 考勤日期。格式 yyyy-MM-dd | |
teamSysNo | int | 否 | 平台为班组分配的接入编号 | |
idCardType | string | 否 | 证件类型。参考人员证件类型字典表 | |
idCardNumber | string | 否 | 证件号码。AES | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
totalCount | int | 是 | 记录总数 | |
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过 100 | |
rows | array | 是 | 记录集合。JSON 数组 | |
rows 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 平台为项目分配的接入编号 | |
teamSysNo | int | 是 | 平台生成的班组编号 | |
teamName | string | 是 | 班组名称 | |
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | |
idCardNumber | string | 是 | 证件号码。AES | |
date | string | 是 | 刷卡时间。格式:yyyy-MM-dd HH:mm:ss.fff | |
int | 是 | 刷卡进出方向。参考工人进退场类型字典表 | ||
imageUrl | string | 否 | 刷卡近照资源地址。 | |
channel | string | 否 | 通道的名称 | |
attendType | int | 否 | 通行方式。参考工人通行方式字典表 | |
lng | decimal | 否 | WGS84 经度 | |
lat | decimal | 否 | WGS84 纬度 | |
temperature | decimal | 否 | 工人体温,35-99 范围数字,最长支持两位小数 | |
请求体格式示例 | ||||
{ "projectCode":"项目编号", "teamSysNo":1, "date":"时间", "idCardType":"证件类型", "idCardNumber":"证件号码", "pageIndex":1, "pageSize":1, "RequestSerialCode":"" } | ||||
响应体格式示例 | ||||
{ "rows":[ { "projectCode":"", "teamSysNo":1, "teamName":"", "imageUrl":"", "idCardType":"", "idCardNumber":"", "date":"", "direction":"", "channel":"", "attendType":"", "lng":1.9, "lat":1.9 } ], "pageCount":1, "pageIndex":1, "pageSize":1 } |
接口信息 | |||||||
Endpoint | http://{host}/webapi/v2.0 | ||||||
Method | Payroll.Add | ||||||
Version | 2.0 | ||||||
返回方式 | 响应体(JSON) | ||||||
接口说明 | 上传工人工资 | ||||||
输入参数 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
projectCode | string | 是 | 平台为项目分配的接入编码 | ||||
corpCode | string | 是 | 工人所属企业统一社会信用代 码,如果无统一社会信用代码,则填写组织机构代码 | ||||
teamSysNo | int | 是 | 平台为班组分配的接入编号 | ||||
payMonth | string | 是 | 发放工资的月份。格式 yyyy-MM | ||||
attachments | array | 否 | 工资单附件。JSON 数组,附件总数不超过 5 个 | ||||
detailList | array | 是 | 工资单详情列表。JSON 数组 | ||||
detailList 数组内对象字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | ||||
idCardNumber | string | 是 | 证件号码。AES | ||||
days | int | 否 | 出勤天数,单位:天 | ||||
workHours | decimal | 否 | 总工时,单位:小时 | ||||
payRollBankCardNumber | string | 是 | 工人工资卡号。AES | ||||
payRollBankCode | string | 是 | 工人工资卡银行代码, 参考银行代码字典表 | ||||
payRollBankName | string | 是 | 工人工资卡开户行名称 | ||||
payBankCardNumber | string | 是 | 工资代发银行卡号。AES | ||||
payBankCode | string | 是 | 工资代发银行代码, 参考银行代码字典表 | ||||
payBankName | string | 是 | 工资代发开户行名称 | ||||
totalPayAmount | decimal | 是 | 应发金额,单位为元 | ||||
actualAmount | decimal | 是 | 实发金额,单位为元 | ||||
isBackPay | int | 是 | 是否为补发。参考是否字典表 | ||||
balanceDate | string | 是 | 发放日期。格式 yyyy-MM-dd | ||||
backPayMonth | string | 否 | 补发月份,如果是补发,此字段必填。格式 yyyy-MM | ||||
thirdPayRollCode | string | 是 | 第三方工资单编号 | ||||
attachments 数组内对象字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
Name | string | 是 | 附件名称 | ||||
Data | string | 是 | 附件。不超过 1M 的 Base64 字符串 | ||||
响应体字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
requestSerialCode | string | 是 | 请求序列编码 | ||||
异步处理结果响应体字段 | |||||||
名称 | 类型 | 是否必需 | 备注 | ||||
payrollCode | string | 是 | 成功生成的工资单编号 | ||||
请求体格式示例 | |||||||
{ "projectCode": "6101002018*******9", "corpCode": "1111234323*******7", "teamSysNo": 100, "payMonth": "2018-07", "attachments": [ { "name":"附件名称", "data":"BASE64 字符串" } ], "detailList": [ { "idCardType":"01", "idCardNumber":"4306811984*******1", "days":15, "workHours":120, "payRollBankCardNumber":"121******3", "payRollBankCode":"bbbb", "payRollBankName":"test Bank Name", "PayBankCardNumber":"aaaaaa", "PayBankCode":"aaaa", "PayBankName":"sdfsdsdfsdf", "totalPayAmount":4100, "actualAmount":4000, "isBackPay":0, "balanceDate":"2018-07-25", "thirdPayRollCode":"" } ] } | |||||||
响应体格式示例 | |||||||
{ "data": { "requestSerialCode": "payroll-add-2018083116-0001" }, "code": "0", "message": "调用成功" } | |||||||
异步返回结果示例 | |||||||
{ "data": { "requestSerialCode": "projecttraining-add-2018083116-0001", "result": "{"payrollCodes":["GZD0001010237201807001","GZD0001010237201807002"]}", "status": 20 }, "code": "0", "message": "调用成功" } |
接口信息 | ||||
Endpoint | http://{host}/webapi/v2.0 | |||
Method | Payroll.Query | |||
Version | 2.0 | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 查询工人工资信息 | |||
输入参数 | ||||
名称 | 类型 | 是否必需 | 备注 | |
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过 100 | |
projectCode | string | 是 | 平台为项目分配的接入编码 | |
payMonth | string | 是 | 发放工资的月份。仅取年月。格式 yyyy-MM-dd | |
corpCode | string | 否 | 工人所属企业统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
corpName | string | 否 | 工人所属企业名称 | |
teamSysNo | int | 否 | 平台为班组分配的接入编号 | |
payrollCode | string | 否 | 工资单编号 | |
idCardType | string | 否 | 证件类型。参考证件类型字典表 | |
idCardNumber | string | 否 | 工人身份证号。AES | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
totalCount | int | 是 | 记录总数 | |
pageIndex | int | 是 | 指定页号,以 0 为起始数字,表示第 1 页 | |
pageSize | int | 是 | 每页记录数,最多不能超过 100 | |
rows | array | 是 | 记录集合。JSON 数组 | |
rows 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectCode | string | 是 | 平台为项目分配的接入编码 | |
corpCode | string | 是 | 所属企业统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码 | |
corpName | string | 是 | 所属企业名称 | |
teamSysNo | int | 是 | 平台为班组分配的接入编号 | |
payMonth | string | 是 | 发放工资的月份。仅取其年月 | |
attachments | array | 否 | 工资单附件。JSON 数组 | |
detailList | array | 是 | 工资单详情列表。JSON 数组 | |
detailList 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
workerName | string | 是 | 工人姓名 | |
idCardType | string | 是 | 证件类型。参考人员证件类型字典表 | |
idCardNumber | string | 是 | 证件号码。AES | |
days | int | 否 | 出勤天数,单位:天 | |
workHours | decimal | 否 | 总工时,单位:小时 | |
payRollBankCardNumber | string | 是 | 工人工资卡号。AES | |
payRollBankCode | string | 是 | 工人工资卡银行代码 | |
payRollBankName | string | 是 | 工人工资卡开户行名称 | |
payBankCardNumber | string | 是 | 工资代发银行卡号。AES | |
payBankCode | string | 是 | 工资代发银行代码 | |
payBankName | string | 是 | 工资代发开户行名称 | |
totalPayAmount | decimal | 是 | 应发金额,单位为元 | |
actualAmount | decimal | 是 | 实发金额,单位为元 | |
isBackPay | int | 是 | 是否为补发。参考是否字典表 | |
balanceDate | string | 是 | 发放日期。格式 yyyy-MM-dd | |
thirdPayRollCode | string | 是 | 第三方工资单编号 | |
teamName | string | 是 | 班组名称 | |
attachments 数组内对象字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
name | string | 是 | 附件名称 | |
url | string | 是 | 附件 url | |
请求体格式示例 | ||||
响应体格式示例 | ||||
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!