> 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"}}}}}}}}}
````
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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/popup-bo-api/undefined-1.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.