> 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/store-front-api/goods-api/undefined-1.md).

# 상품상세

## 단품별 재고증차감

> \## 기능설명\
> \* 단품별 재고증차감 API 입니다.\
> \---\
> \## 상세설명\
> \* 차감한 단품수량이 재고수량보다 클경우 (마이너스 재고), 에러를 리턴합니다.\
> \* 증가한 단품수량이 안전재고수량보다 클경우 단품판매상태코드 판매 중으로 변경합니다.\
> \---\
> \## 특이사항\
> \* 재고관리여부 Y인 단품에 대해 처리합니다.\
> \---\
> \## 코드정리\
> \* \`\`\` 재고증차감코드 \`\`\` : plus, minus<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StockUpdateRequest":{"type":"object","description":"단품별 재고증차감 Request","properties":{"goodsNo":{"type":"string","default":"10001741","description":"상품번호"},"itmNo":{"type":"string","default":"001","description":"단품번호"},"stockCnt":{"type":"integer","format":"int32","default":1,"description":"단품수량"},"stockIncreaseCd":{"type":"string","default":"plus","description":"재고증차감코드 : plus/minus"}}},"ResponseCommonResponseModelObject":{"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/CommonResponseModelObject","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"CommonResponseModelObject":{"type":"object","properties":{"returnCode":{"type":"string","description":"리턴코드"},"message":{"type":"string","description":"리턴 메시지"},"subMessages":{"type":"array","description":"부가 메시지","items":{"type":"string"}},"messageType":{"type":"string","description":"메시지 유형"},"totalCount":{"type":"integer","format":"int64","description":"데이터 row count"},"data":{"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/order/stockUpdate":{"put":{"tags":["상품상세"],"summary":"단품별 재고증차감","description":"## 기능설명\n* 단품별 재고증차감 API 입니다.\n---\n## 상세설명\n* 차감한 단품수량이 재고수량보다 클경우 (마이너스 재고), 에러를 리턴합니다.\n* 증가한 단품수량이 안전재고수량보다 클경우 단품판매상태코드 판매 중으로 변경합니다.\n---\n## 특이사항\n* 재고관리여부 Y인 단품에 대해 처리합니다.\n---\n## 코드정리\n* ``` 재고증차감코드 ``` : plus, minus\n","operationId":"setStockUpdate","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StockUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"단품별 재고증차감 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseCommonResponseModelObject"}}}},"900":{"description":"단품별 재고증차감 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 증정품 정보 조회

> \## 기능설명\
> \* 증정품 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 상품에 해당하는 증정품을 조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request값이 없거나, request값에 상품번호가 없는 경우 발생하는 오류입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PromotionRequest":{"type":"object","description":"프로모션 상품 조회관련 조건 DTO","properties":{"langCd":{"type":"string"},"siteNo":{"type":"string","default":"1","description":"사이트번호 : 1,2,3, ...","enum":["1"]},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부 : Y/N","enum":["Y","N"]},"goodsNo":{"type":"array","description":"상품번호 : 123, ...","items":{"type":"string"}},"ordMediaCd":{"type":"string","description":"주문미디어코드"},"goodsList":{"type":"array","description":"상품번호 : 123, ...","items":{"$ref":"#/components/schemas/PromotionGoodsRequest"}},"offset":{"type":"integer","format":"int64"}}},"PromotionGoodsRequest":{"type":"object","description":"프로모션 상품 조회관련 상품조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","description":"사이트번호"},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dpmlNo":{"type":"string","description":"전시몰번호"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"supPcost":{"type":"integer","format":"int32","description":"공급가"},"salePrc":{"type":"integer","format":"int32","description":"판매가"},"cnt":{"type":"integer","format":"int32","description":"상품개수"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"카테고리번호"},"brandNo":{"type":"string","description":"브랜드번호"},"entrNo":{"type":"string","description":"협력사번호"},"chlNo":{"type":"string","description":"채널번호"},"infDispCtgNoGbCd":{"type":"string","description":"유입전시카테고리번호구분코드(OM041)"},"infDispCtgNo":{"type":"string","description":"유입카테고리번호"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"},"offset":{"type":"integer","format":"int64"}}},"PrPrestHist":{"type":"object","description":"증정품 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일시"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일시"},"langCd":{"type":"string","description":"언어코드(CM009)"},"prestNm":{"type":"string","description":"증정품명"},"useYn":{"type":"string","description":"사용여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/promotion/promotionGiftList":{"post":{"tags":["상품상세"],"summary":"증정품 정보 조회","description":"## 기능설명\n* 증정품 정보를 조회합니다.\n---\n## 상세설명\n* 상품에 해당하는 증정품을 조회합니다.\n---\n## 검증내용\n* 1001 : request값이 없거나, request값에 상품번호가 없는 경우 발생하는 오류입니다.\n","operationId":"seltPromotionGiftList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromotionRequest"}}},"required":true},"responses":{"200":{"description":"증정품 정보 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrPrestHist"}}}}},"900":{"description":"증정품 정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 전시상품정보(전시상품요약) 조회

> \## 기능설명\
> \* 상품의 요약된 정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 다건의 상품조회가 가능합니다.\
> \* 이미지는 상품의 대표이미지를 제공합니다.\
> \* 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \---\
> \## 검증내용\
> \* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductSearch":{"type":"object","description":"상품검색 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"array","description":"상품번호","items":{"type":"string"}},"goodsNm":{"type":"array","description":"상품명","items":{"type":"string"}},"schKwdNm":{"type":"array","description":"검색어","items":{"type":"string"}},"brandNo":{"type":"array","description":"브랜드번호","items":{"type":"string"}},"brandNm":{"type":"array","description":"브랜드명","items":{"type":"string"}},"entrNo":{"type":"string","description":"협력사번호"},"searchNm":{"type":"string","description":"검색어(상품번호,상품명,브랜드명)"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"},"previewLangCd":{"type":"string","description":"미리보기 언어코드(CM009)"},"offset":{"type":"integer","format":"int64"}}},"ProductSummaryResponse":{"type":"object","description":"상품검색 요약정보 검색결과 DTO","properties":{"id":{"type":"string","description":"상품ID"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"prestNm":{"type":"string","description":"증정품명"},"adveWrd":{"type":"string","description":"홍보문구"},"schKwdNm":{"type":"array","description":"검색키워드명","items":{"type":"string"}},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자연령제한코드"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStatCd":{"type":"string","description":"판매상태코드"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드"},"deliWayCd":{"type":"string","description":"배송수단코드"},"deliDday":{"type":"string","description":"배송기일"},"rcntSalePrc":{"type":"string","description":"최근판매가격"},"salePrc":{"type":"number","description":"판매가"},"aplyPrc":{"type":"number","description":"적용가"},"dcRate":{"type":"integer","format":"int32","description":"할인율"},"dispCtgNo":{"type":"array","description":"전시카테고리번호","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"배송비유형코드"},"payWayMeanCd":{"type":"string","description":"결제수단코드정보"},"rservSaleYn":{"type":"string","description":"예약판매여부"},"goodsRevCnt":{"type":"integer","format":"int32","description":"상품리뷰건수"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"상품리뷰도움돼요건수"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"상품리뷰별점평균값"},"wishListCnt":{"type":"string","description":"위시리스트수"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"sendGb":{"type":"string","description":"전송구분"},"langCd":{"type":"string","description":"언어코드"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"상품 대표이미지"},"trnfTextCont":{"type":"string","description":"상품 대표이미지 대체텍스트"},"iconJson":{"type":"string","description":"ICON 정보"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"색상 리스트"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"상품검색 요약정보 검색결과 카테고리정보","properties":{"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"ctgFullPath":{"type":"string","description":"카테고리전체경로"},"ctgFullPathNm":{"type":"string","description":"카테고리전체경로명"},"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"lrgCtgNm":{"type":"string","description":"대카테고리명"},"lrgCtgNo":{"type":"string","description":"대카테고리번호"}}},"SearchProductColorData":{"type":"object","properties":{"colorName":{"type":"string"},"subImageUrl":{"type":"string"},"score":{"type":"string"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/summary":{"post":{"tags":["상품상세"],"summary":"전시상품정보(전시상품요약) 조회","description":"## 기능설명\n* 상품의 요약된 정보를 조회하는 API입니다.\n---\n## 상세설명\n* 다건의 상품조회가 가능합니다.\n* 이미지는 상품의 대표이미지를 제공합니다.\n* 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n---\n## 검증내용\n* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.\n","operationId":"seltProductSmryInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSearch"}}},"required":true},"responses":{"200":{"description":"상품요약정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductSummaryResponse"}}}},"900":{"description":"상품요약정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 상품별 단품정보 조회

> \## 기능설명\
> \* 상품별 단품정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 상품번호에 따라 상품 내 모든 단품의 정보를 조회합니다.\
> \* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \* 단품명, 재고정보, 가격 정보를 조회합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- API 추가\
> &#x20;\- 사이트 조회 조건 중 거래시작일자, 거래종료일자 조건 제외<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductDetailRequest":{"type":"object","description":"상품상세 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"string","description":"상품번호"},"schKwdNm":{"type":"string","description":"검색어"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드번호"},"lgcGoodsNo":{"type":"array","description":"판매자 상품번호","items":{"type":"string"}},"itmNo":{"type":"array","description":"단품번호","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"단품재고수량"},"saleStatCd":{"type":"string","default":"10","description":"판매상태코드(PR005)"},"entrNo":{"type":"string","description":"협력사번호"},"infDispCtgNoGbCd":{"type":"string","description":"카테고리유입번호"},"infDispCtgNo":{"type":"string","description":"유입카테고리번호"},"mbrNo":{"type":"string","description":"회원번호"},"callType":{"type":"string","default":"ALL","description":"호출유형","enum":["ALL","BASE","CONT"]},"chlNo":{"type":"string","description":"채널번호"},"optionItmNo":{"type":"string","description":"단품번호"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"},"previewLangCd":{"type":"string","default":"ko","description":"미리보기 언어코드(CM009)"},"dispMediaCd":{"type":"string","description":"전시매체코드"}}},"ProductInfoResponse":{"type":"object","description":"상품정보조회 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약상품"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006) 10:직매입, 20:위탁판매"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007) 10:과세, 20:면세, 30:영세"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송, 30:e-쿠폰배송"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliWayCdNm":{"type":"string","description":"배송수단코드명"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030) 01:전국, 02:전국, 03:서울 및 수도권"},"deliPsbRgnCdNm":{"type":"string","description":"배송가능지역코드명"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"hsCd":{"type":"string","description":"HS코드"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 적용 방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드 코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 "},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035) 10:우선순위 높은순, 20:최저가 상품순, 30:상품번호 높은순"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029) 01:기간계 시스템, 02:BO시스템, 03:파트너시스템"},"aprvReqDt":{"type":"string","format":"date","description":"승인요청일자"},"aprvDt":{"type":"string","format":"date","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042) 10:가격오류, 20:상품표준분류오류, 30:전시카테고리오류, 40:상품기술서, 50:상품이미지오류, 60:MD문의, 70:QC관련"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","format":"date","description":"반려일자"},"prestNm":{"type":"string","description":"증정품명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"manufYm":{"type":"string","description":"제조년월"},"salemnNm":{"type":"string","description":"판매자명"},"schKwdNm":{"type":"string","description":"검색키워드명"},"adveWrd":{"type":"string","description":"홍보문구"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"entrNm":{"type":"string","description":"협력사명"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약판매시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약판매종료일시"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"},"norPrc":{"type":"integer","format":"int32","description":"정상판매가(종전판매가)"},"supPcost":{"type":"integer","format":"int32","description":"공급가"},"orgSalePrc":{"type":"integer","format":"int32","description":"기존 판매가"},"orgTaxPrc":{"type":"number","format":"double","description":"원가격 기준 세금"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"최대혜택가"},"salePrc":{"type":"integer","format":"int32","description":"할인 적용 판매가"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"일반행사가 구분코드"},"saleRate":{"type":"integer","format":"int32","description":"종전판매가 대비 혜택가 할인율"},"gvgfPsbYn":{"type":"string","description":"선물하기 가능여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"timedealYn":{"type":"string","description":"타임딜여부"},"histEndDtm":{"type":"string","format":"date","description":"타임딜여부"},"itmInfo":{"type":"array","description":"단품정보","items":{"$ref":"#/components/schemas/ProductInfoItemResponse"}},"dispGoodsInfoList":{"type":"array","description":"대표전시카테고리","items":{"$ref":"#/components/schemas/DispGoodsInfoResponse"}}}},"ProductInfoItemResponse":{"type":"object","description":"상품정보조회 단품 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"string","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태"},"salePrc":{"type":"string","description":"판매가"},"supPrc":{"type":"string","description":"공급가"},"norPrc":{"type":"string","description":"정상가"}}},"DispGoodsInfoResponse":{"type":"object","description":"전시카테고리기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"dpmlNm":{"type":"string","description":"몰명"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/productInfo":{"post":{"tags":["상품상세"],"summary":"상품별 단품정보 조회","description":"## 기능설명\n* 상품별 단품정보를 조회하는 API입니다.\n---\n## 상세설명\n* 상품번호에 따라 상품 내 모든 단품의 정보를 조회합니다.\n* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n* 단품명, 재고정보, 가격 정보를 조회합니다.\n---\n## 수정번호\n```Release v1.04_231120```\n - API 추가\n - 사이트 조회 조건 중 거래시작일자, 거래종료일자 조건 제외\n","operationId":"getProductInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductDetailRequest"}}}},"required":true},"responses":{"200":{"description":"상품별 단품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductInfoResponse"}}}},"900":{"description":"상품별 단품정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 상품별 단품정보 조회(주문전용)

> \## 기능설명\
> \* 다건 상품의 단품별 대체 가능한 단품정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 다건의 상품 조회 시 호출합니다.\
> \* 요청 받은 각 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 상품별로 단품목록을 조회합니다.\
> \* 단품재고가 요청수량보다 많은 경우만 조회합니다.\
> \* 쿠키에 저장된 언어코드를 사용하여 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductOrderDetailRequest":{"type":"object","description":"장바구니 상품상세 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"mallNo":{"type":"string","default":"100001","description":"몰번호"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"array","description":"단품번호","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","default":1,"description":"단품수량"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"}}},"ProductDetailItemInfoResponse":{"type":"object","description":"상품별 단품정보 조회 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"itmSaleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"stkQty":{"type":"string","description":"재고수량"},"supPcost":{"type":"string","description":"공급원가"},"norPrc":{"type":"string","description":"정상가"},"salePrc":{"type":"string","description":"판매가"},"dispGoodsInfoList":{"type":"array","description":"대표전시카테고리","items":{"$ref":"#/components/schemas/DispGoodsInfoResponse"}},"tsalePrc":{"type":"string"},"tsupPrc":{"type":"string"}}},"DispGoodsInfoResponse":{"type":"object","description":"전시카테고리기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"dpmlNm":{"type":"string","description":"몰명"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/otherItms":{"post":{"tags":["상품상세"],"summary":"상품별 단품정보 조회(주문전용)","description":"## 기능설명\n* 다건 상품의 단품별 대체 가능한 단품정보를 조회하는 API입니다.\n---\n## 상세설명\n* 다건의 상품 조회 시 호출합니다.\n* 요청 받은 각 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 상품별로 단품목록을 조회합니다.\n* 단품재고가 요청수량보다 많은 경우만 조회합니다.\n* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n","operationId":"getOrderItmInfos","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductOrderDetailRequest"}}}},"required":true},"responses":{"200":{"description":"다건 상품의 단품별 단품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemInfoResponse"}}}},"900":{"description":"다건 상품의 단품별 단품정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 대체가능 상품단품정보 조회(장바구니)

> \## 기능설명\
> \* 단건 상품의 단품별 대체 가능한 단품정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 단건의 상품 조회 시 호출하는 API입니다.\
> \* 요청 받은 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 단품목록을 조회합니다.\
> \* 상품가는 동일하므로 단품추가금만 확인하여 조회합니다.\
> \* 단품재고가 요청수량보다 많은 경우만 조회합니다.\
> \* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.04\_231120 : 단품명이 옵션분류명이 아닌 옵션명으로 조회하도록 수정<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductItemDetailRequest":{"type":"object","description":"단품상세 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"string","description":"상품번호"},"schKwdNm":{"type":"string","description":"검색어"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드번호"},"lgcGoodsNo":{"type":"string","description":"판매자 상품번호"},"itmNo":{"type":"array","description":"단품번호","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"단품재고수량"},"saleStatCd":{"type":"string","default":"10","description":"판매상태코드"},"entrNo":{"type":"string","description":"협력사번호"}}},"ProductDetailItemInfoResponse":{"type":"object","description":"상품별 단품정보 조회 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"itmSaleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"stkQty":{"type":"string","description":"재고수량"},"supPcost":{"type":"string","description":"공급원가"},"norPrc":{"type":"string","description":"정상가"},"salePrc":{"type":"string","description":"판매가"},"dispGoodsInfoList":{"type":"array","description":"대표전시카테고리","items":{"$ref":"#/components/schemas/DispGoodsInfoResponse"}},"tsalePrc":{"type":"string"},"tsupPrc":{"type":"string"}}},"DispGoodsInfoResponse":{"type":"object","description":"전시카테고리기본","properties":{"siteNo":{"type":"string","description":"사이트번호"},"siteNm":{"type":"string","description":"사이트명"},"dpmlNo":{"type":"string","description":"몰번호"},"dpmlNm":{"type":"string","description":"몰명"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/itm":{"post":{"tags":["상품상세"],"summary":"대체가능 상품단품정보 조회(장바구니)","description":"## 기능설명\n* 단건 상품의 단품별 대체 가능한 단품정보를 조회하는 API입니다.\n---\n## 상세설명\n* 단건의 상품 조회 시 호출하는 API입니다.\n* 요청 받은 상품에 대하여 요청한 단품외의 단품 중에 상품+단품+수량으로 대체가능(판매가격+단품추가금 동일한 다른 단품)한 단품목록을 조회합니다.\n* 상품가는 동일하므로 단품추가금만 확인하여 조회합니다.\n* 단품재고가 요청수량보다 많은 경우만 조회합니다.\n* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n---\n## 수정번호\n* Release v1.04_231120 : 단품명이 옵션분류명이 아닌 옵션명으로 조회하도록 수정\n","operationId":"getOrderItmInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductItemDetailRequest"}}},"required":true},"responses":{"200":{"description":"단건 상품의 단품별 대체 가능한 단품정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemInfoResponse"}}}},"900":{"description":"단건 상품의 단품별 대체 가능한 단품정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 상품별 단품정보 조회(장바구니전용)

> \## 기능설명\
> \* 단품 기준의 상세정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 장바구니페이지에서 단품별 상세정보를 조회하기 위해 호출합니다.\
> \* 리스트로 받은 단품번호 기준으로 단품의 상세정보를 조회합니다.\
> \* 쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.\
> \---\
> \## 검증내용\
> \* 0000 : API 조회가 성공적으로 동작한 경우입니다.\
> \* 500 : request 값이 없거나, request의 단품번호가 없는 경우 발생하는 에러입니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.02\_231023\`\`\`\
> &#x20;\- 마일리지적립가능여부(milgRsrvPsbYn) 변수추가\
> &#x20;\- 선물하기가능여부(gvgfPsbYn) 변수추가\
> \
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- 판매가에 단품추가판매가, 공급가에 단품추가공급가로 수정\
> \
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- 정기배송상품여부(rglrDeliGoodsYn) 변수추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductOrderDetailRequest":{"type":"object","description":"장바구니 상품상세 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"mallNo":{"type":"string","default":"100001","description":"몰번호"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"array","description":"단품번호","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","default":1,"description":"단품수량"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"}}},"ProductOrderResponse":{"type":"object","description":"상품+단품 검색결과 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsCompCdNm":{"type":"string","description":"상품구성코드명"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"string","description":"최소제한수량"},"maxLmtQty":{"type":"string","description":"최대제한수량"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030)"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"supPcost":{"type":"integer","format":"int32","description":"공급원가"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"preSalePrc":{"type":"integer","format":"int32","description":"종전판매가"},"salePrc":{"type":"integer","format":"int32","description":"판매가"},"mrgnRate":{"type":"integer","format":"int64","description":"마진율"},"payMeanInfo":{"type":"string","description":"결제수단"},"itmNo":{"type":"string","description":"단품번호"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"integer","format":"int32","description":"단품수량"},"itmSaleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"prestNm":{"type":"string","description":"증정품명"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약종료일시"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"entrItmNo":{"type":"string","description":"협력사단품번호"},"ecpnLinkGbCd":{"type":"string","description":"e-쿠폰연동구분코드(VD015)"},"ecpnUseYn":{"type":"string","description":"e-쿠폰사용여부"},"tsalePrc":{"type":"integer","format":"int32"},"tsupPrc":{"type":"integer","format":"int32"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goods":{"post":{"tags":["상품상세"],"summary":"상품별 단품정보 조회(장바구니전용)","description":"## 기능설명\n* 단품 기준의 상세정보를 조회하는 API입니다.\n---\n## 상세설명\n* 장바구니페이지에서 단품별 상세정보를 조회하기 위해 호출합니다.\n* 리스트로 받은 단품번호 기준으로 단품의 상세정보를 조회합니다.\n* 쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.\n---\n## 검증내용\n* 0000 : API 조회가 성공적으로 동작한 경우입니다.\n* 500 : request 값이 없거나, request의 단품번호가 없는 경우 발생하는 에러입니다.\n---\n## 수정번호\n```Release v1.02_231023```\n - 마일리지적립가능여부(milgRsrvPsbYn) 변수추가\n - 선물하기가능여부(gvgfPsbYn) 변수추가\n\n```Release v1.03_231106```\n - 판매가에 단품추가판매가, 공급가에 단품추가공급가로 수정\n\n```Release v1.05_231204```\n - 정기배송상품여부(rglrDeliGoodsYn) 변수추가\n","operationId":"seltOrderItmInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductOrderDetailRequest"}}}},"required":true},"responses":{"200":{"description":"단품상세 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductOrderResponse"}}}},"900":{"description":"단품상세 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 상품별 결제가능수단 조회

> \## 기능설명\
> \* 상품별 결제수단을 조회합니다.\
> \---\
> \## 상세설명\
> \* 다건의 상품별 각각의 결제수단을 조회합니다.\
> \* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \* 결제수단의 사용여부가 'Y'인 결제수단만 조회합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductDetailResponse":{"type":"object","description":"상품+단품 검색결과 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"상품공통정보"},"prBrandMst":{"$ref":"#/components/schemas/PrBrandMst","description":"브랜드정보"},"prGoodsContInfo":{"type":"array","description":"상품컨텐츠정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"type":"array","description":"가격정보, 일반상품전용","items":{"$ref":"#/components/schemas/PrGoodsPrceHist"}},"prItmBase":{"type":"array","description":"단품정보, 일반상품전용","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsPayMeanInfo":{"type":"array","description":"결제수단, 일반상품전용","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prGoodsItemInfo":{"type":"array","description":"상품고시품목, 일반상품전용","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHist":{"type":"array","description":"상품안전인증이력","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prRelGoodsInfo":{"type":"array","description":"묶음상품, 묶음상품전용","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"prAssocGoodsInfo":{"type":"array","description":"연관상품정보","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"etDeliPolcBase":{"$ref":"#/components/schemas/EtDeliPolcBase","description":"배송정책"},"etAddDlexInfo":{"type":"array","description":"추가배송비정보","items":{"$ref":"#/components/schemas/EtAddDlexInfo"}},"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"협력사정보"},"promoList":{"type":"array","description":"프로모션","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}},"revSummaryDto":{"$ref":"#/components/schemas/RevSummaryDto","description":"상품리뷰 요약"},"productDetailIconInfo":{"type":"array","description":"상품아이콘 정보 목록","items":{"$ref":"#/components/schemas/ProductDetailIconInfo"}},"prGoodsAttInfo":{"type":"array","description":"상품카테고리속성 목록","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}}}},"PrGoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약상품"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006) 10:직매입, 20:위탁판매"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007) 10:과세, 20:면세, 30:영세"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송, 30:e-쿠폰배송"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliWayCdNm":{"type":"string","description":"배송수단코드명"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030) 01:전국, 02:전국, 03:서울 및 수도권"},"deliPsbRgnCdNm":{"type":"string","description":"배송가능지역코드명"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"hsCd":{"type":"string","description":"HS코드"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 적용 방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드 코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 "},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035) 10:우선순위 높은순, 20:최저가 상품순, 30:상품번호 높은순"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029) 01:기간계 시스템, 02:BO시스템, 03:파트너시스템"},"aprvReqDt":{"type":"string","format":"date","description":"승인요청일자"},"aprvDt":{"type":"string","format":"date","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042) 10:가격오류, 20:상품표준분류오류, 30:전시카테고리오류, 40:상품기술서, 50:상품이미지오류, 60:MD문의, 70:QC관련"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","format":"date","description":"반려일자"},"prestNm":{"type":"string","description":"증정품명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"manufYm":{"type":"string","description":"제조년월"},"salemnNm":{"type":"string","description":"판매자명"},"schKwdNm":{"type":"string","description":"검색키워드명"},"adveWrd":{"type":"string","description":"홍보문구"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"entrNm":{"type":"string","description":"협력사명"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약판매시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약판매종료일시"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"},"norPrc":{"type":"integer","format":"int32","description":"정상판매가(종전판매가)"},"supPcost":{"type":"integer","format":"int32","description":"공급가"},"orgSalePrc":{"type":"integer","format":"int32","description":"기존 판매가"},"orgTaxPrc":{"type":"number","format":"double","description":"원가격 기준 세금"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"최대혜택가"},"salePrc":{"type":"integer","format":"int32","description":"할인 적용 판매가"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"일반행사가 구분코드"},"saleRate":{"type":"integer","format":"int32","description":"종전판매가 대비 혜택가 할인율"},"gvgfPsbYn":{"type":"string","description":"선물하기 가능여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"timedealYn":{"type":"string","description":"타임딜여부"},"histEndDtm":{"type":"string","format":"date","description":"타임딜여부"}}},"PrBrandMst":{"type":"object","properties":{"brandNo":{"type":"string","description":"브랜드번호"},"useYn":{"type":"string","description":"사용여부"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"brandNm":{"type":"string","description":"브랜드명"},"brandDescCmt":{"type":"string","description":"브랜드설명내용"},"schKwdNm":{"type":"string","description":"검색키워드명"}}},"PrGoodsContInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, M10:동영상, P20:추가이미지"},"dispSeq":{"type":"string","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"}}},"PrGoodsPrceHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드(PR014)"},"supPcost":{"type":"string","description":"공급원가"},"norPrc":{"type":"string","description":"정상가"},"salePrc":{"type":"string","description":"판매가"},"mrgnRate":{"type":"string","description":"마진율"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033) 10:판매가인하, 11:긴급매가변경, 12:온라인자체행사, 13:행사시작, 14:행사종료, 15:가격오류"}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"addSalePrc":{"type":"string","description":"추가판매가"},"addMrgnRate":{"type":"string","description":"추가마진율"},"limtQty":{"type":"integer","format":"int32","description":"한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"dispSeq":{"type":"string","description":"전시순서"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"repItmYn":{"type":"string","description":"대표단품여부"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string"},"optnNo5":{"type":"string"},"langCd":{"type":"string","description":"언어코드(CM009)"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"stkMgrYn":{"type":"string","description":"재고관리여부"}}},"PrGoodsPayMeanInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"useYn":{"type":"string","description":"사용여부"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"}}},"PrGoodsItemInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드(PR012) 001,002"},"goodsNotiItemCd":{"type":"string","description":"상품고시항목코드"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"notiItemCmt":{"type":"string","description":"고시항목내용"},"sortSeq":{"type":"string","description":"정렬순서"},"notiItemNm":{"type":"string","description":"고시항목명"},"goodsNotiLisartNm":{"type":"string","description":"상품고시항목코드명"}}},"PrGoodsSafeCertiHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"safeCertiGbCd":{"type":"string","description":"안전인증구분코드(PR026)"},"safeCertiNm":{"type":"string"},"safeCertiNo":{"type":"string","description":"안전인증번호"},"aplyStrDt":{"type":"string","format":"date","description":"적용시작일자"},"aplyEndDt":{"type":"string","format":"date","description":"적용종료일자"},"safeCertiOrnNm":{"type":"string","description":"안전인증기관명"}}},"PrRelGoodsInfo":{"type":"object","properties":{"baseGoodsNo":{"type":"string","description":"기준상품번호"},"tgtGoodsNo":{"type":"string","description":"대상상품번호"},"tgtGoodsNm":{"type":"string","description":"대상상품명"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"repYn":{"type":"string","description":"대표여부"},"sortSeq":{"type":"string","description":"정렬순서"}}},"PrAssocGoodsInfo":{"type":"object","description":"추천상품","properties":{"goodsNo":{"type":"string","description":"상품번호"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"asctGbCd":{"type":"string","description":"연관구분코드(PR016)"},"asctGoodsNo":{"type":"string","description":"연관상품번호"},"sortSeq":{"type":"string","description":"정렬순서"},"goodsNm":{"type":"string","description":"상품명"},"brandNm":{"type":"string","description":"브랜드명"},"contFilePathNm":{"type":"string","description":"상품 기본이미지"},"trnfTextCont":{"type":"string","description":"상품 기본이미지 대체 텍스트"},"salePrc":{"type":"integer","format":"int32","description":"판매가"},"aplyPrc":{"type":"integer","format":"int32","description":"즉시할인 적용가"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"saleRate":{"type":"integer","format":"int32","description":"할인율"},"buyrAgeLmtCd":{"type":"string","description":"구매연령제한코드"},"iconJson":{"type":"string","description":"아이콘 URL"}}},"EtDeliPolcBase":{"type":"object","description":"배송정책기본","properties":{"deliPolcNo":{"type":"string"},"entrNo":{"type":"string"},"dlexTypCd":{"type":"string"},"stdAmt":{"type":"integer","format":"int64"},"dlexAmt":{"type":"integer","format":"int64"},"wthdRtnAmt":{"type":"integer","format":"int64"},"exchDlex":{"type":"string"},"useYn":{"type":"string"}}},"EtAddDlexInfo":{"type":"object","description":"추가배송비정보","properties":{"deliPolcNo":{"type":"string"},"deliRegnGrpNo":{"type":"string"},"deliRegnGrpNm":{"type":"string"},"addDlexAmt":{"type":"integer","format":"int64"}}},"EtEntrBase":{"type":"object","description":"협력사기본","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자"},"latt":{"type":"string","description":"위도"},"lngt":{"type":"string","description":"경도"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002) 10:직매입, 20:위탁판매, 30:제휴사"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료"},"lgcEntrNo":{"type":"string","description":"기간계협력사번호"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanNo":{"type":"string","description":"사업자등록번호"},"corpnNo":{"type":"string","description":"법인번호"},"btyp":{"type":"string","description":"업태"},"bkind":{"type":"string","description":"업종"},"contStrtDy":{"type":"string","description":"계약시작일자"},"contEndDy":{"type":"string","description":"계약종료일자"},"aempNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"},"faxRgnNo":{"type":"string","description":"팩스지역번호"},"faxTxnoNo":{"type":"string","description":"팩스국번번호"},"faxEndNo":{"type":"string","description":"팩스끝번호"},"bmanKindCd":{"type":"string","description":"사업자종류코드(VD004) 10:면세업자, 20:일반과세자"},"zipNoSeq":{"type":"string","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rmkCont":{"type":"string","description":"비고내용"},"mrgnRateGbCd":{"type":"string","description":"마진율구분코드(VD008) 10:고정마진, 20:구간마진"},"mrgnRate1":{"type":"string","description":"마진율1"},"mrgnRate2":{"type":"string","description":"마진율2"}}},"ProductDetailPromoResponse":{"type":"object","description":"상품별 프로모션정보 DTO","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션유형코드(MK002)"},"dcAmt":{"type":"integer","format":"int32","description":"프로모션할인가격"}}},"RevSummaryDto":{"type":"object","description":"상품평 요약 정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"totScr":{"type":"number","format":"double","description":"전체점수"},"avgScr":{"type":"number","format":"double","description":"평균점수"},"revTotCnt":{"type":"integer","format":"int64","description":"리뷰전체갯수"},"totalRevCnt":{"type":"string","description":"전체 리뷰 갯수"},"photoVideoRevCnt":{"type":"string","description":"포토/동영상 리뷰 갯수"},"normalRevCnt":{"type":"string","description":"일반리뷰 갯수"}}},"ProductDetailIconInfo":{"type":"object","description":"상품아이콘정보 DTO","properties":{"iconUrl":{"type":"string","description":"아이콘 URL"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"goodsNo":{"type":"string","description":"상품번호"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"attNm":{"type":"string","description":"속성코드명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goodsPayMeanList":{"post":{"tags":["상품상세"],"summary":"상품별 결제가능수단 조회","description":"## 기능설명\n* 상품별 결제수단을 조회합니다.\n---\n## 상세설명\n* 다건의 상품별 각각의 결제수단을 조회합니다.\n* 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n* 결제수단의 사용여부가 'Y'인 결제수단만 조회합니다.\n","operationId":"seltPayMeanList","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}},"required":true},"responses":{"200":{"description":"상품별 결제수단 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailResponse"}}}},"900":{"description":"상품별 결제수단 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 상품별 최대혜택가 조회 (프로모션 제공)

> \## 기능설명\
> \* 상품의 최대혜택가를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* request에 단품번호가 없는 경우는 상품의 단품번호가 가장 빠른 단품을 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.\
> \* request에 단품번호가 있는 경우는 상품의 해당 단품번호를 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.\
> \* 최대혜택가에 해당하는 프로모션리스트를 조회합니다.\
> \* 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.\
> \* request에 채널번호가 있는 경우 해당 채널번호를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 채널번호를 사용하여 조회합니다.\
> \* 로그인을 한 경우 로그인 사용자 정보가 프로모션 최대혜택가 계산 조건에 적용됩니다.\
> \---\
> \## 검증내용\
> \* 500 : 프로모션 최대혜택가 결과값이 오류인 경우 발생하는 에러입니다.\
> \* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PromotionGoodsRequest":{"type":"object","description":"프로모션 상품 조회관련 상품조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","description":"사이트번호"},"pageNo":{"type":"integer","format":"int32","description":"호출 페이지 번호"},"pageSize":{"type":"integer","format":"int32","description":"호출 페이지 사이즈"},"dpmlNo":{"type":"string","description":"전시몰번호"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"supPcost":{"type":"integer","format":"int32","description":"공급가"},"salePrc":{"type":"integer","format":"int32","description":"판매가"},"cnt":{"type":"integer","format":"int32","description":"상품개수"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"dispCtgNo":{"type":"string","description":"카테고리번호"},"brandNo":{"type":"string","description":"브랜드번호"},"entrNo":{"type":"string","description":"협력사번호"},"chlNo":{"type":"string","description":"채널번호"},"infDispCtgNoGbCd":{"type":"string","description":"유입전시카테고리번호구분코드(OM041)"},"infDispCtgNo":{"type":"string","description":"유입카테고리번호"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"},"offset":{"type":"integer","format":"int64"}}},"ProductDetailItemPriceResponse":{"type":"object","description":"상품별 최대혜택가 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"salePrc":{"type":"integer","format":"int32","description":"할인 적용 판매가"},"orgSalePrc":{"type":"integer","format":"int32","description":"기존 판매가"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"최대혜택가"},"saleRate":{"type":"integer","format":"int32","description":"종전판매가 대비 혜택가 할인율"},"promoList":{"type":"array","description":"프로모션 List","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}}}},"ProductDetailPromoResponse":{"type":"object","description":"상품별 프로모션정보 DTO","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션유형코드(MK002)"},"dcAmt":{"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/detail/maxDc/{goodsNo}":{"get":{"tags":["상품상세"],"summary":"상품별 최대혜택가 조회 (프로모션 제공)","description":"## 기능설명\n* 상품의 최대혜택가를 조회하는 API입니다.\n---\n## 상세설명\n* request에 단품번호가 없는 경우는 상품의 단품번호가 가장 빠른 단품을 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.\n* request에 단품번호가 있는 경우는 상품의 해당 단품번호를 기준으로 프로모션 최대혜택가를 적용하여 조회합니다.\n* 최대혜택가에 해당하는 프로모션리스트를 조회합니다.\n* 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.\n* request에 채널번호가 있는 경우 해당 채널번호를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 채널번호를 사용하여 조회합니다.\n* 로그인을 한 경우 로그인 사용자 정보가 프로모션 최대혜택가 계산 조건에 적용됩니다.\n---\n## 검증내용\n* 500 : 프로모션 최대혜택가 결과값이 오류인 경우 발생하는 에러입니다.\n* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.\n","operationId":"getItemPriceInfo","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string"}},{"name":"promotionGoodsRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/PromotionGoodsRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품별 최대혜택가 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemPriceResponse"}}}},"900":{"description":"상품별 최대혜택가 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 단품별 즉시할인가 조회

> \## 기능설명\
> \* 단품별 즉시할인가를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.\
> \* 단품에 즉시할인가가 적용된 가격정보를 조회합니다.\
> \---\
> \## 검증내용\
> \* 500 : 프로모션 즉시할인가 결과값이 오류인 경우 발생하는 에러입니다.\
> \* 1001 : 상품번호, 단품번호가 없는 경우 발생하는 에러입니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductDetailItemPriceResponse":{"type":"object","description":"상품별 최대혜택가 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"salePrc":{"type":"integer","format":"int32","description":"할인 적용 판매가"},"orgSalePrc":{"type":"integer","format":"int32","description":"기존 판매가"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"최대혜택가"},"saleRate":{"type":"integer","format":"int32","description":"종전판매가 대비 혜택가 할인율"},"promoList":{"type":"array","description":"프로모션 List","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}}}},"ProductDetailPromoResponse":{"type":"object","description":"상품별 프로모션정보 DTO","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션유형코드(MK002)"},"dcAmt":{"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/detail/immediateDc/{goodsNo}/{itmNo}":{"get":{"tags":["상품상세"],"summary":"단품별 즉시할인가 조회","description":"## 기능설명\n* 단품별 즉시할인가를 조회하는 API입니다.\n---\n## 상세설명\n* 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.\n* 단품에 즉시할인가가 적용된 가격정보를 조회합니다.\n---\n## 검증내용\n* 500 : 프로모션 즉시할인가 결과값이 오류인 경우 발생하는 에러입니다.\n* 1001 : 상품번호, 단품번호가 없는 경우 발생하는 에러입니다.\n","operationId":"getImmediateDcInfo","parameters":[{"name":"goodsNo","in":"path","description":"상품번호","required":true,"schema":{"type":"string"}},{"name":"itmNo","in":"path","description":"단품번호","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"단품별 즉시할인가 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemPriceResponse"}}}},"900":{"description":"단품별 즉시할인가 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 옵션정보 조회 (옵션팝업)

> \## 기능설명\
> \* 상품의 옵션정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 상품에 대한 옵션목록을 조회하기 위한 API입니다.\
> \* 묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록을 조회합니다.\
> \* 상품의 전시여부가 Y이고, 단품의 판매상태가 판매중/품절인 단품이 속한 옵션들을 조회합니다.\
> \* 단품목록이 없는 옵션은 조회에서 제외합니다.\
> \* 리프옵션에 해당하는 단품의 기본정보를 포함합니다.\
> \* 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.\
> \* 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.\
> \---\
> \## 검증내용\
> \* 1001 : request에 상품번호가 없는 경우 발생하는 에러입니다.\
> \* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.\
> \* 5003 : 판매종료 / 존재하지 않는 상품 / 상품의 필수 데이터가 입력되지 않는 상품을 조회하는 경우 발생하는 에러입니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.03\_231106\`\`\`:\
> \- 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가\
> \
> \`\`\`Release v2.00\_240401\`\`\`:\
> \- 단품 추가 가격(addSalePrc) 추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductDetailRequest":{"type":"object","description":"상품상세 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"string","description":"상품번호"},"schKwdNm":{"type":"string","description":"검색어"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드번호"},"lgcGoodsNo":{"type":"array","description":"판매자 상품번호","items":{"type":"string"}},"itmNo":{"type":"array","description":"단품번호","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"단품재고수량"},"saleStatCd":{"type":"string","default":"10","description":"판매상태코드(PR005)"},"entrNo":{"type":"string","description":"협력사번호"},"infDispCtgNoGbCd":{"type":"string","description":"카테고리유입번호"},"infDispCtgNo":{"type":"string","description":"유입카테고리번호"},"mbrNo":{"type":"string","description":"회원번호"},"callType":{"type":"string","default":"ALL","description":"호출유형","enum":["ALL","BASE","CONT"]},"chlNo":{"type":"string","description":"채널번호"},"optionItmNo":{"type":"string","description":"단품번호"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"},"previewLangCd":{"type":"string","default":"ko","description":"미리보기 언어코드(CM009)"},"dispMediaCd":{"type":"string","description":"전시매체코드"}}},"ProductOptionBaseResponse":{"type":"object","description":"상품별 단품 옵션정보 및 상품 기본정보 검색결과 DTO","properties":{"optionInfo":{"$ref":"#/components/schemas/ProductOptionInfoResponse","description":"상품별 단품 옵션정보 검색결과 DTO"},"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"상품 기본정보 검색결과 DTO"},"itmOptnNoArr":{"type":"array","description":"단품 옵션값 Array","items":{"type":"string"}}}},"ProductOptionInfoResponse":{"type":"object","description":"상품별 단품 옵션정보 검색결과 DTO","properties":{"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류정렬순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션정렬순서"},"itmNo":{"type":"string","description":"단품번호"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"addSalePrc":{"type":"integer","format":"int32","description":"단품추가가격"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"goodsNo":{"type":"string","description":"상품번호"},"leafOption":{"type":"integer","format":"int32","description":"옵션개수"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"productOption1InfoList":{"type":"array","description":"옵션1정보 List","items":{"$ref":"#/components/schemas/ProductOption1InfoResponse"}},"previewDate":{"type":"string","format":"date","description":"상품미리보기날짜"}}},"ProductOption1InfoResponse":{"type":"object","description":"옵션1정보 DTO","properties":{"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류정렬순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션정렬순서"},"itmNo":{"type":"string","description":"단품번호"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"addSalePrc":{"type":"integer","format":"int32","description":"단품추가가격"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"productOption2InfoList":{"type":"array","description":"옵션2정보 List","items":{"$ref":"#/components/schemas/ProductOption2InfoResponse"}}}},"ProductOption2InfoResponse":{"type":"object","description":"옵션2정보 DTO","properties":{"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류정렬순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션정렬순서"},"itmNo":{"type":"string","description":"단품번호"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"addSalePrc":{"type":"integer","format":"int32","description":"단품추가가격"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"productOption3InfoList":{"type":"array","description":"옵션3정보 List","items":{"$ref":"#/components/schemas/ProductOption3InfoResponse"}}}},"ProductOption3InfoResponse":{"type":"object","description":"옵션3정보 DTO","properties":{"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류정렬순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션정렬순서"},"itmNo":{"type":"string","description":"단품번호"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"addSalePrc":{"type":"integer","format":"int32","description":"단품추가가격"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"productOption4InfoList":{"type":"array","description":"옵션4정보 List","items":{"$ref":"#/components/schemas/ProductOption4InfoResponse"}}}},"ProductOption4InfoResponse":{"type":"object","description":"옵션4정보 DTO","properties":{"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류정렬순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션정렬순서"},"itmNo":{"type":"string","description":"단품번호"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"addSalePrc":{"type":"integer","format":"int32","description":"단품추가가격"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"},"productOption5InfoList":{"type":"array","description":"옵션5정보 List","items":{"$ref":"#/components/schemas/ProductOptionInfoCommonResponse"}}}},"ProductOptionInfoCommonResponse":{"type":"object","description":"옵션정보 공통 DTO","properties":{"optnCatNo":{"type":"string","description":"옵션분류번호"},"optnNo":{"type":"string","description":"옵션번호"},"optnCatNm":{"type":"string","description":"옵션분류명"},"optnNm":{"type":"string","description":"옵션명"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"옵션분류정렬순서"},"optnSortSeq":{"type":"integer","format":"int32","description":"옵션정렬순서"},"itmNo":{"type":"string","description":"단품번호"},"limtQty":{"type":"integer","format":"int32","description":"예약한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"addSalePrc":{"type":"integer","format":"int32","description":"단품추가가격"},"imgPathNm":{"type":"string","description":"이미지경로명"},"imgFileNm":{"type":"string","description":"이미지파일명"},"rgbVal":{"type":"string","description":"RGB값"}}},"PrGoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약상품"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006) 10:직매입, 20:위탁판매"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007) 10:과세, 20:면세, 30:영세"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송, 30:e-쿠폰배송"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliWayCdNm":{"type":"string","description":"배송수단코드명"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030) 01:전국, 02:전국, 03:서울 및 수도권"},"deliPsbRgnCdNm":{"type":"string","description":"배송가능지역코드명"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"hsCd":{"type":"string","description":"HS코드"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 적용 방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드 코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 "},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035) 10:우선순위 높은순, 20:최저가 상품순, 30:상품번호 높은순"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029) 01:기간계 시스템, 02:BO시스템, 03:파트너시스템"},"aprvReqDt":{"type":"string","format":"date","description":"승인요청일자"},"aprvDt":{"type":"string","format":"date","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042) 10:가격오류, 20:상품표준분류오류, 30:전시카테고리오류, 40:상품기술서, 50:상품이미지오류, 60:MD문의, 70:QC관련"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","format":"date","description":"반려일자"},"prestNm":{"type":"string","description":"증정품명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"manufYm":{"type":"string","description":"제조년월"},"salemnNm":{"type":"string","description":"판매자명"},"schKwdNm":{"type":"string","description":"검색키워드명"},"adveWrd":{"type":"string","description":"홍보문구"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"entrNm":{"type":"string","description":"협력사명"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약판매시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약판매종료일시"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"},"norPrc":{"type":"integer","format":"int32","description":"정상판매가(종전판매가)"},"supPcost":{"type":"integer","format":"int32","description":"공급가"},"orgSalePrc":{"type":"integer","format":"int32","description":"기존 판매가"},"orgTaxPrc":{"type":"number","format":"double","description":"원가격 기준 세금"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"최대혜택가"},"salePrc":{"type":"integer","format":"int32","description":"할인 적용 판매가"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"일반행사가 구분코드"},"saleRate":{"type":"integer","format":"int32","description":"종전판매가 대비 혜택가 할인율"},"gvgfPsbYn":{"type":"string","description":"선물하기 가능여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"timedealYn":{"type":"string","description":"타임딜여부"},"histEndDtm":{"type":"string","format":"date","description":"타임딜여부"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goodsOptionInfo":{"get":{"tags":["상품상세"],"summary":"옵션정보 조회 (옵션팝업)","description":"## 기능설명\n* 상품의 옵션정보를 조회하는 API입니다.\n---\n## 상세설명\n* 상품에 대한 옵션목록을 조회하기 위한 API입니다.\n* 묶음상품을 조회하는 경우 해당 묶음상품의 대표 상품의 옵션목록을 조회합니다.\n* 상품의 전시여부가 Y이고, 단품의 판매상태가 판매중/품절인 단품이 속한 옵션들을 조회합니다.\n* 단품목록이 없는 옵션은 조회에서 제외합니다.\n* 리프옵션에 해당하는 단품의 기본정보를 포함합니다.\n* 쿠키에 저장된 사이트번호, 몰번호를 사용하여 조회합니다.\n* 미리보기의 경우 request의 미리보기 언어코드를 사용하여 조회하고, 외의 경우는 쿠키에 저장된 언어코드를 사용하여 조회합니다.\n---\n## 검증내용\n* 1001 : request에 상품번호가 없는 경우 발생하는 에러입니다.\n* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.\n* 5003 : 판매종료 / 존재하지 않는 상품 / 상품의 필수 데이터가 입력되지 않는 상품을 조회하는 경우 발생하는 에러입니다.\n---\n## 수정번호\n```Release v1.03_231106```:\n- 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가\n\n```Release v2.00_240401```:\n- 단품 추가 가격(addSalePrc) 추가\n","operationId":"seltProductOptionInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ProductDetailRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"옵션정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductOptionBaseResponse"}}}},"900":{"description":"옵션정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## 상품 상세정보 조회

> \## 기능설명\
> \* 상품의 상세정보를 조회하는 API입니다.\
> \---\
> \## 상세설명\
> \* 상품의 상세페이지에서 상품정보를 상세 조회하기 위한 API입니다.\
> \* 전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회합니다.\
> \* 상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계 정보를 조회합니다.\
> \* 쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.\
> \---\
> \## 검증내용\
> \* 0000 : API 조회가 성공적으로 동작한 경우입니다.\
> \* 1001 : request에 상품번호가 없는 경우 발생하는 에러입니다.\
> \* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.\
> \* 5003 : 판매종료 / 존재하지 않는 상품 / 상품의 필수 데이터가 입력되지 않는 상품을 조회하는 경우 발생하는 에러입니다.\
> \* 7010 : 구매 연령제한 만19세 이상 상품이지만, 로그인이 안된 경우 발생하는 에러입니다.\
> \* 7060 : 구매 연령제한 만19세 이상 상품이고, 로그인한 사용자가 성인인증이 이루어 지지 않은 경우 발생하는 에러입니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.02\_231023\`\`\`: 마일리지적립가능여부(milgRsrvPsbYn) 변수추가, 선물하기가능여부(gvgfPsbYn) 변수추가\
> \
> \`\`\`Release v1.03\_231106\`\`\`: 사이즈가이드 관련 변수(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가, 아이콘(뱃지) 설정\
> \
> \`\`\`Release v1.04\_231120\`\`\`: 정기배송상품여부(rglrDeliGoodsYn) 추가, 묶음상품의 구매제한연령이 19금이 아닐 경우, 19금 상품을 목록에서 제외\
> \
> \`\`\`Release v1.05\_231204\`\`\`: 표준카테고리 관리속성 - 상품카테고리속성(prGoodsAttInfo) 추가\
> \
> \`\`\`Release v2.00\_240401\`\`\`:\
> \- 예약상품 예약 시작일/종료일 추가\
> \- 연관상품정보 내 가격정보, 판매상태코드 추가\
> \
> \`\`\`Release v2.00\_240627\`\`\`: 추가배송비정보(etAddDlexInfo) - 지역별 추가배송비 가격정보 추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Goods API","version":"v1"},"servers":[{"url":"https://api-goods.x2bee.com/api/goods/","description":"prd"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","name":"Authorization","in":"header","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ProductDetailRequest":{"type":"object","description":"상품상세 조회관련 조건 DTO","properties":{"langCd":{"type":"string","default":"ko","description":"언어코드(CM009)"},"siteNo":{"type":"string","default":"1","description":"사이트번호"},"dispYn":{"type":"string","default":"Y","description":"전시여부","enum":["Y","N"]},"goodsNo":{"type":"string","description":"상품번호"},"schKwdNm":{"type":"string","description":"검색어"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드번호"},"lgcGoodsNo":{"type":"array","description":"판매자 상품번호","items":{"type":"string"}},"itmNo":{"type":"array","description":"단품번호","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"단품재고수량"},"saleStatCd":{"type":"string","default":"10","description":"판매상태코드(PR005)"},"entrNo":{"type":"string","description":"협력사번호"},"infDispCtgNoGbCd":{"type":"string","description":"카테고리유입번호"},"infDispCtgNo":{"type":"string","description":"유입카테고리번호"},"mbrNo":{"type":"string","description":"회원번호"},"callType":{"type":"string","default":"ALL","description":"호출유형","enum":["ALL","BASE","CONT"]},"chlNo":{"type":"string","description":"채널번호"},"optionItmNo":{"type":"string","description":"단품번호"},"previewDate":{"type":"string","format":"date","description":"미리보기날짜"},"previewLangCd":{"type":"string","default":"ko","description":"미리보기 언어코드(CM009)"},"dispMediaCd":{"type":"string","description":"전시매체코드"}}},"ProductDetailResponse":{"type":"object","description":"상품+단품 검색결과 DTO","properties":{"goodsNo":{"type":"string","description":"상품번호"},"langCd":{"type":"string","description":"언어코드(CM009)"},"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"상품공통정보"},"prBrandMst":{"$ref":"#/components/schemas/PrBrandMst","description":"브랜드정보"},"prGoodsContInfo":{"type":"array","description":"상품컨텐츠정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"type":"array","description":"가격정보, 일반상품전용","items":{"$ref":"#/components/schemas/PrGoodsPrceHist"}},"prItmBase":{"type":"array","description":"단품정보, 일반상품전용","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsPayMeanInfo":{"type":"array","description":"결제수단, 일반상품전용","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prGoodsItemInfo":{"type":"array","description":"상품고시품목, 일반상품전용","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHist":{"type":"array","description":"상품안전인증이력","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prRelGoodsInfo":{"type":"array","description":"묶음상품, 묶음상품전용","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"prAssocGoodsInfo":{"type":"array","description":"연관상품정보","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"etDeliPolcBase":{"$ref":"#/components/schemas/EtDeliPolcBase","description":"배송정책"},"etAddDlexInfo":{"type":"array","description":"추가배송비정보","items":{"$ref":"#/components/schemas/EtAddDlexInfo"}},"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"협력사정보"},"promoList":{"type":"array","description":"프로모션","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}},"revSummaryDto":{"$ref":"#/components/schemas/RevSummaryDto","description":"상품리뷰 요약"},"productDetailIconInfo":{"type":"array","description":"상품아이콘 정보 목록","items":{"$ref":"#/components/schemas/ProductDetailIconInfo"}},"prGoodsAttInfo":{"type":"array","description":"상품카테고리속성 목록","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}}}},"PrGoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001) 10:일반상품, 20:묶음상품"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002) 10:일반상품, 20:사은품, 30:e-쿠폰상품"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003) 10:일반판매, 20:예약상품"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004) 0:, 15:15세이용가, 19:19세이용가, 12:12세이용가"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 30:판매종료"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006) 10:직매입, 20:위탁판매"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007) 10:과세, 20:면세, 30:영세"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008) 10:센터배송, 20:업체배송, 30:e-쿠폰배송"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010) 01:일반상품, 02:설치상품, 03:주문제작, 04:e-쿠폰"},"deliGoodsGbCdNm":{"type":"string","description":"배송상품구분코드명"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009) 01:택배배송, 02:무배송"},"deliWayCdNm":{"type":"string","description":"배송수단코드명"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030) 01:전국, 02:전국, 03:서울 및 수도권"},"deliPsbRgnCdNm":{"type":"string","description":"배송가능지역코드명"},"deliDday":{"type":"string","description":"배송기일"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"hsCd":{"type":"string","description":"HS코드"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 적용 방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드 코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 "},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035) 10:우선순위 높은순, 20:최저가 상품순, 30:상품번호 높은순"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029) 01:기간계 시스템, 02:BO시스템, 03:파트너시스템"},"aprvReqDt":{"type":"string","format":"date","description":"승인요청일자"},"aprvDt":{"type":"string","format":"date","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042) 10:가격오류, 20:상품표준분류오류, 30:전시카테고리오류, 40:상품기술서, 50:상품이미지오류, 60:MD문의, 70:QC관련"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","format":"date","description":"반려일자"},"prestNm":{"type":"string","description":"증정품명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"manufYm":{"type":"string","description":"제조년월"},"salemnNm":{"type":"string","description":"판매자명"},"schKwdNm":{"type":"string","description":"검색키워드명"},"adveWrd":{"type":"string","description":"홍보문구"},"aplyStrDtm":{"type":"string","format":"date-time","description":"적용시작일자"},"aplyEndDtm":{"type":"string","format":"date-time","description":"적용종료일자"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"entrNm":{"type":"string","description":"협력사명"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"예약판매시작일시"},"rsvEndDtm":{"type":"string","format":"date-time","description":"예약판매종료일시"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispCtgNm":{"type":"string","description":"전시카테고리명"},"norPrc":{"type":"integer","format":"int32","description":"정상판매가(종전판매가)"},"supPcost":{"type":"integer","format":"int32","description":"공급가"},"orgSalePrc":{"type":"integer","format":"int32","description":"기존 판매가"},"orgTaxPrc":{"type":"number","format":"double","description":"원가격 기준 세금"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"최대혜택가"},"salePrc":{"type":"integer","format":"int32","description":"할인 적용 판매가"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"마진율"},"goodsPrceTypCd":{"type":"string","description":"일반행사가 구분코드"},"saleRate":{"type":"integer","format":"int32","description":"종전판매가 대비 혜택가 할인율"},"gvgfPsbYn":{"type":"string","description":"선물하기 가능여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"timedealYn":{"type":"string","description":"타임딜여부"},"histEndDtm":{"type":"string","format":"date","description":"타임딜여부"}}},"PrBrandMst":{"type":"object","properties":{"brandNo":{"type":"string","description":"브랜드번호"},"useYn":{"type":"string","description":"사용여부"},"brandImgPathNm":{"type":"string","description":"브랜드이미지경로명"},"brandImgFileNm":{"type":"string","description":"브랜드이미지파일명"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"brandNm":{"type":"string","description":"브랜드명"},"brandDescCmt":{"type":"string","description":"브랜드설명내용"},"schKwdNm":{"type":"string","description":"검색키워드명"}}},"PrGoodsContInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, M10:동영상, P20:추가이미지"},"dispSeq":{"type":"string","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"}}},"PrGoodsPrceHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"histStrDtm":{"type":"string","format":"date-time","description":"이력시작일시"},"histEndDtm":{"type":"string","format":"date-time","description":"이력종료일시"},"goodsPrceTypCd":{"type":"string","description":"상품가격유형코드(PR014)"},"supPcost":{"type":"string","description":"공급원가"},"norPrc":{"type":"string","description":"정상가"},"salePrc":{"type":"string","description":"판매가"},"mrgnRate":{"type":"string","description":"마진율"},"prcChgCausCd":{"type":"string","description":"가격변경사유코드(PR033) 10:판매가인하, 11:긴급매가변경, 12:온라인자체행사, 13:행사시작, 14:행사종료, 15:가격오류"}}},"PrItmBase":{"type":"object","description":"단품기본","properties":{"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"addSalePrc":{"type":"string","description":"추가판매가"},"addMrgnRate":{"type":"string","description":"추가마진율"},"limtQty":{"type":"integer","format":"int32","description":"한정수량"},"stkQty":{"type":"integer","format":"int32","description":"재고수량"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005) 01:임시저장, 02:승인대기, 03:반려, 10:판매중, 20:품절, 40:판매종료"},"dispSeq":{"type":"string","description":"전시순서"},"safeStkQty":{"type":"integer","format":"int32","description":"안전재고수량"},"repItmYn":{"type":"string","description":"대표단품여부"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058) 41:판매종료(정상), 42:판매종료(삭제)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032) 10:발송불가 자동품절처리, 11:재고수량 0 품절처리, 12:관리자 수동품절처리"},"lgcItmNo":{"type":"string","description":"자체단품번호"},"optnCatNo1":{"type":"string","description":"옵션분류번호_1"},"optnNo1":{"type":"string","description":"옵션번호_1"},"optnCatNo2":{"type":"string","description":"옵션분류번호_2"},"optnNo2":{"type":"string","description":"옵션번호_2"},"optnCatNo3":{"type":"string","description":"옵션분류번호_3"},"optnNo3":{"type":"string","description":"옵션번호_3"},"optnCatNo4":{"type":"string","description":"옵션분류번호_4"},"optnNo4":{"type":"string","description":"옵션번호_4"},"optnCatNo5":{"type":"string"},"optnNo5":{"type":"string"},"langCd":{"type":"string","description":"언어코드(CM009)"},"optnCatNm1":{"type":"string","description":"옵션분류명_1"},"optnNm1":{"type":"string","description":"옵션명_1"},"optnCatNm2":{"type":"string","description":"옵션분류명_2"},"optnNm2":{"type":"string","description":"옵션명_2"},"optnCatNm3":{"type":"string","description":"옵션분류명_3"},"optnNm3":{"type":"string","description":"옵션명_3"},"optnCatNm4":{"type":"string","description":"옵션분류명_4"},"optnNm4":{"type":"string","description":"옵션명_4"},"optnCatNm5":{"type":"string","description":"옵션분류명_5"},"optnNm5":{"type":"string","description":"옵션명_5"},"stkMgrYn":{"type":"string","description":"재고관리여부"}}},"PrGoodsPayMeanInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"payWayCd":{"type":"string","description":"결제수단코드(OM013)"},"payWayCdNm":{"type":"string","description":"결제수단코드명"},"useYn":{"type":"string","description":"사용여부"},"langCd":{"type":"string","description":"언어코드(CM009)"},"cdNm":{"type":"string","description":"코드명"},"cdDesc":{"type":"string","description":"코드설명"}}},"PrGoodsItemInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNotiLisartCd":{"type":"string","description":"상품고시품목코드(PR012) 001,002"},"goodsNotiItemCd":{"type":"string","description":"상품고시항목코드"},"langCd":{"type":"string","description":"언어코드(CM009) ko:한국어, en:영어"},"notiItemCmt":{"type":"string","description":"고시항목내용"},"sortSeq":{"type":"string","description":"정렬순서"},"notiItemNm":{"type":"string","description":"고시항목명"},"goodsNotiLisartNm":{"type":"string","description":"상품고시항목코드명"}}},"PrGoodsSafeCertiHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"safeCertiGbCd":{"type":"string","description":"안전인증구분코드(PR026)"},"safeCertiNm":{"type":"string"},"safeCertiNo":{"type":"string","description":"안전인증번호"},"aplyStrDt":{"type":"string","format":"date","description":"적용시작일자"},"aplyEndDt":{"type":"string","format":"date","description":"적용종료일자"},"safeCertiOrnNm":{"type":"string","description":"안전인증기관명"}}},"PrRelGoodsInfo":{"type":"object","properties":{"baseGoodsNo":{"type":"string","description":"기준상품번호"},"tgtGoodsNo":{"type":"string","description":"대상상품번호"},"tgtGoodsNm":{"type":"string","description":"대상상품명"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"repYn":{"type":"string","description":"대표여부"},"sortSeq":{"type":"string","description":"정렬순서"}}},"PrAssocGoodsInfo":{"type":"object","description":"추천상품","properties":{"goodsNo":{"type":"string","description":"상품번호"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"asctGbCd":{"type":"string","description":"연관구분코드(PR016)"},"asctGoodsNo":{"type":"string","description":"연관상품번호"},"sortSeq":{"type":"string","description":"정렬순서"},"goodsNm":{"type":"string","description":"상품명"},"brandNm":{"type":"string","description":"브랜드명"},"contFilePathNm":{"type":"string","description":"상품 기본이미지"},"trnfTextCont":{"type":"string","description":"상품 기본이미지 대체 텍스트"},"salePrc":{"type":"integer","format":"int32","description":"판매가"},"aplyPrc":{"type":"integer","format":"int32","description":"즉시할인 적용가"},"norPrc":{"type":"integer","format":"int32","description":"정상가"},"saleRate":{"type":"integer","format":"int32","description":"할인율"},"buyrAgeLmtCd":{"type":"string","description":"구매연령제한코드"},"iconJson":{"type":"string","description":"아이콘 URL"}}},"EtDeliPolcBase":{"type":"object","description":"배송정책기본","properties":{"deliPolcNo":{"type":"string"},"entrNo":{"type":"string"},"dlexTypCd":{"type":"string"},"stdAmt":{"type":"integer","format":"int64"},"dlexAmt":{"type":"integer","format":"int64"},"wthdRtnAmt":{"type":"integer","format":"int64"},"exchDlex":{"type":"string"},"useYn":{"type":"string"}}},"EtAddDlexInfo":{"type":"object","description":"추가배송비정보","properties":{"deliPolcNo":{"type":"string"},"deliRegnGrpNo":{"type":"string"},"deliRegnGrpNm":{"type":"string"},"addDlexAmt":{"type":"integer","format":"int64"}}},"EtEntrBase":{"type":"object","description":"협력사기본","properties":{"entrNo":{"type":"string","description":"협력사번호"},"entrNm":{"type":"string","description":"협력사명"},"entrGbCd":{"type":"string","description":"협력사구분코드(VD001) 10:상품공급업자, 20:제휴사업자"},"latt":{"type":"string","description":"위도"},"lngt":{"type":"string","description":"경도"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002) 10:직매입, 20:위탁판매, 30:제휴사"},"trdStatCd":{"type":"string","description":"거래상태코드(VD003) 10:거래대기, 20:거래중, 30:거래종료"},"lgcEntrNo":{"type":"string","description":"기간계협력사번호"},"rpstmnNm":{"type":"string","description":"대표자명"},"bmanNo":{"type":"string","description":"사업자등록번호"},"corpnNo":{"type":"string","description":"법인번호"},"btyp":{"type":"string","description":"업태"},"bkind":{"type":"string","description":"업종"},"contStrtDy":{"type":"string","description":"계약시작일자"},"contEndDy":{"type":"string","description":"계약종료일자"},"aempNm":{"type":"string","description":"담당자명"},"aempTelRgnNo":{"type":"string","description":"담당자전화지역번호"},"aempTelTxnoNo":{"type":"string","description":"담당자전화국번번호"},"aempTelEndNo":{"type":"string","description":"담당자전화끝번호"},"aempCellSctNo":{"type":"string","description":"담당자휴대폰구분번호"},"aempCellTxnoNo":{"type":"string","description":"담당자휴대폰국번번호"},"aempCellEndNo":{"type":"string","description":"담당자휴대폰끝번호"},"faxRgnNo":{"type":"string","description":"팩스지역번호"},"faxTxnoNo":{"type":"string","description":"팩스국번번호"},"faxEndNo":{"type":"string","description":"팩스끝번호"},"bmanKindCd":{"type":"string","description":"사업자종류코드(VD004) 10:면세업자, 20:일반과세자"},"zipNoSeq":{"type":"string","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"rmkCont":{"type":"string","description":"비고내용"},"mrgnRateGbCd":{"type":"string","description":"마진율구분코드(VD008) 10:고정마진, 20:구간마진"},"mrgnRate1":{"type":"string","description":"마진율1"},"mrgnRate2":{"type":"string","description":"마진율2"}}},"ProductDetailPromoResponse":{"type":"object","description":"상품별 프로모션정보 DTO","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션유형코드(MK002)"},"dcAmt":{"type":"integer","format":"int32","description":"프로모션할인가격"}}},"RevSummaryDto":{"type":"object","description":"상품평 요약 정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"totScr":{"type":"number","format":"double","description":"전체점수"},"avgScr":{"type":"number","format":"double","description":"평균점수"},"revTotCnt":{"type":"integer","format":"int64","description":"리뷰전체갯수"},"totalRevCnt":{"type":"string","description":"전체 리뷰 갯수"},"photoVideoRevCnt":{"type":"string","description":"포토/동영상 리뷰 갯수"},"normalRevCnt":{"type":"string","description":"일반리뷰 갯수"}}},"ProductDetailIconInfo":{"type":"object","description":"상품아이콘정보 DTO","properties":{"iconUrl":{"type":"string","description":"아이콘 URL"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"언어코드(CM009)"},"goodsNo":{"type":"string","description":"상품번호"},"attCd":{"type":"string","description":"속성코드"},"attVal":{"type":"string","description":"속성값"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"attNm":{"type":"string","description":"속성코드명"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goodsDetail":{"get":{"tags":["상품상세"],"summary":"상품 상세정보 조회","description":"## 기능설명\n* 상품의 상세정보를 조회하는 API입니다.\n---\n## 상세설명\n* 상품의 상세페이지에서 상품정보를 상세 조회하기 위한 API입니다.\n* 전시여부가 Y이고, 판매상태가 판매중/품절이고, 판매기간에 해당하는 상품을 조회합니다.\n* 상품의 기본/단품/브랜드/이미지/가격/결제수단/연관상품/묶음상품/배송비정책/프로모션/증정품/리뷰별점통계 정보를 조회합니다.\n* 쿠키에 저장된 언어코드, 사이트번호, 몰번호를 사용하여 조회합니다.\n---\n## 검증내용\n* 0000 : API 조회가 성공적으로 동작한 경우입니다.\n* 1001 : request에 상품번호가 없는 경우 발생하는 에러입니다.\n* 5001 : 미리보기의 경우 request에 미리보기날짜가 'yyyyMMdd'형식에 맞지 않는 경우 발생하는 에러입니다.\n* 5003 : 판매종료 / 존재하지 않는 상품 / 상품의 필수 데이터가 입력되지 않는 상품을 조회하는 경우 발생하는 에러입니다.\n* 7010 : 구매 연령제한 만19세 이상 상품이지만, 로그인이 안된 경우 발생하는 에러입니다.\n* 7060 : 구매 연령제한 만19세 이상 상품이고, 로그인한 사용자가 성인인증이 이루어 지지 않은 경우 발생하는 에러입니다.\n---\n## 수정번호\n```Release v1.02_231023```: 마일리지적립가능여부(milgRsrvPsbYn) 변수추가, 선물하기가능여부(gvgfPsbYn) 변수추가\n\n```Release v1.03_231106```: 사이즈가이드 관련 변수(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가, 아이콘(뱃지) 설정\n\n```Release v1.04_231120```: 정기배송상품여부(rglrDeliGoodsYn) 추가, 묶음상품의 구매제한연령이 19금이 아닐 경우, 19금 상품을 목록에서 제외\n\n```Release v1.05_231204```: 표준카테고리 관리속성 - 상품카테고리속성(prGoodsAttInfo) 추가\n\n```Release v2.00_240401```:\n- 예약상품 예약 시작일/종료일 추가\n- 연관상품정보 내 가격정보, 판매상태코드 추가\n\n```Release v2.00_240627```: 추가배송비정보(etAddDlexInfo) - 지역별 추가배송비 가격정보 추가\n","operationId":"seltProductDetailInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/ProductDetailRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"상품 상세정보 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailResponse"}}}},"900":{"description":"상품 상세정보 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/api/store-front-api/goods-api/undefined-1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.