Employee Discount Limit Management

Upload Excel for Employee Bulk Registration

post

Function Description

• Validates the Excel file containing employee information to be registered.

---

Detailed Description

• Checks whether any columns are missing.

• Checks whether the employee number is already registered.

• Checks whether the member number matches the name and ID.

• Checks whether the member is already an employee.

• Checks for duplicate member numbers or employee numbers within the Excel data.

---

Revision History

• Release v1.03_231106: Initial development of employee bulk registration

Authorizations

Bodyobject · StaffManyRegistResponse[]

Employee Bulk Registration Response

mbrNostringOptional

Member No.

Example: 1000001

loginIdstringOptional

Member ID

Example: x2bee

mbrNmstringOptional

Member Name

Example: 홍길동

stafMgrNostringOptional

Employee No.

Example: 10001

comGbCdstring · enumOptional

Company Classification Code (ME038)

Example: P00Possible values:

comGbNmstringOptional

Company Name

Example: 플래티어

errorMsgstringOptional

Error Message

Example: 임직원 기등록

Responses

200

Success

*/*

Employee Bulk Registration Response

mbrNostringOptional

Member No.

Example: 1000001

loginIdstringOptional

Member ID

Example: x2bee

mbrNmstringOptional

Member Name

Example: 홍길동

stafMgrNostringOptional

Employee No.

Example: 10001

comGbCdstring · enumOptional

Company Classification Code (ME038)

Example: P00Possible values:

comGbNmstringOptional

Company Name

Example: 플래티어

errorMsgstringOptional

Error Message

Example: 임직원 기등록

900

Business processing error details

*/*

post/v1/member/staffDcLimMgmt/staffLoadByExcel

POST /api/bo/v1/member/staffDcLimMgmt/staffLoadByExcel HTTP/1.1
Host: api-bo.x2bee.com/
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": "임직원 기등록"
  }
]

Retrieve Employee Discount Limit Usage History

get

Function Description

• Retrieves the discount limit usage history list of the selected employee.

---

Detailed Description

• Retrieves the discount limit usage history list of the selected employee.

---

Revision History

• Release v1.03_231106: Initial development of employee discount limit

Authorizations

Query parameters

mbrNostringOptional

Member No.

comGbCdstringOptional

Company Classification Code

langCdstringOptional

Language Code

rsrvUseYearstringOptional

Usage/Accrual Year

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

get/v2/member/staffDcLimMgmt/getStaffDcLimUseHistList

GET /api/bo/v2/member/staffDcLimMgmt/getStaffDcLimUseHistList?staffDcLimUseHistRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "rsrvUseGbNm": "사용",
      "ocurAmt": 100,
      "ordNo": "20231019O062153",
      "claimNo": "20231022C021442",
      "useDtm": "2023-10-12 09:30:15"
    }
  ]
}

Retrieve Employee Discount Limit Remaining Mileage

get

Function Description

• Retrieves the remaining discount limit mileage of the selected employee.

---

Detailed Description

• Retrieves the remaining discount limit mileage of the selected employee.

---

Revision History

• Release v1.03_231106: Initial development of employee discount limit

Authorizations

Query parameters

mbrNostringOptional

Member No.

comGbCdstringOptional

Company Classification Code

Responses

200

Success

*/*

numberOptional

900

Business processing error details

*/*

get/v2/member/staffDcLimMgmt/getStaffDcLimRemainMileage

GET /api/bo/v2/member/staffDcLimMgmt/getStaffDcLimRemainMileage?staffDcLimUseHistRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Accept: */*

1

Retrieve Employee Discount Limit List

get

Function Description

• Retrieves the employee discount limit list according to the conditions selected on screen.

---

Detailed Description

• Retrieves the employee discount limit list according to the conditions selected on screen.

---

Revision History

• Release v1.03_231106: Initial development of employee discount limit

Authorizations

Query parameters

condxMbrOptstringOptional

Search Target: Employee No., Member Name, Member No.

condxMbrValuestringOptional

Corresponding Input Value

condxCompanyCdstringOptional

Company Classification Code

useYnstringOptional

Search Type

Responses

200

Success

*/*

totalCountinteger · int32Optional

900

Business processing error details

*/*

get/v2/member/staffDcLimMgmt/getStaffDcLimList

GET /api/bo/v2/member/staffDcLimMgmt/getStaffDcLimList?staffDcLimRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "mbrNo": 1000001,
      "loginId": "x2bee",
      "mbrNm": "홍길동",
      "stafMgrNo": 10001,
      "mbrMgrNm": "소셜회원",
      "comGbCd": "P00",
      "comGbNm": "플래티어",
      "rmndAmt": 10000000,
      "limAmt": 1000000,
      "useYn": "Y",
      "sysRegId": "x2bee",
      "sysRegDtm": "2023-09-07 09:37:25",
      "sysModId": "x2bee",
      "sysModDtm": "2023-09-07 09:37:25",
      "siteNm": "x2bee"
    }
  ]
}