目录
1概述1
1.1简介1
1.2接口调用方式说明1
1.3AES加密1
1.4调用参数1
1.5接口响应2
1.6接口类型3
1.6.1异步处理接口3
1.6.2同步处理接口3
2接口详细信息4
2.1企业4
2.1.1上传企业基本信息4
2.2项目7
2.2.1项目基本信息7
2.2.1.1上传项目信息7
2.2.1.2修改项目信息12
2.2.2项目参建单位16
2.2.2.1上传项目参建单位信息16
2.2.2.2批量上传项目参建单位信息19
2.2.2.3修改项目参建单位信息21
2.2.2.3批量修改项目参建单位信息24
2.2.3项目班组27
2.2.3.1上传班组信息27
2.2.3.1修改班组信息30
2.2.4项目人员32
2.2.4.1上传工人基本信息32
2.2.4.2批量上传工人基本信息36
2.2.4.3修改工人基本信息41
2.2.4.4上传项目工人信息44
2.2.4.5修改项目工人信息48
2.2.5项目人员进退场52
2.2.5.1上传项目工人进/退场信息52
2.2.6项目人员合同53
2.2.6.1上传工人合同信息53
2.2.7项目人员考勤56
2.2.7.1上传工人考勤56
2.2.8项目人员工资58
2.2.8.1上传工人工资58
2.2.9项目培训62
2.2.9.1上传项目培训62
2.3异步接口调用结果查询65
2.3.1异步查询65
3数据字典66
3.1企业登记注册类型字典表66
3.2行政区划字典表67
3.3人员证件类型字典表72
3.4币种字典表73
3.5企业资质资格类型字典表74
3.6企业资质资格专业类别字典表74
3.7企业资质等级字典表80
3.8企业资质取得方式字典表81
3.9企业资质状态字典82
3.10项目分类字典表82
3.11项目状态字典表83
3.12立项级别字典表83
3.13建设规模字典表83
3.14建设性质分类字典表83
3.15工程用途字典表84
3.16国籍及地区字典表84
3.17参建单位类型字典表84
3.18工人工种字典表85
3.19银行代码字典表87
3.20是否字典表95
3.21合同期限类型字典表95
3.22工人考勤方向字典表95
3.23工人进退场类型字典表95
3.24计量单位类型字典表95
3.25工人通行方式字典表96
3.26培训类型字典表96
3.27性别字典表96
3.28政治面貌字典表96
3.29文化程度字典表97
3.30婚姻状况字典表97
3.31人员证书种类字典表98
3.32人员证书类型:安管证书专业字典表98
3.33人员证书类型:岗位证书专业字典表98
3.34人员证书类型:执业注册类别字典表99
3.35人员证书类型:执业注册证书专业字典表100
3.36人员证书类型:职业技能人员类别101
3.37人员资质等级:职称等级107
3.38人员资质等级:职业技能等级107
3.39资质证书状态字典表107
3.40企业不良行为字典表108
3.41认定部门级别字典表126
3.42市场主体类别字典表126
3.43人员不良行为字典表126
3.44附件类型字典表132
3.45银行卡业务类型字典表132
3.46异步处理结果状态字典表132
3.47工人类型字典表132
3.48管理岗位字典表133
本数据接口规范主要为地市劳务实名制监管系统(第三方服务商)和项目使用的劳务实名制系统与河北省城乡建设厅建筑工人实名制管理系统进行数据交互使用;所有API均基于Post方式请求调用.
参数名称 | 参数说明 |
Url地址 | 测试环境接口地址: http://39.106.50.195:7890/webapi/v1.0/ 正式环境接口地址: http://218.11.13.5:7890/webapi/v1.0/ |
Encoding | UTF-8 |
Method | POST |
Body | JSON数据 |
返回 | JSON数据 |
secretKey为:平台软件供应商编码(provider)
调用API,必须传入系统参数和应用参数。
系统参数
token | string | Y | 授权帐号 |
provider | string | Y | 平台软件供应商编码 |
timestamp | string | Y | 时间戳,格式为yyyy-MM-ddhh:mm:ss,例如:2016-06-0613:52:03。服务端允许客户端请求时间误差为6分钟 |
signature | string | Y | 对API输入参数进行MD5加密获得 |
应用参数
应用参数放在body数据区
签名signature
使用系统默认MD5加密,因为各语言语法不一致,以下实例只体现逻辑。为便于说明,假设token值为test。provider的值为pro,body区的数据项对应的jsonkey为”body”,value为整个body原始字符串。
1)所有参数为: token=test provider=pro timestamp=2019-03-0709:05:03 body={name:zhangsan} 2)按照参数名称升序排列: body={name:zhangsan} provider=pro timestamp=2019-03-0709:05:03 token=test 3)连接字符串 连接参数名与参数值,并在首尾加上token,如下: testbody{name:zhangsan}providerprotimestamp2016-06-1009:05:03tokentesttest 若无应用参数时body为{}如下: testbody{}providerprotimestamp2016-06-1009:05:03tokentesttest 4)生成签名: 32位大写MD5值-<xxxxxxxxxxxxxxxxxxxx< p=""> 5)拼装HTTP请求 将所有参数值转换为UTF-8编码,然后拼装,通过浏览器访问该地址,即成功调用一次接口。 |
注意事项
所有的请求和响应数据编码皆为utf-8格式,url里的所有参数值请做urlencode编码。
统一返回参数结构
参数名称 | 参数说明 |
code | 处理结果编码(参考下面的“标准错误代码定义”) |
message | 处理结果消息 |
data | 接口处理完毕返回的数据 |
返回的Json格式:
{"code":"0","message":"","data":{requestSerialNo":"","message":""}
异步处理接口是指调用之后不会立即返回处理结果,而是返回响应体字段requestSerialNo供后续查询使用。可通过异步接口调用结果查询进行结果查询,其返回内容可参考每一接口的异步处理结果响应体字段部分,若异步处理结果响应体字段部分没有任何内容,则表明该异步处理不返回任何额外信息,仅需关注异步处理状态即可;上传/修改接口都是异步处理接口。
同步处理接口是指调用之后立即返回处理结果,查询接口都是同步处理接口。
标准错误代码代码定义
code | message | 说明或解决方案 |
0 | 请求成功 | 成功 |
-1 | 请求参数错误 | 请检查请求的url |
-2 | 签名校验错误 | 请检查请求的token |
-3 | 无API访问权限 | 请检查密钥状态 |
-4 | 访问超过限制 | 请稍后再发送请求 |
注:标准错误码小于0,大于0的错误码由各接口根据接口语义自行定义
接口信息 | |||
接口名称 | addCorp | ||
返回方式 | 响应体(JSON) | ||
接口说明 | 上传企业基本信息 | ||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/addCorp?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | ||
请求体字段 | |||
名称 | 类型 | 是否必需 | 备注 |
corpCode | string | 是 | 企业统一社会信用代码,如果无统一社会信用代码,则用组织机构代码 |
corpName | string | 是 | 企业名称 |
corpType | string | 否 | 单位性质。参考企业登记注册类型字典表 |
licenseNum | string | 否 | 工商营业执照注册号 |
areaCode | string | 是 | 企业注册地区编码。参考行政区划字典表 |
address | string | 否 | 企业营业地址 |
zipCode | string | 否 | 邮政编码 |
legalMan | string | 否 | 法定代表人姓名 |
legalManDuty | string | 否 | 法定代表人职务 |
legaManProTitle | string | 否 | 法定代表人职称 |
legalManIDCardType | string | 否 | 法定代表人证件类型。参考人员证件类型字典表 |
legalManIDCardNumber | string | 否 | 法定代表人证件号码。需要使用AES加密 |
regCapital | decimal | 否 | 注册资本(万元) |
factRegCapital | decimal | 否 | 实收资本(万元) |
capitalCurrencyType | string | 否 | 注册资本币种。参考币种字典表 |
registerDate | string | 是 | 注册日期,格式yyyy-MM-dd |
establishDate | string | 否 | 成立日期,格式yyyy-MM-dd |
officePhone | string | 否 | 办公电话 |
faxNumber | string | 否 | 传真号码 |
linkman | string | 否 | 联系人姓名 |
linkTel | string | 否 | 联系人办公电话 |
string | 否 | 企业联系邮箱 | |
website | string | 否 | 企业网址 |
remark | string | 否 | 企业备注 |
sourceAreaCode | string | 是 | 数据来源(区级区划编码) |
响应体字段 | |||
名称 | 类型 | 是否必需 | 备注 |
code | string | 是 | 处理结果编码 |
message | string | 是 | 处理结果消息 |
data | json | 是 | 接口处理完毕返回的数据 |
请求体格式示例 | |||
{ "registerDate":"2017-09-04", "corpCode":"913501003157357147", "corpName":"0810-劳务分包01", "corpType":"100", "licenseNum":"", "areaCode":"350423", "address":"清流县龙津镇永顺花园6幢1305室", "zipCode":"", "legalMan":"张三", "legalManDuty":"董事长", "legaManProTitle":"教授", "legalManIDCardType":"01", "legalManIDCardNumber":"MiJ2Z/CxijInCyQf8MRMuo6ComKGao4eW/GMbSnseds=", "regCapital":1.9, "factRegCapital":1.9, "capitalCurrencyType":"", "establishDate":"2017-08-01", "officePhone":"028-98890987", "faxNumber":"", "linkMan":"李数", "linkPhone":"15890987876", "email":"t@126.com", "webSite":"http://www.baidu.com", "remark":"备注", "sourceAreaCode":"610100" } | |||
响应体格式示例 | |||
{ "requestSerialNo":"" } |
2.2.1.1上传项目信息
接口信息 | ||||||
接口名称 | addProject | |||||
返回方式 | 响应体(JSON) | |||||
接口说明 | 上传项目信息 | |||||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/addProject?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | |||||
请求体字段 | ||||||
名称 | 类型 | 是否必需 | 备注 | |||
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 | 是 | 项目所在地(6位数字,如:440000)。参考行政区划字典表 | |||
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 | 是 | 软件供应商名称 | |||
sourceAreaCode | string | 是 | 数据来源(区级区划编码) | |||
builderLicenses数组内对象字段 | ||||||
名称 | 类型 | 是否必需 | 备注 | |||
prjName | string | 是 | 工程名称 | |||
builderLicenseNum | string | 是 | 施工许可证编号。需要使用AES加密 | |||
响应体字段 | ||||||
名称 | 类型 | 是否必需 | 备注 | |||
code | string | 是 | 处理结果编码 | |||
message | string | 是 | 处理结果消息 | |||
data | json | 是 | 接口处理完毕返回的数据 | |||
请求体格式示例 | ||||||
{ "contractorCorpCode":"", "contractorCorpName":"", "name":"", "description":"", "category":"", "buildCorpName":"", "buildCorpCode":"", "buildPlanNum":"", "prjPlanNum":"", "areaCode":"", "invest":1.9, "buildingArea":1.9, "buildingLength":1.9, "startDate":"", "completeDate":"", "linkMan":"", "linkPhone":"", "prjStatus":"", "lng":30, "lat":30, "address":"", "approvalNum":"", "approvalLevelNum":"", "prjSize":"", "propertyNum":"", "functionNum":"", "nationNum":"", "sourceAreaCode":"610100", "builderLicenses":[ { "prjName":"", "builderLicenseNum":"" } ] } | ||||||
响应体格式示例 | ||||||
{ "requestSerialNo":"project-add-20180110-1623452" } | ||||||
异步返回结果示例 | ||||||
{ "data":{ "requestSerialNo:"", "result":"{projectNo:project-add-20180110-1623452}", "status":20 }, "code":"0", "message":"调用成功" } |
2.2.1.2修改项目信息
接口信息 | ||||||
接口名称 | updateProject | |||||
返回方式 | 响应体(JSON) | |||||
接口说明 | 上传项目信息 | |||||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/updateProject?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | |||||
请求体字段 | ||||||
名称 | 类型 | 是否必需 | 备注 | |||
projectNo | 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 | string | 否 | 国籍或地区。参考国籍及地区字典表 | |||
supplierName | string | 是 | 软件供应商名称 | |||
builderLicenses数组内对象字段 | ||||||
名称 | 类型 | 是否必需 | 备注 | |||
prjName | string | 是 | 工程名称 | |||
builderLicenseNum | string | 是 | 施工许可证编号。需要使用AES加密 | |||
响应体字段 | ||||||
名称 | 类型 | 是否必需 | 备注 | |||
code | string | 是 | 处理结果编码 | |||
message | string | 是 | 处理结果消息 | |||
data | json | 是 | 接口处理完毕返回的数据 | |||
请求体格式示例 | ||||||
{ "contractorCorpCode":"", "contractorCorpName":"", "name":"", "description":"", "category":"", "buildCorpName":"", "buildCorpCode":"", "buildPlanNum":"", "prjPlanNum":"", "areaCode":"", "invest":1.9, "buildingArea":1.9, "buildingLength":1.9, "startDate":"", "completeDate":"", "linkMan":"", "linkPhone":"", "prjStatus":"", "lng":30, "lat":30, "address":"", "approvalNum":"", "approvalLevelNum":"", "prjSize":"", "propertyNum":"", "functionNum":"", "nationNum":"", "builderLicenses":[ { "prjName":"", "builderLicenseNum":"" } ] } | ||||||
响应体格式示例 | ||||||
{ "requestSerialNo":"" } |
接口信息 | ||||
接口名称 | addProjectCorp | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传项目参建单位 | |||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/addProjectCorp?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectNo | string | 是 | 项目编号 | |
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则用组织机构代码 | |
corpName | string | 是 | 企业名称 | |
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | |
entryTime | string | 否 | 进场时间。格式yyyy-MM-ddHH:mm:ss | |
exitTime | string | 否 | 退场时间。格式yyyy-MM-ddHH:mm:ss | |
bankInfos | array | 否 | 发放工资的银行。JSON数组 | |
pmName | string | 否 | 项目经理名称 | |
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | |
pmIDCardNumber | string | 否 | 项目经理证件号码。需要使用AES加密 | |
pmPhone | string | 否 | 项目经理电话 | |
sourceAreaCode | string | 是 | 数据来源(区级区划编码) | |
bankInfos数组对象相关字段 | ||||
bankCode | string | 是 | 银行代码。参考银行代码字典表 | |
bankName | string | 是 | 银行支行名称 | |
bankNumber | string | 是 | 银行卡号。需要使用AES加密 | |
bankLinkNumber | string | 否 | 银行联号 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
code | string | 是 | 处理结果编码 | |
message | string | 是 | 处理结果消息 | |
data | json | 是 | 接口处理完毕返回的数据 | |
请求体格式示例 | ||||
{ "projectNo":"10008" "corpCode":"12510823FHFAMRWB57", "corpName":"企业01ab#%^", "corpType":"006", "entryTime":"2018-08-2112:13:14", "exitTime":"2018-08-3105:16:17", "bankInfos":[{ "bankCode":"103", "bankName":"绿色披萨盘", "bankNumber":"QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=", "bankLinkNumber":"453226789" }], "pmName":"饿殍", "pmIDCardType":"01", "pmIDCardNumber":"UQIJxmqlHruG7haaaIs99Avx/iaLczTEODMnsAXeUQk=", "pmPhone":"13234344444", "sourceAreaCode":"610100" } | ||||
响应体格式示例 | ||||
{ "requestSerialCode":"subcontractor-add-20200927170402-5-0002", "result":"{\"pmCode\":\"121764692\",\"memo\":\"项目管理部代码,上传管 理人员及管理人员考勤时使用!\"}", "status":20 } |
接口信息 | ||||
接口名称 | addProjectCorps | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传项目参建单位 | |||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/addProjectCorps?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectNo | string | 是 | 项目编号 | |
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则用组织机构代码 | |
corpName | string | 是 | 企业名称 | |
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | |
entryTime | string | 否 | 进场时间。格式yyyy-MM-ddHH:mm:ss | |
exitTime | string | 否 | 退场时间。格式yyyy-MM-ddHH:mm:ss | |
bankInfos | array | 否 | 发放工资的银行。JSON数组 | |
pmName | string | 否 | 项目经理名称 | |
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | |
pmIDCardNumber | string | 否 | 项目经理证件号码。需要使用AES加密 | |
pmPhone | string | 否 | 项目经理电话 | |
sourceAreaCode | string | 是 | 数据来源(区级区划编码) | |
bankInfos数组对象相关字段 | ||||
bankCode | string | 是 | 银行代码。参考银行代码字典表 | |
bankName | string | 是 | 银行支行名称 | |
bankNumber | string | 是 | 银行卡号。需要使用AES加密 | |
bankLinkNumber | string | 否 | 银行联号 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
code | string | 是 | 处理结果编码 | |
message | string | 是 | 处理结果消息 | |
data | json | 是 | 接口处理完毕返回的数据 | |
请求体格式示例 | ||||
[{ "projectNo":"10008" "corpCode":"12510823FHFAMRWB57", "corpName":"企业01ab#%^", "corpType":"006", "entryTime":"2018-08-2112:13:14", "exitTime":"2018-08-3105:16:17", "bankInfos":[{ "bankCode":"103", "bankName":"绿色披萨盘", "bankNumber":"QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=", "bankLinkNumber":"453226789" }], "pmName":"饿殍", "pmIDCardType":"01", "pmIDCardNumber":"UQIJxmqlHruG7haaaIs99Avx/iaLczTEODMnsAXeUQk=", "pmPhone":"13234344444", "sourceAreaCode":"610100" }] | ||||
响应体格式示例 | ||||
{ "requestSerialCode":"subcontractor-add-20200927170402-5-0002", "result":"{\"pmCode\":\"121764692\",\"memo\":\"项目管理部代码,上传管 理人员及管理人员考勤时使用!\"}", "status":20 } |
2.2.2.3修改项目参建单位信息
接口信息 | ||||
接口名称 | updateProjectCorp | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传项目参建单位 | |||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/updateProjectCorp?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectNo | string | 是 | 项目编号 | |
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则用组织机构代码 | |
corpName | string | 是 | 企业名称 | |
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | |
entryTime | string | 否 | 进场时间。格式yyyy-MM-ddHH:mm:ss | |
exitTime | string | 否 | 退场时间。格式yyyy-MM-ddHH:mm:ss | |
bankInfos | array | 否 | 发放工资的银行。JSON数组 | |
pmName | string | 否 | 项目经理名称 | |
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | |
pmIDCardNumber | string | 否 | 项目经理证件号码。需要使用AES加密 | |
pmPhone | string | 否 | 项目经理电话 | |
bankInfos数组对象相关字段 | ||||
bankCode | string | 是 | 银行代码。参考银行代码字典表 | |
bankName | string | 是 | 银行支行名称 | |
bankNumber | string | 是 | 银行卡号。需要使用AES加密 | |
bankLinkNumber | string | 否 | 银行联号 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
code | string | 是 | 处理结果编码 | |
message | string | 是 | 处理结果消息 | |
data | json | 是 | 接口处理完毕返回的数据 | |
请求体格式示例 | ||||
{ "corpCode":"12510823FHFAMRWB57", "corpName":"企业01", "corpType":"006", "entryTime":"2018-08-2112:13:14", "exitTime":"2018-08-3105:16:17", "bankInfos":[{ "bankCode":"103", "bankName":"绿色披萨盘", "bankNumber":"QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=", "bankLinkNumber":"453226789" }], "pmName":"饿殍", "pmIDCardType":"01", "pmIDCardNumber":"UQIJxmqlHruG7haaaIs99Avx/iaLczTEODMnsAXeUQk=", "pmPhone":"13234344444" } | ||||
响应体格式示例 | ||||
{ "data":{ "requestSerialCode":"projectsubcontractor-update-2018082917-0001", "result":null, "status":20 }, "code":"0", "message":"调用成功" } |
接口信息 | ||||
接口名称 | updateProjectCorps | |||
返回方式 | 响应体(JSON) | |||
接口说明 | 上传项目参建单位 | |||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/updateProjectCorps?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | |||
请求体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
projectNo | string | 是 | 项目编号 | |
corpCode | string | 是 | 统一社会信用代码,如果无统一社会信用代码,则用组织机构代码 | |
corpName | string | 是 | 企业名称 | |
corpType | string | 是 | 参建类型。参考参建单位类型字典表 | |
entryTime | string | 否 | 进场时间。格式yyyy-MM-ddHH:mm:ss | |
exitTime | string | 否 | 退场时间。格式yyyy-MM-ddHH:mm:ss | |
bankInfos | array | 否 | 发放工资的银行。JSON数组 | |
pmName | string | 否 | 项目经理名称 | |
pmIDCardType | string | 否 | 项目经理证件类型。参考人员证件类型字典表 | |
pmIDCardNumber | string | 否 | 项目经理证件号码。需要使用AES加密 | |
pmPhone | string | 否 | 项目经理电话 | |
bankInfos数组对象相关字段 | ||||
bankCode | string | 是 | 银行代码。参考银行代码字典表 | |
bankName | string | 是 | 银行支行名称 | |
bankNumber | string | 是 | 银行卡号。需要使用AES加密 | |
bankLinkNumber | string | 否 | 银行联号 | |
响应体字段 | ||||
名称 | 类型 | 是否必需 | 备注 | |
code | string | 是 | 处理结果编码 | |
message | string | 是 | 处理结果消息 | |
data | json | 是 | 接口处理完毕返回的数据 | |
请求体格式示例 | ||||
[ { "corpCode":"12510823FHFAMRWB57", "corpName":"企业01", "corpType":"006", "entryTime":"2018-08-2112:13:14", "exitTime":"2018-08-3105:16:17", "bankInfos":[{ "bankCode":"103", "bankName":"绿色披萨盘", "bankNumber":"QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=", "bankLinkNumber":"453226789" }], "pmName":"饿殍", "pmIDCardType":"01", "pmIDCardNumber":"UQIJxmqlHruG7haaaIs99Avx/iaLczTEODMnsAXeUQk=", "pmPhone":"13234344444" } ] | ||||
响应体格式示例 | ||||
{ "data":{ "requestSerialCode":"projectsubcontractor-update-2018082917-0001", "result":null, "status":20 }, "code":"0", "message":"调用成功" } |
2.2.3项目班组
2.2.3.1上传班组信息
接口信息 | |||
Endpoint | addTeam | ||
返回方式 | 响应体(JSON) | ||
接口说明 | 上传班组信息 | ||
请求url示例 | http://39.106.50.195:7890/webapi/v1.0/addTeam?token=TK1B92315A13904C0B959CB8DFD6924BA4&provider=PD602BCF63EF2F457F84E3F4E8E61E1B7C×tamp=2019-03-0718:08:25&signature=726DE14C7BCF24F0E5219034E4D5A772 | ||
请求体字段 | |||
名称 | 类型 | 是否必需 | 备注 |
projectNo | string | 是 | 项目编号 |
corpCode | string | 是 | 班组所在企业统一社会信用代码,如果无统一社会信用代码,则用组织机构代码 |
corpName | 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个 |
sourceAreaCode | string | 是 | 数据来源(区级区划编码) |
entryAttachments,exitAttachments数组内对象字段 | |||
name | string | 是 | 附件名称 |
data | string | 是 | 附件Base64字符串,不超过1M |
响应体字段 | |||
名称 | 类型 | 是否必需 | 备注 |
code | string | 是 | 处理结果编码 |
message | string | 是 | 处理结果消息 |
data | json | 是 | 接口处理完毕返回的数据 |
请求体格式示例 | |||
[ { "entryAttachments":[], "exitAttachments":[], "entryTime":"2018-08-23", "exitTime":"2018-08-24", "projectNo":"510104201807310225", "corpCode":"91440300618874367T", "corpName":"10236", "teamName":"y1", "responsiblePersonName":"i", "responsiblePersonPhone":"rr位01234", "responsiblePersonIDCardType":"01", "responsiblePersonIDNumber":"GRpitrqL9DGWOVthhZ3fEH3S+vHznaBGAQktzmVOl9w=", "remark":"test", "sourceAreaCode":"610100" } ] | |||
响应体格式示例 | |||
{ "requestSerialNo":"" } | |||
异步返回结果示例 | |||
{ "data":{ "requestSerialNo:"", "result":"{teamNo:}", "status":20 }, "code":"0", "message":"调用成功" } |
部分内容由用户投稿或者来源于网络,如有侵权,请联系底部邮箱进行删除!非常感谢您的支持!