# 상품 정보 관리
## 상품 목록 조회
> \## 기능설명\
> \* 상품 검색 조건에 따라 상품 리스트를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품 검색 조건에 따라 상품 리스트를 조회합니다.\
> \* 검색 조건 중 상품 번호를 입력한 경우 상품 등록기간 조건을 무시하고 조회합니다.
```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"}}}}}}}}}
```
---
# 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-23.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.