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