POST/business-support/attendance/absences

부재 항목을 추가한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증를 참고한다.

Scope

businessSupport.attendance

HTTP Request

POSThttps://www.worksapis.com/v1.0/business-support/attendance/absences

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required 

Request Body

PropertyTypeDescription
absenceName string 

부재 항목 명


required 
i18nNames array (i18nName) 

다국어 목록 정보.
Admin > 기본환경 > 회사 정보 > 다국어 설정에서 지정된 항목의 다국어만 표시된다.

 
leaveType string 

휴가 구분

  • NONE: 해당 없음
  • ANNUAL_LEAVE: 연차
  • BUSINESS_TRIP: 출장
  • FAMILY_EVENT: 경조
  • SPECIAL_LEAVE: 특별휴가

required
Allowed values : NONE, ANNUAL_LEAVE, BUSINESS_TRIP, FAMILY_EVENT, SPECIAL_LEAVE 
timeUnit string 

부재 사용 시간 단위

  • ADAY: 종일
  • HALF_DAY: 반일
  • ONE_HOUR: 1시간
  • TWO_HOURS: 2시간
  • HALF_HOUR: 30분

required
Allowed values : ADAY, HALF_DAY, ONE_HOUR, TWO_HOURS, HALF_HOUR 
isWorkingHours boolean 

근로 시간에 합산 여부


default : false 
isActualWork boolean 

실제 근로 여부


default : false 
isAllowExceedStandardHours boolean 

기준 근로 시간 초과 연차 사용 허용 여부


default : false 
isIncludeAnnualCalculation boolean 

연차 산정 출근 일수 포함 여부

 
enabled boolean 

사용 여부


default : false 
displayOrder integer 

노출 순서


format : int32 

i18nName

PropertyTypeDescription
name string 

다국어 이름


required
minLength : 1
maxLength : 100 
language string 

다국어 언어 코드


required
Allowed values : ko_KR, en_US, ja_JP, zh_CN, zh_TW 

Response

HTTP 201

부재 항목

PropertyTypeDescription
absenceId string 

부재 항목 ID

 
absenceName string 

부재 항목 명


required 
i18nNames array (i18nName) 

다국어 목록 정보.
Admin > 기본환경 > 회사 정보 > 다국어 설정에서 지정된 항목의 다국어만 표시된다.

 
leaveType string 

휴가 구분

  • NONE: 해당 없음
  • ANNUAL_LEAVE: 연차
  • BUSINESS_TRIP: 출장
  • FAMILY_EVENT: 경조
  • SPECIAL_LEAVE: 특별휴가

required
Allowed values : NONE, ANNUAL_LEAVE, BUSINESS_TRIP, FAMILY_EVENT, SPECIAL_LEAVE 
timeUnit string 

부재 사용 시간 단위

  • ADAY: 종일
  • HALF_DAY: 반일
  • ONE_HOUR: 1시간
  • TWO_HOURS: 2시간
  • HALF_HOUR: 30분

required
Allowed values : ADAY, HALF_DAY, ONE_HOUR, TWO_HOURS, HALF_HOUR 
isWorkingHours boolean 

근로 시간에 합산 여부


default : false 
isActualWork boolean 

실제 근로 여부


default : false 
isAllowExceedStandardHours boolean 

기준 근로 시간 초과 연차 사용 허용 여부
leaveType이 ANNUAL_LEAVE(연차)인 경우만 적용되는 옵션


default : false 
isIncludeAnnualCalculation boolean 

연차 산정 출근 일수 포함 여부

 
enabled boolean 

사용 여부


default : false 
displayOrder integer 

노출 순서


format : int32 

i18nName

PropertyTypeDescription
name string 

다국어 이름


required
minLength : 1
maxLength : 100 
language string 

다국어 언어 코드


required
Allowed values : ko_KR, en_US, ja_JP, zh_CN, zh_TW 

Response Example

Example

1{2  "absenceId": "97e1ef5c-1f35-4f64-81cc-65074ef3e26c",3  "absenceName": "연차",4  "i18nNames": [5    {6      "language": "ja_JP",7      "name": "年次"8    },9    {10      "language": "en_US",11      "name": "Annual"12    }13  ],14  "leaveType": "ANNUAL_LEAVE",15  "timeUnit": "ADAY",16  "displayOrder": 1,17  "isActualWork": false,18  "isWorkingHours": true,19  "isAllowExceedStandardHours": false,20  "isIncludeAnnualCalculation": false,21  "enabled": true22}