옵션 정보 관리

옵션 코드 목록 저장

post

기능설명

• 옵션 코드 목록 저장 API 입니다.

---

상세설명

• 옵션 코드 정보 목록을 저장합니다.

---

특이사항

• 옵션명 수정 시 단품 옵션 정보의 옵션명도 수정됩니다.

---

검증내용

• 저장 시 옵션 코드 정보의 유효성을 검증합니다.

  • 필수 입력: 옵션명, 정렬순서, 사용여부, 옵션분류번호, 시스템 등록자 ID

---

수정번호

Release v1.03_231106: 옵션 정보 관리 내 옵션코드목록에서 이미지추가 및 RGB값 등록 기능 신규 추가, 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

옵션 코드 목록 저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

옵션 코드 목록 저장 실패

*/*

post/v1/goods/optionMgmtApi/saveOptionList

HTTPcURLJavaScriptPython

POST /api/bo/v1/goods/optionMgmtApi/saveOptionList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 582

{
  "all": [
    {
      "optnCatNo": "1000",
      "optnNo": "001",
      "optnNm": "옵션명",
      "sortSeq": 1,
      "useYn": "Y",
      "imgPathNm": "text",
      "imgFileNm": "text",
      "rgbVal": "text"
    }
  ],
  "create": [
    {
      "optnCatNo": "1000",
      "optnNo": "001",
      "optnNm": "옵션명",
      "sortSeq": 1,
      "useYn": "Y",
      "imgPathNm": "text",
      "imgFileNm": "text",
      "rgbVal": "text"
    }
  ],
  "update": [
    {
      "optnCatNo": "1000",
      "optnNo": "001",
      "optnNm": "옵션명",
      "sortSeq": 1,
      "useYn": "Y",
      "imgPathNm": "text",
      "imgFileNm": "text",
      "rgbVal": "text"
    }
  ],
  "delete": [
    {
      "optnCatNo": "1000",
      "optnNo": "001",
      "optnNm": "옵션명",
      "sortSeq": 1,
      "useYn": "Y",
      "imgPathNm": "text",
      "imgFileNm": "text",
      "rgbVal": "text"
    }
  ]
}

{
  "timestamp": "2026-07-14T09:23:04.861Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

옵션 분류 코드 목록 저장

post

기능설명

• 옵션 분류 코드 목록 저장 API 입니다.

---

상세설명

• 옵션 분류 코드 정보 목록을 저장합니다.

---

특이사항

• 옵션 분류명 수정 시 단품 옵션 정보의 옵션 분류명도 수정됩니다.

---

검증내용

• 저장 시 옵션 분류 코드 정보의 유효성을 검증합니다.

  • 필수 입력: 옵션분류등록구분코드, 옵션분류유형, 옵션분류명, 정렬순서, 사용여부, 시스템 등록자 ID, 협력사번호(옵션분류등록구분코드 '협력사전용'인 경우)

• 옵션분류명은 중복이 불가합니다.

  • 중복 기준: 옵션분류등록구분코드, 옵션분류유형코드, 옵션분류명, 협력사번호(옵션분류등록구분코드 '협력사전용'인 경우)

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

Responses

200

옵션 분류 코드 목록 저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

옵션 분류 코드 목록 저장 실패

*/*

post/v1/goods/optionMgmtApi/saveOptionCategoryList

HTTPcURLJavaScriptPython

POST /api/bo/v1/goods/optionMgmtApi/saveOptionCategoryList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 586

{
  "all": [
    {
      "optnCatNo": "1000",
      "optnCatNm": "옵션분류명",
      "optnCatRegGbCd": "01",
      "entrNo": "1000001",
      "optnCatTypCd": "10",
      "sortSeq": 1,
      "useYn": "Y"
    }
  ],
  "create": [
    {
      "optnCatNo": "1000",
      "optnCatNm": "옵션분류명",
      "optnCatRegGbCd": "01",
      "entrNo": "1000001",
      "optnCatTypCd": "10",
      "sortSeq": 1,
      "useYn": "Y"
    }
  ],
  "update": [
    {
      "optnCatNo": "1000",
      "optnCatNm": "옵션분류명",
      "optnCatRegGbCd": "01",
      "entrNo": "1000001",
      "optnCatTypCd": "10",
      "sortSeq": 1,
      "useYn": "Y"
    }
  ],
  "delete": [
    {
      "optnCatNo": "1000",
      "optnCatNm": "옵션분류명",
      "optnCatRegGbCd": "01",
      "entrNo": "1000001",
      "optnCatTypCd": "10",
      "sortSeq": 1,
      "useYn": "Y"
    }
  ]
}

{
  "timestamp": "2026-07-14T09:23:04.861Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

직접 입력 옵션 마스터 저장

post

기능설명

• 옵션 정보 그리드에서 직접 입력한 옵션을 협력사 마스터(PR_OPTN_CLSS_CD / PR_OPTN_CD)에 영구 등록합니다.

---

상세설명

• optnCatRegGbCd='02'(협력사전용), 지정한 entrNo / optnCatTypCd 로 분류 코드 신규 INSERT.

• 응답의 optnCatNo / optnNo 로 그리드 sentinel ID 를 교체하여 이후 저장은 master-linked 경로로 처리됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

직접 입력 옵션 마스터 저장 Request

langCdstringOptional

언어코드

Default: ko

optnCatRegGbCdstringRequired

옵션분류등록구분코드(PR018) — 01:공통(BO), 02:협력사전용(PO)

entrNostringOptional

협력사번호 — optnCatRegGbCd='02'(협력사전용)일 때 필수

optnCatTypCdstringRequired

옵션분류유형코드(PR019)

optnCatNmstringRequired

옵션분류명

sortSeqinteger · int32Optional

정렬순서 (기본값 0)

Responses

200

저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

저장 실패

*/*

post/v1/goods/optionMgmtApi/saveCustomOption

HTTPcURLJavaScriptPython

POST /api/bo/v1/goods/optionMgmtApi/saveCustomOption HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 139

{
  "langCd": "ko",
  "optnCatRegGbCd": "text",
  "entrNo": "text",
  "optnCatTypCd": "text",
  "optnCatNm": "text",
  "sortSeq": 1,
  "optnList": [
    {
      "optnNm": "text"
    }
  ]
}

{
  "timestamp": "2026-07-14T09:23:04.861Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "optnCatNo": "text",
    "optnList": [
      {
        "optnNo": "text",
        "optnNm": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

옵션코드 목록 조회

get

기능설명

• 옵션 코드 목록 조회 API 입니다.

---

상세설명

• 옵션 분류 번호 기준으로 옵션 코드 정보 목록을 조회합니다.

  • 정렬순서 오름차순, 수정일시 내림차순으로 정렬합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

langCdstringOptional

언어코드

optnCatNostringRequired

옵션분류번호

Responses

200

옵션코드 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

옵션코드 목록 조회 실패

*/*

get/v1/goods/optionMgmtApi/getOptionList

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/optionMgmtApi/getOptionList?optnCatNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-07-14T09:23:04.861Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "langCd": "text",
        "optnCatNo": "text",
        "optnCatRegGbCd": "text",
        "entrNo": "text",
        "optnCatTypCd": "text",
        "optnCatNm": "text",
        "sortSeq": 1,
        "useYn": "text",
        "optnCatRegGbCdNm": "text",
        "optnCatTypCdNm": "text",
        "entrNm": "text",
        "optnNo": "text",
        "optnNm": "text",
        "addOptnNm": "text",
        "imgPathNm": "text",
        "imgFileNm": "text",
        "rgbVal": "text",
        "totalCount": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

옵션 분류 코드 목록 조회

get

기능설명

• 옵션 분류 코드 목록 조회 API 입니다.

---

상세설명

• 옵션 분류 코드 정보 목록을 조회합니다.

  • 정렬순서 오름차순, 수정일시 내림차순으로 정렬됩니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

옵션 분류 코드 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

옵션 분류 코드 목록 조회 실패

*/*

get/v1/goods/optionMgmtApi/getOptionCategoryList

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/optionMgmtApi/getOptionCategoryList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-07-14T09:23:04.861Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "langCd": "text",
        "optnCatNo": "text",
        "optnCatRegGbCd": "text",
        "entrNo": "text",
        "optnCatTypCd": "text",
        "optnCatNm": "text",
        "sortSeq": 1,
        "useYn": "text",
        "optnCatRegGbCdNm": "text",
        "optnCatTypCdNm": "text",
        "entrNm": "text",
        "optnNo": "text",
        "optnNm": "text",
        "addOptnNm": "text",
        "imgPathNm": "text",
        "imgFileNm": "text",
        "rgbVal": "text",
        "totalCount": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}