> 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/ai.md).

# 상품 AI 통신

## XGEN AI 상품 상세 설명 생성

> \## 기능 설명\
> 상품 기본 정보를 기반으로 XGEN AI를 이용해 상품 상세 설명을 생성합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.\<br>\<br>\
> \* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.\<br>\<br>\
> \* 생성시 추가 설명을 제공할 수 있습니다.\<br>\<br><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":{"AiGoodsDescRequest":{"type":"object","description":"AI 상품 상세 설명 생성 요청 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호","minLength":1},"option":{"type":"string","description":"AI상품설명옵션(PR050)","minLength":1},"additionalInfo":{"type":"string","description":"추가정보"}},"required":["goodsNo","option"]},"AiGoodsDescResponse":{"type":"object","description":"AI 상품 상세 설명 생성 응답 DTO","properties":{"result":{"type":"string","description":"생성 결과"},"content":{"type":"string","description":"AI가 생성한 내용 (텍스트 또는 JSON 문자열)"},"citations":{"type":"array","description":"참조 문서 목록","items":{"$ref":"#/components/schemas/XgenCitation"}}}},"XgenCitation":{"type":"object","description":"XGEN 참조 문서 정보","properties":{"file_name":{"type":"string","description":"참조 파일명"},"page_number":{"type":"integer","format":"int32","description":"참조 페이지 번호"}}},"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":["상품 AI 통신"],"summary":"XGEN AI 상품 상세 설명 생성","description":"## 기능 설명\n상품 기본 정보를 기반으로 XGEN AI를 이용해 상품 상세 설명을 생성합니다.\n<br><br>\n---\n## 상세 내용\n* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.<br><br>\n* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.<br><br>\n* 생성시 추가 설명을 제공할 수 있습니다.<br><br>\n","operationId":"getAiGoodsDesc","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiGoodsDescRequest"}}},"required":true},"responses":{"200":{"description":"XGEN AI 상품 상세 설명 생성 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiGoodsDescResponse"}}}},"900":{"description":"XGEN AI 상품 상세 설명 생성 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## XGEN AI상품 목록 조회

> \## 기능설명\
> \* XGEN AI가 추천하는 상품 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 따라 상품 목록을 조회합니다.\
> \* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\
> \---<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":{"AiGoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"조회기간 무시 옵션"},"goodsDtmOption":{"type":"string","description":"조회기간 옵션"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdList":{"type":"array","description":"판매상태코드 리스트","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형모드"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송여부"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품여부"},"mkdpNm":{"type":"string","description":"기획전 명"},"brefDesc":{"type":"string","description":"기획전 간략설명"},"introConts":{"type":"string","description":"기획전 소개글"},"divobjNm":{"type":"string","description":"구분자 명"},"searchCodeOption":{"type":"string","description":"상품번호 옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"searchCodeFrom":{"type":"string","description":"상품번호 시작 조건"},"searchCodeTo":{"type":"string","description":"상품번호 마지막 조건"},"searchCode":{"type":"string","description":"상품번호"},"searchCodeText":{"type":"string","description":"상품번호 검색어"},"searchCodeTextList":{"type":"array","description":"상품번호 검색어(멀티)","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":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"goodsReason":{"type":"string","description":"추천사유"},"entrNm":{"type":"string","description":"협력사명"},"entrNo":{"type":"string","description":"협력사번호"},"brandNm":{"type":"string","description":"브랜드명"},"saleMethCd":{"type":"string","description":"판매방식코드"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분"},"deliWayCd":{"type":"string","description":"배송수단코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"mdNm":{"type":"string","description":"담당MD명"},"dispYn":{"type":"string","description":"전시여부"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형명"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"salePrc":{"type":"number","description":"판매가"},"dispDlexAmt":{"type":"string","description":"배송비"},"stdCtgHierarchy":{"type":"string","description":"표준 카테고리"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"rglrDeliGoodsYn":{"type":"string","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/ai/getAiGoodsList":{"get":{"tags":["상품 AI 통신"],"summary":"XGEN AI상품 목록 조회","description":"## 기능설명\n* XGEN AI가 추천하는 상품 목록을 조회합니다.\n---\n## 상세설명\n* 검색 조건에 따라 상품 목록을 조회합니다.\n* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\n---\n","operationId":"getAiGoodsList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsListPopupApiRequest"}}],"responses":{"200":{"description":"AI 상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAiGoodsListPopupApiResponse"}}}},"900":{"description":"AI 상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## AI상품 목록 조회

> \## 기능설명\
> \* AI가 추천하는 상품 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색 조건에 따라 상품 목록을 조회합니다.\
> \* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\
> \---<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":{"AiGoodsListPopupApiRequest":{"type":"object","properties":{"goodsDtmIgnoreOption":{"type":"boolean","description":"조회기간 무시 옵션"},"goodsDtmOption":{"type":"string","description":"조회기간 옵션"},"goodsRegStartDtm":{"type":"string","format":"date-time","description":"상품등록 시작일자"},"goodsRegEndDtm":{"type":"string","format":"date-time","description":"상품등록 종료일자"},"mdId":{"type":"string","description":"담당 MD 아이디"},"entrNo":{"type":"string","description":"협력사번호"},"brandNo":{"type":"string","description":"브랜드번호"},"stdCtgNo":{"type":"string","description":"표준분류카테고리번호"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdList":{"type":"array","description":"판매상태코드 리스트","items":{"type":"string"}},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"saleMethCd":{"type":"string","description":"판매방식코드"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형모드"},"goodsNm":{"type":"string","description":"상품명"},"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송여부"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품여부"},"mkdpNm":{"type":"string","description":"기획전 명"},"brefDesc":{"type":"string","description":"기획전 간략설명"},"introConts":{"type":"string","description":"기획전 소개글"},"divobjNm":{"type":"string","description":"구분자 명"},"searchCodeOption":{"type":"string","description":"상품번호 옵션 ( st : 시작, in : 포함, eq : 같음, mt : 멀티, rg : 범위)"},"searchCodeFrom":{"type":"string","description":"상품번호 시작 조건"},"searchCodeTo":{"type":"string","description":"상품번호 마지막 조건"},"searchCode":{"type":"string","description":"상품번호"},"searchCodeText":{"type":"string","description":"상품번호 검색어"},"searchCodeTextList":{"type":"array","description":"상품번호 검색어(멀티)","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":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"goodsCompCd":{"type":"string","description":"상품구성코드"},"goodsTypCd":{"type":"string","description":"상품유형코드"},"goodsReason":{"type":"string","description":"추천사유"},"entrNm":{"type":"string","description":"협력사명"},"entrNo":{"type":"string","description":"협력사번호"},"brandNm":{"type":"string","description":"브랜드명"},"saleMethCd":{"type":"string","description":"판매방식코드"},"saleStatCd":{"type":"string","description":"판매상태코드"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"buyTypCd":{"type":"string","description":"매입형태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분"},"deliWayCd":{"type":"string","description":"배송수단코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"mdNm":{"type":"string","description":"담당MD명"},"dispYn":{"type":"string","description":"전시여부"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형명"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"salePrc":{"type":"number","description":"판매가"},"dispDlexAmt":{"type":"string","description":"배송비"},"stdCtgHierarchy":{"type":"string","description":"표준 카테고리"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"rglrDeliGoodsYn":{"type":"string","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":{"/v1/goods/ai/getAiGoodsList":{"get":{"tags":["상품 AI 통신"],"summary":"AI상품 목록 조회","description":"## 기능설명\n* AI가 추천하는 상품 목록을 조회합니다.\n---\n## 상세설명\n* 검색 조건에 따라 상품 목록을 조회합니다.\n* 상품번호를 입력한 경우 상품 등록기간 조건을 무시하고 전체기간 조회합니다.\n---\n","operationId":"getAiGoodsList_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsListPopupApiRequest"}}],"responses":{"200":{"description":"AI 상품 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseAiGoodsListPopupApiResponse"}}}},"900":{"description":"AI 상품 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}}
```

## AI 상품 상세 설명 생성

> \## 기능 설명\
> 상품 기본 정보를 기반으로 AI를 이용해 상품 상세 설명을 생성합니다.\
> \<br>\<br>\
> \---\
> \## 상세 내용\
> \* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.\<br>\<br>\
> \* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.\<br>\<br>\
> \* 생성시 추가 설명을 제공할 수 있습니다.\<br>\<br><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":{"AiGoodsDescRequest":{"type":"object","description":"AI 상품 상세 설명 생성 요청 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호","minLength":1},"option":{"type":"string","description":"AI상품설명옵션(PR050)","minLength":1},"additionalInfo":{"type":"string","description":"추가정보"}},"required":["goodsNo","option"]},"AiGoodsDescResponse":{"type":"object","description":"AI 상품 상세 설명 생성 응답 DTO","properties":{"result":{"type":"string","description":"생성 결과"},"content":{"type":"string","description":"AI가 생성한 내용 (텍스트 또는 JSON 문자열)"},"citations":{"type":"array","description":"참조 문서 목록","items":{"$ref":"#/components/schemas/XgenCitation"}}}},"XgenCitation":{"type":"object","description":"XGEN 참조 문서 정보","properties":{"file_name":{"type":"string","description":"참조 파일명"},"page_number":{"type":"integer","format":"int32","description":"참조 페이지 번호"}}},"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":["상품 AI 통신"],"summary":"AI 상품 상세 설명 생성","description":"## 기능 설명\n상품 기본 정보를 기반으로 AI를 이용해 상품 상세 설명을 생성합니다.\n<br><br>\n---\n## 상세 내용\n* 단건의 상품에 대해 상품번호로 상품정보를 조회합니다.<br><br>\n* 생성 옵션은 공통코드(PR050)를 대상으로 합니다.<br><br>\n* 생성시 추가 설명을 제공할 수 있습니다.<br><br>\n","operationId":"getAiGoodsDesc_1","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/AiGoodsDescRequest"}}],"responses":{"200":{"description":"AI 상품 상세 설명 생성 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AiGoodsDescResponse"}}}},"900":{"description":"AI 상품 상세 설명 생성 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}},"deprecated":true}}}}
```