> 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/popup-bo-api/undefined-1.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":{"GoodsSaleStatePopupApiRequest":{"type":"object","properties":{"goodsSaleStateRequest":{"type":"string"},"goodsSaleStateList":{"type":"array","description":"상품 판매상태 정보 DTO 리스트","items":{"$ref":"#/components/schemas/GoodsSaleStateDto"}}}},"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":"품절알림기준수량"}}},"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":{"/v2/popup/goodsMgmtPopupApi/modifyGoodsSaleState":{"post":{"tags":["상품관리 공통 팝업"],"summary":"판매상태 일괄변경","description":"## 기능설명\n* 상품 또는 단품의 판매상태를 일괄변경합니다.\n---\n## 상세설명\n* 상품 또는 단품의 판매상태를 일괄적으로 변경합니다.\n* 상품 판매상태 일괄 변경을 하는 경우 상품번호만 입력하고 단품번호는 빈 값으로 입력합니다.\n * 상품 판매상태 일괄 변경 시에는 해당 상품의 모든 단품도 일괄적으로 상태를 변경합니다.\n * 판매중 -> 품절로 변경 시 판매중인 단품만 품절로 변경 됩니다.\n * 품절 -> 판매중으로 변경 시 단품 판매상태를 별도로 변경하지 않은 모든 품절 상태의 단품을 판매중으로 변경합니다.\n * 판매중으로 변경 시 재고가 없는 단품은 품절 배치가 작동할 때 자동으로 품절로 변경됩니다.\n* 단품 판매상태 일괄 변경을 하는 경우 상품번호와 단품번호를 모두 입력합니다.\n * 단품 판매상태 일괄 변경 시 모든 단품의 판매 상태가 변경되는 경우 상품의 판매상태도 함께 변경됩니다.\n","operationId":"modifyGoodsSaleState","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsSaleStatePopupApiRequest"}}},"required":true},"responses":{"200":{"description":"판매상태 일괄변경 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"판매상태 일괄변경 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```
## 상품 목록 조회
> \## 기능설명\
> \* 상품 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 따라 상품 목록을 조회합니다.\
> \* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`\
> \- 묶음상품 상품추가 검증 프로세스 추가\
> \- response에 구매수량제한여부(buyQtyLmtYn), 최소제한수량(minLmtQty), 최대제한수량(maxLmtQty) 추가\
> \
> \`\`\`Release v1.05\_231204\`\`\`\
> \- 검색조건에 정기배송상품여부(rglrDeliGoodsYn) 추가\
> \
> \`\`\`Release v1.06\_250609\`\`\`\
> \- 타임딜 정보 조회 추가
````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":{"GoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"조회기간 무시 옵션"},"goodsDtmOption":{"type":"string","description":"조회기간 옵션"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdList":{"type":"array","description":"판매상태코드 리스트","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형모드"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송여부"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품여부"},"searchCodeOption":{"type":"string","description":"상품번호 옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"searchCodeFrom":{"type":"string","description":"상품번호 시작 조건"},"searchCodeTo":{"type":"string","description":"상품번호 마지막 조건"},"searchCode":{"type":"string","description":"상품번호"},"searchCodeText":{"type":"string","description":"상품번호 검색어"},"searchCodeTextList":{"type":"array","description":"상품번호 검색어(멀티)","items":{"type":"string"}}}},"ResponseRealGridListResponseGoodsListPopupApiResponse":{"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/RealGridListResponseGoodsListPopupApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseGoodsListPopupApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsListPopupApiResponse"}}}},"GoodsListPopupApiResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"entrNm":{"type":"string","description":"협력사명"},"entrNo":{"type":"string","description":"협력사번호"},"brandNm":{"type":"string","description":"브랜드명"},"saleMethCd":{"type":"string","description":"판매방식코드"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분"},"deliWayCd":{"type":"string","description":"배송수단코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"mdNm":{"type":"string","description":"담당MD명"},"dispYn":{"type":"string","description":"전시여부"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형명"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"salePrc":{"type":"number","description":"판매가"},"dispDlexAmt":{"type":"string","description":"배송비"},"stdCtgHierarchy":{"type":"string","description":"표준 카테고리"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"mileagePayYn":{"type":"string","description":"마일리지결제가능여부"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"타임딜종료일시"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"},"rsvStrtDtm":{"type":"string","description":"예약시작일시(YYYYMMDDHH24MISS)"},"rsvEndDtm":{"type":"string","description":"예약종료일시(YYYYMMDDHH24MISS)"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"frgnDirPurGoodsYn":{"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":{"/v2/popup/goodsMgmtPopupApi/getGoodsList":{"get":{"tags":["상품관리 공통 팝업"],"summary":"상품 목록 조회","description":"## 기능설명\n* 상품 목록을 조회합니다.\n---\n## 상세설명\n* 검색 조건에 따라 상품 목록을 조회합니다.\n* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\n---\n## 수정번호\n```Release v1.04_231120```\n - 묶음상품 상품추가 검증 프로세스 추가\n - response에 구매수량제한여부(buyQtyLmtYn), 최소제한수량(minLmtQty), 최대제한수량(maxLmtQty) 추가\n\n```Release v1.05_231204```\n - 검색조건에 정기배송상품여부(rglrDeliGoodsYn) 추가\n\n```Release v1.06_250609```\n - 타임딜 정보 조회 추가\n","operationId":"getGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsListPopupApiRequest"}}],"responses":{"200":{"description":"상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseGoodsListPopupApiResponse"}}}},"900":{"description":"상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````