> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined-17.md).
# 단품 정보 관리
## 단품 품절 처리
> \## 기능설명\
> \* 단품을 품절 처리합니다.\
> \---\
> \## 상세설명\
> \* 단품 목록을 품절 처리합니다.\
> \* 배송 모듈의 결품 관리에서 결품 처리를 위해 호출됩니다.
```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":{"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"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/goodsItemMgmtApi/soldOutGoodsItemList":{"post":{"tags":["단품 정보 관리"],"summary":"단품 품절 처리","description":"## 기능설명\n* 단품을 품절 처리합니다.\n---\n## 상세설명\n* 단품 목록을 품절 처리합니다.\n* 배송 모듈의 결품 관리에서 결품 처리를 위해 호출됩니다.\n","operationId":"soldOutGoodsItemList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"required":true},"responses":{"200":{"description":"단품 품절 처리 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"단품 품절 처리 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 단품관리 목록 저장
> \## 기능설명\
> \* 단품관리 목록을 저장합니다.\
> \---\
> \## 상세설명\
> \* 단품관리 목록에서 재고수량, 안전재고 기준수량, 안전재고 알림 여부 등의 정보를 수정 및 저장합니다.\
> \* 필수값이 입력되지 않은 경우 오류를 반환합니다.\
> \* 필수값: 상품번호, 단품번호
```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":{"RealGridCUDRequestPrItmBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"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/goodsItemMgmtApi/saveGoodsItemList":{"post":{"tags":["단품 정보 관리"],"summary":"단품관리 목록 저장","description":"## 기능설명\n* 단품관리 목록을 저장합니다.\n---\n## 상세설명\n* 단품관리 목록에서 재고수량, 안전재고 기준수량, 안전재고 알림 여부 등의 정보를 수정 및 저장합니다.\n* 필수값이 입력되지 않은 경우 오류를 반환합니다.\n * 필수값: 상품번호, 단품번호\n","operationId":"saveGoodsItemList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestPrItmBase"}}},"required":true},"responses":{"200":{"description":"단품관리 목록 저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"단품관리 목록 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 재고수량 일괄 변경
> \## 기준수량\
> \* 단품의 재고수량을 일괄 변경합니다.\
> \---\
> \## 상세설명\
> \* 선택한 단품들의 재고수량을 일괄 변경합니다.\
> \* 재고관리 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 요청이 반영되지 않습니다.\
> \* 필수값 미입력 시 오류를 반환합니다.\
> \* 필수값: 상품번호, 단품번호, 재고수량
```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":{"GoodsItemStockQuantityApiRequest":{"type":"object","description":"단품 재고수량 변경 DTO","properties":{"goodsItemStockQuantityRequest":{"type":"string","description":"단품 재고수량 변경 DTO"},"goodsItemStockQuantityList":{"type":"array","description":"단품 재고수량 변경 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsItemStockQuantityDto"}}}},"GoodsItemStockQuantityDto":{"type":"object","description":"단품 재고수량 변경 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"stkQty":{"type":"integer","format":"int32","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/goodsItemMgmtApi/modifyGoodsItemStockQuantity":{"post":{"tags":["단품 정보 관리"],"summary":"재고수량 일괄 변경","description":"## 기준수량\n* 단품의 재고수량을 일괄 변경합니다.\n---\n## 상세설명\n* 선택한 단품들의 재고수량을 일괄 변경합니다.\n* 재고관리 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 요청이 반영되지 않습니다.\n* 필수값 미입력 시 오류를 반환합니다.\n * 필수값: 상품번호, 단품번호, 재고수량\n","operationId":"modifyGoodsItemStockQuantity","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsItemStockQuantityApiRequest"}}},"required":true},"responses":{"200":{"description":"재고수량 일괄 변경 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"재고수량 일괄 변경 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 안전재고 알림 기준 수량 일괄 변경
> \## 기능설명\
> \* 단품의 안전재고 알림 기준수량을 일괄 변경합니다.\
> \---\
> \## 상세설명\
> \* 선택한 단품들의 안전재고 알림 기준수량을 일괄 변경합니다.\
> \* 안전재고 알림 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 반영되지 않습니다.\
> \* 안전재고알림여부가 'N'인 경우, 안전재고알림기준수량이 초기화됩니다.\
> \* 필수값 미입력 시 오류를 반환합니다.\
> \* 필수값: 상품번호, 단품번호, 안전재고알림 기준수량
```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":{"GoodsItemMgmtApiRequest":{"type":"object","description":"단품관리 API Request DTO","properties":{"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료\", example = \"10\""},"entrNo":{"type":"string","description":"협력사번호"},"deliProcTypCd":{"type":"string","description":"배송처리유형"},"itmSaleStatCd":{"type":"string","description":"단품판매상태"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"lowStkYn":{"type":"string","description":"재고부족 여부"},"regDtAll":{"type":"string","description":"전체기간 검색여부"},"modUserId":{"type":"string","description":"수정자 아이디"},"stkMgrYn":{"type":"string","description":"재고수량관리여부"},"brandNo":{"type":"string","description":"브랜드번호"},"lgcItmNo":{"type":"string","description":"업체단품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNoOpt":{"type":"string","description":"상품번호옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"goodsNoList":{"type":"string","description":"상품번호목록"},"goodsNoArr":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"goodsNoFrom":{"type":"string","description":"상품번호시작"},"goodsNoTo":{"type":"string","description":"상품번호끝"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"soutNotiStdQty":{"type":"string","description":"품절알림기준수량"},"stkQty":{"type":"string","description":"재고수량"},"goodsSaleStateRequest":{"type":"string","description":"상품 판매상태 요청 DTO"},"goodsSaleStateList":{"type":"array","description":"상품 판매상태 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsSaleStateDto"}},"goodsItemStockQuantityRequest":{"type":"string","description":"상품 재고관리 요청 DTO"},"goodsItemStockQuantityList":{"type":"array","description":"상품 재고관리 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsItemStockQuantityDto"}},"goodsItemSoldOutNotificationRequest":{"type":"string","description":"상품 품절알림 요청 DTO"},"goodsItemSoldOutNotificationList":{"type":"array","description":"상품 품절알림 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsItemSoldOutNotificationDto"}}}},"GoodsSaleStateDto":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"saleStatCd":{"type":"string","description":"판매상태"},"soutCausCd":{"type":"string","description":"품절사유코드"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드"},"itmNo":{"type":"string","description":"단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드"},"soutNotiYn":{"type":"string","description":"단품품절알림여부"},"soutNotiStdQty":{"type":"string","description":"품절알림기준수량"}}},"GoodsItemStockQuantityDto":{"type":"object","description":"단품 재고수량 변경 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"}}},"GoodsItemSoldOutNotificationDto":{"type":"object","description":"단품 안전재고알림 변경 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"safeStkQty":{"type":"integer","format":"int32","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/goodsItemMgmtApi/modifyGoodsItemSoldOutNotificationYn":{"post":{"tags":["단품 정보 관리"],"summary":"안전재고 알림 기준 수량 일괄 변경","description":"## 기능설명\n* 단품의 안전재고 알림 기준수량을 일괄 변경합니다.\n---\n## 상세설명\n* 선택한 단품들의 안전재고 알림 기준수량을 일괄 변경합니다.\n* 안전재고 알림 여부가 'Y'일 경우에만 변경되며, 'N'일 경우 반영되지 않습니다.\n* 안전재고알림여부가 'N'인 경우, 안전재고알림기준수량이 초기화됩니다.\n* 필수값 미입력 시 오류를 반환합니다.\n * 필수값: 상품번호, 단품번호, 안전재고알림 기준수량\n","operationId":"modifyGoodsItemSoldOutNotificationYn","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsItemMgmtApiRequest"}}},"required":true},"responses":{"200":{"description":"안전재고 알림 기준 수량 일괄 변경 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"안전재고 알림 기준 수량 일괄 변경 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 단품 정보 조회
> \## 기능설명\
> \* 특정 상품의 단품 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 단품 기본 조회, 단품 옵션정보를 조회합니다.
```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":{"ResponseGeneralGoodsApiResponse":{"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/GeneralGoodsApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GeneralGoodsApiResponse":{"type":"object","description":"일반 상품 상세 Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"상품 기본 정보"},"prGoodsCurrentPrce":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"상품 현재 적용 가격 정보"},"prRsvSaleHistList":{"type":"array","description":"예약 판매 이력","items":{"$ref":"#/components/schemas/PrRsvSaleHist"}},"prGoodsItemInfoList":{"type":"array","description":"상품 고시 항목 목록","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"상품 안전인증 이력","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"상품 카테고리 속성","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"상품결제수단정보 목록","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prItmOptnInfoList":{"type":"array","description":"단품 옵션 목록","items":{"$ref":"#/components/schemas/GoodsOptionApiResponse"}},"prItmBaseList":{"type":"array","description":"단품 목록","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsContInfoList":{"type":"array","description":"상품 컨텐츠 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prStdCtgDispInfoList":{"type":"array","description":"표준카테고리전시정보 목록","items":{"$ref":"#/components/schemas/PrStdCtgDispInfo"}},"prAssocGoodsInfoList":{"type":"array","description":"연관상품 목록","items":{"$ref":"#/components/schemas/AssociatedGoodsResponse"}},"prAdveWrdHistList":{"type":"array","description":"홍보문구 목록","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"증정품 목록","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsIconInfoList":{"type":"array","description":"상품아이콘 정보 목록","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"GoodsBaseResponse":{"type":"object","description":"상품기본 Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrNm":{"type":"string","description":"협력사명"},"brandNm":{"type":"string","description":"브랜드명"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD아이디"},"mdNm":{"type":"string","description":"MD명"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드"},"safeCertiNeedYn":{"type":"string","description":"안전인증필요여부(표준카테고리)"},"trdTypCd":{"type":"string","description":"거래형태코드(VD002)"},"mrgnRateGbCd":{"type":"string","description":"마진구분코드(VD008)"},"mrgnRate1":{"type":"number","description":"마진율1"},"mrgnRate2":{"type":"number","description":"마진율2"}}},"PrGoodsPrceHist":{"type":"object","description":"상품가격이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"supPcost":{"type":"number","description":"공급원가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"eventPrc":{"type":"number","description":"행사가"},"mrgnRate":{"type":"number","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033)"},"prcChgCausCdNm":{"type":"string","description":"가격변경사유"},"timeDealYn":{"type":"string","description":"타임딜 여부"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"예약판매이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"rsvEndAfProcMethCd":{"type":"string","description":"예약종료후판매방식(PR011)"},"rsvStopYn":{"type":"string","description":"예약중단여부"},"rsvStopCausCd":{"type":"string","description":"예약중단사유코드(PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"예약중단일시"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"}}},"PrGoodsItemInfo":{"type":"object","description":"상품항목정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시항목코드"},"goodsNotiItemCd":{"type":"string","description":"상품고시품목코드"},"notiItemCmt":{"type":"string","description":"고시항목내용"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"상품안전인증이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"safeCertiGbCd":{"type":"string","description":"안전인증구분코드"},"safeCertiNo":{"type":"string","description":"안전인증번호"},"aplyStrDt":{"type":"string","description":"적용시작일자"},"aplyEndDt":{"type":"string","description":"적용종료일자"},"safeCertiOrnNm":{"type":"string","description":"안전인증기관명"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"goodsNo":{"type":"string","description":"상품번호"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"}}},"PrGoodsPayMeanInfo":{"type":"object","description":"상품겿제수단정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"payWayCd":{"type":"string","description":"결제수단코드"},"useYn":{"type":"string","description":"사용여부"}}},"GoodsOptionApiResponse":{"type":"object","description":"상품 단품옵션정보 Api Response","properties":{"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNo":{"type":"string","description":"옵션번호"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"string","description":"옵션분류 순서"},"optnCatRegGbCd":{"type":"string","description":"옵션분류등록구분코드"},"optnCatRegGbNm":{"type":"string","description":"옵션분류등록구분코드명"},"optnCatTypCd":{"type":"string","description":"옵션분류유형코드(PR019)"},"optnCatTypCdNm":{"type":"string","description":"옵션분류유형코드명"},"optnList":{"type":"array","description":"단품 옵션값 리스트","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}},"optnCdList":{"type":"string","deprecated":true,"description":"옵션값 리스트"},"optnCdNmList":{"type":"string","deprecated":true,"description":"옵션명 리스트"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"}}},"PrItmOptnInfo":{"type":"object","description":"단품옵션정보","properties":{"langCd":{"type":"string","description":"언어코드"},"goodsNo":{"type":"string","description":"상품번호"},"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류 순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션 순서"}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"itmSaleStatCdNm":{"type":"string","description":"단품판매상태코드명"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상) 42:판매종료(삭제)"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"addSupPcost":{"type":"number","description":"추가공급원가"},"addSalePrc":{"type":"number","description":"추가판매가"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리, 13:익일배송지연 자동품절처리, 14:모든단품품절로 상품 품절처리, 15:예약상품 품절처리, 16:묶음상품 품절로 인한 품절"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string","description":"옵션분류번호_5"},"optnNo5":{"type":"string","description":"옵션번호_5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrStdCtgDispInfo":{"type":"object","description":"표준카테고리전시정보","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"repCtgYn":{"type":"string","description":"대표카테고리여부"},"useYn":{"type":"string","description":"사용여부"},"dispCtgNm":{"type":"string","description":"전시카테고리명","readOnly":true},"dpmlNo":{"type":"string","description":"전시몰 번호"},"siteNm":{"type":"string","description":"사이트명","readOnly":true},"dpmlNm":{"type":"string","description":"전시몰명","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"상품 BO-API_전시카테고리 구조","readOnly":true}}},"AssociatedGoodsResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"asctGoodsNo":{"type":"string","description":"연관상품번호"},"asctGbCd":{"type":"string","description":"연관구분코드"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"},"asctGoodsNm":{"type":"string"},"saleStatCdNm":{"type":"string"}}},"PrAdveWrdHist":{"type":"object","description":"상품홍보문구이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"adveWrd":{"type":"string","description":"홍보문구"},"useYn":{"type":"string","description":"사용여부"}}},"PrPrestHist":{"type":"object","description":"증정품이력","properties":{"goodsNo":{"type":"string","description":"상품번호"},"prestNm":{"type":"string","description":"증정품명"},"useYn":{"type":"string","description":"사용여부"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"}}},"PrGoodsIconInfo":{"type":"object","description":"상품아이콘정보","properties":{"siteNo":{"type":"string","description":"사이트번호"},"goodsNo":{"type":"string","description":"상품번호"},"dispIconNo":{"type":"string","description":"전시아이콘번호"},"siteNm":{"type":"string","description":"사이트명"},"iconNm":{"type":"string","description":"아이콘명"},"dispMediaCdNm":{"type":"string","description":"전시매체"},"iconTypCdNm":{"type":"string","description":"아이콘 유형"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"iconPathNm":{"type":"string","description":"아이콘 이미지 경로"},"delYn":{"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/goodsItemMgmtApi/getItemOptionInfo":{"get":{"tags":["단품 정보 관리"],"summary":"단품 정보 조회","description":"## 기능설명\n* 특정 상품의 단품 정보를 조회합니다.\n---\n## 상세설명\n* 단품 기본 조회, 단품 옵션정보를 조회합니다.\n","operationId":"getItemOptionInfo","parameters":[{"name":"goodsNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"단품 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGeneralGoodsApiResponse"}}}},"900":{"description":"단품 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 단품목록 조회
> \## 기능설명\
> \* 단품목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 따라 단품 목록을 조회합니다.\
> \---\
> \## 코드정리\
> \`\`\`전체기간 검색여부\`\`\`: 'on' : 전체기간 검색\
> \`\`\`재고부족 여부\`\`\` : 'on' : 기준 수량 이하 단품 조회, 'off' : 기준 수량 이상 단품 조회
````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":{"GoodsItemMgmtApiRequest":{"type":"object","description":"단품관리 API Request DTO","properties":{"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료\", example = \"10\""},"entrNo":{"type":"string","description":"협력사번호"},"deliProcTypCd":{"type":"string","description":"배송처리유형"},"itmSaleStatCd":{"type":"string","description":"단품판매상태"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"lowStkYn":{"type":"string","description":"재고부족 여부"},"regDtAll":{"type":"string","description":"전체기간 검색여부"},"modUserId":{"type":"string","description":"수정자 아이디"},"stkMgrYn":{"type":"string","description":"재고수량관리여부"},"brandNo":{"type":"string","description":"브랜드번호"},"lgcItmNo":{"type":"string","description":"업체단품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNoOpt":{"type":"string","description":"상품번호옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"goodsNoList":{"type":"string","description":"상품번호목록"},"goodsNoArr":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"goodsNoFrom":{"type":"string","description":"상품번호시작"},"goodsNoTo":{"type":"string","description":"상품번호끝"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"soutNotiStdQty":{"type":"string","description":"품절알림기준수량"},"stkQty":{"type":"string","description":"재고수량"},"goodsSaleStateRequest":{"type":"string","description":"상품 판매상태 요청 DTO"},"goodsSaleStateList":{"type":"array","description":"상품 판매상태 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsSaleStateDto"}},"goodsItemStockQuantityRequest":{"type":"string","description":"상품 재고관리 요청 DTO"},"goodsItemStockQuantityList":{"type":"array","description":"상품 재고관리 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsItemStockQuantityDto"}},"goodsItemSoldOutNotificationRequest":{"type":"string","description":"상품 품절알림 요청 DTO"},"goodsItemSoldOutNotificationList":{"type":"array","description":"상품 품절알림 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsItemSoldOutNotificationDto"}}}},"GoodsSaleStateDto":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"saleStatCd":{"type":"string","description":"판매상태"},"soutCausCd":{"type":"string","description":"품절사유코드"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드"},"itmNo":{"type":"string","description":"단품번호"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드"},"soutNotiYn":{"type":"string","description":"단품품절알림여부"},"soutNotiStdQty":{"type":"string","description":"품절알림기준수량"}}},"GoodsItemStockQuantityDto":{"type":"object","description":"단품 재고수량 변경 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"}}},"GoodsItemSoldOutNotificationDto":{"type":"object","description":"단품 안전재고알림 변경 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"}}},"ResponseRealGridListResponseGoodsItemMgmtApiResponse":{"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/RealGridListResponseGoodsItemMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseGoodsItemMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsItemMgmtApiResponse"}}}},"GoodsItemMgmtApiResponse":{"type":"object","description":"단품정보관리 API Response DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시자정, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"brandNm":{"type":"string","description":"브랜드명"},"lowrBrandNm":{"type":"string","description":"하위브랜드명"},"entrNm":{"type":"string","description":"협력사명"},"stdCtgHierarchy":{"type":"string","description":"표준분류구조"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"mdId":{"type":"string","description":"담당MD 아이디"},"itmNo":{"type":"string","description":"단품번호"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnNm5":{"type":"string","description":"옵션명_5"},"optionVal":{"type":"string","description":"옵션값"},"modlNm":{"type":"string","description":"모델명"},"lgcItmNo":{"type":"string","description":"자체단품번호(품번)"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"repItmYn":{"type":"string","description":"대표단품여부"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"totIssuQty":{"type":"integer","format":"int32","description":"총발급수량"},"soutNotiYn":{"type":"string","description":"품절알림여부"},"soutNotiStdQty":{"type":"integer","format":"int32","description":"품절알림기준수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"soutCausCdNm":{"type":"string","description":"품절사유코드명(PR005)"},"supPcost":{"type":"number","description":"공급가"},"norPrc":{"type":"number","description":"정산가"},"salePrc":{"type":"number","description":"판매가"},"rsvSaleGoodsYn":{"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/goodsItemMgmtApi/getGoodsItemList":{"get":{"tags":["단품 정보 관리"],"summary":"단품목록 조회","description":"## 기능설명\n* 단품목록을 조회합니다.\n---\n## 상세설명\n* 검색 조건에 따라 단품 목록을 조회합니다.\n---\n## 코드정리\n```전체기간 검색여부```: 'on' : 전체기간 검색\n```재고부족 여부``` : 'on' : 기준 수량 이하 단품 조회, 'off' : 기준 수량 이상 단품 조회\n","operationId":"getGoodsItemList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsItemMgmtApiRequest"}}],"responses":{"200":{"description":"단품목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseGoodsItemMgmtApiResponse"}}}},"900":{"description":"단품목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````