발령

설명

직급/직책/부서이동/겸직/리포트 투/부서장/고용형태/퇴직/겸직/휴직/복직에 대한 발령(임명/해제)를 처리합니다.

임명/변경/해제 발령 API

직급/직책/부서이동/겸직/리포트 투/부서장/고용형태/퇴직/겸직/휴직/복직 임명/해제/변경

요청 URL

POST https://workplace.apigw.ntruss.com/organization/apigw/v1/company/{companyId}/appointment/{externalKey}/{appoint:GRADE|JOB|EMPLOYEE_TYPE|LEADER|DEPARTMENT|CONCURRENT|LEAVE|REINSTATEMENT|RETIRE|REPORT_TO}

요청 헤더

헤더명 설명
x-ncp-apigw-timestamp 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며
API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주

x-ncp-apigw-timestamp:{Timestamp}
x-ncp-apigw-api-key APIGW에서 발급받은 키 값
x-ncp-apigw-api-key:{API Gateway API Key}
x-ncp-iam-access-key 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Account Access Key}
x-ncp-apigw-signature-v1 Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v1:{API Gateway Signature}
Content-Type Request body content type을 application/json으로 지정
Content-Type: application/json

요청 Path 파라미터

파라미터 타입 크기 필수 여부 설명
companyId String 36 Y 연동키(CompanyId) Developers > 기본 설정 > 연동키
appoint String - Y 발령 파라미터
externalKey String 100 Y 발령 시퀀스 외부키(중복 불가)

요청 Body 파라미터

파라미터 타입 크기 필수 여부 설명
companyId String 36 Y 연동키(CompanyId) Developers > 기본 설정 > 연동키
appoint String - Y 발령 파라미터
sourceEmp String 100 Y 사원 외부키
changedData String 100 Y 변경 데이터 외부키직급/직책/부서장/겸직/고용형태 발령 해제 시, 'CLEAR'로 입력
appointType String 100 Y 임명 종류겸직/부서장/리포트 투 발령일 경우 필수값

예를 들면, 직급 변경 시 변경 데이터 외부키에는 직급 외부키를 입력 직책 변경 시 변경 데이터 외부키에는 직책 외부키를 입력

요청 예시

POST https://workplace.apigw.ntruss.com/organization/apigw/v1/company/578c7009-bdad-4493-9835-72302cf988c6/appointment/concurrent001/CONCURRENT

POST /organization/apigw/v1/company/578c7009-bdad-4493-9835-72302cf988c6/appointment/concurrent001/CONCURRENT
HOST: workplace.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp: 1505290625682
x-ncp-apigw-api-key: DUxjP4HYTP8V7khBkgywdDHQjKuaYWGrppHKpvdv
x-ncp-iam-access-key: D78BB444D6D3C84CA38A
x-ncp-apigw-signature-v1: WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=

{
  "companyId":"578c7009-bdad-4493-9835-72302cf988c6",
  "sourceEmp" : "emp00001",
  "changedData": "nbp00002",
  "appointType": "APPO",
  "appointmentDate" : "",
  "appointmentToDate" : ""
}

응답 예시

{
  "timestamp": "2019-12-10 11:24:44",
  "status": 200,
  "error": null,
  "message": null,
  "path": "/organization/apigw/v1/company/578c7009-bdad-4493-9835-72302cf988c6/appointment/concurrent001/CONCURRENT",
  "body": {
    "companyId": "578c7009-bdad-4493-9835-72302cf988c6",
    "sourceEmp": "emp00001",
    "changedData": "nbp00002",
    "appointType": "APPO",
    "appointmentId": "concurrent006",
    "appointmentDate" : "",
    "appointmentToDate" : ""
  }
}

취소 발령 API

고객사 사원의 발령 내역을 취소 처리합니다.

요청 URL

DELETE https://workplace.apigw.ntruss.com/organization/apigw/v1/company/{companyId}/appointment/{externalKey}/{appoint:GRADE|JOB|EMPLOYEE_TYPE|LEADER|DEPARTMENT|CONCURRENT|LEAVE|REINSTATEMENT|RETIRE|REPORT_TO}

요청 헤더

헤더명 설명
x-ncp-apigw-timestamp 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며
API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주

x-ncp-apigw-timestamp:{Timestamp}
x-ncp-apigw-api-key APIGW에서 발급받은 키 값
x-ncp-apigw-api-key:{API Gateway API Key}
x-ncp-iam-access-key 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
x-ncp-iam-access-key:{Account Access Key}
x-ncp-apigw-signature-v1 Access Key ID 값과 Secret Key로 암호화한 서명
x-ncp-apigw-signature-v1:{API Gateway Signature}
Content-Type Request body content type을 application/json으로 지정
Content-Type: application/json

요청 Path 파라미터

파라미터 타입 크기 필수 여부 설명
companyId String 36 Y 연동키(CompanyId) Developers > 기본 설정 > 연동키
appoint String - Y 발령 파라미터
externalKey String 100 Y 발령 시퀀스 외부키(중복 불가)

요청 예시

DELETE https://workplace.apigw.ntruss.com/organization/apigw/v1/company/578c7009-bdad-4493-9835-72302cf988c6/appointment/concurrent001/CONCURRENT

DELETE /organization/apigw/v1/company/578c7009-bdad-4493-9835-72302cf988c6/appointment/concurrent001/CONCURRENT
HOST: workplace.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp: 1505290625682
x-ncp-apigw-api-key: DUxjP4HYTP8V7khBkgywdDHQjKuaYWGrppHKpvdv
x-ncp-iam-access-key: D78BB444D6D3C84CA38A
x-ncp-apigw-signature-v1: WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=

응답 예시

{
  "timestamp": "2019-12-10 11:24:44",
  "status": 200,
  "error": null,
  "message": null,
  "path": "/organization/apigw/v1/company/578c7009-bdad-4493-9835-72302cf988c6/appointment/concurrent001/CONCURRENT",
  "body": {
    "companyId": "578c7009-bdad-4493-9835-72302cf988c6",
    "sourceEmp": "emp00001",
    "changedData": "nbp00002",
    "appointType": "CANCEL",
    "appointmentId": "concurrent006",
    "appointmentDate" : "",
    "appointmentToDate" : ""
  }
}

발령 종류 별 파라미터

파라미터 설명 appointType changedData appointmentDate appointmentToDate
CONCURRENT 겸직 APPO / REMOVE 부서 외부키 - -
LEADER 부서장 APPO / REMOVE 부서 외부키 - -
REPORT_TO 리포트 투 APPO / REMOVE 사원 외부키 - -
LEAVE 휴직 - - 휴직 시작일(API호출시점 자동부여) 복직 예정일(yyyy-MM-dd)
REINSTATEMENT 복직 - - 복직일(API호출시점 자동부여) -
RETIRE 퇴직 - - 퇴직일(API호출시점 자동부여) -
GRADE 직급 CHANGED 직급 외부키, 삭제 시, “changedData” : “CLEAR” - -
JOB 직급 CHANGED 직책 외부키, 삭제 시, “changedData” : “CLEAR” - -
EMPLOYEE_TYPE 고용형태 CHANGED 고용형태 외부키, 삭제 시, “changedData” : “CLEAR” - -
DEPARTMENT 부서이동 CHANGED 부서 외부키 - -