Attendance API

Attendance API로 부재 항목과 연차 정보 조회/수정/삭제, 부재 일정 정보 조회, 출퇴근 정보 조회/등록/수정, 사용자 출근/퇴근, 상태 조회를 할 수 있다.

Attendance API를 호출하려면 구성원 계정 또는 서비스 계정으로 인증하여 얻은 Access Token이 필요하다. API Scope는 businessSupport.attendance, businessSupport.attendance.read이다.

부재 항목 관리 {#manage-absence}

다음 API로 부재 항목을 관리할 수 있다.

HTTP RequestDescription
POST /business-support/attendance/absences부재 항목 추가
GET /business-support/attendance/absences부재 항목 목록 조회
GET /business-support/attendance/absences/{absenceId}부재 항목 조회
PATCH /business-support/attendance/absences/{absenceId}부재 항목 부분 수정
DELETE /business-support/attendance/absences/{absenceId}부재 항목 삭제

부재 일정 목록 조회 {#search-absence-schedule}

결재로 생성된 부재 일정 목록을 조회한다.

HTTP RequestDescription
GET /business-support/attendance/absence-schedule부재 일정 목록 조회

부재 일정은 결재 문서로 생성/수정/삭제하므로 Attendance API로는 조회만 할 수 있다.
부재 일정 조회 시 파라미터로 부재 시작일(fromDate)과 부재 종료일(toDate)을 필수로 입력받는다.

연차 관리 {#manage-annual-leave}

사용자에게 부여된 현재 차수의 연차 정보를 조회한다.

HTTP RequestDescription
GET /business-support/business-support/attendance/annual-leaves연차 정보 목록 조회

조정 연차 수정 {#annual-leave-adjust}

사용자에게 부여된 현재 차수의 조정 연차를 수정한다.

HTTP RequestDescription
POST /business-support/attendance/annual-leaves/adjust조정 연차 수정

연차 정보는 조정 연차(adjustmentCount)로만 수정할 수 있다.

{   "userId": "10000001",   "adjustmentCount" : 5}

출퇴근 정보 {#manage-timecard}

다음 API로 출퇴근 정보를 관리할 수 있다.

HTTP RequestDescription
POST /business-support/attendance/timecards출퇴근 정보 등록
GET /business-support/attendance/timecards출퇴근 정보 목록 조회
GET /business-support/attendance/timecards/{timecardId}출퇴근 정보 조회
PATCH /business-support/attendance/timecards/{timecardId}출퇴근 정보 수정
GET /business-support/attendance/users/{userId}/status사용자 출퇴근 상태 조회
POST /business-support/attendance/users/{userId}/clock-in사용자 출근하기
POST /business-support/attendance/users/{userId}/clock-out사용자 퇴근하기