> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/api-en/store-front-api-reference/goods-api/product-detail.md).

# Product Detail

## Increase/Decrease Item Inventory

> \## Function Description\
> \* This is the API for increasing/decreasing inventory by item.\
> \---\
> \## Detailed Description\
> \* Returns an error if the deducted item quantity exceeds the inventory quantity (negative inventory).\
> \* If the increased item quantity exceeds the safety stock quantity, changes the item sales status code to On Sale.\
> \---\
> \## Notes\
> \* Processes only items with inventory management status Y.\
> \---\
> \## Code Reference\
> \* \`\`\` Inventory Increase/Decrease Code \`\`\` : 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":"Item Inventory Increase/Decrease Request","properties":{"goodsNo":{"type":"string","default":"10001741","description":"Product No."},"itmNo":{"type":"string","default":"001","description":"Item No."},"stockCnt":{"type":"integer","format":"int32","default":1,"description":"Item Quantity"},"stockIncreaseCd":{"type":"string","default":"plus","description":"Inventory Increase/Decrease Code : 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":"Return Code"},"message":{"type":"string","description":"Return Message"},"subMessages":{"type":"array","description":"Additional Message","items":{"type":"string"}},"messageType":{"type":"string","description":"Message Type"},"totalCount":{"type":"integer","format":"int64","description":"Data Row Count"},"data":{"description":"Result Data"}}},"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":["Product Detail"],"summary":"Increase/Decrease Item Inventory","description":"## Function Description\n* This is the API for increasing/decreasing inventory by item.\n---\n## Detailed Description\n* Returns an error if the deducted item quantity exceeds the inventory quantity (negative inventory).\n* If the increased item quantity exceeds the safety stock quantity, changes the item sales status code to On Sale.\n---\n## Notes\n* Processes only items with inventory management status Y.\n---\n## Code Reference\n* ``` Inventory Increase/Decrease Code ``` : 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":"Item Inventory Increase/Decrease Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseCommonResponseModelObject"}}}},"900":{"description":"Item Inventory Increase/Decrease Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Retrieve Free Gift Info

> \## Function Description\
> \* Retrieves free gift information.\
> \---\
> \## Detailed Description\
> \* Retrieves the free gift corresponding to the product.\
> \---\
> \## Validation Details\
> \* 1001 : Occurs when the request value is missing, or when the request value does not include a product number.<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":"Promotion Product Inquiry Condition DTO","properties":{"langCd":{"type":"string"},"siteNo":{"type":"string","default":"1","description":"Site No.: 1, 2, 3, ...","enum":["1"]},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dispYn":{"type":"string","default":"Y","description":"Display Status: Y/N","enum":["Y","N"]},"goodsNo":{"type":"array","description":"Product No.: 123, ...","items":{"type":"string"}},"ordMediaCd":{"type":"string","description":"Order Media Code"},"goodsList":{"type":"array","description":"Product No.: 123, ...","items":{"$ref":"#/components/schemas/PromotionGoodsRequest"}},"offset":{"type":"integer","format":"int64"}}},"PromotionGoodsRequest":{"type":"object","description":"Promotion Product Inquiry Product Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","description":"Site No."},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dpmlNo":{"type":"string","description":"Display Mall No."},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"supPcost":{"type":"integer","format":"int32","description":"Supply Price"},"salePrc":{"type":"integer","format":"int32","description":"Selling Price"},"cnt":{"type":"integer","format":"int32","description":"Product Count"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"dispCtgNo":{"type":"string","description":"Category No."},"brandNo":{"type":"string","description":"Brand No."},"entrNo":{"type":"string","description":"Vendor No."},"chlNo":{"type":"string","description":"Channel No."},"infDispCtgNoGbCd":{"type":"string","description":"Referral Display Category No. Classification Code (OM041)"},"infDispCtgNo":{"type":"string","description":"Referral Category No."},"previewDate":{"type":"string","format":"date","description":"Preview Date"},"offset":{"type":"integer","format":"int64"}}},"PrPrestHist":{"type":"object","description":"Free Gift DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"langCd":{"type":"string","description":"Language Code (CM009)"},"prestNm":{"type":"string","description":"Gift Item Name"},"useYn":{"type":"string","description":"Usage Status"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/promotion/promotionGiftList":{"post":{"tags":["Product Detail"],"summary":"Retrieve Free Gift Info","description":"## Function Description\n* Retrieves free gift information.\n---\n## Detailed Description\n* Retrieves the free gift corresponding to the product.\n---\n## Validation Details\n* 1001 : Occurs when the request value is missing, or when the request value does not include a product number.\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":"Free Gift Info Inquiry Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrPrestHist"}}}}},"900":{"description":"Free Gift Info Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Displayed Product Info (Displayed Product Summary)

> \## Function Description\
> \* This API retrieves summarized information of a product.\
> \---\
> \## Detailed Description\
> \* Supports retrieving multiple products at once.\
> \* The image provided is the product's representative image.\
> \* For preview, retrieves using the preview language code in the request; otherwise, retrieves using the language code stored in the cookie.\
> \---\
> \## Validation Details\
> \* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.<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":"Product Search Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"array","description":"Product No.","items":{"type":"string"}},"goodsNm":{"type":"array","description":"Product Name","items":{"type":"string"}},"schKwdNm":{"type":"array","description":"Search Term","items":{"type":"string"}},"brandNo":{"type":"array","description":"Brand No.","items":{"type":"string"}},"brandNm":{"type":"array","description":"Brand Name","items":{"type":"string"}},"entrNo":{"type":"string","description":"Vendor No."},"searchNm":{"type":"string","description":"Search Term (Product No., Product Name, Brand Name)"},"previewDate":{"type":"string","format":"date","description":"Preview Date"},"previewLangCd":{"type":"string","description":"Preview Language Code (CM009)"},"offset":{"type":"integer","format":"int64"}}},"ProductSummaryResponse":{"type":"object","description":"Product Search Summary Information Search Result DTO","properties":{"id":{"type":"string","description":"Product ID"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"prestNm":{"type":"string","description":"Gift Item Name"},"adveWrd":{"type":"string","description":"Promotional Text"},"schKwdNm":{"type":"array","description":"Search Keyword","items":{"type":"string"}},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code"},"deliWayCd":{"type":"string","description":"Delivery Method Code"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"rcntSalePrc":{"type":"string","description":"Recent Selling Price"},"salePrc":{"type":"number","description":"Selling Price"},"aplyPrc":{"type":"number","description":"Applied Price"},"dcRate":{"type":"integer","format":"int32","description":"Discount Rate"},"dispCtgNo":{"type":"array","description":"Display Category No.","items":{"$ref":"#/components/schemas/SearchProductCateData"}},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code"},"payWayMeanCd":{"type":"string","description":"Payment Method Code Information"},"rservSaleYn":{"type":"string","description":"Reservation Sale Status"},"goodsRevCnt":{"type":"integer","format":"int32","description":"Product Review Count"},"goodsRevHlpfulCnt":{"type":"integer","format":"int32","description":"Product Review Helpful Count"},"goodsRevStarscrAvgVal":{"type":"integer","format":"int32","description":"Product Review Average Rating"},"wishListCnt":{"type":"string","description":"Wishlist Count"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"sendGb":{"type":"string","description":"Transmission Type"},"langCd":{"type":"string","description":"Language Code"},"extraData":{"type":"string","description":"ExtraData"},"goodsRepImgPathNm":{"type":"string","description":"Product Main Image"},"trnfTextCont":{"type":"string","description":"Product Main Image Alt Text"},"iconJson":{"type":"string","description":"ICON Information"},"colorDataList":{"$ref":"#/components/schemas/SearchProductColorData","description":"Color List"},"iconList":{"type":"array","items":{"type":"string"}}}},"SearchProductCateData":{"type":"object","description":"Product Search Summary Info Search Result Category Info","properties":{"dispCtgNo":{"type":"string","description":"Display Category No."},"ctgFullPath":{"type":"string","description":"Full Category Path"},"ctgFullPathNm":{"type":"string","description":"Full Category Path Name"},"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"lrgCtgNm":{"type":"string","description":"Large Category Name"},"lrgCtgNo":{"type":"string","description":"Large Category No."}}},"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":["Product Detail"],"summary":"Retrieve Displayed Product Info (Displayed Product Summary)","description":"## Function Description\n* This API retrieves summarized information of a product.\n---\n## Detailed Description\n* Supports retrieving multiple products at once.\n* The image provided is the product's representative image.\n* For preview, retrieves using the preview language code in the request; otherwise, retrieves using the language code stored in the cookie.\n---\n## Validation Details\n* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.\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":"Product Summary Info Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductSummaryResponse"}}}},"900":{"description":"Product Summary Info Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Item Info by Product

> \## Function Description\
> \* This API retrieves item information by product.\
> \---\
> \## Detailed Description\
> \* Retrieves the information of all items within a product according to the product number.\
> \* Retrieves using the language code stored in the cookie.\
> \* Retrieves the item name, inventory information, and price information.\
> \---\
> \## Revision History\
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- Added API\
> &#x20;\- Removed the transaction start date and transaction end date conditions from the site inquiry conditions<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":"Product Detail Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"string","description":"Product No."},"schKwdNm":{"type":"string","description":"Search Term"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand No."},"lgcGoodsNo":{"type":"array","description":"Seller Product No.","items":{"type":"string"}},"itmNo":{"type":"array","description":"Item No.","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"Item Stock Quantity"},"saleStatCd":{"type":"string","default":"10","description":"Sales Status Code (PR005)"},"entrNo":{"type":"string","description":"Vendor No."},"infDispCtgNoGbCd":{"type":"string","description":"Category Referral No."},"infDispCtgNo":{"type":"string","description":"Referral Category No."},"mbrNo":{"type":"string","description":"Member No."},"callType":{"type":"string","default":"ALL","description":"Call Type","enum":["ALL","BASE","CONT"]},"chlNo":{"type":"string","description":"Channel No."},"optionItmNo":{"type":"string","description":"Item No."},"previewDate":{"type":"string","format":"date","description":"Preview Date"},"previewLangCd":{"type":"string","default":"ko","description":"Preview Language Code (CM009)"},"dispMediaCd":{"type":"string","description":"Display Media Code"}}},"ProductInfoResponse":{"type":"object","description":"Product Information Inquiry DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"lgcGoodsNo":{"type":"string","description":"Internal Product No."},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001) 10: General Product, 20: Bundled Product"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002) 10: General Product, 20: Free Gift, 30: E-Coupon Product"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003) 10: General Sale, 20: Reservation Product"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code (PR004) 0: None, 15: Age 15+, 19: Age 19+, 12: Age 12+"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 30: Discontinued"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Discontinued (Normal), 42: Discontinued (Deleted)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStrDtm":{"type":"string","format":"date-time","description":"Sales Start Date/Time"},"saleEndDtm":{"type":"string","format":"date-time","description":"Sales End Date/Time"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006) 10: Direct Purchase, 20: Consignment Sale"},"taxGbCd":{"type":"string","description":"Tax/Tax-Exempt Classification Code (PR007) 10: Taxable, 20: Tax-Exempt, 30: Zero-Rated"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008) 10: Center Delivery, 20: Vendor Delivery, 30: E-Coupon Delivery"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010) 01: General Product, 02: Installation Product, 03: Made-to-Order, 04: E-Coupon"},"deliGoodsGbCdNm":{"type":"string","description":"Delivery Product Classification Code Name"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009) 01: Courier Delivery, 02: No Delivery"},"deliWayCdNm":{"type":"string","description":"Delivery Method Code Name"},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code (PR030) 01: Nationwide, 02: Nationwide, 03: Seoul and Metropolitan Area"},"deliPsbRgnCdNm":{"type":"string","description":"Deliverable Area Code Name"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"hsCd":{"type":"string","description":"HS Code"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Application Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundle Product Priority Code (PR035) 10: Highest Priority First, 20: Lowest Price First, 30: Highest Product No. First"},"regInfPathCd":{"type":"string","description":"Registration Source Code (PR029) 01: Core System, 02: BO System, 03: Partner System"},"aprvReqDt":{"type":"string","format":"date","description":"Approval Request Date"},"aprvDt":{"type":"string","format":"date","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042) 10: Price Error, 20: Product Standard Classification Error, 30: Display Category Error, 40: Product Description, 50: Product Image Error, 60: MD Inquiry, 70: QC Related"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","format":"date","description":"Rejection Date"},"prestNm":{"type":"string","description":"Gift Item Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"goodsNm":{"type":"string","description":"Product Name"},"modlNm":{"type":"string","description":"Model Name"},"homeNm":{"type":"string","description":"Country of Origin"},"mfcoNm":{"type":"string","description":"Manufacturer Name"},"incomNm":{"type":"string","description":"Importer Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"salemnNm":{"type":"string","description":"Seller Name"},"schKwdNm":{"type":"string","description":"Search Keyword"},"adveWrd":{"type":"string","description":"Promotional Text"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"saleMethCdNm":{"type":"string","description":"Sales Method Code Name"},"entrNm":{"type":"string","description":"Vendor Name"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reserved Sale Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reserved Sale End Date/Time"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"},"norPrc":{"type":"integer","format":"int32","description":"Regular Selling Price (Previous Selling Price)"},"supPcost":{"type":"integer","format":"int32","description":"Supply Price"},"orgSalePrc":{"type":"integer","format":"int32","description":"Existing Selling Price"},"orgTaxPrc":{"type":"number","format":"double","description":"Tax Based on Original Price"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"Maximum Benefit Price"},"salePrc":{"type":"integer","format":"int32","description":"Discounted Selling Price"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"General Event Price Classification Code"},"saleRate":{"type":"integer","format":"int32","description":"Benefit Price Discount Rate vs. Previous Selling Price"},"gvgfPsbYn":{"type":"string","description":"Gift Availability Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"entrGoodsNo":{"type":"string","description":"Vendor Product No."},"ordCnclPsbYn":{"type":"string","description":"Order Cancellation Availability Status"},"wthdYn":{"type":"string","description":"Collection Status"},"ecpnAplyTermGbCd":{"type":"string","description":"E-Coupon Application Period Classification Code (MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"Usage Days Based on E-Coupon Issue Date"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"E-Coupon Usage Start Date"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"E-Coupon Usage End Date"},"timedealYn":{"type":"string","description":"Time Deal Status"},"histEndDtm":{"type":"string","format":"date","description":"Time Deal Status"},"itmInfo":{"type":"array","description":"Item Information","items":{"$ref":"#/components/schemas/ProductInfoItemResponse"}},"dispGoodsInfoList":{"type":"array","description":"Representative Display Category","items":{"$ref":"#/components/schemas/DispGoodsInfoResponse"}}}},"ProductInfoItemResponse":{"type":"object","description":"Product Information Retrieval Item DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"itmNm":{"type":"string","description":"Item Name"},"stkQty":{"type":"string","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status"},"salePrc":{"type":"string","description":"Selling Price"},"supPrc":{"type":"string","description":"Supply Price"},"norPrc":{"type":"string","description":"Regular Price"}}},"DispGoodsInfoResponse":{"type":"object","description":"Display Category Basic","properties":{"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"dpmlNm":{"type":"string","description":"Mall Name"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/productInfo":{"post":{"tags":["Product Detail"],"summary":"Retrieve Item Info by Product","description":"## Function Description\n* This API retrieves item information by product.\n---\n## Detailed Description\n* Retrieves the information of all items within a product according to the product number.\n* Retrieves using the language code stored in the cookie.\n* Retrieves the item name, inventory information, and price information.\n---\n## Revision History\n```Release v1.04_231120```\n - Added API\n - Removed the transaction start date and transaction end date conditions from the site inquiry conditions\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":"Item Info by Product Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductInfoResponse"}}}},"900":{"description":"Item Info by Product Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Retrieve Item Info by Product (Order-Only)

> \## Function Description\
> \* This API retrieves, for multiple products, item information that can be substituted for each item.\
> \---\
> \## Detailed Description\
> \* Called when retrieving multiple products.\
> \* For each requested product, retrieves the list of items, by product, among items other than the requested item that can be substituted based on product + item + quantity (a different item with the same sale price + additional item price).\
> \* Retrieves only items whose stock is greater than the requested quantity.\
> \* Retrieves using the language code stored in the cookie.<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":"Cart Product Detail Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"mallNo":{"type":"string","default":"100001","description":"Mall No."},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"array","description":"Item No.","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","default":1,"description":"Item Quantity"},"previewDate":{"type":"string","format":"date","description":"Preview Date"}}},"ProductDetailItemInfoResponse":{"type":"object","description":"Item Info by Product Inquiry DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"itmNo":{"type":"string","description":"Item No."},"itmNm":{"type":"string","description":"Item Name"},"itmSaleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"stkQty":{"type":"string","description":"Stock Quantity"},"supPcost":{"type":"string","description":"Supply Cost"},"norPrc":{"type":"string","description":"Regular Price"},"salePrc":{"type":"string","description":"Selling Price"},"dispGoodsInfoList":{"type":"array","description":"Representative Display Category","items":{"$ref":"#/components/schemas/DispGoodsInfoResponse"}},"tsalePrc":{"type":"string"},"tsupPrc":{"type":"string"}}},"DispGoodsInfoResponse":{"type":"object","description":"Display Category Basic","properties":{"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"dpmlNm":{"type":"string","description":"Mall Name"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/otherItms":{"post":{"tags":["Product Detail"],"summary":"Retrieve Item Info by Product (Order-Only)","description":"## Function Description\n* This API retrieves, for multiple products, item information that can be substituted for each item.\n---\n## Detailed Description\n* Called when retrieving multiple products.\n* For each requested product, retrieves the list of items, by product, among items other than the requested item that can be substituted based on product + item + quantity (a different item with the same sale price + additional item price).\n* Retrieves only items whose stock is greater than the requested quantity.\n* Retrieves using the language code stored in the cookie.\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":"Item Info by Item for Multiple Products Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemInfoResponse"}}}},"900":{"description":"Item Info by Item for Multiple Products Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Substitutable Product Item Info (Cart)

> \## Function Description\
> \* This API retrieves, for a single product, item information that can be substituted for each item.\
> \---\
> \## Detailed Description\
> \* An API called when retrieving a single product.\
> \* For the requested product, retrieves the list of items, among items other than the requested item, that can be substituted based on product + item + quantity (a different item with the same sale price + additional item price).\
> \* Since the product price is the same, retrieves by checking only the additional item price.\
> \* Retrieves only items whose stock is greater than the requested quantity.\
> \* Retrieves using the language code stored in the cookie.\
> \---\
> \## Revision History\
> \* Release v1.04\_231120 : Fixed the item name to be retrieved as the option name rather than the option classification name<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":"Item Detail Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"string","description":"Product No."},"schKwdNm":{"type":"string","description":"Search Term"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand No."},"lgcGoodsNo":{"type":"string","description":"Seller Product No."},"itmNo":{"type":"array","description":"Item No.","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"Item Stock Quantity"},"saleStatCd":{"type":"string","default":"10","description":"Sales Status Code"},"entrNo":{"type":"string","description":"Vendor No."}}},"ProductDetailItemInfoResponse":{"type":"object","description":"Item Info by Product Inquiry DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"itmNo":{"type":"string","description":"Item No."},"itmNm":{"type":"string","description":"Item Name"},"itmSaleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"stkQty":{"type":"string","description":"Stock Quantity"},"supPcost":{"type":"string","description":"Supply Cost"},"norPrc":{"type":"string","description":"Regular Price"},"salePrc":{"type":"string","description":"Selling Price"},"dispGoodsInfoList":{"type":"array","description":"Representative Display Category","items":{"$ref":"#/components/schemas/DispGoodsInfoResponse"}},"tsalePrc":{"type":"string"},"tsupPrc":{"type":"string"}}},"DispGoodsInfoResponse":{"type":"object","description":"Display Category Basic","properties":{"siteNo":{"type":"string","description":"Site No."},"siteNm":{"type":"string","description":"Site Name"},"dpmlNo":{"type":"string","description":"Mall No."},"dpmlNm":{"type":"string","description":"Mall Name"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/itm":{"post":{"tags":["Product Detail"],"summary":"Retrieve Substitutable Product Item Info (Cart)","description":"## Function Description\n* This API retrieves, for a single product, item information that can be substituted for each item.\n---\n## Detailed Description\n* An API called when retrieving a single product.\n* For the requested product, retrieves the list of items, among items other than the requested item, that can be substituted based on product + item + quantity (a different item with the same sale price + additional item price).\n* Since the product price is the same, retrieves by checking only the additional item price.\n* Retrieves only items whose stock is greater than the requested quantity.\n* Retrieves using the language code stored in the cookie.\n---\n## Revision History\n* Release v1.04_231120 : Fixed the item name to be retrieved as the option name rather than the option classification name\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":"Substitutable Item Info for a Single Product Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemInfoResponse"}}}},"900":{"description":"Substitutable Item Info for a Single Product Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Item Info by Product (Cart-Only)

> \## Function Description\
> \* This API retrieves detailed information on an item basis.\
> \---\
> \## Detailed Description\
> \* Called to retrieve detailed information by item on the cart page.\
> \* Retrieves the item's detailed information based on the list of item numbers received.\
> \* Retrieves using the language code, site number, and mall number stored in the cookie.\
> \---\
> \## Validation Details\
> \* 0000 : The API inquiry operated successfully.\
> \* 500 : Occurs when the request value is missing, or when the item number is missing from the request.\
> \---\
> \## Revision History\
> \`\`\`Release v1.02\_231023\`\`\`\
> &#x20;\- Added the mileage accrual availability (milgRsrvPsbYn) variable\
> &#x20;\- Added the gifting availability (gvgfPsbYn) variable\
> \
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- Changed the sale price to include the item's additional sale price, and the supply price to include the item's additional supply price\
> \
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- Added the subscription delivery product status (rglrDeliGoodsYn) variable<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":"Cart Product Detail Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"mallNo":{"type":"string","default":"100001","description":"Mall No."},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"array","description":"Item No.","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","default":1,"description":"Item Quantity"},"previewDate":{"type":"string","format":"date","description":"Preview Date"}}},"ProductOrderResponse":{"type":"object","description":"Product + SKU Search Result DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"goodsCompCdNm":{"type":"string","description":"Product Composition Code Name"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"goodsTypCdNm":{"type":"string","description":"Product Type Code Name"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"saleMethCdNm":{"type":"string","description":"Sales Method Code Name"},"brandNo":{"type":"string","description":"Brand No."},"brandNm":{"type":"string","description":"Brand Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"saleStatCdNm":{"type":"string","description":"Sales Status Code Name"},"saleStrDtm":{"type":"string","format":"date-time","description":"Sales Start Date/Time"},"saleEndDtm":{"type":"string","format":"date-time","description":"Sales End Date/Time"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006)"},"taxGbCd":{"type":"string","description":"Tax/Duty-Free Classification Code (PR007)"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"string","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"string","description":"Maximum Limit Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code (PR030)"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"supPcost":{"type":"integer","format":"int32","description":"Supply Cost"},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"preSalePrc":{"type":"integer","format":"int32","description":"Previous Selling Price"},"salePrc":{"type":"integer","format":"int32","description":"Selling Price"},"mrgnRate":{"type":"integer","format":"int64","description":"Margin Rate"},"payMeanInfo":{"type":"string","description":"Payment Method"},"itmNo":{"type":"string","description":"Item No."},"itmNm":{"type":"string","description":"Item Name"},"stkQty":{"type":"integer","format":"int32","description":"Item Quantity"},"itmSaleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"prestNm":{"type":"string","description":"Gift Item Name"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reservation Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reservation End Date/Time"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"sngGoodsYn":{"type":"string","description":"Single Product Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"},"entrGoodsNo":{"type":"string","description":"Vendor Product No."},"ordCnclPsbYn":{"type":"string","description":"Order Cancellation Availability Status"},"wthdYn":{"type":"string","description":"Collection Status"},"ecpnAplyTermGbCd":{"type":"string","description":"E-Coupon Application Period Classification Code (MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"Usage Days Based on E-Coupon Issue Date"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"E-Coupon Usage Start Date"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"E-Coupon Usage End Date"},"entrItmNo":{"type":"string","description":"Vendor SKU No."},"ecpnLinkGbCd":{"type":"string","description":"E-Coupon Integration Type Code (VD015)"},"ecpnUseYn":{"type":"string","description":"E-Coupon Usage Status"},"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":["Product Detail"],"summary":"Retrieve Item Info by Product (Cart-Only)","description":"## Function Description\n* This API retrieves detailed information on an item basis.\n---\n## Detailed Description\n* Called to retrieve detailed information by item on the cart page.\n* Retrieves the item's detailed information based on the list of item numbers received.\n* Retrieves using the language code, site number, and mall number stored in the cookie.\n---\n## Validation Details\n* 0000 : The API inquiry operated successfully.\n* 500 : Occurs when the request value is missing, or when the item number is missing from the request.\n---\n## Revision History\n```Release v1.02_231023```\n - Added the mileage accrual availability (milgRsrvPsbYn) variable\n - Added the gifting availability (gvgfPsbYn) variable\n\n```Release v1.03_231106```\n - Changed the sale price to include the item's additional sale price, and the supply price to include the item's additional supply price\n\n```Release v1.05_231204```\n - Added the subscription delivery product status (rglrDeliGoodsYn) variable\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":"Item Detail Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductOrderResponse"}}}},"900":{"description":"Item Detail Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Retrieve Available Payment Methods by Product

> \## Function Description\
> \* Retrieves payment methods by product.\
> \---\
> \## Detailed Description\
> \* Retrieves each payment method for multiple products.\
> \* Retrieves using the language code stored in the cookie.\
> \* Retrieves only payment methods whose usage status is '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":"Product + SKU Search Result DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"langCd":{"type":"string","description":"Language Code (CM009)"},"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Product Common Info"},"prBrandMst":{"$ref":"#/components/schemas/PrBrandMst","description":"Brand Information"},"prGoodsContInfo":{"type":"array","description":"Product Content Information","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"type":"array","description":"Price Info, General Product Only","items":{"$ref":"#/components/schemas/PrGoodsPrceHist"}},"prItmBase":{"type":"array","description":"Item Info, General Product Only","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsPayMeanInfo":{"type":"array","description":"Payment Method, General Product Only","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prGoodsItemInfo":{"type":"array","description":"Product Notice Item, General Product Only","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHist":{"type":"array","description":"Product Safety Certification History","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prRelGoodsInfo":{"type":"array","description":"Bundle Product, Bundle Product Only","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"prAssocGoodsInfo":{"type":"array","description":"Related Product Information","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"etDeliPolcBase":{"$ref":"#/components/schemas/EtDeliPolcBase","description":"Delivery Policy"},"etAddDlexInfo":{"type":"array","description":"Additional Delivery Fee Information","items":{"$ref":"#/components/schemas/EtAddDlexInfo"}},"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"Vendor Information"},"promoList":{"type":"array","description":"Promotion","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}},"revSummaryDto":{"$ref":"#/components/schemas/RevSummaryDto","description":"Product Review Summary"},"productDetailIconInfo":{"type":"array","description":"Product Icon Information List","items":{"$ref":"#/components/schemas/ProductDetailIconInfo"}},"prGoodsAttInfo":{"type":"array","description":"Product Category Attribute List","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}}}},"PrGoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"lgcGoodsNo":{"type":"string","description":"Internal Product No."},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001) 10: General Product, 20: Bundled Product"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002) 10: General Product, 20: Free Gift, 30: E-Coupon Product"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003) 10: General Sale, 20: Reservation Product"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code (PR004) 0: None, 15: Age 15+, 19: Age 19+, 12: Age 12+"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 30: Discontinued"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Discontinued (Normal), 42: Discontinued (Deleted)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStrDtm":{"type":"string","format":"date-time","description":"Sales Start Date/Time"},"saleEndDtm":{"type":"string","format":"date-time","description":"Sales End Date/Time"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006) 10: Direct Purchase, 20: Consignment Sale"},"taxGbCd":{"type":"string","description":"Tax/Tax-Exempt Classification Code (PR007) 10: Taxable, 20: Tax-Exempt, 30: Zero-Rated"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008) 10: Center Delivery, 20: Vendor Delivery, 30: E-Coupon Delivery"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010) 01: General Product, 02: Installation Product, 03: Made-to-Order, 04: E-Coupon"},"deliGoodsGbCdNm":{"type":"string","description":"Delivery Product Classification Code Name"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009) 01: Courier Delivery, 02: No Delivery"},"deliWayCdNm":{"type":"string","description":"Delivery Method Code Name"},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code (PR030) 01: Nationwide, 02: Nationwide, 03: Seoul and Metropolitan Area"},"deliPsbRgnCdNm":{"type":"string","description":"Deliverable Area Code Name"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"hsCd":{"type":"string","description":"HS Code"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Application Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundle Product Priority Code (PR035) 10: Highest Priority First, 20: Lowest Price First, 30: Highest Product No. First"},"regInfPathCd":{"type":"string","description":"Registration Source Code (PR029) 01: Core System, 02: BO System, 03: Partner System"},"aprvReqDt":{"type":"string","format":"date","description":"Approval Request Date"},"aprvDt":{"type":"string","format":"date","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042) 10: Price Error, 20: Product Standard Classification Error, 30: Display Category Error, 40: Product Description, 50: Product Image Error, 60: MD Inquiry, 70: QC Related"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","format":"date","description":"Rejection Date"},"prestNm":{"type":"string","description":"Gift Item Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"goodsNm":{"type":"string","description":"Product Name"},"modlNm":{"type":"string","description":"Model Name"},"homeNm":{"type":"string","description":"Country of Origin"},"mfcoNm":{"type":"string","description":"Manufacturer Name"},"incomNm":{"type":"string","description":"Importer Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"salemnNm":{"type":"string","description":"Seller Name"},"schKwdNm":{"type":"string","description":"Search Keyword"},"adveWrd":{"type":"string","description":"Promotional Text"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"saleMethCdNm":{"type":"string","description":"Sales Method Code Name"},"entrNm":{"type":"string","description":"Vendor Name"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reserved Sale Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reserved Sale End Date/Time"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"},"norPrc":{"type":"integer","format":"int32","description":"Regular Selling Price (Previous Selling Price)"},"supPcost":{"type":"integer","format":"int32","description":"Supply Price"},"orgSalePrc":{"type":"integer","format":"int32","description":"Existing Selling Price"},"orgTaxPrc":{"type":"number","format":"double","description":"Tax Based on Original Price"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"Maximum Benefit Price"},"salePrc":{"type":"integer","format":"int32","description":"Discounted Selling Price"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"General Event Price Classification Code"},"saleRate":{"type":"integer","format":"int32","description":"Benefit Price Discount Rate vs. Previous Selling Price"},"gvgfPsbYn":{"type":"string","description":"Gift Availability Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"entrGoodsNo":{"type":"string","description":"Vendor Product No."},"ordCnclPsbYn":{"type":"string","description":"Order Cancellation Availability Status"},"wthdYn":{"type":"string","description":"Collection Status"},"ecpnAplyTermGbCd":{"type":"string","description":"E-Coupon Application Period Classification Code (MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"Usage Days Based on E-Coupon Issue Date"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"E-Coupon Usage Start Date"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"E-Coupon Usage End Date"},"timedealYn":{"type":"string","description":"Time Deal Status"},"histEndDtm":{"type":"string","format":"date","description":"Time Deal Status"}}},"PrBrandMst":{"type":"object","properties":{"brandNo":{"type":"string","description":"Brand No."},"useYn":{"type":"string","description":"Usage Status"},"brandImgPathNm":{"type":"string","description":"Brand Image Path"},"brandImgFileNm":{"type":"string","description":"Brand Image File Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"brandNm":{"type":"string","description":"Brand Name"},"brandDescCmt":{"type":"string","description":"Brand Description"},"schKwdNm":{"type":"string","description":"Search Keyword"}}},"PrGoodsContInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"contTypCd":{"type":"string","description":"Content Type Code (PR017) 01: Detailed Description, 02: Video, 03: Product Image"},"contSn":{"type":"string","description":"Content Serial No."},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Default Image, M10: Video, P20: Additional Image"},"dispSeq":{"type":"string","description":"Display Order"},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"trnfTextCont":{"type":"string","description":"Alt Text Content"},"useYn":{"type":"string","description":"Usage Status"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"}}},"PrGoodsPrceHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"histStrDtm":{"type":"string","format":"date-time","description":"History Start Date/Time"},"histEndDtm":{"type":"string","format":"date-time","description":"History End Date/Time"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code (PR014)"},"supPcost":{"type":"string","description":"Supply Cost"},"norPrc":{"type":"string","description":"Regular Price"},"salePrc":{"type":"string","description":"Selling Price"},"mrgnRate":{"type":"string","description":"Margin Rate"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033) 10: Sale Price Reduction, 11: Urgent Price Change, 12: Online In-House Event, 13: Event Start, 14: Event End, 15: Price Error"}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"addSalePrc":{"type":"string","description":"Additional Sales Price"},"addMrgnRate":{"type":"string","description":"Additional Margin Rate"},"limtQty":{"type":"integer","format":"int32","description":"Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 40: Discontinued"},"dispSeq":{"type":"string","description":"Display Order"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"repItmYn":{"type":"string","description":"Representative Item Status"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Discontinued (Normal), 42: Discontinued (Deleted)"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Auto Out-of-Stock Due to Shipping Unavailable, 11: Out-of-Stock Due to Zero Inventory, 12: Manual Out-of-Stock by Admin"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"optnCatNo1":{"type":"string","description":"Option Category No._1"},"optnNo1":{"type":"string","description":"Option No._1"},"optnCatNo2":{"type":"string","description":"Option Category No._2"},"optnNo2":{"type":"string","description":"Option No._2"},"optnCatNo3":{"type":"string","description":"Option Category No._3"},"optnNo3":{"type":"string","description":"Option No._3"},"optnCatNo4":{"type":"string","description":"Option Category No._4"},"optnNo4":{"type":"string","description":"Option No._4"},"optnCatNo5":{"type":"string"},"optnNo5":{"type":"string"},"langCd":{"type":"string","description":"Language Code (CM009)"},"optnCatNm1":{"type":"string","description":"Option Category Name_1"},"optnNm1":{"type":"string","description":"Option Name 1"},"optnCatNm2":{"type":"string","description":"Option Category Name_2"},"optnNm2":{"type":"string","description":"Option Name 2"},"optnCatNm3":{"type":"string","description":"Option Category Name_3"},"optnNm3":{"type":"string","description":"Option Name 3"},"optnCatNm4":{"type":"string","description":"Option Category Name_4"},"optnNm4":{"type":"string","description":"Option Name 4"},"optnCatNm5":{"type":"string","description":"Option Category Name_5"},"optnNm5":{"type":"string","description":"Option Name 5"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"}}},"PrGoodsPayMeanInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"payWayCd":{"type":"string","description":"Payment Method Code (OM013)"},"payWayCdNm":{"type":"string","description":"Payment Method Code Name"},"useYn":{"type":"string","description":"Usage Status"},"langCd":{"type":"string","description":"Language Code (CM009)"},"cdNm":{"type":"string","description":"Code Name"},"cdDesc":{"type":"string","description":"Code Description"}}},"PrGoodsItemInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNotiLisartCd":{"type":"string","description":"Product Notice Item Code (PR012) 001, 002"},"goodsNotiItemCd":{"type":"string","description":"Product Disclosure Item Code"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"notiItemCmt":{"type":"string","description":"Notice Item Content"},"sortSeq":{"type":"string","description":"Sort Order"},"notiItemNm":{"type":"string","description":"Notice Item Name"},"goodsNotiLisartNm":{"type":"string","description":"Product Notice Item Code Name"}}},"PrGoodsSafeCertiHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"safeCertiGbCd":{"type":"string","description":"Safety Certification Type Code (PR026)"},"safeCertiNm":{"type":"string"},"safeCertiNo":{"type":"string","description":"Safety Certification No."},"aplyStrDt":{"type":"string","format":"date","description":"Application Start Date"},"aplyEndDt":{"type":"string","format":"date","description":"Application End Date"},"safeCertiOrnNm":{"type":"string","description":"Safety Certification Agency Name"}}},"PrRelGoodsInfo":{"type":"object","properties":{"baseGoodsNo":{"type":"string","description":"Reference Product No."},"tgtGoodsNo":{"type":"string","description":"Target Product No."},"tgtGoodsNm":{"type":"string","description":"Target Product Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"repYn":{"type":"string","description":"Representative Status"},"sortSeq":{"type":"string","description":"Sort Order"}}},"PrAssocGoodsInfo":{"type":"object","description":"Recommended Product","properties":{"goodsNo":{"type":"string","description":"Product No."},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"asctGbCd":{"type":"string","description":"Related Type Code (PR016)"},"asctGoodsNo":{"type":"string","description":"Related Product No."},"sortSeq":{"type":"string","description":"Sort Order"},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"contFilePathNm":{"type":"string","description":"Product Default Image"},"trnfTextCont":{"type":"string","description":"Product Default Image Alt Text"},"salePrc":{"type":"integer","format":"int32","description":"Selling Price"},"aplyPrc":{"type":"integer","format":"int32","description":"Instant Discount Applied Price"},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"saleRate":{"type":"integer","format":"int32","description":"Discount Rate"},"buyrAgeLmtCd":{"type":"string","description":"Purchase Age Restriction Code"},"iconJson":{"type":"string","description":"Icon URL"}}},"EtDeliPolcBase":{"type":"object","description":"Delivery Policy Basic Information","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":"Additional Delivery Fee Information","properties":{"deliPolcNo":{"type":"string"},"deliRegnGrpNo":{"type":"string"},"deliRegnGrpNm":{"type":"string"},"addDlexAmt":{"type":"integer","format":"int64"}}},"EtEntrBase":{"type":"object","description":"Vendor Basic Information","properties":{"entrNo":{"type":"string","description":"Vendor No."},"entrNm":{"type":"string","description":"Vendor Name"},"entrGbCd":{"type":"string","description":"Vendor Classification Code (VD001) 10: Product Supplier, 20: Affiliate Partner"},"latt":{"type":"string","description":"Latitude"},"lngt":{"type":"string","description":"Longitude"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002) 10: Direct Purchase, 20: Consignment Sale, 30: Affiliate"},"trdStatCd":{"type":"string","description":"Transaction Status Code (VD003) 10: Pending Transaction, 20: In Transaction, 30: Transaction Ended"},"lgcEntrNo":{"type":"string","description":"Core System Vendor No."},"rpstmnNm":{"type":"string","description":"Representative Name"},"bmanNo":{"type":"string","description":"Business Registration No."},"corpnNo":{"type":"string","description":"Corporate Registration No."},"btyp":{"type":"string","description":"Business Type"},"bkind":{"type":"string","description":"Business Category"},"contStrtDy":{"type":"string","description":"Contract Start Date"},"contEndDy":{"type":"string","description":"Contract End Date"},"aempNm":{"type":"string","description":"Person in Charge Name"},"aempTelRgnNo":{"type":"string","description":"Contact Person's Phone Area Code"},"aempTelTxnoNo":{"type":"string","description":"Contact Person's Phone Exchange Code"},"aempTelEndNo":{"type":"string","description":"Contact Person's Phone Last Digits"},"aempCellSctNo":{"type":"string","description":"Contact Person's Mobile Phone Prefix Code"},"aempCellTxnoNo":{"type":"string","description":"Contact Person's Mobile Phone Exchange Code"},"aempCellEndNo":{"type":"string","description":"Contact Person's Mobile Phone Last Digits"},"faxRgnNo":{"type":"string","description":"Fax Area Code"},"faxTxnoNo":{"type":"string","description":"Fax Exchange Code"},"faxEndNo":{"type":"string","description":"Fax Last Digits"},"bmanKindCd":{"type":"string","description":"Business Type Code (VD004) 10: Tax-Exempt Business, 20: General Taxable Business"},"zipNoSeq":{"type":"string","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"rmkCont":{"type":"string","description":"Remarks"},"mrgnRateGbCd":{"type":"string","description":"Margin Rate Classification Code (VD008) 10: Fixed Margin, 20: Tiered Margin"},"mrgnRate1":{"type":"string","description":"Margin Rate 1"},"mrgnRate2":{"type":"string","description":"Margin Rate 2"}}},"ProductDetailPromoResponse":{"type":"object","description":"Promotion Info by Product DTO","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)"},"dcAmt":{"type":"integer","format":"int32","description":"Promotion Discount Price"}}},"RevSummaryDto":{"type":"object","description":"Review Summary Info","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"totScr":{"type":"number","format":"double","description":"Overall Score"},"avgScr":{"type":"number","format":"double","description":"Average Score"},"revTotCnt":{"type":"integer","format":"int64","description":"Total Review Count"},"totalRevCnt":{"type":"string","description":"Total Review Count"},"photoVideoRevCnt":{"type":"string","description":"Photo/Video Review Count"},"normalRevCnt":{"type":"string","description":"General Review Count"}}},"ProductDetailIconInfo":{"type":"object","description":"Product Icon Info DTO","properties":{"iconUrl":{"type":"string","description":"Icon URL"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"Language Code (CM009)"},"goodsNo":{"type":"string","description":"Product No."},"attCd":{"type":"string","description":"Attribute Code"},"attVal":{"type":"string","description":"Attribute Value"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"attNm":{"type":"string","description":"Attribute Code Name"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goodsPayMeanList":{"post":{"tags":["Product Detail"],"summary":"Retrieve Available Payment Methods by Product","description":"## Function Description\n* Retrieves payment methods by product.\n---\n## Detailed Description\n* Retrieves each payment method for multiple products.\n* Retrieves using the language code stored in the cookie.\n* Retrieves only payment methods whose usage status is '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":"Payment Methods by Product Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailResponse"}}}},"900":{"description":"Payment Methods by Product Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Maximum Benefit Price by Product (Promotion-Provided)

> \## Function Description\
> \* This API retrieves the maximum benefit price of a product.\
> \---\
> \## Detailed Description\
> \* If the item number is missing from the request, retrieves by applying the promotional maximum benefit price based on the item with the lowest item number of the product.\
> \* If the item number is present in the request, retrieves by applying the promotional maximum benefit price based on that item number of the product.\
> \* Retrieves the list of promotions corresponding to the maximum benefit price.\
> \* Retrieves using the site number and mall number stored in the cookie.\
> \* If a channel number is present in the request, retrieves using that channel number; otherwise, retrieves using the channel number stored in the cookie.\
> \* If logged in, the logged-in user's information is applied to the promotional maximum benefit price calculation conditions.\
> \---\
> \## Validation Details\
> \* 500 : Occurs when the promotional maximum benefit price result value is an error.\
> \* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.<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":"Promotion Product Inquiry Product Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","description":"Site No."},"pageNo":{"type":"integer","format":"int32","description":"Requested Page No."},"pageSize":{"type":"integer","format":"int32","description":"Requested Page Size"},"dpmlNo":{"type":"string","description":"Display Mall No."},"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"supPcost":{"type":"integer","format":"int32","description":"Supply Price"},"salePrc":{"type":"integer","format":"int32","description":"Selling Price"},"cnt":{"type":"integer","format":"int32","description":"Product Count"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"dispCtgNo":{"type":"string","description":"Category No."},"brandNo":{"type":"string","description":"Brand No."},"entrNo":{"type":"string","description":"Vendor No."},"chlNo":{"type":"string","description":"Channel No."},"infDispCtgNoGbCd":{"type":"string","description":"Referral Display Category No. Classification Code (OM041)"},"infDispCtgNo":{"type":"string","description":"Referral Category No."},"previewDate":{"type":"string","format":"date","description":"Preview Date"},"offset":{"type":"integer","format":"int64"}}},"ProductDetailItemPriceResponse":{"type":"object","description":"Maximum Benefit Price by Product DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"salePrc":{"type":"integer","format":"int32","description":"Discounted Selling Price"},"orgSalePrc":{"type":"integer","format":"int32","description":"Existing Selling Price"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"Maximum Benefit Price"},"saleRate":{"type":"integer","format":"int32","description":"Benefit Price Discount Rate vs. Previous Selling Price"},"promoList":{"type":"array","description":"Promotion List","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}}}},"ProductDetailPromoResponse":{"type":"object","description":"Promotion Info by Product DTO","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)"},"dcAmt":{"type":"integer","format":"int32","description":"Promotion Discount Price"}}},"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":["Product Detail"],"summary":"Retrieve Maximum Benefit Price by Product (Promotion-Provided)","description":"## Function Description\n* This API retrieves the maximum benefit price of a product.\n---\n## Detailed Description\n* If the item number is missing from the request, retrieves by applying the promotional maximum benefit price based on the item with the lowest item number of the product.\n* If the item number is present in the request, retrieves by applying the promotional maximum benefit price based on that item number of the product.\n* Retrieves the list of promotions corresponding to the maximum benefit price.\n* Retrieves using the site number and mall number stored in the cookie.\n* If a channel number is present in the request, retrieves using that channel number; otherwise, retrieves using the channel number stored in the cookie.\n* If logged in, the logged-in user's information is applied to the promotional maximum benefit price calculation conditions.\n---\n## Validation Details\n* 500 : Occurs when the promotional maximum benefit price result value is an error.\n* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.\n","operationId":"getItemPriceInfo","parameters":[{"name":"goodsNo","in":"path","description":"Product No.","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":"Maximum Benefit Price by Product Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemPriceResponse"}}}},"900":{"description":"Maximum Benefit Price by Product Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Instant Discount Price by Item

> \## Function Description\
> \* This API retrieves the instant discount price by item.\
> \---\
> \## Detailed Description\
> \* Retrieves using the site number and mall number stored in the cookie.\
> \* Retrieves the price information with the instant discount price applied to the item.\
> \---\
> \## Validation Details\
> \* 500 : Occurs when the promotional instant discount price result value is an error.\
> \* 1001 : Occurs when the product number or item number is missing.<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":"Maximum Benefit Price by Product DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"salePrc":{"type":"integer","format":"int32","description":"Discounted Selling Price"},"orgSalePrc":{"type":"integer","format":"int32","description":"Existing Selling Price"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"Maximum Benefit Price"},"saleRate":{"type":"integer","format":"int32","description":"Benefit Price Discount Rate vs. Previous Selling Price"},"promoList":{"type":"array","description":"Promotion List","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}}}},"ProductDetailPromoResponse":{"type":"object","description":"Promotion Info by Product DTO","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)"},"dcAmt":{"type":"integer","format":"int32","description":"Promotion Discount Price"}}},"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":["Product Detail"],"summary":"Retrieve Instant Discount Price by Item","description":"## Function Description\n* This API retrieves the instant discount price by item.\n---\n## Detailed Description\n* Retrieves using the site number and mall number stored in the cookie.\n* Retrieves the price information with the instant discount price applied to the item.\n---\n## Validation Details\n* 500 : Occurs when the promotional instant discount price result value is an error.\n* 1001 : Occurs when the product number or item number is missing.\n","operationId":"getImmediateDcInfo","parameters":[{"name":"goodsNo","in":"path","description":"Product No.","required":true,"schema":{"type":"string"}},{"name":"itmNo","in":"path","description":"Item No.","required":true,"schema":{"type":"string"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"Instant Discount Price by Item Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailItemPriceResponse"}}}},"900":{"description":"Instant Discount Price by Item Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Retrieve Option Info (Option Popup)

> \## Function Description\
> \* This API retrieves the option information of a product.\
> \---\
> \## Detailed Description\
> \* An API to retrieve the option list for a product.\
> \* When retrieving a bundle product, retrieves the option list of the bundle product's representative product.\
> \* Retrieves the options containing items whose product display status is Y and whose item sales status is On Sale/Out of Stock.\
> \* Excludes from the inquiry any option that has no item list.\
> \* Includes the basic information of the item corresponding to the leaf option.\
> \* Retrieves using the site number and mall number stored in the cookie.\
> \* For preview, retrieves using the preview language code in the request; otherwise, retrieves using the language code stored in the cookie.\
> \---\
> \## Validation Details\
> \* 1001 : Occurs when the product number is missing from the request.\
> \* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.\
> \* 5003 : Occurs when retrieving a product whose sales has ended / that does not exist / whose required data is not entered.\
> \---\
> \## Revision History\
> \`\`\`Release v1.03\_231106\`\`\`:\
> \- Added the image path name (imgPathNm), image file name (imgFileNm), and RGB value (rgbVal) variables\
> \
> \`\`\`Release v2.00\_240401\`\`\`:\
> \- Added the item additional price (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":"Product Detail Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"string","description":"Product No."},"schKwdNm":{"type":"string","description":"Search Term"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand No."},"lgcGoodsNo":{"type":"array","description":"Seller Product No.","items":{"type":"string"}},"itmNo":{"type":"array","description":"Item No.","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"Item Stock Quantity"},"saleStatCd":{"type":"string","default":"10","description":"Sales Status Code (PR005)"},"entrNo":{"type":"string","description":"Vendor No."},"infDispCtgNoGbCd":{"type":"string","description":"Category Referral No."},"infDispCtgNo":{"type":"string","description":"Referral Category No."},"mbrNo":{"type":"string","description":"Member No."},"callType":{"type":"string","default":"ALL","description":"Call Type","enum":["ALL","BASE","CONT"]},"chlNo":{"type":"string","description":"Channel No."},"optionItmNo":{"type":"string","description":"Item No."},"previewDate":{"type":"string","format":"date","description":"Preview Date"},"previewLangCd":{"type":"string","default":"ko","description":"Preview Language Code (CM009)"},"dispMediaCd":{"type":"string","description":"Display Media Code"}}},"ProductOptionBaseResponse":{"type":"object","description":"Item Option Info and Product Basic Info Search Result DTO by Product","properties":{"optionInfo":{"$ref":"#/components/schemas/ProductOptionInfoResponse","description":"Per-Product SKU Option Information Search Result DTO"},"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Product Basic Info Search Result DTO"},"itmOptnNoArr":{"type":"array","description":"Item Option Value Array","items":{"type":"string"}}}},"ProductOptionInfoResponse":{"type":"object","description":"Per-Product SKU Option Information Search Result DTO","properties":{"optnCatNo":{"type":"string","description":"Option Classification No."},"optnNo":{"type":"string","description":"Option No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"Option Classification Sort Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Sort Order"},"itmNo":{"type":"string","description":"Item No."},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"addSalePrc":{"type":"integer","format":"int32","description":"Item Additional Price"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"},"goodsNo":{"type":"string","description":"Product No."},"leafOption":{"type":"integer","format":"int32","description":"Option Count"},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"productOption1InfoList":{"type":"array","description":"Option 1 Info List","items":{"$ref":"#/components/schemas/ProductOption1InfoResponse"}},"previewDate":{"type":"string","format":"date","description":"Product Preview Date"}}},"ProductOption1InfoResponse":{"type":"object","description":"Option 1 Info DTO","properties":{"optnCatNo":{"type":"string","description":"Option Classification No."},"optnNo":{"type":"string","description":"Option No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"Option Classification Sort Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Sort Order"},"itmNo":{"type":"string","description":"Item No."},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"addSalePrc":{"type":"integer","format":"int32","description":"Item Additional Price"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"},"productOption2InfoList":{"type":"array","description":"Option 2 Info List","items":{"$ref":"#/components/schemas/ProductOption2InfoResponse"}}}},"ProductOption2InfoResponse":{"type":"object","description":"Option 2 Info DTO","properties":{"optnCatNo":{"type":"string","description":"Option Classification No."},"optnNo":{"type":"string","description":"Option No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"Option Classification Sort Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Sort Order"},"itmNo":{"type":"string","description":"Item No."},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"addSalePrc":{"type":"integer","format":"int32","description":"Item Additional Price"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"},"productOption3InfoList":{"type":"array","description":"Option 3 Info List","items":{"$ref":"#/components/schemas/ProductOption3InfoResponse"}}}},"ProductOption3InfoResponse":{"type":"object","description":"Option 3 Info DTO","properties":{"optnCatNo":{"type":"string","description":"Option Classification No."},"optnNo":{"type":"string","description":"Option No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"Option Classification Sort Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Sort Order"},"itmNo":{"type":"string","description":"Item No."},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"addSalePrc":{"type":"integer","format":"int32","description":"Item Additional Price"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"},"productOption4InfoList":{"type":"array","description":"Option 4 Info List","items":{"$ref":"#/components/schemas/ProductOption4InfoResponse"}}}},"ProductOption4InfoResponse":{"type":"object","description":"Option 4 Info DTO","properties":{"optnCatNo":{"type":"string","description":"Option Classification No."},"optnNo":{"type":"string","description":"Option No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"Option Classification Sort Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Sort Order"},"itmNo":{"type":"string","description":"Item No."},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"addSalePrc":{"type":"integer","format":"int32","description":"Item Additional Price"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"},"productOption5InfoList":{"type":"array","description":"Option 5 Info List","items":{"$ref":"#/components/schemas/ProductOptionInfoCommonResponse"}}}},"ProductOptionInfoCommonResponse":{"type":"object","description":"Option Info Common DTO","properties":{"optnCatNo":{"type":"string","description":"Option Classification No."},"optnNo":{"type":"string","description":"Option No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"integer","format":"int32","description":"Option Classification Sort Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Sort Order"},"itmNo":{"type":"string","description":"Item No."},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005)"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"addSalePrc":{"type":"integer","format":"int32","description":"Item Additional Price"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"}}},"PrGoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"lgcGoodsNo":{"type":"string","description":"Internal Product No."},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001) 10: General Product, 20: Bundled Product"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002) 10: General Product, 20: Free Gift, 30: E-Coupon Product"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003) 10: General Sale, 20: Reservation Product"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code (PR004) 0: None, 15: Age 15+, 19: Age 19+, 12: Age 12+"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 30: Discontinued"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Discontinued (Normal), 42: Discontinued (Deleted)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStrDtm":{"type":"string","format":"date-time","description":"Sales Start Date/Time"},"saleEndDtm":{"type":"string","format":"date-time","description":"Sales End Date/Time"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006) 10: Direct Purchase, 20: Consignment Sale"},"taxGbCd":{"type":"string","description":"Tax/Tax-Exempt Classification Code (PR007) 10: Taxable, 20: Tax-Exempt, 30: Zero-Rated"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008) 10: Center Delivery, 20: Vendor Delivery, 30: E-Coupon Delivery"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010) 01: General Product, 02: Installation Product, 03: Made-to-Order, 04: E-Coupon"},"deliGoodsGbCdNm":{"type":"string","description":"Delivery Product Classification Code Name"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009) 01: Courier Delivery, 02: No Delivery"},"deliWayCdNm":{"type":"string","description":"Delivery Method Code Name"},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code (PR030) 01: Nationwide, 02: Nationwide, 03: Seoul and Metropolitan Area"},"deliPsbRgnCdNm":{"type":"string","description":"Deliverable Area Code Name"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"hsCd":{"type":"string","description":"HS Code"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Application Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundle Product Priority Code (PR035) 10: Highest Priority First, 20: Lowest Price First, 30: Highest Product No. First"},"regInfPathCd":{"type":"string","description":"Registration Source Code (PR029) 01: Core System, 02: BO System, 03: Partner System"},"aprvReqDt":{"type":"string","format":"date","description":"Approval Request Date"},"aprvDt":{"type":"string","format":"date","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042) 10: Price Error, 20: Product Standard Classification Error, 30: Display Category Error, 40: Product Description, 50: Product Image Error, 60: MD Inquiry, 70: QC Related"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","format":"date","description":"Rejection Date"},"prestNm":{"type":"string","description":"Gift Item Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"goodsNm":{"type":"string","description":"Product Name"},"modlNm":{"type":"string","description":"Model Name"},"homeNm":{"type":"string","description":"Country of Origin"},"mfcoNm":{"type":"string","description":"Manufacturer Name"},"incomNm":{"type":"string","description":"Importer Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"salemnNm":{"type":"string","description":"Seller Name"},"schKwdNm":{"type":"string","description":"Search Keyword"},"adveWrd":{"type":"string","description":"Promotional Text"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"saleMethCdNm":{"type":"string","description":"Sales Method Code Name"},"entrNm":{"type":"string","description":"Vendor Name"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reserved Sale Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reserved Sale End Date/Time"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"},"norPrc":{"type":"integer","format":"int32","description":"Regular Selling Price (Previous Selling Price)"},"supPcost":{"type":"integer","format":"int32","description":"Supply Price"},"orgSalePrc":{"type":"integer","format":"int32","description":"Existing Selling Price"},"orgTaxPrc":{"type":"number","format":"double","description":"Tax Based on Original Price"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"Maximum Benefit Price"},"salePrc":{"type":"integer","format":"int32","description":"Discounted Selling Price"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"General Event Price Classification Code"},"saleRate":{"type":"integer","format":"int32","description":"Benefit Price Discount Rate vs. Previous Selling Price"},"gvgfPsbYn":{"type":"string","description":"Gift Availability Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"entrGoodsNo":{"type":"string","description":"Vendor Product No."},"ordCnclPsbYn":{"type":"string","description":"Order Cancellation Availability Status"},"wthdYn":{"type":"string","description":"Collection Status"},"ecpnAplyTermGbCd":{"type":"string","description":"E-Coupon Application Period Classification Code (MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"Usage Days Based on E-Coupon Issue Date"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"E-Coupon Usage Start Date"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"E-Coupon Usage End Date"},"timedealYn":{"type":"string","description":"Time Deal Status"},"histEndDtm":{"type":"string","format":"date","description":"Time Deal Status"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goodsOptionInfo":{"get":{"tags":["Product Detail"],"summary":"Retrieve Option Info (Option Popup)","description":"## Function Description\n* This API retrieves the option information of a product.\n---\n## Detailed Description\n* An API to retrieve the option list for a product.\n* When retrieving a bundle product, retrieves the option list of the bundle product's representative product.\n* Retrieves the options containing items whose product display status is Y and whose item sales status is On Sale/Out of Stock.\n* Excludes from the inquiry any option that has no item list.\n* Includes the basic information of the item corresponding to the leaf option.\n* Retrieves using the site number and mall number stored in the cookie.\n* For preview, retrieves using the preview language code in the request; otherwise, retrieves using the language code stored in the cookie.\n---\n## Validation Details\n* 1001 : Occurs when the product number is missing from the request.\n* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.\n* 5003 : Occurs when retrieving a product whose sales has ended / that does not exist / whose required data is not entered.\n---\n## Revision History\n```Release v1.03_231106```:\n- Added the image path name (imgPathNm), image file name (imgFileNm), and RGB value (rgbVal) variables\n\n```Release v2.00_240401```:\n- Added the item additional price (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":"Option Info Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductOptionBaseResponse"}}}},"900":{"description":"Option Info Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Retrieve Product Detail Info

> \## Function Description\
> \* This API retrieves the detailed information of a product.\
> \---\
> \## Detailed Description\
> \* An API to retrieve detailed product information on the product detail page.\
> \* Retrieves products whose display status is Y, whose sales status is On Sale/Out of Stock, and that fall within the sales period.\
> \* Retrieves the product's basic/item/brand/image/price/payment method/related product/bundle product/delivery fee policy/promotion/free gift/review rating statistics information.\
> \* Retrieves using the language code, site number, and mall number stored in the cookie.\
> \---\
> \## Validation Details\
> \* 0000 : The API inquiry operated successfully.\
> \* 1001 : Occurs when the product number is missing from the request.\
> \* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.\
> \* 5003 : Occurs when retrieving a product whose sales has ended / that does not exist / whose required data is not entered.\
> \* 7010 : Occurs when the product has an age restriction of 19 years or older but the user is not logged in.\
> \* 7060 : Occurs when the product has an age restriction of 19 years or older and the logged-in user has not completed adult verification.\
> \---\
> \## Revision History\
> \`\`\`Release v1.02\_231023\`\`\`: Added the mileage accrual availability (milgRsrvPsbYn) variable, added the gifting availability (gvgfPsbYn) variable\
> \
> \`\`\`Release v1.03\_231106\`\`\`: Added size guide-related variables (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts), configured icon (badge)\
> \
> \`\`\`Release v1.04\_231120\`\`\`: Added subscription delivery product status (rglrDeliGoodsYn); excludes 19+ products from the list when the bundle product's purchase age restriction is not 19+\
> \
> \`\`\`Release v1.05\_231204\`\`\`: Added the standard category management attribute - product category attribute (prGoodsAttInfo)\
> \
> \`\`\`Release v2.00\_240401\`\`\`:\
> \- Added reservation start/end dates for reservation products\
> \- Added price information and sales status code within related product information\
> \
> \`\`\`Release v2.00\_240627\`\`\`: Added additional delivery fee information (etAddDlexInfo) - added additional delivery fee price information by region<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":"Product Detail Inquiry Condition DTO","properties":{"langCd":{"type":"string","default":"ko","description":"Language Code (CM009)"},"siteNo":{"type":"string","default":"1","description":"Site No."},"dispYn":{"type":"string","default":"Y","description":"Display Status","enum":["Y","N"]},"goodsNo":{"type":"string","description":"Product No."},"schKwdNm":{"type":"string","description":"Search Term"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand No."},"lgcGoodsNo":{"type":"array","description":"Seller Product No.","items":{"type":"string"}},"itmNo":{"type":"array","description":"Item No.","items":{"type":"string"}},"stkQty":{"type":"integer","format":"int64","description":"Item Stock Quantity"},"saleStatCd":{"type":"string","default":"10","description":"Sales Status Code (PR005)"},"entrNo":{"type":"string","description":"Vendor No."},"infDispCtgNoGbCd":{"type":"string","description":"Category Referral No."},"infDispCtgNo":{"type":"string","description":"Referral Category No."},"mbrNo":{"type":"string","description":"Member No."},"callType":{"type":"string","default":"ALL","description":"Call Type","enum":["ALL","BASE","CONT"]},"chlNo":{"type":"string","description":"Channel No."},"optionItmNo":{"type":"string","description":"Item No."},"previewDate":{"type":"string","format":"date","description":"Preview Date"},"previewLangCd":{"type":"string","default":"ko","description":"Preview Language Code (CM009)"},"dispMediaCd":{"type":"string","description":"Display Media Code"}}},"ProductDetailResponse":{"type":"object","description":"Product + SKU Search Result DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"langCd":{"type":"string","description":"Language Code (CM009)"},"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Product Common Info"},"prBrandMst":{"$ref":"#/components/schemas/PrBrandMst","description":"Brand Information"},"prGoodsContInfo":{"type":"array","description":"Product Content Information","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"type":"array","description":"Price Info, General Product Only","items":{"$ref":"#/components/schemas/PrGoodsPrceHist"}},"prItmBase":{"type":"array","description":"Item Info, General Product Only","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsPayMeanInfo":{"type":"array","description":"Payment Method, General Product Only","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prGoodsItemInfo":{"type":"array","description":"Product Notice Item, General Product Only","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHist":{"type":"array","description":"Product Safety Certification History","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prRelGoodsInfo":{"type":"array","description":"Bundle Product, Bundle Product Only","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"prAssocGoodsInfo":{"type":"array","description":"Related Product Information","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"etDeliPolcBase":{"$ref":"#/components/schemas/EtDeliPolcBase","description":"Delivery Policy"},"etAddDlexInfo":{"type":"array","description":"Additional Delivery Fee Information","items":{"$ref":"#/components/schemas/EtAddDlexInfo"}},"etEntrBase":{"$ref":"#/components/schemas/EtEntrBase","description":"Vendor Information"},"promoList":{"type":"array","description":"Promotion","items":{"$ref":"#/components/schemas/ProductDetailPromoResponse"}},"revSummaryDto":{"$ref":"#/components/schemas/RevSummaryDto","description":"Product Review Summary"},"productDetailIconInfo":{"type":"array","description":"Product Icon Information List","items":{"$ref":"#/components/schemas/ProductDetailIconInfo"}},"prGoodsAttInfo":{"type":"array","description":"Product Category Attribute List","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}}}},"PrGoodsBase":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"lgcGoodsNo":{"type":"string","description":"Internal Product No."},"entrNo":{"type":"string","description":"Vendor No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001) 10: General Product, 20: Bundled Product"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002) 10: General Product, 20: Free Gift, 30: E-Coupon Product"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003) 10: General Sale, 20: Reservation Product"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Buyer Age Restriction Code (PR004) 0: None, 15: Age 15+, 19: Age 19+, 12: Age 12+"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 30: Discontinued"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Discontinued (Normal), 42: Discontinued (Deleted)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"saleStrDtm":{"type":"string","format":"date-time","description":"Sales Start Date/Time"},"saleEndDtm":{"type":"string","format":"date-time","description":"Sales End Date/Time"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006) 10: Direct Purchase, 20: Consignment Sale"},"taxGbCd":{"type":"string","description":"Tax/Tax-Exempt Classification Code (PR007) 10: Taxable, 20: Tax-Exempt, 30: Zero-Rated"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"},"buyQtyLmtYn":{"type":"string","description":"Purchase Quantity Limit Status"},"minLmtQty":{"type":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008) 10: Center Delivery, 20: Vendor Delivery, 30: E-Coupon Delivery"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010) 01: General Product, 02: Installation Product, 03: Made-to-Order, 04: E-Coupon"},"deliGoodsGbCdNm":{"type":"string","description":"Delivery Product Classification Code Name"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009) 01: Courier Delivery, 02: No Delivery"},"deliWayCdNm":{"type":"string","description":"Delivery Method Code Name"},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code (PR030) 01: Nationwide, 02: Nationwide, 03: Seoul and Metropolitan Area"},"deliPsbRgnCdNm":{"type":"string","description":"Deliverable Area Code Name"},"deliDday":{"type":"string","description":"Delivery Lead Time"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"hsCd":{"type":"string","description":"HS Code"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"frgnDirPurGoodsYn":{"type":"string","description":"Overseas Direct Purchase Product Status"},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Application Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundle Product Priority Code (PR035) 10: Highest Priority First, 20: Lowest Price First, 30: Highest Product No. First"},"regInfPathCd":{"type":"string","description":"Registration Source Code (PR029) 01: Core System, 02: BO System, 03: Partner System"},"aprvReqDt":{"type":"string","format":"date","description":"Approval Request Date"},"aprvDt":{"type":"string","format":"date","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042) 10: Price Error, 20: Product Standard Classification Error, 30: Display Category Error, 40: Product Description, 50: Product Image Error, 60: MD Inquiry, 70: QC Related"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","format":"date","description":"Rejection Date"},"prestNm":{"type":"string","description":"Gift Item Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"goodsNm":{"type":"string","description":"Product Name"},"modlNm":{"type":"string","description":"Model Name"},"homeNm":{"type":"string","description":"Country of Origin"},"mfcoNm":{"type":"string","description":"Manufacturer Name"},"incomNm":{"type":"string","description":"Importer Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"salemnNm":{"type":"string","description":"Seller Name"},"schKwdNm":{"type":"string","description":"Search Keyword"},"adveWrd":{"type":"string","description":"Promotional Text"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"saleMethCdNm":{"type":"string","description":"Sales Method Code Name"},"entrNm":{"type":"string","description":"Vendor Name"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reserved Sale Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reserved Sale End Date/Time"},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispCtgNm":{"type":"string","description":"Display Category Name"},"norPrc":{"type":"integer","format":"int32","description":"Regular Selling Price (Previous Selling Price)"},"supPcost":{"type":"integer","format":"int32","description":"Supply Price"},"orgSalePrc":{"type":"integer","format":"int32","description":"Existing Selling Price"},"orgTaxPrc":{"type":"number","format":"double","description":"Tax Based on Original Price"},"maxBenefitAmt":{"type":"integer","format":"int64","description":"Maximum Benefit Price"},"salePrc":{"type":"integer","format":"int32","description":"Discounted Selling Price"},"saleTaxPrc":{"type":"number","format":"double"},"mrgnRate":{"type":"string","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"General Event Price Classification Code"},"saleRate":{"type":"integer","format":"int32","description":"Benefit Price Discount Rate vs. Previous Selling Price"},"gvgfPsbYn":{"type":"string","description":"Gift Availability Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"entrGoodsNo":{"type":"string","description":"Vendor Product No."},"ordCnclPsbYn":{"type":"string","description":"Order Cancellation Availability Status"},"wthdYn":{"type":"string","description":"Collection Status"},"ecpnAplyTermGbCd":{"type":"string","description":"E-Coupon Application Period Classification Code (MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"Usage Days Based on E-Coupon Issue Date"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"E-Coupon Usage Start Date"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"E-Coupon Usage End Date"},"timedealYn":{"type":"string","description":"Time Deal Status"},"histEndDtm":{"type":"string","format":"date","description":"Time Deal Status"}}},"PrBrandMst":{"type":"object","properties":{"brandNo":{"type":"string","description":"Brand No."},"useYn":{"type":"string","description":"Usage Status"},"brandImgPathNm":{"type":"string","description":"Brand Image Path"},"brandImgFileNm":{"type":"string","description":"Brand Image File Name"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"brandNm":{"type":"string","description":"Brand Name"},"brandDescCmt":{"type":"string","description":"Brand Description"},"schKwdNm":{"type":"string","description":"Search Keyword"}}},"PrGoodsContInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"contTypCd":{"type":"string","description":"Content Type Code (PR017) 01: Detailed Description, 02: Video, 03: Product Image"},"contSn":{"type":"string","description":"Content Serial No."},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Default Image, M10: Video, P20: Additional Image"},"dispSeq":{"type":"string","description":"Display Order"},"contFilePathNm":{"type":"string","description":"Content File Path"},"contFileNm":{"type":"string","description":"Content File Name"},"trnfTextCont":{"type":"string","description":"Alt Text Content"},"useYn":{"type":"string","description":"Usage Status"},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"}}},"PrGoodsPrceHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"histStrDtm":{"type":"string","format":"date-time","description":"History Start Date/Time"},"histEndDtm":{"type":"string","format":"date-time","description":"History End Date/Time"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code (PR014)"},"supPcost":{"type":"string","description":"Supply Cost"},"norPrc":{"type":"string","description":"Regular Price"},"salePrc":{"type":"string","description":"Selling Price"},"mrgnRate":{"type":"string","description":"Margin Rate"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033) 10: Sale Price Reduction, 11: Urgent Price Change, 12: Online In-House Event, 13: Event Start, 14: Event End, 15: Price Error"}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"addSalePrc":{"type":"string","description":"Additional Sales Price"},"addMrgnRate":{"type":"string","description":"Additional Margin Rate"},"limtQty":{"type":"integer","format":"int32","description":"Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status Code (PR005) 01: Temporary Save, 02: Pending Approval, 03: Rejected, 10: On Sale, 20: Sold Out, 40: Discontinued"},"dispSeq":{"type":"string","description":"Display Order"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"repItmYn":{"type":"string","description":"Representative Item Status"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Discontinued (Normal), 42: Discontinued (Deleted)"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Auto Out-of-Stock Due to Shipping Unavailable, 11: Out-of-Stock Due to Zero Inventory, 12: Manual Out-of-Stock by Admin"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"optnCatNo1":{"type":"string","description":"Option Category No._1"},"optnNo1":{"type":"string","description":"Option No._1"},"optnCatNo2":{"type":"string","description":"Option Category No._2"},"optnNo2":{"type":"string","description":"Option No._2"},"optnCatNo3":{"type":"string","description":"Option Category No._3"},"optnNo3":{"type":"string","description":"Option No._3"},"optnCatNo4":{"type":"string","description":"Option Category No._4"},"optnNo4":{"type":"string","description":"Option No._4"},"optnCatNo5":{"type":"string"},"optnNo5":{"type":"string"},"langCd":{"type":"string","description":"Language Code (CM009)"},"optnCatNm1":{"type":"string","description":"Option Category Name_1"},"optnNm1":{"type":"string","description":"Option Name 1"},"optnCatNm2":{"type":"string","description":"Option Category Name_2"},"optnNm2":{"type":"string","description":"Option Name 2"},"optnCatNm3":{"type":"string","description":"Option Category Name_3"},"optnNm3":{"type":"string","description":"Option Name 3"},"optnCatNm4":{"type":"string","description":"Option Category Name_4"},"optnNm4":{"type":"string","description":"Option Name 4"},"optnCatNm5":{"type":"string","description":"Option Category Name_5"},"optnNm5":{"type":"string","description":"Option Name 5"},"stkMgrYn":{"type":"string","description":"Inventory Management Status"}}},"PrGoodsPayMeanInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"payWayCd":{"type":"string","description":"Payment Method Code (OM013)"},"payWayCdNm":{"type":"string","description":"Payment Method Code Name"},"useYn":{"type":"string","description":"Usage Status"},"langCd":{"type":"string","description":"Language Code (CM009)"},"cdNm":{"type":"string","description":"Code Name"},"cdDesc":{"type":"string","description":"Code Description"}}},"PrGoodsItemInfo":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNotiLisartCd":{"type":"string","description":"Product Notice Item Code (PR012) 001, 002"},"goodsNotiItemCd":{"type":"string","description":"Product Disclosure Item Code"},"langCd":{"type":"string","description":"Language Code (CM009) ko: Korean, en: English"},"notiItemCmt":{"type":"string","description":"Notice Item Content"},"sortSeq":{"type":"string","description":"Sort Order"},"notiItemNm":{"type":"string","description":"Notice Item Name"},"goodsNotiLisartNm":{"type":"string","description":"Product Notice Item Code Name"}}},"PrGoodsSafeCertiHist":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"safeCertiGbCd":{"type":"string","description":"Safety Certification Type Code (PR026)"},"safeCertiNm":{"type":"string"},"safeCertiNo":{"type":"string","description":"Safety Certification No."},"aplyStrDt":{"type":"string","format":"date","description":"Application Start Date"},"aplyEndDt":{"type":"string","format":"date","description":"Application End Date"},"safeCertiOrnNm":{"type":"string","description":"Safety Certification Agency Name"}}},"PrRelGoodsInfo":{"type":"object","properties":{"baseGoodsNo":{"type":"string","description":"Reference Product No."},"tgtGoodsNo":{"type":"string","description":"Target Product No."},"tgtGoodsNm":{"type":"string","description":"Target Product Name"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"repYn":{"type":"string","description":"Representative Status"},"sortSeq":{"type":"string","description":"Sort Order"}}},"PrAssocGoodsInfo":{"type":"object","description":"Recommended Product","properties":{"goodsNo":{"type":"string","description":"Product No."},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"asctGbCd":{"type":"string","description":"Related Type Code (PR016)"},"asctGoodsNo":{"type":"string","description":"Related Product No."},"sortSeq":{"type":"string","description":"Sort Order"},"goodsNm":{"type":"string","description":"Product Name"},"brandNm":{"type":"string","description":"Brand Name"},"contFilePathNm":{"type":"string","description":"Product Default Image"},"trnfTextCont":{"type":"string","description":"Product Default Image Alt Text"},"salePrc":{"type":"integer","format":"int32","description":"Selling Price"},"aplyPrc":{"type":"integer","format":"int32","description":"Instant Discount Applied Price"},"norPrc":{"type":"integer","format":"int32","description":"Regular Price"},"saleRate":{"type":"integer","format":"int32","description":"Discount Rate"},"buyrAgeLmtCd":{"type":"string","description":"Purchase Age Restriction Code"},"iconJson":{"type":"string","description":"Icon URL"}}},"EtDeliPolcBase":{"type":"object","description":"Delivery Policy Basic Information","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":"Additional Delivery Fee Information","properties":{"deliPolcNo":{"type":"string"},"deliRegnGrpNo":{"type":"string"},"deliRegnGrpNm":{"type":"string"},"addDlexAmt":{"type":"integer","format":"int64"}}},"EtEntrBase":{"type":"object","description":"Vendor Basic Information","properties":{"entrNo":{"type":"string","description":"Vendor No."},"entrNm":{"type":"string","description":"Vendor Name"},"entrGbCd":{"type":"string","description":"Vendor Classification Code (VD001) 10: Product Supplier, 20: Affiliate Partner"},"latt":{"type":"string","description":"Latitude"},"lngt":{"type":"string","description":"Longitude"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002) 10: Direct Purchase, 20: Consignment Sale, 30: Affiliate"},"trdStatCd":{"type":"string","description":"Transaction Status Code (VD003) 10: Pending Transaction, 20: In Transaction, 30: Transaction Ended"},"lgcEntrNo":{"type":"string","description":"Core System Vendor No."},"rpstmnNm":{"type":"string","description":"Representative Name"},"bmanNo":{"type":"string","description":"Business Registration No."},"corpnNo":{"type":"string","description":"Corporate Registration No."},"btyp":{"type":"string","description":"Business Type"},"bkind":{"type":"string","description":"Business Category"},"contStrtDy":{"type":"string","description":"Contract Start Date"},"contEndDy":{"type":"string","description":"Contract End Date"},"aempNm":{"type":"string","description":"Person in Charge Name"},"aempTelRgnNo":{"type":"string","description":"Contact Person's Phone Area Code"},"aempTelTxnoNo":{"type":"string","description":"Contact Person's Phone Exchange Code"},"aempTelEndNo":{"type":"string","description":"Contact Person's Phone Last Digits"},"aempCellSctNo":{"type":"string","description":"Contact Person's Mobile Phone Prefix Code"},"aempCellTxnoNo":{"type":"string","description":"Contact Person's Mobile Phone Exchange Code"},"aempCellEndNo":{"type":"string","description":"Contact Person's Mobile Phone Last Digits"},"faxRgnNo":{"type":"string","description":"Fax Area Code"},"faxTxnoNo":{"type":"string","description":"Fax Exchange Code"},"faxEndNo":{"type":"string","description":"Fax Last Digits"},"bmanKindCd":{"type":"string","description":"Business Type Code (VD004) 10: Tax-Exempt Business, 20: General Taxable Business"},"zipNoSeq":{"type":"string","description":"Postal Code Sequence No."},"zipNo":{"type":"string","description":"Postal Code"},"zipAddr":{"type":"string","description":"Postal Address"},"dtlAddr":{"type":"string","description":"Detailed Address"},"rmkCont":{"type":"string","description":"Remarks"},"mrgnRateGbCd":{"type":"string","description":"Margin Rate Classification Code (VD008) 10: Fixed Margin, 20: Tiered Margin"},"mrgnRate1":{"type":"string","description":"Margin Rate 1"},"mrgnRate2":{"type":"string","description":"Margin Rate 2"}}},"ProductDetailPromoResponse":{"type":"object","description":"Promotion Info by Product DTO","properties":{"promoNo":{"type":"string","description":"Promotion No."},"promoNm":{"type":"string","description":"Promotion Name"},"promoTypCd":{"type":"string","description":"Promotion Type Code (MK002)"},"dcAmt":{"type":"integer","format":"int32","description":"Promotion Discount Price"}}},"RevSummaryDto":{"type":"object","description":"Review Summary Info","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"totScr":{"type":"number","format":"double","description":"Overall Score"},"avgScr":{"type":"number","format":"double","description":"Average Score"},"revTotCnt":{"type":"integer","format":"int64","description":"Total Review Count"},"totalRevCnt":{"type":"string","description":"Total Review Count"},"photoVideoRevCnt":{"type":"string","description":"Photo/Video Review Count"},"normalRevCnt":{"type":"string","description":"General Review Count"}}},"ProductDetailIconInfo":{"type":"object","description":"Product Icon Info DTO","properties":{"iconUrl":{"type":"string","description":"Icon URL"}}},"PrGoodsAttInfo":{"type":"object","properties":{"langCd":{"type":"string","description":"Language Code (CM009)"},"goodsNo":{"type":"string","description":"Product No."},"attCd":{"type":"string","description":"Attribute Code"},"attVal":{"type":"string","description":"Attribute Value"},"stdCtgNo":{"type":"string","description":"Standard Category No."},"attNm":{"type":"string","description":"Attribute Code Name"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/detail/goodsDetail":{"get":{"tags":["Product Detail"],"summary":"Retrieve Product Detail Info","description":"## Function Description\n* This API retrieves the detailed information of a product.\n---\n## Detailed Description\n* An API to retrieve detailed product information on the product detail page.\n* Retrieves products whose display status is Y, whose sales status is On Sale/Out of Stock, and that fall within the sales period.\n* Retrieves the product's basic/item/brand/image/price/payment method/related product/bundle product/delivery fee policy/promotion/free gift/review rating statistics information.\n* Retrieves using the language code, site number, and mall number stored in the cookie.\n---\n## Validation Details\n* 0000 : The API inquiry operated successfully.\n* 1001 : Occurs when the product number is missing from the request.\n* 5001 : Occurs when, for preview, the preview date in the request does not match the 'yyyyMMdd' format.\n* 5003 : Occurs when retrieving a product whose sales has ended / that does not exist / whose required data is not entered.\n* 7010 : Occurs when the product has an age restriction of 19 years or older but the user is not logged in.\n* 7060 : Occurs when the product has an age restriction of 19 years or older and the logged-in user has not completed adult verification.\n---\n## Revision History\n```Release v1.02_231023```: Added the mileage accrual availability (milgRsrvPsbYn) variable, added the gifting availability (gvgfPsbYn) variable\n\n```Release v1.03_231106```: Added size guide-related variables (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts), configured icon (badge)\n\n```Release v1.04_231120```: Added subscription delivery product status (rglrDeliGoodsYn); excludes 19+ products from the list when the bundle product's purchase age restriction is not 19+\n\n```Release v1.05_231204```: Added the standard category management attribute - product category attribute (prGoodsAttInfo)\n\n```Release v2.00_240401```:\n- Added reservation start/end dates for reservation products\n- Added price information and sales status code within related product information\n\n```Release v2.00_240627```: Added additional delivery fee information (etAddDlexInfo) - added additional delivery fee price information by region\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":"Product Detail Info Inquiry Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProductDetailResponse"}}}},"900":{"description":"Product Detail Info Inquiry Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````