V_1.0

基础版本

2018-12

陈石杨

V_1.1

签名signature生成规则调整

2019-09

陈石杨

V_1.2

增加查询项目接口

2020-05

陈石杨

V_1.2

工种数据字典数据修改(删除管理人员工种,增加住建部新增的工种(总包参建单位类型的))

2020-11

陈石杨

Encoding

UTF-8

Method

POST

Body

JSON数据

返回

JSON数据

api_version

String

Y

API协议版本,可选值:1.0

timestamp

String

Y

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2016-06-06 13:52:03。服务端允许客户端请求时间误差为6分钟

signature

String

Y

对API输入参数进行MD5加密获得

message

String

否

错误信息

detail_message

String

否

详细错误信息

result_data

Object

是

返回结果集

成功返回的result_data结果集

名称

类型

是否必须

描述

请求URL

/UploadSmz/UploadCompanyInfo?api_key=test&signature=2A1C0A69BF2F073671B2E4502F7748B8&api_version=1.0×tamp=2019-08-21+17%3A46%3A06

Post Json

{"corpCode":"888888888888888888","corpName":"测试企业","corpType":null,"licenseNum":null,"areaCode":"330783","address":null,"zipCode":null,"legalMan":null,"legalManDuty":null,"legaManProTitle":null,"legalManIDCardType":null,"legalManIDCardNumber":null,"regCapital":null,"factRegCapital":null,"registerDate":"1998-04-03","establishDate":null,"officePhone":null,"faxNumber":null,"linkman":null,"linkTel":null,"email":null,"website":null,"remark":null}

返回示例

Return Json

{"result":"true","message":"","result_data":""}

1

单位性质

2

人员证件类型

3

注册资本币种

4

项目分类

5

项目状态

6

立项级别

7

建设规模

8

建设性质

9

工程用途

10

参建类型

11

人员工种

12

工人类型

13

银行代码

14

政治面貌

15

文化程度

16

婚姻状况

17

工人进退场类型

18

合同期限类型

19

计量单位

20

刷卡进出方向

21

通行方式

22

培训类型代码

根据类型获取所有基础数据字典,通过验证后获得对应的数据字典编码。

输入参数

名称

类型

是否必须

描述

api_key

String

是

授权帐号

api_version

String

是

API协议版本,可选值:1.0

timestamp

String

是

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2016-06-06 13:52:03。

signature

String

是

对API输入参数进行MD5加密获得

POST的JSON数据

名称

类型

是否必须

描述

type

Int

是

参考国标(基础数据字典类型)

成功返回的result_data结果集

名称

类型

是否必须

描述

orders

int

是

编码

value

String

是

名称

/UploadSmz/UploadCompanyInfo

上传企业信息

/UploadSmz/UploadItemInfo

上传项目信息

/UploadSmz/UploadParticipateInfo

上传参建单位信息

/UploadSmz/UpdateParticipateInfo

修改建单位信息

/UploadSmz/UploadTeamInfo

上传班组信息

/UploadSmz/UpdateTeamInfo

修改班组信息

/UploadSmz/UploadRosterInfo

上传项目工人信息

/UploadSmz/UpdateRosterInfo

修改项目工人信息

/UploadSmz/UploadEntryExitInfo

上传人员进退场

/UploadSmz/UploadContract

上传劳动合同

/UploadSmz/UploadPayroll

上传项目工资单信息

/UploadSmz/UploadPayrollDetail

上传项目工资单详细信息

/UploadSmz/UploadTrainInfo

上传项目培训课程信息

/UploadSmz/UploadTrainWorkerInfo

上传项目培训课程人员信息

/UploadSmz/UploadDeviceInfo

上传设备信息

/UploadSmz/GetItemInfo

查询项目信息

/UploadSmz/GetTeamInfo

查询班组信息

输入参数

名称

类型

是否必须

描述

api_key

String

是

授权帐号

api_version

String

是

API协议版本,可选值:1.0

timestamp

String

是

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2016-06-06 13:52:03

signature

String

是

对API输入参数进行MD5加密获得

POST的JSON数据

名称

类型

是否必须

描述

corpCode

string

是

企业统一社会信用代码或者组织机构码

corpName

string

是

企业名称

corpType

int

否

单位性质。参考国标(基础数据类型数据字典)

licenseNum

string

否

工商营业执照注册号

areaCode

string

是

企业注册地区编码。参考国标(行政区划字典)

address

string

否

企业营业地址

zipCode

string

否

邮政编码

legalMan

string

否

法定代表人姓名

legalManDuty

string

否

法定代表人职务

legaManProTitle

string

否

法定代表人职称

legalManIDCardType

int

否

法定代表人证件类型。参考国标(基础数据类型数据字典)

legalManIDCardNumber

string

否

法定代表人证件号码。

regCapital

decimal

否

注册资本(万元,可保留4位小数)

factRegCapital

decimal

否

实收资本(万元,可保留4位小数)

registerDate

string

是

注册日期,格式yyyy-MM-dd

establishDate

string

否

成立日期,格式yyyy-MM-dd

officePhone

string

否

办公电话

faxNumber

string

否

传真号码

linkman

string

否

联系人姓名

linkTel

string

否

联系人办公电话

email

string

否

企业联系邮箱

website

String

否

企业网址

remark

String

否

企业备注

输入参数

名称

类型

是否必须

描述

api_key

String

是

授权帐号

api_version

String

是

API协议版本,可选值:1.0

timestamp

String

是

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2016-06-06 13:52:03

signature

String

是

对API输入参数进行MD5加密获得

POST的JSON数据

名称

类型

是否必须

描述

projectCode

String

否

项目统一编号(修改项目信息时必填)

contractorCorpCode

string

是

总承包单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码

contractorCorpName

string

是

总承包单位名称

name

string

是

项目名称

description

string

否

项目简介

category

int

是

项目分类。参考国标(基础数据类型数据字典)

buildCorpName

string

否

建设单位名称

buildCorpCode

string

否

建设单位统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码

builderLicenses

array

是

施工许可证。JSON数组

buildPlanNum

string

否

建设用地规划许可证编号。

prjPlanNum

string

否

建设工程规划许可证编号。

areaCode

string

是

项目所在地。。参考国标(行政区划字典)

invest

decimal

否

总投资,单位:(万元)(最多精确到4位小数)

buildingArea

decimal

否

总面积,单位:平方米(最多精确到2位小数)

buildingLength

decimal

否

总长度,单位:米(最多精确到2位小数)

startDate

string

否

开工日期,精确到天,格式:yyyy-MM-dd

completeDate

string

否

竣工日期,精确到天,格式:yyyy-MM-dd

linkMan

string

否

联系人姓名

linkPhone

string

否

联系人办公电话

prjStatus

int

是

项目状态。参考国标(基础数据类型数据字典)

lat

decimal

否

WGS84经度(精确到15位小数)

lng

decimal

否

WGS84纬度(精确到15位小数)

address

string

否

项目地点

approvalNum

string

否

立项文号

approvalLevelNum

int

否

立项级别。参考国标(基础数据类型数据字典)

prjSize

int

否

建设规模。参考国标(基础数据类型数据字典)

propertyNum

int

否

建设性质。参考国标(基础数据类型数据字典)

functionNum

int

否

工程用途。参考国标(基础数据类型数据字典)

thirdPartyProjectCode

string

是

供应商为项目创建的编码,同一个系统不能重复编码

builderLicenses数组对象相关字段

名称

类型

是否必须

描述

prjName

string

是

工程名称

builderLicenseNum

string

是

施工许可证编号。

成功返回的result_data结果集

名称

类型

是否必须

描述

projectCode

String

是

项目统一编号

输入参数

名称

类型

是否必须

描述

api_key

String

是

授权帐号

api_version

String

是

API协议版本,可选值:1.0

timestamp

String

是

时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2016-06-06 13:52:03

signature

String

是

对API输入参数进行MD5加密获得

POST的JSON数据

名称

类型

是否必须

描述

projectCode

string

是

项目编码

corpCode

string

是

统一社会信用代码,如果无统一社会信用代码,则填写组织机构代码

corpName

string

是

企业名称

corpType

int

是

参建类型。参考国标(基础数据类型数据字典)

entryTime

string

否

进场时间。格式yyyy-MM-ddHH:mm:ss

exitTime

string

否

退场时间。格式yyyy-MM-ddHH:mm:ss

bankInfos

array

否

发放工资的银行。JSON数组

pmName

string

否

项目经理名称

pmIDCardType

int

否

项目经理证件类型。参考国标(基础数据类型数据字典)

pmIDCardNumber

string

否

项目经理证件号码。

pmPhone

string

否

项目经理电话

bankInfos数组对象相关字段

名称

类型

是否必须

描述

bankCode

int

是

银行代码。参考国标(基础数据类型数据字典)

bankName

string

是

银行支行名称

bankNumber

string

是

银行卡号。

bankLinkNumber

string

是

银行联号