> 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/api-en/back-office-api-reference/goods-bo-api/time-deal-product-management.md).

# Time Deal Product Management

## Search Time Deal Product List

> \## Function Description\
> \* Searches the product list according to the time deal product search conditions.\
> \---\
> \## Detailed Description\
> \* Searches the product list according to the time deal product search conditions.\
> \* If a product number is entered among the search conditions, the product registration period condition is ignored.<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":"Time Deal Product Management API Request","properties":{"startDate":{"type":"string","format":"date-time","description":"Start Date"},"endDate":{"type":"string","format":"date-time","description":"End Date"},"dateSelect":{"type":"string","description":"Search Period Option"},"tmdlStatCd":{"type":"string","description":"Time Deal Status"},"saleStatCd":{"type":"string","description":"Sales Status"},"dispYn":{"type":"string","description":"MD No."},"goodsTypCd":{"type":"string","description":"Product Type"},"mdId":{"type":"string","description":"MD No."},"mdNm":{"type":"string","description":"MD Name"},"entrNo":{"type":"string","description":"Vendor No."},"entrNm":{"type":"string","description":"Vendor Name"},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"goodsNoOption":{"type":"string","description":"Product No. Option"},"goodsNoFrom":{"type":"string","description":"Product No. From Condition"},"goodsNoTo":{"type":"string","description":"Product No. To Condition"},"goodsNoList":{"type":"string","description":"Product No. List String"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"stdCtgNo":{"type":"string","description":"Standard Category"},"dispCtgNo":{"type":"string","description":"Display Category"},"goodsNoArray":{"type":"array","description":"Product No. List Array","items":{"type":"string"}},"tmdlStatListCd":{"type":"array","description":"Time Deal Progress Status Array","items":{"type":"string"}},"saleStatListCd":{"type":"array","description":"Sales Status Array","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":"Time Deal Product Management API Response","properties":{"goodsTypNm":{"type":"string","description":"Product Type Name"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"histStrDtm":{"type":"string","format":"date-time","description":"History Applied Date/Time"},"histEndDtm":{"type":"string","format":"date-time","description":"History End Date/Time"},"salePrc":{"type":"number","description":"Existing Selling Price"},"norPrc":{"type":"number","description":"Regular Price"},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"entrNo":{"type":"string","description":"Vendor No."},"entrNm":{"type":"string","description":"Vendor Name"},"mdId":{"type":"string","description":"MD in Charge"},"stdCtgHierarchy":{"type":"string","description":"Standard Category"},"supPcost":{"type":"number","description":"Supply Cost"},"mrgnRate":{"type":"number","description":"Margin Rate"},"tmdlStatNm":{"type":"string","description":"Time Deal Progress Status Name"},"tmdlSalePrc":{"type":"number","description":"Time Deal Selling Price"},"timeDealYn":{"type":"string","description":"Time Deal Application Status"},"tmdlHistStrDtm":{"type":"string","format":"date-time","description":"Time Deal Start Date/Time"},"tmdlHistEndDtm":{"type":"string","format":"date-time","description":"Time Deal End Date/Time"}}},"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":["Time Deal Product Management"],"summary":"Search Time Deal Product List","description":"## Function Description\n* Searches the product list according to the time deal product search conditions.\n---\n## Detailed Description\n* Searches the product list according to the time deal product search conditions.\n* If a product number is entered among the search conditions, the product registration period condition is ignored.\n","operationId":"getTmdlGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/TmdlGoodsMgmtApiRequest"}}],"responses":{"200":{"description":"Product List Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseTmdlGoodsMgmtApiResponse"}}}},"900":{"description":"Product List Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```