> 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-23.md).

# 상품 정보 관리

## 상품 목록 조회

> \## 기능설명\
> \* 상품 검색 조건에 따라 상품 리스트를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품 검색 조건에 따라 상품 리스트를 조회합니다.\
> \* 검색 조건 중 상품 번호를 입력한 경우 상품 등록기간 조건을 무시하고 조회합니다.<br>

```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":{"GoodsMgmtApiRequest":{"type":"object","description":"상품관리 API Request","properties":{"goodsDtmOption":{"type":"string","description":"조회기간 옵션"},"goodsDtmIgnoreOption":{"type":"string","description":"조회기간 무시 옵션"},"goodsStartDtm":{"type":"string","format":"date-time","description":"시작일"},"goodsEndDtm":{"type":"string","format":"date-time","description":"종료일"},"saleStatCd":{"type":"string","description":"판매상태"},"soutCausCd":{"type":"string","description":"품절 사유"},"saleStatChgCausCd":{"type":"string","description":"상품상태 변경 사유"},"mdId":{"type":"string","description":"MD 번호"},"mdNm":{"type":"string","description":"MD 이름"},"goodsNm":{"type":"string","description":"상품명"},"brandNo":{"type":"string","description":"브랜드 번호"},"brandNm":{"type":"string","description":"브랜드명"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사명"},"goodsNoOption":{"type":"string","description":"상품 번호 옵션"},"goodsNoList":{"type":"string","description":"상품번호 리스트 스트링"},"goodsNoArray":{"type":"array","description":"상품번호 리스트 배열","items":{"type":"string"}},"goodsNoFrom":{"type":"string","description":"상품번호 From 조건"},"goodsNoTo":{"type":"string","description":"상품번호 To 조건"},"goodsNo":{"type":"string","description":"상품번호"},"goodsCompCd":{"type":"string","description":"상품구성"},"goodsTypCd":{"type":"string","description":"상품유형"},"deliProcTypCd":{"type":"string","description":"배송처리유형"},"saleMethCd":{"type":"string","description":"판매방식"},"buyTypCd":{"type":"string","description":"매입형태"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"stkMgrYn":{"type":"string","description":"재고관리 여부"},"stdCtgNo":{"type":"string","description":"표준 카테고리"},"adveWrd":{"type":"string","description":"홍보문구"},"adveUseYn":{"type":"string","description":"홍보문구 사용여부"},"prestYn":{"type":"string","description":"증정품 여부"},"searchDispCtgNo":{"type":"string","description":"전시 카테고리"},"dispYn":{"type":"string","description":"전시여부"},"goodsImgYn":{"type":"string","description":"이미지 포함 여부"},"optnYn":{"type":"string","description":"옵션사용"},"gvgfPsbYn":{"type":"string","description":"선물하기 여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기주문 여부"},"buyQtyLmtYn":{"type":"string","description":"구매제한 여부"},"prcCompaExpYn":{"type":"string","description":"가격비교 여부"},"searchSysModId":{"type":"string","description":"수정자 id"},"milgRsrvPsbYn":{"type":"string","description":"마일리지 적립여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}}},"ResponseRealGridListResponseGoodsMgmtApiResponse":{"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/RealGridListResponseGoodsMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseGoodsMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsMgmtApiResponse"}}}},"GoodsMgmtApiResponse":{"type":"object","description":"상품관리 API Response","properties":{"goodsCompCd":{"type":"string","description":"상품구성"},"goodsTypCd":{"type":"string","description":"상품유형"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"modlNm":{"type":"string","description":"모델명"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleMethCd":{"type":"string","description":"판매방식코드"},"taxGbCd":{"type":"string","description":"과면세구분코드"},"supPcost":{"type":"number","description":"공급가"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"mrgnRate":{"type":"number","description":"마진율"},"prcCompaExpYn":{"type":"string","description":"가격비교여부"},"dispYn":{"type":"string","description":"전시여부"},"safeStkNotiYn":{"type":"string","description":"안전재고 알림여부"},"stdCtgHierarchy":{"type":"string","description":"표준분류하이라키구조"},"mdId":{"type":"string","description":"MD명"},"entrNm":{"type":"string","description":"협력사명"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"adveWrd":{"type":"string","description":"홍보문구"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"buyTypCd":{"type":"string","description":"계약형태"},"buyQtyLmtYn":{"type":"string","description":"구매제한"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"optnYn":{"type":"string","description":"옵션사용여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립여부"},"gvgfPsbYn":{"type":"string","description":"선물가능여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"prestYn":{"type":"string","description":"증정품여부"},"deliGoodsGbNm":{"type":"string","description":"배송상품구분"},"deliProcTypNm":{"type":"string","description":"배송처리유형"},"buyTypNm":{"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":"타임딜판매가"},"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/goods/goodsMgmtApi/getGoodsList":{"get":{"tags":["상품 정보 관리"],"summary":"상품 목록 조회","description":"## 기능설명\n* 상품 검색 조건에 따라 상품 리스트를 조회합니다.\n---\n## 상세설명\n* 상품 검색 조건에 따라 상품 리스트를 조회합니다.\n* 검색 조건 중 상품 번호를 입력한 경우 상품 등록기간 조건을 무시하고 조회합니다.\n","operationId":"getGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsMgmtApiRequest"}}],"responses":{"200":{"description":"상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseGoodsMgmtApiResponse"}}}},"900":{"description":"상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```