# 단품 정보 관리
## 단품 품절 처리
> \## 기능설명\
> \* 단품을 품절 처리합니다.\
> \---\
> \## 상세설명\
> \* 단품 목록을 품절 처리합니다.\
> \* 배송 모듈의 결품 관리에서 결품 처리를 위해 호출됩니다.
```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"}}}}}}}}}
````
---
# 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-17.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.