> 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"}}}}}}}}}
````