> 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-22.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":{"TmdlGoodsMgmtApiRequest":{"type":"object","description":"타임딜상품관리 API Request","properties":{"startDate":{"type":"string","format":"date-time","description":"시작일"},"endDate":{"type":"string","format":"date-time","description":"종료일"},"dateSelect":{"type":"string","description":"조회기간 옵션"},"tmdlStatCd":{"type":"string","description":"타임딜 상태"},"saleStatCd":{"type":"string","description":"판매상태"},"dispYn":{"type":"string","description":"MD 번호"},"goodsTypCd":{"type":"string","description":"상품유형"},"mdId":{"type":"string","description":"MD 번호"},"mdNm":{"type":"string","description":"MD 이름"},"entrNo":{"type":"string","description":"협력사 번호"},"entrNm":{"type":"string","description":"협력사명"},"brandNo":{"type":"string","description":"브랜드 번호"},"brandNm":{"type":"string","description":"브랜드명"},"goodsNoOption":{"type":"string","description":"상품 번호 옵션"},"goodsNoFrom":{"type":"string","description":"상품번호 From 조건"},"goodsNoTo":{"type":"string","description":"상품번호 To 조건"},"goodsNoList":{"type":"string","description":"상품번호 리스트 스트링"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준 카테고리"},"dispCtgNo":{"type":"string","description":"전시 카테고리"},"goodsNoArray":{"type":"array","description":"상품번호 리스트 배열","items":{"type":"string"}},"tmdlStatListCd":{"type":"array","description":"타임딜 진행상태 배열","items":{"type":"string"}},"saleStatListCd":{"type":"array","description":"판매상태 배열","items":{"type":"string"}}}},"ResponseRealGridListResponseTmdlGoodsMgmtApiResponse":{"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/RealGridListResponseTmdlGoodsMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseTmdlGoodsMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/TmdlGoodsMgmtApiResponse"}}}},"TmdlGoodsMgmtApiResponse":{"type":"object","description":"타임딜상품 관리 API Response","properties":{"goodsTypNm":{"type":"string","description":"상품유형명"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"histStrDtm":{"type":"string","format":"date-time","description":"이력적용일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"salePrc":{"type":"number","description":"기존 판매가"},"norPrc":{"type":"number","description":"정상가"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"mdId":{"type":"string","description":"담당MD"},"stdCtgHierarchy":{"type":"string","description":"표준카테고리"},"supPcost":{"type":"number","description":"공급원가"},"mrgnRate":{"type":"number","description":"마진율"},"tmdlStatNm":{"type":"string","description":"타임딜 진행상태명"},"tmdlSalePrc":{"type":"number","description":"타임딜판매가"},"timeDealYn":{"type":"string","description":"타임딜적용여부"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"타임딜시작일시"},"tmdlHistEndDtm":{"type":"string","format":"date-time","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/tmdlGoodsMgmtApi/getTmdlGoodsList":{"get":{"tags":["타임딜상품 관리"],"summary":"타임딜상품 목록 조회","description":"## 기능설명\n* 타임딜상품 검색 조건에 따라 상품 리스트를 조회합니다.\n---\n## 상세설명\n* 타임딜상품 검색 조건에 따라 상품 리스트를 조회합니다.\n* 검색 조건 중 상품 번호를 입력한 경우 상품 등록기간 조건을 무시하고 조회합니다.\n","operationId":"getTmdlGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/TmdlGoodsMgmtApiRequest"}}],"responses":{"200":{"description":"상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseTmdlGoodsMgmtApiResponse"}}}},"900":{"description":"상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```