> 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/promotional-text-management.md).

# Promotional Text Management

## Modify Promotional Phrase

> \## Function Description\
> \* Modifies the changes made in the promotional phrase grid on the Promotional Phrase Management page.\
> \---\
> \## Detailed Description\
> \* Saves the modifications made in the promotional phrase grid.\
> \---\
> \## Validation\
> \* Validates whether there is a duplicate promotional phrase for the applicable date/time.<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":{"RealGridCUDRequestPrAdveWrdHist":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}}}},"PrAdveWrdHist":{"type":"object","description":"Product Promotional Copy History","properties":{"goodsNo":{"type":"string","description":"Product No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"useYn":{"type":"string","description":"Usage Status"}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"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":{"/v1/goods/advertisingWordMgmtApi/saveAdvertisingWordList":{"post":{"tags":["Promotional Text Management"],"summary":"Modify Promotional Phrase","description":"## Function Description\n* Modifies the changes made in the promotional phrase grid on the Promotional Phrase Management page.\n---\n## Detailed Description\n* Saves the modifications made in the promotional phrase grid.\n---\n## Validation\n* Validates whether there is a duplicate promotional phrase for the applicable date/time.\n","operationId":"saveAdvertisingWordList","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestPrAdveWrdHist"}}},"required":true},"responses":{"200":{"description":"Modify Promotional Phrase Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Modify Promotional Phrase Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Promotional Phrase List

> \## Function Description\
> \* Searches the promotional phrase list on the Promotional Phrase Management page.\
> \---\
> \## Detailed Description\
> \* Searches the promotional phrase corresponding to the entered application date/time, product name, product number, usage status, and promotional phrase.\
> \* Searched in order of most recent modification date/time.<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":{"AdvertisingWordMgmtApiRequest":{"type":"object","description":"Promotional Text Management Request","properties":{"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"useYn":{"type":"string","description":"Usage Status"}}},"ResponseRealGridListResponseAdvertisingWordMgmtApiResponse":{"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/RealGridListResponseAdvertisingWordMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseAdvertisingWordMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AdvertisingWordMgmtApiResponse"}}}},"AdvertisingWordMgmtApiResponse":{"type":"object","description":"Promotional Text Management Response","properties":{"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"useYn":{"type":"string","description":"Usage Status"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"}}},"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":{"/v1/goods/advertisingWordMgmtApi/getAdvertisingWordList":{"get":{"tags":["Promotional Text Management"],"summary":"Search Promotional Phrase List","description":"## Function Description\n* Searches the promotional phrase list on the Promotional Phrase Management page.\n---\n## Detailed Description\n* Searches the promotional phrase corresponding to the entered application date/time, product name, product number, usage status, and promotional phrase.\n* Searched in order of most recent modification date/time.\n","operationId":"getAdvertisingWordList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AdvertisingWordMgmtApiRequest"}}],"responses":{"200":{"description":"Search Promotional Phrase List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAdvertisingWordMgmtApiResponse"}}}},"900":{"description":"Search Promotional Phrase List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```