报工系统接口(1.0.0

 

企业微信

1)构造网页授权链接

构造网页授权链接

接口描述

构造网页授权链接

URL

/timeSheet/getRedirectUri

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.redirect_uri

string

query

Y

redirect_uri

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

redirect_uri=string

返回值

{"msg":"string","code":0,"data":{}}

2)获取Token

获取Token

接口描述

获取Token

URL

/timeSheet/getToken

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.personNum

string

query

Y

personNum

2.userId

string

query

Y

userId

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

personNum=string&userId=string

返回值

{"msg":"string","code":0,"data":{}}

3)获取用户信息

获取用户信息

接口描述

获取用户信息

URL

/timeSheet/getUserInfo

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.code

string

query

Y

code

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

code=string

返回值

{"msg":"string","code":0,"data":{}}

员工报工

13.9 指定日期驳回、通过

3.9 指定日期驳回、通过

接口描述

3.9 指定日期驳回、通过

URL

/timeSheet/approvalProject

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.appProJect

object:AppProJect

body

Y

appProJect

1.1.status

string

N

1.2.timeSheetIds

string

N

2.token

string

header

Y

token

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{"status":"string","timeSheetIds":"string"}'

返回值

{"msg":"string","code":0,"data":{}}

2)校验年假

校验年假

接口描述

校验年假

URL

/timeSheet/checkAttWinter

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.beginTime

string

query

Y

开始时间yyyy-MM-dd

2.endTime

string

query

Y

结束时间yyyy-MM-dd

3.token

string

header

Y

token

4.workingHour

ref

query

Y

工时

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

beginTime=string&endTime=string&workingHour=null --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

3)校验可填报日期

校验可填报日期

接口描述

校验可填报日期

URL

/timeSheet/checkAvailableDate

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.beginTime

string

query

Y

开始时间yyyy-MM-dd

2.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

beginTime=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

4)删除员工当前月份报工单

删除员工当前月份报工单

接口描述

删除员工当前月份报工单

URL

/timeSheet/deleteSheet

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.timeSheetId

object

body

Y

timeSheetId

2.token

string

header

Y

token

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{}'

返回值

{"msg":"string","code":0,"data":{}}

5)获取审核员待办、已办

获取审核员待办、已办

接口描述

获取审核员待办、已办

URL

/timeSheet/getAudited

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.audited

boolean

query

Y

是否已经审核

2.month

string

query

N

月份(yyyy-MM)

3.page

ref

query

Y

页码

4.size

ref

query

Y

每页条数

5.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

audited=true&month=string&page=null&size=null --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

6new]获取指定员工的审核员待办、已办列表

new]获取指定员工的审核员待办、已办列表

接口描述

new]获取指定员工的审核员待办、已办列表

URL

/timeSheet/getEmpAudited

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.audited

boolean

query

N

是否未经审核

2.empNumber

string

query

N

指定员工工号

3.month

string

query

Y

月份(yyyy-MM)

4.page

ref

query

Y

页码

5.size

ref

query

Y

每页条数

6.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

audited=true&empNumber=string&month=string&page=null&size=null --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

7[new]获取审核员待办相关的员工列表

[new]获取审核员待办相关的员工列表

接口描述

[new]获取审核员待办相关的员工列表

URL

/timeSheet/getEmpList

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.audited

boolean

query

N

是否已经审核

2.month

string

query

Y

月份(yyyy-MM)

3.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

audited=true&month=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

8)获取员工报工合计

获取员工报工合计

接口描述

获取员工报工合计

URL

/timeSheet/getJobDayByPerson

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.month

string

query

Y

月份(yyyy-MM)

2.projectId

string

query

N

项目id

3.token

string

header

Y

token

4.type

string

query

N

考勤类型id

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

month=string&projectId=string&type=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

9)获取员工当前月份报工单

获取员工当前月份报工单

接口描述

获取员工当前月份报工单

URL

/timeSheet/getMonthWorkSheet

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.committed

boolean

query

N

null

2.month

string

query

Y

月份(yyyy-MM)

3.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

committed=true&month=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

10)获取员工月份报工明细

获取员工月份报工明细

接口描述

获取员工月份报工明细

URL

/timeSheet/getPersonWorkDetail

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.month

string

query

Y

报工月份字符串,格式:yyyy-MM

2.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

month=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

11)获取报工明细数据(审核)

获取报工明细数据(审核)

接口描述

获取报工明细数据(审核)

URL

/timeSheet/getTimeSheetDetail

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.audited

boolean

query

N

是否审核

2.month

string

query

Y

月份(yyyy-MM)

3.projectId

string

query

Y

项目id

4.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

audited=true&month=string&projectId=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

12)根据id获取员工报工信息

根据id获取员工报工信息

接口描述

根据id获取员工报工信息

URL

/timeSheet/getWorkSheetById

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.timeSheetId

string

query

Y

报工id

2.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

timeSheetId=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

13)员工报工新增

员工报工新增

接口描述

员工报工新增

URL

/timeSheet/insert

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.param

object:InsertJobBookingVO

body

Y

param

1.1.attendanceType

string

N

1.2.beginTime

string

N

1.3.endTime

string

N

1.4.projectId

string

N

1.5.state

string

N

1.6.times

array:InsertJobBookingEnteyVO

N

1.6.1.attendanceType

string

N

1.6.2.workingHours

string

N

1.7.workingHours

string

N

2.token

string

header

Y

token

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{"attendanceType":"string","beginTime":"string","endTime":"string","projectId":"string","state":"string","times":[{"attendanceType":"string","workingHours":"string"}],"workingHours":"string"}'

返回值

{"msg":"string","code":0,"data":{}}

14)员工报工专员新增

员工报工专员新增

接口描述

员工报工专员新增

URL

/timeSheet/insertV3

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.param

object:InsertJobBookingVO

body

Y

param

1.1.attendanceType

string

N

1.2.beginTime

string

N

1.3.endTime

string

N

1.4.projectId

string

N

1.5.state

string

N

1.6.times

array:InsertJobBookingEnteyVO

N

1.6.1.attendanceType

string

N

1.6.2.workingHours

string

N

1.7.workingHours

string

N

2.token

string

header

Y

token

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{"attendanceType":"string","beginTime":"string","endTime":"string","projectId":"string","state":"string","times":[{"attendanceType":"string","workingHours":"string"}],"workingHours":"string"}'

返回值

{"msg":"string","code":0,"data":{}}

员工项目

1)员工项目

员工项目

接口描述

员工项目

URL

/timeSheet/getProjectList

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.id

string

query

N

项目id;不传查询员工所有项目信息

2.month

string

query

N

月份(yyyy-MM)

3.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

id=string&month=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

报工接口:3.10;3.12

13.10 指定日期驳回、通过

3.10 指定日期驳回、通过

接口描述

3.10 指定日期驳回、通过

URL

/timeSheet/appProjectOnDate

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.cancelOnDateVO

object:CancelOnDateVO

body

Y

cancelOnDateVO

1.1.detailId

string

N

1.2.status

integer(int32)

N

1.3.timeSheetId

string

N

2.token

string

header

Y

token

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{"detailId":"string","status":0,"timeSheetId":"string"}'

返回值

{"msg":"string","code":0,"data":{}}

23.12 员工指定日期撤回

3.12 员工指定日期撤回

接口描述

3.12 员工指定日期撤回

URL

/timeSheet/cancelOnDate

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.cancelOnDateVO

object:CancelOnDateVO

body

Y

cancelOnDateVO

1.1.detailId

string

N

1.2.status

integer(int32)

N

1.3.timeSheetId

string

N

2.token

string

header

Y

token

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{"detailId":"string","status":0,"timeSheetId":"string"}'

返回值

{"msg":"string","code":0,"data":{}}

33.13 员工修改报工数据

3.13 员工修改报工数据

接口描述

3.13 员工修改报工数据

URL

/timeSheet/update

请求方式

post

请求类型

application/json

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.token

string

header

Y

token

2.workSheetVO

object:WorkSheetVO

body

Y

workSheetVO

2.1.attendanceType

string

N

2.2.projectId

string

N

2.3.status

string

N

2.4.timeSheetId

string

N

2.5.workingHours

string

N

状态码

描述

说明

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

--header 'token:string' -d '{"attendanceType":"string","projectId":"string","status":"string","timeSheetId":"string","workingHours":"string"}'

返回值

{"msg":"string","code":0,"data":{}}

获取工作日历

1)获取工作日历

获取工作日历

接口描述

获取工作日历

URL

/timeSheet/getWorkCalendar

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.endDate

string

query

Y

结束日期

2.startDate

string

query

Y

开始日期

3.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

endDate=string&startDate=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

获取考勤类型:报工接口:3.4

1)获取考勤类型

获取考勤类型

接口描述

获取考勤类型

URL

/timeSheet/getAttendanceTypeList

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.state

string

query

N

state

2.token

string

header

Y

token

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

state=string --header 'token:string'

返回值

{"msg":"string","code":0,"data":{}}

飞书

1)构造网页授权链接

构造网页授权链接

接口描述

构造网页授权链接

URL

/feishu/timeSheet/getRedirectUri

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.redirect_uri

string

query

Y

redirect_uri

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

redirect_uri=string

返回值

{"msg":"string","code":0,"data":{}}

2)获取用户信息

获取用户信息

接口描述

获取用户信息

URL

/feishu/timeSheet/getUserInfo

请求方式

get

请求类型

返回类型

*/*

参数名

数据类型

参数类型

是否必填

说明

1.code

string

query

Y

code

2.redirect_uri

string

query

Y

redirect_uri

状态码

描述

说明

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

返回属性名

类型

说明

1.code

integer(int32)

2.data

object

3.msg

string

示例

请求参数

code=string&redirect_uri=string

返回值

{"msg":"string","code":0,"data":{}}