# 옵션 정보 관리
## 옵션 코드 목록 저장
> \## 기능설명\
> \* 옵션 코드 목록 저장 API 입니다.\
> \---\
> \## 상세설명\
> \* 옵션 코드 정보 목록을 저장합니다.\
> \---\
> \## 특이사항\
> \* 옵션명 수정 시 단품 옵션 정보의 옵션명도 수정됩니다.\
> \---\
> \## 검증내용\
> \* 저장 시 옵션 코드 정보의 유효성을 검증합니다.\
> \* 필수 입력: 옵션명, 정렬순서, 사용여부, 옵션분류번호, 시스템 등록자 ID\
> \---\
> \## 수정번호\
> \`\`\`Release v1.03\_231106\`\`\`: 옵션 정보 관리 내 옵션코드목록에서 이미지추가 및 RGB값 등록 기능 신규 추가,\
> 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestPrOptnCd":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnCd"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnCd"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnCd"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnCd"}}}},"PrOptnCd":{"type":"object","description":"옵션코드","properties":{"optnCatNo":{"type":"string","default":"1000","description":"옵션분류번호"},"optnNo":{"type":"string","default":"001","description":"옵션번호"},"optnNm":{"type":"string","default":"옵션명","description":"옵션명"},"sortSeq":{"type":"integer","format":"int32","default":1,"description":"정렬순서"},"useYn":{"type":"string","default":"Y","description":"사용여부"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/optionMgmtApi/saveOptionList":{"post":{"tags":["옵션 정보 관리"],"summary":"옵션 코드 목록 저장","description":"## 기능설명\n* 옵션 코드 목록 저장 API 입니다.\n---\n## 상세설명\n* 옵션 코드 정보 목록을 저장합니다.\n---\n## 특이사항\n* 옵션명 수정 시 단품 옵션 정보의 옵션명도 수정됩니다.\n---\n## 검증내용\n* 저장 시 옵션 코드 정보의 유효성을 검증합니다.\n * 필수 입력: 옵션명, 정렬순서, 사용여부, 옵션분류번호, 시스템 등록자 ID\n---\n## 수정번호\n```Release v1.03_231106```: 옵션 정보 관리 내 옵션코드목록에서 이미지추가 및 RGB값 등록 기능 신규 추가,\n이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가\n","operationId":"saveOptionList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestPrOptnCd"}}},"required":true},"responses":{"200":{"description":"옵션 코드 목록 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"옵션 코드 목록 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
## 옵션 분류 코드 목록 저장
> \## 기능설명\
> \* 옵션 분류 코드 목록 저장 API 입니다.\
> \---\
> \## 상세설명\
> \* 옵션 분류 코드 정보 목록을 저장합니다.\
> \---\
> \## 특이사항\
> \* 옵션 분류명 수정 시 단품 옵션 정보의 옵션 분류명도 수정됩니다.\
> \---\
> \## 검증내용\
> \* 저장 시 옵션 분류 코드 정보의 유효성을 검증합니다.\
> \* 필수 입력: 옵션분류등록구분코드, 옵션분류유형, 옵션분류명, 정렬순서, 사용여부, 시스템 등록자 ID, 협력사번호(옵션분류등록구분코드 '협력사전용'인 경우)\
> \* 옵션분류명은 중복이 불가합니다.\
> \* 중복 기준: 옵션분류등록구분코드, 옵션분류유형코드, 옵션분류명, 협력사번호(옵션분류등록구분코드 '협력사전용'인 경우)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestPrOptnClssCd":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnClssCd"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnClssCd"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnClssCd"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrOptnClssCd"}}}},"PrOptnClssCd":{"type":"object","description":"옵션분류코드","properties":{"optnCatNo":{"type":"string","default":"1000","description":"옵션분류번호"},"optnCatNm":{"type":"string","default":"옵션분류명","description":"옵션분류명"},"optnCatRegGbCd":{"type":"string","default":"01","description":"옵션분류등록구분코드(PR018) 01:공통, 02:협력사전용"},"entrNo":{"type":"string","default":"1000001","description":"협력사번호"},"optnCatTypCd":{"type":"string","default":"10","description":"옵션분류유형코드(PR019) 10:색상, 11:크기, 12:중량, 13:용량, 14:지역, 15:의류사이즈, 17:모니터종류, 18:모니터크기, 19:모니터해상도, 20:카메라색상, 21:카메라해상도, 22:식품중량, 23:식품용량"},"sortSeq":{"type":"integer","format":"int32","default":1,"description":"정렬순서"},"useYn":{"type":"string","default":"Y","description":"사용여부"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/optionMgmtApi/saveOptionCategoryList":{"post":{"tags":["옵션 정보 관리"],"summary":"옵션 분류 코드 목록 저장","description":"## 기능설명\n* 옵션 분류 코드 목록 저장 API 입니다.\n---\n## 상세설명\n* 옵션 분류 코드 정보 목록을 저장합니다.\n---\n## 특이사항\n* 옵션 분류명 수정 시 단품 옵션 정보의 옵션 분류명도 수정됩니다.\n---\n## 검증내용\n* 저장 시 옵션 분류 코드 정보의 유효성을 검증합니다.\n * 필수 입력: 옵션분류등록구분코드, 옵션분류유형, 옵션분류명, 정렬순서, 사용여부, 시스템 등록자 ID, 협력사번호(옵션분류등록구분코드 '협력사전용'인 경우)\n* 옵션분류명은 중복이 불가합니다.\n * 중복 기준: 옵션분류등록구분코드, 옵션분류유형코드, 옵션분류명, 협력사번호(옵션분류등록구분코드 '협력사전용'인 경우)\n","operationId":"saveOptionCategoryList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestPrOptnClssCd"}}},"required":true},"responses":{"200":{"description":"옵션 분류 코드 목록 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"옵션 분류 코드 목록 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 직접 입력 옵션 마스터 저장
> \## 기능설명\
> \* 옵션 정보 그리드에서 직접 입력한 옵션을 협력사 마스터(PR\_OPTN\_CLSS\_CD / PR\_OPTN\_CD)에 영구 등록합니다.\
> \---\
> \## 상세설명\
> \* optnCatRegGbCd='02'(협력사전용), 지정한 entrNo / optnCatTypCd 로 분류 코드 신규 INSERT.\
> \* 응답의 optnCatNo / optnNo 로 그리드 sentinel ID 를 교체하여 이후 저장은 master-linked 경로로 처리됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"SaveCustomOptionRequest":{"type":"object","description":"직접 입력 옵션 마스터 저장 Request","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드"},"optnCatRegGbCd":{"type":"string","description":"옵션분류등록구분코드(PR018) — 01:공통(BO), 02:협력사전용(PO)"},"entrNo":{"type":"string","description":"협력사번호 — optnCatRegGbCd='02'(협력사전용)일 때 필수"},"optnCatTypCd":{"type":"string","description":"옵션분류유형코드(PR019)"},"optnCatNm":{"type":"string","description":"옵션분류명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서 (기본값 0)"},"optnList":{"type":"array","description":"옵션값 목록","items":{"$ref":"#/components/schemas/OptnItem"}}},"required":["optnCatNm","optnCatRegGbCd","optnCatTypCd","optnList"]},"OptnItem":{"type":"object","properties":{"optnNm":{"type":"string","description":"옵션명"}}},"ResponseSaveCustomOptionResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/SaveCustomOptionResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"SaveCustomOptionResponse":{"type":"object","description":"직접 입력 옵션 마스터 저장 Response","properties":{"optnCatNo":{"type":"string","description":"신규 옵션분류번호"},"optnList":{"type":"array","description":"저장된 옵션값 목록","items":{"$ref":"#/components/schemas/OptnResultItem"}}}},"OptnResultItem":{"type":"object","properties":{"optnNo":{"type":"string","description":"옵션번호"},"optnNm":{"type":"string","description":"옵션명"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/optionMgmtApi/saveCustomOption":{"post":{"tags":["옵션 정보 관리"],"summary":"직접 입력 옵션 마스터 저장","description":"## 기능설명\n* 옵션 정보 그리드에서 직접 입력한 옵션을 협력사 마스터(PR_OPTN_CLSS_CD / PR_OPTN_CD)에 영구 등록합니다.\n---\n## 상세설명\n* optnCatRegGbCd='02'(협력사전용), 지정한 entrNo / optnCatTypCd 로 분류 코드 신규 INSERT.\n* 응답의 optnCatNo / optnNo 로 그리드 sentinel ID 를 교체하여 이후 저장은 master-linked 경로로 처리됩니다.\n","operationId":"saveCustomOption","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCustomOptionRequest"}}},"required":true},"responses":{"200":{"description":"저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseSaveCustomOptionResponse"}}}},"900":{"description":"저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 옵션코드 목록 조회
> \## 기능설명\
> \* 옵션 코드 목록 조회 API 입니다.\
> \---\
> \## 상세설명\
> \* 옵션 분류 번호 기준으로 옵션 코드 정보 목록을 조회합니다.\
> \* 정렬순서 오름차순, 수정일시 내림차순으로 정렬합니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseRealGridListResponseOptionMgmtApiResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseOptionMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseOptionMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OptionMgmtApiResponse"}}}},"OptionMgmtApiResponse":{"type":"object","description":"옵션관리 Api Response","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnCatRegGbCd":{"type":"string","description":"옵션분류등록구분코드(PR018) 01:공통, 02:협력사전용"},"entrNo":{"type":"string","description":"협력사번호"},"optnCatTypCd":{"type":"string","description":"옵션분류유형코드(PR019) 10:색상, 11:크기, 12:중량, 13:용량, 14:지역, 15:의류사이즈, 17:모니터종류, 18:모니터크기, 19:모니터해상도, 20:카메라색상, 21:카메라해상도, 22:식품중량, 23:식품용량"},"optnCatNm":{"type":"string","description":"옵션분류명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"useYn":{"type":"string","description":"사용여부"},"optnCatRegGbCdNm":{"type":"string","description":"옵션분류등록구분코드명"},"optnCatTypCdNm":{"type":"string","description":"옵션분류유형코드명"},"entrNm":{"type":"string","description":"협력사명"},"optnNo":{"type":"string","description":"옵션번호"},"optnNm":{"type":"string","description":"옵션명"},"addOptnNm":{"type":"string","description":"추가옵션명"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"totalCount":{"type":"integer","format":"int32"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/optionMgmtApi/getOptionList":{"get":{"tags":["옵션 정보 관리"],"summary":"옵션코드 목록 조회","description":"## 기능설명\n* 옵션 코드 목록 조회 API 입니다.\n---\n## 상세설명\n* 옵션 분류 번호 기준으로 옵션 코드 정보 목록을 조회합니다.\n * 정렬순서 오름차순, 수정일시 내림차순으로 정렬합니다.\n","operationId":"getOptionList","parameters":[{"name":"langCd","in":"query","description":"언어코드","schema":{"type":"string"}},{"name":"optnCatNo","in":"query","description":"옵션분류번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"옵션코드 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseOptionMgmtApiResponse"}}}},"900":{"description":"옵션코드 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 옵션 분류 코드 목록 조회
> \## 기능설명\
> \* 옵션 분류 코드 목록 조회 API 입니다.\
> \---\
> \## 상세설명\
> \* 옵션 분류 코드 정보 목록을 조회합니다.\
> \* 정렬순서 오름차순, 수정일시 내림차순으로 정렬됩니다.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"OptionMgmtApiRequest":{"type":"object","description":"옵션관리 Request","properties":{"condxOptnCatTypCd":{"type":"string","default":"10","description":"옵션분류유형코드(PR019) 10:색상, 11:크기, 12:중량, 13:용량, 14:지역, 15:의류사이즈, 17:모니터종류, 18:모니터크기, 19:모니터해상도, 20:카메라색상, 21:카메라해상도, 22:식품중량, 23:식품용량"},"condxOptnCatRegGbCd":{"type":"string","default":"01","description":"옵션분류등록구분코드(PR018)"},"condxUseYn":{"type":"string","default":"Y","description":"옵션분류코드 사용여부"},"optnCatNo":{"type":"string","default":"1000","description":"옵션분류번호"},"entrNo":{"type":"string","default":"1000001","description":"협력사번호"},"useYn":{"type":"string","default":"Y","description":"옵션코드 사용여부"}}},"ResponseRealGridListResponseOptionMgmtApiResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/RealGridListResponseOptionMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseOptionMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/OptionMgmtApiResponse"}}}},"OptionMgmtApiResponse":{"type":"object","description":"옵션관리 Api Response","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnCatRegGbCd":{"type":"string","description":"옵션분류등록구분코드(PR018) 01:공통, 02:협력사전용"},"entrNo":{"type":"string","description":"협력사번호"},"optnCatTypCd":{"type":"string","description":"옵션분류유형코드(PR019) 10:색상, 11:크기, 12:중량, 13:용량, 14:지역, 15:의류사이즈, 17:모니터종류, 18:모니터크기, 19:모니터해상도, 20:카메라색상, 21:카메라해상도, 22:식품중량, 23:식품용량"},"optnCatNm":{"type":"string","description":"옵션분류명"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"useYn":{"type":"string","description":"사용여부"},"optnCatRegGbCdNm":{"type":"string","description":"옵션분류등록구분코드명"},"optnCatTypCdNm":{"type":"string","description":"옵션분류유형코드명"},"entrNm":{"type":"string","description":"협력사명"},"optnNo":{"type":"string","description":"옵션번호"},"optnNm":{"type":"string","description":"옵션명"},"addOptnNm":{"type":"string","description":"추가옵션명"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"totalCount":{"type":"integer","format":"int32"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/optionMgmtApi/getOptionCategoryList":{"get":{"tags":["옵션 정보 관리"],"summary":"옵션 분류 코드 목록 조회","description":"## 기능설명\n* 옵션 분류 코드 목록 조회 API 입니다.\n---\n## 상세설명\n* 옵션 분류 코드 정보 목록을 조회합니다.\n * 정렬순서 오름차순, 수정일시 내림차순으로 정렬됩니다.\n","operationId":"getOptionCategoryList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/OptionMgmtApiRequest"}}],"responses":{"200":{"description":"옵션 분류 코드 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseOptionMgmtApiResponse"}}}},"900":{"description":"옵션 분류 코드 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined-15.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.