임직원 관리

임직원 일괄등록

post

기능설명

• 임직원 일괄등록을 진행하고 결과 데이터를 반환합니다.

---

상세설명

• 요청 값으로 넘어온 데이터 중 에러 메시지가 없는 데이터만 등록을 진행합니다.

• 이미 임직원으로 등록되어 있으면 등록이 불가능 합니다.

• 요청 데이터의 사번이 이미 등록되어 있으면 등록이 불가능 합니다.

• SQL 예외 발생 시 에러 메시지에 예외 메시지 값을 넣어 반환합니다.

---

수정번호

• Release v1.03_231106: 임직원 일괄등록 최초 개발

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Bodyobject[]

application/json

임직원 일괄등록 Response

mbrNostringOptional

회원번호

Example: 1000001

loginIdstringOptional

회원ID

Example: x2bee

mbrNmstringOptional

회원명

Example: 홍길동

stafMgrNostringOptional

사번

Example: 10001

comGbCdstring · enumOptional

회사구분코드(ME038)

Example: P00Possible values:

comGbNmstringOptional

회사명

Example: 플래티어

errorMsgstringOptional

에러 메시지

Example: 임직원 기등록

Responses

200

성공

*/*

임직원 일괄등록 Response

mbrNostringOptional

회원번호

Example: 1000001

loginIdstringOptional

회원ID

Example: x2bee

mbrNmstringOptional

회원명

Example: 홍길동

stafMgrNostringOptional

사번

Example: 10001

comGbCdstring · enumOptional

회사구분코드(ME038)

Example: P00Possible values:

comGbNmstringOptional

회사명

Example: 플래티어

errorMsgstringOptional

에러 메시지

Example: 임직원 기등록

900

업무처리 오류 내용

*/*

post

/v1/member/staffMgmt/staffManyRegist

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/staffMgmt/staffManyRegist HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 149

[
  {
    "mbrNo": 1000001,
    "loginId": "x2bee",
    "mbrNm": "홍길동",
    "stafMgrNo": 10001,
    "comGbCd": "P00",
    "comGbNm": "플래티어",
    "errorMsg": "임직원 기등록"
  }
]

[
  {
    "mbrNo": 1000001,
    "loginId": "x2bee",
    "mbrNm": "홍길동",
    "stafMgrNo": 10001,
    "comGbCd": "P00",
    "comGbNm": "플래티어",
    "errorMsg": "임직원 기등록"
  }
]

임직원 해제

post

기능설명

• 화면에서 선택한 회원의 임직원을 해제 처리합니다.

---

상세설명

• 화면에서 선택한 회원의 임직원을 해제 처리합니다.

---

수정번호

• Release v1.03_231106: 임직원 해제 처리 시 임직원 할인한도 테이블 USE_YN 값 'N'으로 UPDATE

• Release v2.00_250314: 회사 임직원이었다가 임직원 해제 시, 포인트 초기화

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

임직원 해제 Request

mbrNoListstring[]Optional

회원번호 리스트

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/member/staffMgmt/deleteMbrStaff

HTTPcURLJavaScriptPython

POST /api/bo/v1/member/staffMgmt/deleteMbrStaff HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "mbrNoList": [
    "text"
  ]
}

No content

임직원 목록 조회

get

기능설명

• 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.

---

상세설명

• 화면에서 선택한 조건에 따라 임직원 목록을 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

condxMbrOptstringOptional

조회 타입

condxMbrValuestringOptional

입력 값

condxCompanyCdstringOptional

회사구분코드

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v2/member/staffMgmt/getStaffList

HTTPcURLJavaScriptPython

GET /api/bo/v2/member/staffMgmt/getStaffList?staffMgmtSearchRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "sysRegDtm": "text",
      "sysRegId": "text",
      "sysModDtm": "text",
      "sysModId": "text",
      "rowsPerPage": 1,
      "pageIdx": 1,
      "endPage": true,
      "mbrNo": 10000001,
      "mbrGbNm": "일반회원",
      "mbrNm": "홍길동",
      "comGbNm": "플래티어",
      "comGbCd": "P00",
      "mbrStatNm": "정상회원",
      "loginId": "x2bee12",
      "emailAddr": "[e-mail]",
      "cellNo": "010-1234-1234",
      "stafMgrNo": 12345678,
      "siteNm": "x2bee"
    }
  ]
}