> 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/product-ai-communication.md). # Product AI Communication ## Generate Product Detail Description with XGEN AI > \## Function Description\ > Generates a product detail description using XGEN AI based on the product's basic information.\ > \
\
\ > \---\ > \## Details\ > \* Retrieves product information by product number for a single product.\
\
\ > \* Generation options are based on common code (PR050).\
\
\ > \* Additional descriptions can be provided at the time of generation.\
\

```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":{"AiGoodsDescRequest":{"type":"object","description":"AI Product Detail Description Generation Request DTO","properties":{"goodsNo":{"type":"string","description":"Product No.","minLength":1},"option":{"type":"string","description":"AI Product Description Option (PR050)","minLength":1},"additionalInfo":{"type":"string","description":"Additional Information"}},"required":["goodsNo","option"]},"AiGoodsDescResponse":{"type":"object","description":"AI Product Detail Description Generation Response DTO","properties":{"result":{"type":"string","description":"Generation Result"},"content":{"type":"string","description":"AI-Generated Content (Text or JSON String)"},"citations":{"type":"array","description":"Reference Document List","items":{"$ref":"#/components/schemas/XgenCitation"}}}},"XgenCitation":{"type":"object","description":"XGEN Reference Document Information","properties":{"file_name":{"type":"string","description":"Reference File Name"},"page_number":{"type":"integer","format":"int32","description":"Reference Page No."}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/ai/getAiGoodsDesc":{"post":{"tags":["Product AI Communication"],"summary":"Generate Product Detail Description with XGEN AI","description":"## Function Description\nGenerates a product detail description using XGEN AI based on the product's basic information.\n

\n---\n## Details\n* Retrieves product information by product number for a single product.

\n* Generation options are based on common code (PR050).

\n* Additional descriptions can be provided at the time of generation.

\n","operationId":"getAiGoodsDesc","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiGoodsDescRequest"}}},"required":true},"responses":{"200":{"description":"XGEN AI product detail description generated successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiGoodsDescResponse"}}}},"900":{"description":"Failed to generate XGEN AI product detail description","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}} ``` ## Search XGEN AI Product List > \## Function Description\ > \* Searches the product list recommended by XGEN AI.\ > \---\ > \## Detailed Description\ > \* Searches the product list according to the search conditions.\ > \* If a product number is entered, the product registration period condition is ignored and the search is performed over the entire period.\ > \---
```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":{"AiGoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"Ignore Search Period Option"},"goodsDtmOption":{"type":"string","description":"Search Period Option"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"Product Registration Start Date"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"Product Registration End Date"},"mdId":{"type":"string","description":"Assigned MD ID"},"entrNo":{"type":"string","description":"Vendor No."},"brandNo":{"type":"string","description":"Brand No."},"stdCtgNo":{"type":"string","description":"Standard Classification Category No."},"saleStatCd":{"type":"string","description":"Sales Status Code"},"saleStatCdList":{"type":"array","description":"Sales Status Code List","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"Product Composition Code"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code"},"buyTypCd":{"type":"string","description":"Purchase Type Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Mode"},"goodsNm":{"type":"string","description":"Product Name"},"goodsNo":{"type":"string","description":"Product No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Direct Purchase Product Status"},"mkdpNm":{"type":"string","description":"Exhibition Name"},"brefDesc":{"type":"string","description":"Exhibition Brief Description"},"introConts":{"type":"string","description":"Exhibition Introduction"},"divobjNm":{"type":"string","description":"Separator Name"},"searchCodeOption":{"type":"string","description":"Product No. Option (st: Starts With, in: Contains, eq: Equals, mt: Multiple, rg: Range)"},"searchCodeFrom":{"type":"string","description":"Product No. Start Condition"},"searchCodeTo":{"type":"string","description":"Product No. End Condition"},"searchCode":{"type":"string","description":"Product No."},"searchCodeText":{"type":"string","description":"Product No. Search Term"},"searchCodeTextList":{"type":"array","description":"Product No. Search Term (Multiple)","items":{"type":"string"}}}},"ResponseRealGridListResponseAiGoodsListPopupApiResponse":{"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/RealGridListResponseAiGoodsListPopupApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseAiGoodsListPopupApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AiGoodsListPopupApiResponse"}}}},"AiGoodsListPopupApiResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"goodsCompCd":{"type":"string","description":"Product Composition Code"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"goodsReason":{"type":"string","description":"Recommendation Reason"},"entrNm":{"type":"string","description":"Vendor Name"},"entrNo":{"type":"string","description":"Vendor No."},"brandNm":{"type":"string","description":"Brand Name"},"saleMethCd":{"type":"string","description":"Sales Method Code"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"saleStatCdNm":{"type":"string","description":"Sales Status Code Name"},"buyTypCd":{"type":"string","description":"Purchase Type Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Type"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"mdNm":{"type":"string","description":"MD in Charge Name"},"dispYn":{"type":"string","description":"Display Status"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Name"},"deliGoodsGbCdNm":{"type":"string","description":"Delivery Product Classification Code Name"},"salePrc":{"type":"number","description":"Selling Price"},"dispDlexAmt":{"type":"string","description":"Delivery Fee"},"stdCtgHierarchy":{"type":"string","description":"Standard Category"},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"}}},"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/ai/getAiGoodsList":{"get":{"tags":["Product AI Communication"],"summary":"Search XGEN AI Product List","description":"## Function Description\n* Searches the product list recommended by XGEN AI.\n---\n## Detailed Description\n* Searches the product list according to the search conditions.\n* If a product number is entered, the product registration period condition is ignored and the search is performed over the entire period.\n---\n","operationId":"getAiGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsListPopupApiRequest"}}],"responses":{"200":{"description":"Retrieve AI Product List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAiGoodsListPopupApiResponse"}}}},"900":{"description":"Retrieve AI Product List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}} ``` ## Search AI Product List > \## Function Description\ > \* Searches the product list recommended by AI.\ > \---\ > \## Detailed Description\ > \* Searches the product list according to the search conditions.\ > \* If a product number is entered, the product registration period condition is ignored and the search is performed over the entire period.\ > \---
```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":{"AiGoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"Ignore Search Period Option"},"goodsDtmOption":{"type":"string","description":"Search Period Option"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"Product Registration Start Date"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"Product Registration End Date"},"mdId":{"type":"string","description":"Assigned MD ID"},"entrNo":{"type":"string","description":"Vendor No."},"brandNo":{"type":"string","description":"Brand No."},"stdCtgNo":{"type":"string","description":"Standard Classification Category No."},"saleStatCd":{"type":"string","description":"Sales Status Code"},"saleStatCdList":{"type":"array","description":"Sales Status Code List","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"Product Composition Code"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code"},"buyTypCd":{"type":"string","description":"Purchase Type Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Mode"},"goodsNm":{"type":"string","description":"Product Name"},"goodsNo":{"type":"string","description":"Product No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Direct Purchase Product Status"},"mkdpNm":{"type":"string","description":"Exhibition Name"},"brefDesc":{"type":"string","description":"Exhibition Brief Description"},"introConts":{"type":"string","description":"Exhibition Introduction"},"divobjNm":{"type":"string","description":"Separator Name"},"searchCodeOption":{"type":"string","description":"Product No. Option (st: Starts With, in: Contains, eq: Equals, mt: Multiple, rg: Range)"},"searchCodeFrom":{"type":"string","description":"Product No. Start Condition"},"searchCodeTo":{"type":"string","description":"Product No. End Condition"},"searchCode":{"type":"string","description":"Product No."},"searchCodeText":{"type":"string","description":"Product No. Search Term"},"searchCodeTextList":{"type":"array","description":"Product No. Search Term (Multiple)","items":{"type":"string"}}}},"ResponseRealGridListResponseAiGoodsListPopupApiResponse":{"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/RealGridListResponseAiGoodsListPopupApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseAiGoodsListPopupApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/AiGoodsListPopupApiResponse"}}}},"AiGoodsListPopupApiResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"goodsCompCd":{"type":"string","description":"Product Composition Code"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"goodsReason":{"type":"string","description":"Recommendation Reason"},"entrNm":{"type":"string","description":"Vendor Name"},"entrNo":{"type":"string","description":"Vendor No."},"brandNm":{"type":"string","description":"Brand Name"},"saleMethCd":{"type":"string","description":"Sales Method Code"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"saleStatCdNm":{"type":"string","description":"Sales Status Code Name"},"buyTypCd":{"type":"string","description":"Purchase Type Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Type"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"mdNm":{"type":"string","description":"MD in Charge Name"},"dispYn":{"type":"string","description":"Display Status"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Name"},"deliGoodsGbCdNm":{"type":"string","description":"Delivery Product Classification Code Name"},"salePrc":{"type":"number","description":"Selling Price"},"dispDlexAmt":{"type":"string","description":"Delivery Fee"},"stdCtgHierarchy":{"type":"string","description":"Standard Category"},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"}}},"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/ai/getAiGoodsList":{"get":{"tags":["Product AI Communication"],"summary":"Search AI Product List","description":"## Function Description\n* Searches the product list recommended by AI.\n---\n## Detailed Description\n* Searches the product list according to the search conditions.\n* If a product number is entered, the product registration period condition is ignored and the search is performed over the entire period.\n---\n","operationId":"getAiGoodsList_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsListPopupApiRequest"}}],"responses":{"200":{"description":"Retrieve AI Product List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAiGoodsListPopupApiResponse"}}}},"900":{"description":"Retrieve AI Product List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}} ``` ## Generate AI Product Detail Description > \## Function Description\ > Generates a product detail description using AI based on the product's basic information.\ > \
\
\ > \---\ > \## Detailed Content\ > \* Searches product information by product number for a single product.\
\
\ > \* The generation option targets common code (PR050).\
\
\ > \* Additional description can be provided during generation.\
\

```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":{"AiGoodsDescRequest":{"type":"object","description":"AI Product Detail Description Generation Request DTO","properties":{"goodsNo":{"type":"string","description":"Product No.","minLength":1},"option":{"type":"string","description":"AI Product Description Option (PR050)","minLength":1},"additionalInfo":{"type":"string","description":"Additional Information"}},"required":["goodsNo","option"]},"AiGoodsDescResponse":{"type":"object","description":"AI Product Detail Description Generation Response DTO","properties":{"result":{"type":"string","description":"Generation Result"},"content":{"type":"string","description":"AI-Generated Content (Text or JSON String)"},"citations":{"type":"array","description":"Reference Document List","items":{"$ref":"#/components/schemas/XgenCitation"}}}},"XgenCitation":{"type":"object","description":"XGEN Reference Document Information","properties":{"file_name":{"type":"string","description":"Reference File Name"},"page_number":{"type":"integer","format":"int32","description":"Reference Page No."}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/ai/getAiGoodsDesc":{"get":{"tags":["Product AI Communication"],"summary":"Generate AI Product Detail Description","description":"## Function Description\nGenerates a product detail description using AI based on the product's basic information.\n

\n---\n## Detailed Content\n* Searches product information by product number for a single product.

\n* The generation option targets common code (PR050).

\n* Additional description can be provided during generation.

\n","operationId":"getAiGoodsDesc_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsDescRequest"}}],"responses":{"200":{"description":"Generate AI Product Detail Description Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiGoodsDescResponse"}}}},"900":{"description":"Generate AI Product Detail Description Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}} ```