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

# Product Common

## Save Image

> \## Function Description\
> \* Registers product images.\
> \---\
> \## Detailed Description\
> \* Registers product images to S3.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}}}},"paths":{"/v2/goods/goodsCommonApi/uploadGoodsImage":{"post":{"tags":["Product Common"],"summary":"Save Image","description":"## Function Description\n* Registers product images.\n---\n## Detailed Description\n* Registers product images to S3.\n","operationId":"uploadGoodsRegistImageFile","parameters":[{"name":"files","in":"query","description":"Image File List","required":true,"schema":{"type":"string","format":"binary"}},{"name":"imageInfo","in":"query","description":"Image Information Request","schema":{"type":"ImageInfoRequestV2"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"imageInfo":{"type":"ImageInfoRequestV2","description":"Image Information Request"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}}}}}}}}}}
```

## Register/Edit Product Multilingual Information

> \## Function Description\
> \* Registers/edits the product's multilingual information.\
> \---\
> \## Detailed Description\
> \* Registers or edits the product's multilingual information.\
> \* Sends an error message if not all required fields are entered.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GeneralGoodsCUDRequestV2":{"type":"object","description":"General Product Detail Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Product Basic Information"},"prGoodsItemInfoList":{"type":"array","description":"Product Item Information List","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"Product Safety Certification History","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"Product Category Attribute List","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"Product Payment Method List","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prAdveWrdHistList":{"type":"array","description":"Promotional Text List","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"Free Gift List","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Content Information"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Basic Image Information"},"subImageInfoList":{"type":"array","description":"Product Additional Image Information","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Basic Video Information"},"deleteContsList":{"type":"array","description":"Product Content (Additional Images, Videos) Deletion List","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"Product Price Information"},"prRsvSaleHist":{"$ref":"#/components/schemas/PrRsvSaleHist","description":"Reserved Sale Information"},"prDispGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo"},"prAssocGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrAssocGoodsInfo"},"prGoodsIconInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrGoodsIconInfo"},"prItmBaseList":{"$ref":"#/components/schemas/RealGridCUDRequestPrItmBase"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase"},"manualOptnInfoList":{"type":"array","description":"Manually Entered Option Information List (sentinel ID row, VALUES inserted directly without master JOIN)","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}}}},"PrGoodsBase":{"type":"object","description":"Product Basic Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keyword"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"}}},"PrGoodsItemInfo":{"type":"object","description":"Product Item Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNotiLisartCd":{"type":"string","description":"Product Disclosure Item Code"},"goodsNotiItemCd":{"type":"string","description":"Product Notification Item Code"},"notiItemCmt":{"type":"string","description":"Notice Item Content"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"Product Safety Certification History","properties":{"goodsNo":{"type":"string","description":"Product No."},"safeCertiGbCd":{"type":"string","description":"Safety Certification Type Code"},"safeCertiNo":{"type":"string","description":"Safety Certification No."},"aplyStrDt":{"type":"string","description":"Application Start Date"},"aplyEndDt":{"type":"string","description":"Application End Date"},"safeCertiOrnNm":{"type":"string","description":"Safety Certification Agency Name"}}},"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."}}},"PrGoodsPayMeanInfo":{"type":"object","description":"Product Payment Method Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"payWayCd":{"type":"string","description":"Payment Method Code"},"useYn":{"type":"string","description":"Usage Status"}}},"PrAdveWrdHist":{"type":"object","description":"Product Promotional Copy History","properties":{"goodsNo":{"type":"string","description":"Product No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"useYn":{"type":"string","description":"Usage Status"}}},"PrPrestHist":{"type":"object","description":"Free Gift History","properties":{"goodsNo":{"type":"string","description":"Product No."},"prestNm":{"type":"string","description":"Gift Item Name"},"useYn":{"type":"string","description":"Usage Status"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrGoodsPrceHist":{"type":"object","description":"Product Price History","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"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"eventPrc":{"type":"number","description":"Promotional Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"prcChgCausCdNm":{"type":"string","description":"Reason for Price Change"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"Reserved Sale History","properties":{"goodsNo":{"type":"string","description":"Product No."},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reservation Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reservation End Date/Time"},"rsvEndAfProcMethCd":{"type":"string","description":"Sales Method After Reservation Ends (PR011)"},"rsvStopYn":{"type":"string","description":"Reservation Suspended Status"},"rsvStopCausCd":{"type":"string","description":"Reservation Stop Reason Code (PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"Reservation Suspension Date/Time"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"Display Category Basic_Product Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispYn":{"type":"string","description":"Display Status"},"errorMessage":{"type":"string","description":"Error Message","readOnly":true},"goodsList":{"type":"array","description":"Product No. List","items":{"type":"string"}},"goodsArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"itemList":{"type":"array","description":"SKU No. List","items":{"type":"string"}},"itemArray":{"type":"array","description":"SKU No. Array","items":{"type":"string"}},"goodsNm":{"type":"string","description":"Product Name","readOnly":true},"goodsTypCd":{"type":"string","description":"Product Type","readOnly":true},"norPrc":{"type":"number","description":"Regular Price","readOnly":true},"salePrc":{"type":"number","description":"Selling Price","readOnly":true},"saleStatCd":{"type":"string","description":"Sales Status","readOnly":true},"entrNm":{"type":"string","description":"Vendor Name","readOnly":true},"goodsImg":{"type":"string","description":"Product Image","readOnly":true},"moodTagVal":{"type":"string","description":"Mood","readOnly":true},"wght":{"type":"string","description":"Weight","readOnly":true}}},"RealGridCUDRequestPrAssocGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}}}},"PrAssocGoodsInfo":{"type":"object","description":"Related Product Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"asctGoodsNo":{"type":"string","description":"Related Product No."},"asctGbCd":{"type":"string","description":"Related Type Code"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"}}},"RealGridCUDRequestPrGoodsIconInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"PrGoodsIconInfo":{"type":"object","description":"Product Icon Information","properties":{"siteNo":{"type":"string","description":"Site No."},"goodsNo":{"type":"string","description":"Product No."},"dispIconNo":{"type":"string","description":"Display Icon No."},"siteNm":{"type":"string","description":"Site Name"},"iconNm":{"type":"string","description":"Icon Name"},"dispMediaCdNm":{"type":"string","description":"Display Media"},"iconTypCdNm":{"type":"string","description":"Icon Type"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"iconPathNm":{"type":"string","description":"Icon Image Path"},"delYn":{"type":"string","description":"Deletion Status"}}},"RealGridCUDRequestPrItmBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"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"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"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"},"itmSaleStatCdNm":{"type":"string","description":"Unit Sales Status Code Name"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Sales Ended (Normal) 42: Sales Ended (Deleted)"},"repItmYn":{"type":"string","description":"Representative Item Status"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"addSupPcost":{"type":"number","description":"Additional Supply Cost"},"addSalePrc":{"type":"number","description":"Additional Sales Price"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Automatic out-of-stock processing due to shipment unavailable, 11: Out-of-stock processing due to 0 stock quantity, 12: Manual out-of-stock processing by administrator, 13: Automatic out-of-stock processing due to next-day delivery delay, 14: Product out-of-stock processing due to all units out of stock, 15: Reserved product out-of-stock processing, 16: Out of stock due to bundle product out of stock"},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"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","description":"Option Category No._5"},"optnNo5":{"type":"string","description":"Option No._5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrItmOptnInfo":{"type":"object","description":"Unit Option Information","properties":{"langCd":{"type":"string","description":"Language Code"},"goodsNo":{"type":"string","description":"Product No."},"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 Category Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Order"}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/registGoodsMultiLanguage":{"post":{"tags":["Product Common"],"summary":"Register/Edit Product Multilingual Information","description":"## Function Description\n* Registers/edits the product's multilingual information.\n---\n## Detailed Description\n* Registers or edits the product's multilingual information.\n* Sends an error message if not all required fields are entered.\n","operationId":"registGoodsMultiLanguage","parameters":[{"name":"request","in":"query","description":"Product Multilingual Information Request","schema":{"type":"GeneralGoodsCUDRequestV2"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralGoodsCUDRequestV2"}}},"required":true},"responses":{"200":{"description":"Product multilingual information registered/edited successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Failed to register/edit product multilingual information","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Edit Bundle Product

> \## Function Description\
> \* Edits bundle product information.\
> \---\
> \## Detailed Description\
> \* Edits bundle product information.\
> \* Product information cannot be edited for products whose sales status is Ended.\
> \* Sends an error message if not all required fields are entered.\
> \---\
> \## Revision History\
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- Added bundle product buyer age restriction code (buyrAgeLmtCd)<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PackageGoodsCUDRequest":{"type":"object","description":"Bundle Product Detail Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Product Basic Information"},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Content Information"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Basic Image Information"},"subImageInfoList":{"type":"array","description":"Product Additional Image Information","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Basic Video Information"},"deleteContsList":{"type":"array","description":"Product Content (Additional Image, Video) Deletion Information","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"packageRelatedGoodsListGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestPrRelGoodsInfo","description":"Related Product Add/Modify/Delete Information"},"prDispGoodsInfoListGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo","description":"Display Category Add/Modify/Delete Information"}}},"PrGoodsBase":{"type":"object","description":"Product Basic Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keyword"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"RealGridCUDRequestPrRelGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}}}},"PrRelGoodsInfo":{"type":"object","description":"Related Product Information","properties":{"baseGoodsNo":{"type":"string","description":"Reference Product No."},"tgtGoodsNo":{"type":"string","description":"Target Product No."},"repYn":{"type":"string","description":"Representative Status"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"Display Category Basic_Product Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispYn":{"type":"string","description":"Display Status"},"errorMessage":{"type":"string","description":"Error Message","readOnly":true},"goodsList":{"type":"array","description":"Product No. List","items":{"type":"string"}},"goodsArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"itemList":{"type":"array","description":"SKU No. List","items":{"type":"string"}},"itemArray":{"type":"array","description":"SKU No. Array","items":{"type":"string"}},"goodsNm":{"type":"string","description":"Product Name","readOnly":true},"goodsTypCd":{"type":"string","description":"Product Type","readOnly":true},"norPrc":{"type":"number","description":"Regular Price","readOnly":true},"salePrc":{"type":"number","description":"Selling Price","readOnly":true},"saleStatCd":{"type":"string","description":"Sales Status","readOnly":true},"entrNm":{"type":"string","description":"Vendor Name","readOnly":true},"goodsImg":{"type":"string","description":"Product Image","readOnly":true},"moodTagVal":{"type":"string","description":"Mood","readOnly":true},"wght":{"type":"string","description":"Weight","readOnly":true}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/modifyPackageGoods":{"post":{"tags":["Product Common"],"summary":"Edit Bundle Product","description":"## Function Description\n* Edits bundle product information.\n---\n## Detailed Description\n* Edits bundle product information.\n* Product information cannot be edited for products whose sales status is Ended.\n* Sends an error message if not all required fields are entered.\n---\n## Revision History\n```Release v1.04_231120```\n - Added bundle product buyer age restriction code (buyrAgeLmtCd)\n","operationId":"modifyPackageGoods","parameters":[{"name":"request","in":"query","description":"Bundle Product Information Request","schema":{"type":"PackageGoodsCUDRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageGoodsCUDRequest"}}},"required":true},"responses":{"200":{"description":"Bundle product edited successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Failed to edit bundle product","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Batch Edit Product Information

> \## Function Description\
> \* Batch edits the display category and promotional text of the selected products.\
> \---\
> \## Detailed Description\
> \* Batch edits the display category or promotional text of the selected products.\
> \* When editing the promotional text, the existing promotional text is deleted and replaced with the requested promotional text.\
> \---\
> \## Code Summary\
> \* target : 'dispCtg' : Display Category, 'adveWrd' : Promotional Text\
> \* state : 'U' : Update, 'D' : Delete<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsMgmtInfoSaveApiRequest":{"type":"object","description":"Product Management Batch Change Request","properties":{"goodsNoList":{"type":"array","description":"Product No. List","items":{"type":"string"}},"goodsMgmtInfo":{"type":"array","description":"Product Management Change Request List","items":{"$ref":"#/components/schemas/GoodsMgmtInfoApiRequest"}}}},"GoodsMgmtInfoApiRequest":{"type":"object","description":"Product Management Change Request","properties":{"state":{"type":"string","description":"Request Status"},"target":{"type":"string","description":"Changed Item"},"dispCtgNoList":{"type":"array","description":"Display Category List","items":{"type":"string"}},"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"}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/modifyGoodsInfo":{"post":{"tags":["Product Common"],"summary":"Batch Edit Product Information","description":"## Function Description\n* Batch edits the display category and promotional text of the selected products.\n---\n## Detailed Description\n* Batch edits the display category or promotional text of the selected products.\n* When editing the promotional text, the existing promotional text is deleted and replaced with the requested promotional text.\n---\n## Code Summary\n* target : 'dispCtg' : Display Category, 'adveWrd' : Promotional Text\n* state : 'U' : Update, 'D' : Delete\n","operationId":"modifyGoodsInfo","parameters":[{"name":"request","in":"query","schema":{"type":"GoodsMgmtInfoSaveApiRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsMgmtInfoSaveApiRequest"}}},"required":true},"responses":{"200":{"description":"Product information batch edited successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Failed to batch edit product information","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Edit Gift

> \## Function Description\
> \* Edits gift information.\
> \---\
> \## Detailed Description\
> \* Edits gift information.\
> \* Gift information cannot be edited for gifts whose sales status is Ended.\
> \* Sends an error message if not all required fields are entered.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GiftGoodsCUDRequest":{"type":"object","description":"Register/Modify Free Gift Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Gift Basic Information"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase","description":"Gift SKU Information"},"giftImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Gift Image Information"}}},"PrGoodsBase":{"type":"object","description":"Product Basic Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keyword"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"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"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"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"},"itmSaleStatCdNm":{"type":"string","description":"Unit Sales Status Code Name"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Sales Ended (Normal) 42: Sales Ended (Deleted)"},"repItmYn":{"type":"string","description":"Representative Item Status"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"addSupPcost":{"type":"number","description":"Additional Supply Cost"},"addSalePrc":{"type":"number","description":"Additional Sales Price"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Automatic out-of-stock processing due to shipment unavailable, 11: Out-of-stock processing due to 0 stock quantity, 12: Manual out-of-stock processing by administrator, 13: Automatic out-of-stock processing due to next-day delivery delay, 14: Product out-of-stock processing due to all units out of stock, 15: Reserved product out-of-stock processing, 16: Out of stock due to bundle product out of stock"},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"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","description":"Option Category No._5"},"optnNo5":{"type":"string","description":"Option No._5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/modifyGiftGoods":{"post":{"tags":["Product Common"],"summary":"Edit Gift","description":"## Function Description\n* Edits gift information.\n---\n## Detailed Description\n* Edits gift information.\n* Gift information cannot be edited for gifts whose sales status is Ended.\n* Sends an error message if not all required fields are entered.\n","operationId":"modifyGiftGoods","parameters":[{"name":"request","in":"query","description":"Gift Information Request","schema":{"type":"GiftGoodsCUDRequest"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GiftGoodsCUDRequest"}}},"required":true},"responses":{"200":{"description":"Gift edited successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Failed to edit gift","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Edit General Product

> \## Function Description\
> \* Edits general product information.\
> \---\
> \## Detailed Description\
> \* Edits general product information.\
> \* When the sales status is changed to Out of Stock, the sales status of the product and all its on-sale SKUs is changed to Out of Stock, and the out-of-stock reason is saved as 'Administrator Out of Stock'.\
> \* Product information cannot be edited for products whose sales status is Ended.\
> \* If a product currently on reservation sale has a sales status of Out of Stock, it cannot be changed to On Sale.\
> \* Sends an error message if not all required fields are entered.\
> \---\
> \## Revision History\
> \`\`\`Release v1.02\_231023\`\`\`\
> &#x20;\- Added gift wrapping availability variable (gvgfPsbYn)\
> \
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- Added size guide related columns (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts)\
> &#x20;\- Added icon (badge) settings\
> \
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- Fixed validation and added fallback values for temporary save\
> &#x20;\- Added logic for adding/removing SKU options during temporary save\
> &#x20;\- Improved icon (badge) settings feature\
> &#x20;\- Added recurring delivery product status column (rglrDeliGoodsYn)\
> \
> &#x20;\`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- Added standard category management attributes to product registration and product detail popup\
> \
> \`\`\`Release v1.06\_251020\`\`\`\
> &#x20;\- For products in temporary save or pending approval, recalculates the SKU supply price based on the previously registered product price margin rate<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GeneralGoodsCUDRequestV2":{"type":"object","description":"General Product Detail Request","properties":{"prGoodsBase":{"$ref":"#/components/schemas/PrGoodsBase","description":"Product Basic Information"},"prGoodsItemInfoList":{"type":"array","description":"Product Item Information List","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"Product Safety Certification History","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"Product Category Attribute List","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"Product Payment Method List","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prAdveWrdHistList":{"type":"array","description":"Promotional Text List","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"Free Gift List","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Content Information"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Basic Image Information"},"subImageInfoList":{"type":"array","description":"Product Additional Image Information","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Basic Video Information"},"deleteContsList":{"type":"array","description":"Product Content (Additional Images, Videos) Deletion List","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prGoodsPrceHist":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"Product Price Information"},"prRsvSaleHist":{"$ref":"#/components/schemas/PrRsvSaleHist","description":"Reserved Sale Information"},"prDispGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo"},"prAssocGoodsInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrAssocGoodsInfo"},"prGoodsIconInfoList":{"$ref":"#/components/schemas/RealGridCUDRequestPrGoodsIconInfo"},"prItmBaseList":{"$ref":"#/components/schemas/RealGridCUDRequestPrItmBase"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase"},"manualOptnInfoList":{"type":"array","description":"Manually Entered Option Information List (sentinel ID row, VALUES inserted directly without master JOIN)","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}}}},"PrGoodsBase":{"type":"object","description":"Product Basic Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keyword"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"}}},"PrGoodsItemInfo":{"type":"object","description":"Product Item Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNotiLisartCd":{"type":"string","description":"Product Disclosure Item Code"},"goodsNotiItemCd":{"type":"string","description":"Product Notification Item Code"},"notiItemCmt":{"type":"string","description":"Notice Item Content"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"Product Safety Certification History","properties":{"goodsNo":{"type":"string","description":"Product No."},"safeCertiGbCd":{"type":"string","description":"Safety Certification Type Code"},"safeCertiNo":{"type":"string","description":"Safety Certification No."},"aplyStrDt":{"type":"string","description":"Application Start Date"},"aplyEndDt":{"type":"string","description":"Application End Date"},"safeCertiOrnNm":{"type":"string","description":"Safety Certification Agency Name"}}},"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."}}},"PrGoodsPayMeanInfo":{"type":"object","description":"Product Payment Method Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"payWayCd":{"type":"string","description":"Payment Method Code"},"useYn":{"type":"string","description":"Usage Status"}}},"PrAdveWrdHist":{"type":"object","description":"Product Promotional Copy History","properties":{"goodsNo":{"type":"string","description":"Product No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"useYn":{"type":"string","description":"Usage Status"}}},"PrPrestHist":{"type":"object","description":"Free Gift History","properties":{"goodsNo":{"type":"string","description":"Product No."},"prestNm":{"type":"string","description":"Gift Item Name"},"useYn":{"type":"string","description":"Usage Status"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrGoodsPrceHist":{"type":"object","description":"Product Price History","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"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"eventPrc":{"type":"number","description":"Promotional Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"prcChgCausCdNm":{"type":"string","description":"Reason for Price Change"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"Reserved Sale History","properties":{"goodsNo":{"type":"string","description":"Product No."},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reservation Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reservation End Date/Time"},"rsvEndAfProcMethCd":{"type":"string","description":"Sales Method After Reservation Ends (PR011)"},"rsvStopYn":{"type":"string","description":"Reservation Suspended Status"},"rsvStopCausCd":{"type":"string","description":"Reservation Stop Reason Code (PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"Reservation Suspension Date/Time"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"Display Category Basic_Product Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"dispYn":{"type":"string","description":"Display Status"},"errorMessage":{"type":"string","description":"Error Message","readOnly":true},"goodsList":{"type":"array","description":"Product No. List","items":{"type":"string"}},"goodsArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"itemList":{"type":"array","description":"SKU No. List","items":{"type":"string"}},"itemArray":{"type":"array","description":"SKU No. Array","items":{"type":"string"}},"goodsNm":{"type":"string","description":"Product Name","readOnly":true},"goodsTypCd":{"type":"string","description":"Product Type","readOnly":true},"norPrc":{"type":"number","description":"Regular Price","readOnly":true},"salePrc":{"type":"number","description":"Selling Price","readOnly":true},"saleStatCd":{"type":"string","description":"Sales Status","readOnly":true},"entrNm":{"type":"string","description":"Vendor Name","readOnly":true},"goodsImg":{"type":"string","description":"Product Image","readOnly":true},"moodTagVal":{"type":"string","description":"Mood","readOnly":true},"wght":{"type":"string","description":"Weight","readOnly":true}}},"RealGridCUDRequestPrAssocGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrAssocGoodsInfo"}}}},"PrAssocGoodsInfo":{"type":"object","description":"Related Product Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"asctGoodsNo":{"type":"string","description":"Related Product No."},"asctGbCd":{"type":"string","description":"Related Type Code"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"}}},"RealGridCUDRequestPrGoodsIconInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"PrGoodsIconInfo":{"type":"object","description":"Product Icon Information","properties":{"siteNo":{"type":"string","description":"Site No."},"goodsNo":{"type":"string","description":"Product No."},"dispIconNo":{"type":"string","description":"Display Icon No."},"siteNm":{"type":"string","description":"Site Name"},"iconNm":{"type":"string","description":"Icon Name"},"dispMediaCdNm":{"type":"string","description":"Display Media"},"iconTypCdNm":{"type":"string","description":"Icon Type"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"iconPathNm":{"type":"string","description":"Icon Image Path"},"delYn":{"type":"string","description":"Deletion Status"}}},"RealGridCUDRequestPrItmBase":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"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"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"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"},"itmSaleStatCdNm":{"type":"string","description":"Unit Sales Status Code Name"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Sales Ended (Normal) 42: Sales Ended (Deleted)"},"repItmYn":{"type":"string","description":"Representative Item Status"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"addSupPcost":{"type":"number","description":"Additional Supply Cost"},"addSalePrc":{"type":"number","description":"Additional Sales Price"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Automatic out-of-stock processing due to shipment unavailable, 11: Out-of-stock processing due to 0 stock quantity, 12: Manual out-of-stock processing by administrator, 13: Automatic out-of-stock processing due to next-day delivery delay, 14: Product out-of-stock processing due to all units out of stock, 15: Reserved product out-of-stock processing, 16: Out of stock due to bundle product out of stock"},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"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","description":"Option Category No._5"},"optnNo5":{"type":"string","description":"Option No._5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrItmOptnInfo":{"type":"object","description":"Unit Option Information","properties":{"langCd":{"type":"string","description":"Language Code"},"goodsNo":{"type":"string","description":"Product No."},"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 Category Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Order"}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/modifyGeneralGoods":{"post":{"tags":["Product Common"],"summary":"Edit General Product","description":"## Function Description\n* Edits general product information.\n---\n## Detailed Description\n* Edits general product information.\n* When the sales status is changed to Out of Stock, the sales status of the product and all its on-sale SKUs is changed to Out of Stock, and the out-of-stock reason is saved as 'Administrator Out of Stock'.\n* Product information cannot be edited for products whose sales status is Ended.\n* If a product currently on reservation sale has a sales status of Out of Stock, it cannot be changed to On Sale.\n* Sends an error message if not all required fields are entered.\n---\n## Revision History\n```Release v1.02_231023```\n - Added gift wrapping availability variable (gvgfPsbYn)\n\n```Release v1.03_231106```\n - Added size guide related columns (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts)\n - Added icon (badge) settings\n\n```Release v1.04_231120```\n - Fixed validation and added fallback values for temporary save\n - Added logic for adding/removing SKU options during temporary save\n - Improved icon (badge) settings feature\n - Added recurring delivery product status column (rglrDeliGoodsYn)\n\n ```Release v1.05_231204```\n - Added standard category management attributes to product registration and product detail popup\n\n```Release v1.06_251020```\n - For products in temporary save or pending approval, recalculates the SKU supply price based on the previously registered product price margin rate\n","operationId":"modifyGeneralGoods","parameters":[{"name":"request","in":"query","description":"General Product Information Request","schema":{"type":"GeneralGoodsCUDRequestV2"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeneralGoodsCUDRequestV2"}}},"required":true},"responses":{"200":{"description":"General product edited successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Failed to edit general product","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Register/Cancel Price Change Reservation

> \## Function Description\
> \* Registers or cancels a price change reservation.\
> \---\
> \## Detailed Description\
> \* Registers or cancels a price change reservation.\
> \* Registration and cancellation are distinguished based on the price change request code (rsvCudStat).\
> \* If a price change reservation already exists, the existing entry is deleted and the requested information is registered.\
> \* For registration, all required values must be entered.\
> &#x20;\* Supply cost, regular price, selling price, margin rate, history start date/time, price change reason code (PR033)\
> \---\
> \## Code Reference\
> \* \`\`\`Price Change Request Code\`\`\` : C: Register, D: Cancel\
> \## Revision History\
> \`\`\`Release v2.00\_240827\`\`\`\
> &#x20;\- Integrated selling price/promotional price<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsPriceHistoryRequest":{"type":"object","description":"Product Price History Request","properties":{"goodsNo":{"type":"string","description":"Product No."},"histEndDtm":{"type":"string","format":"date-time","description":"History End Date/Time"},"histStrDtm":{"type":"string","format":"date-time","description":"History Start Date/Time"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"rsvCudStat":{"type":"string","description":"Price Change Request Code"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"ResponseString":{"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":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/goodsCommontApi/modifyGeneralGoodsPriceReservation":{"post":{"tags":["Product Common"],"summary":"Register/Cancel Price Change Reservation","description":"## Function Description\n* Registers or cancels a price change reservation.\n---\n## Detailed Description\n* Registers or cancels a price change reservation.\n* Registration and cancellation are distinguished based on the price change request code (rsvCudStat).\n* If a price change reservation already exists, the existing entry is deleted and the requested information is registered.\n* For registration, all required values must be entered.\n * Supply cost, regular price, selling price, margin rate, history start date/time, price change reason code (PR033)\n---\n## Code Reference\n* ```Price Change Request Code``` : C: Register, D: Cancel\n## Revision History\n```Release v2.00_240827```\n - Integrated selling price/promotional price\n","operationId":"modifyGeneralGoodsPriceReservation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsPriceHistoryRequest"}}},"required":true},"responses":{"200":{"description":"Register/Cancel Price Change Reservation Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Register/Cancel Price Change Reservation Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Icon Information

> \## Function Description\
> \* Searches the icon information registered on a product.\
> \---\
> \## Detailed Description\
> \* Searches the icon information registered on a product.\
> \---\
> \## Notes\
> \* The NEW and BEST icons are not manually registered; their display is determined each time the query is run.\
> \---\
> \## Revision History\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- Sprint 5 PO1 defect/improvement - modified icon image query<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsIconApiRequest":{"type":"object","properties":{"siteNo":{"type":"string","description":"Site No."},"goodsNo":{"type":"string","description":"Product No."},"dispIconNo":{"type":"string","description":"Display Icon No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"delYn":{"type":"string","description":"Deletion Status"}}},"ResponseListPrGoodsIconInfo":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrGoodsIconInfo":{"type":"object","description":"Product Icon Information","properties":{"siteNo":{"type":"string","description":"Site No."},"goodsNo":{"type":"string","description":"Product No."},"dispIconNo":{"type":"string","description":"Display Icon No."},"siteNm":{"type":"string","description":"Site Name"},"iconNm":{"type":"string","description":"Icon Name"},"dispMediaCdNm":{"type":"string","description":"Display Media"},"iconTypCdNm":{"type":"string","description":"Icon Type"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"iconPathNm":{"type":"string","description":"Icon Image Path"},"delYn":{"type":"string","description":"Deletion Status"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getPrGoodsIconInfoList":{"get":{"tags":["Product Common"],"summary":"Search Icon Information","description":"## Function Description\n* Searches the icon information registered on a product.\n---\n## Detailed Description\n* Searches the icon information registered on a product.\n---\n## Notes\n* The NEW and BEST icons are not manually registered; their display is determined each time the query is run.\n---\n## Revision History\n```Release v1.05_231204```\n - Sprint 5 PO1 defect/improvement - modified icon image query\n","operationId":"getPrGoodsIconInfoList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsIconApiRequest"}}],"responses":{"200":{"description":"Search Product Icon Information Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrGoodsIconInfo"}}}},"900":{"description":"Search Product Icon Information Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Bundle Product Information

> \## Function Description\
> \* Searches bundle product information.\
> \---\
> \## Detailed Description\
> \* Searches the product information of the bundle product.\
> \---\
> \## Revision History\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- Changed the displayed product search query to an inner join<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsBaseResponse":{"type":"object","description":"Product Basic Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keywords"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"},"entrNm":{"type":"string","description":"Vendor Name"},"brandNm":{"type":"string","description":"Brand Name"},"stdCtgHierarchy":{"type":"string","description":"Standard Classification Hierarchy Structure"},"mdId":{"type":"string","description":"MD ID"},"mdNm":{"type":"string","description":"MD Name"},"goodsNotiLisartCd":{"type":"string","description":"Product Notification Item Code"},"safeCertiNeedYn":{"type":"string","description":"Safety Certification Required Status (Standard Category)"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002)"},"mrgnRateGbCd":{"type":"string","description":"Margin Type Code (VD008)"},"mrgnRate1":{"type":"number","description":"Margin Rate 1"},"mrgnRate2":{"type":"number","description":"Margin Rate 2"}}},"ResponsePackageGoodsResponse":{"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/PackageGoodsResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PackageGoodsResponse":{"type":"object","description":"Bundle Product Detail Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"Product Basic Information"},"prRelGoodsInfoList":{"type":"array","description":"Related Product List","items":{"$ref":"#/components/schemas/RelatedGoodsResponse"}},"prStdCtgDispInfoList":{"type":"array","description":"Standard Category Display Information List","items":{"$ref":"#/components/schemas/PrStdCtgDispInfo"}},"prGoodsContInfoList":{"type":"array","description":"Product Content List","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}}}},"RelatedGoodsResponse":{"type":"object","properties":{"baseGoodsNo":{"type":"string","description":"Reference Product No."},"tgtGoodsNo":{"type":"string","description":"Target Product No."},"repYn":{"type":"string","description":"Representative Status"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"goodsNm":{"type":"string"},"brandNm":{"type":"string"},"entrNo":{"type":"string"},"entrNm":{"type":"string"},"mdId":{"type":"string"},"mdNm":{"type":"string"},"saleStatCdNm":{"type":"string"},"dispYn":{"type":"string"},"deliProcTypCdNm":{"type":"string"},"deliGoodsGbCdNm":{"type":"string"},"salePrc":{"type":"number"},"dispDlexAmt":{"type":"string"}}},"PrStdCtgDispInfo":{"type":"object","description":"Standard Category Display Information","properties":{"siteNo":{"type":"string","description":"Site No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"repCtgYn":{"type":"string","description":"Representative Category Status"},"useYn":{"type":"string","description":"Usage Status"},"dispCtgNm":{"type":"string","description":"Display Category Name","readOnly":true},"dpmlNo":{"type":"string","description":"Display Mall No."},"siteNm":{"type":"string","description":"Site Name","readOnly":true},"dpmlNm":{"type":"string","description":"Display Mall Name","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"Product BO-API_Display Category Structure","readOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getPackageGoodsInfo":{"get":{"tags":["Product Common"],"summary":"Search Bundle Product Information","description":"## Function Description\n* Searches bundle product information.\n---\n## Detailed Description\n* Searches the product information of the bundle product.\n---\n## Revision History\n```Release v1.05_231204```\n - Changed the displayed product search query to an inner join\n","operationId":"getPackageGoodsInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsBaseResponse"}}],"responses":{"200":{"description":"Product Information Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePackageGoodsResponse"}}}},"900":{"description":"Product Information Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Unit Option List

> \## Function Description\
> \* Searches the unit option list.\
> \---\
> \## Detailed Description\
> \* Searches the unit option list.\
> \---\
> \## Revision History\
> \`\`\`Release v1.03\_231106\`\`\`\
> \- Added variables image path name (imgPathNm), image file name (imgFileNm), RGB value (rgbVal)<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsOptionApiRequest":{"type":"object","description":"Product Option Request","properties":{"pregGoodsNo":{"type":"string"},"goodsNo":{"type":"string"},"entrNo":{"type":"string"},"optnCatNo":{"type":"string"}}},"ResponseListGoodsOptionApiResponse":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/GoodsOptionApiResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsOptionApiResponse":{"type":"object","description":"Product Item Option Info API Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"optnCatNo":{"type":"string","description":"Option Classification No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNo":{"type":"string","description":"Option No."},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"string","description":"Option Category Order"},"optnCatRegGbCd":{"type":"string","description":"Option Classification Registration Type Code"},"optnCatRegGbNm":{"type":"string","description":"Option Classification Registration Type Code Name"},"optnCatTypCd":{"type":"string","description":"Option Classification Type Code (PR019)"},"optnCatTypCdNm":{"type":"string","description":"Option Classification Type Code Name"},"optnList":{"type":"array","description":"Item Option Value List","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}},"optnCdList":{"type":"string","deprecated":true,"description":"Option Value List"},"optnCdNmList":{"type":"string","deprecated":true,"description":"Option Name List"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"}}},"PrItmOptnInfo":{"type":"object","description":"Unit Option Information","properties":{"langCd":{"type":"string","description":"Language Code"},"goodsNo":{"type":"string","description":"Product No."},"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 Category Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Order"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getItemOptionList":{"get":{"tags":["Product Common"],"summary":"Search Unit Option List","description":"## Function Description\n* Searches the unit option list.\n---\n## Detailed Description\n* Searches the unit option list.\n---\n## Revision History\n```Release v1.03_231106```\n- Added variables image path name (imgPathNm), image file name (imgFileNm), RGB value (rgbVal)\n","operationId":"getItemOptionList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsOptionApiRequest"}}],"responses":{"200":{"description":"Search Unit Option List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListGoodsOptionApiResponse"}}}},"900":{"description":"Search Unit Option List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Unit Sales Status List

> \## Function Description\
> \* Searches the unit sales status list.\
> \---\
> \## Detailed Description\
> \* Searches the unit sales status list.\
> \---\
> \## Revision History\
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- Added the unit sales status list search API<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseGoodsSaleStateResponse":{"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/GoodsSaleStateResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsSaleStateResponse":{"type":"object","description":"Product Sales Status Inquiry API Response DTO","properties":{"goodsNo":{"type":"string","description":"Product No."},"saleStatCd":{"type":"string","description":"Product Sales Status Code"},"saleStatChgCausCd":{"type":"string","description":"Product Sales Status Change Reason Code"},"prItmBaseList":{"type":"array","description":"Item Sales Status Info List","items":{"$ref":"#/components/schemas/PrItmBase"}}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"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"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"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"},"itmSaleStatCdNm":{"type":"string","description":"Unit Sales Status Code Name"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Sales Ended (Normal) 42: Sales Ended (Deleted)"},"repItmYn":{"type":"string","description":"Representative Item Status"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"addSupPcost":{"type":"number","description":"Additional Supply Cost"},"addSalePrc":{"type":"number","description":"Additional Sales Price"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Automatic out-of-stock processing due to shipment unavailable, 11: Out-of-stock processing due to 0 stock quantity, 12: Manual out-of-stock processing by administrator, 13: Automatic out-of-stock processing due to next-day delivery delay, 14: Product out-of-stock processing due to all units out of stock, 15: Reserved product out-of-stock processing, 16: Out of stock due to bundle product out of stock"},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"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","description":"Option Category No._5"},"optnNo5":{"type":"string","description":"Option No._5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGoodsSaleStateList":{"get":{"tags":["Product Common"],"summary":"Search Unit Sales Status List","description":"## Function Description\n* Searches the unit sales status list.\n---\n## Detailed Description\n* Searches the unit sales status list.\n---\n## Revision History\n```Release v1.03_231106```\n - Added the unit sales status list search API\n","operationId":"getGoodsSaleStateList","parameters":[{"name":"goodsNo","in":"query","description":"Product No.","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Search Unit Sales Status List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGoodsSaleStateResponse"}}}},"900":{"description":"Search Unit Sales Status List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Product Notice Item List

> \## Function Description\
> \* Searches the product notice item list needed on the Product Registration/Modification/Detail page.\
> \---\
> \## Detailed Description\
> \* Searches the list of product notice items according to the product notice item code.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListGoodsNotificationItemCodeResponse":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/GoodsNotificationItemCodeResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsNotificationItemCodeResponse":{"type":"object","description":"Product Notice Item Code Response","properties":{"goodsNotiItemCd":{"type":"string","description":"Product Disclosure Item Code"},"notiItemNm":{"type":"string","description":"Notice Item Name"},"notiItemDesc":{"type":"string","description":"Notice Item Description"},"insrtMethCd":{"type":"string","description":"Input Method Code (PR013)"},"useYn":{"type":"string","description":"Usage Status"},"orgnNotiItemNm":{"type":"string","description":"(Multilingual) Existing Notice Item Name"},"orgnNotiItemDesc":{"type":"string","description":"(Multilingual) Existing Notice Item Description"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGoodsNotificationItemList":{"get":{"tags":["Product Common"],"summary":"Search Product Notice Item List","description":"## Function Description\n* Searches the product notice item list needed on the Product Registration/Modification/Detail page.\n---\n## Detailed Description\n* Searches the list of product notice items according to the product notice item code.\n","operationId":"getGoodsNotificationItemList","parameters":[{"name":"goodsNotiLisartCd","in":"query","description":"Product Notification Item Code","required":false,"schema":{"type":"String"}},{"name":"langCd","in":"query","description":"Language Code","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"Search Product Notice Item Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListGoodsNotificationItemCodeResponse"}}}},"900":{"description":"Search Product Notice Item Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Product Multilingual Information

> \## Function Description\
> \* Searches the multilingual information of a product.\
> \---\
> \## Detailed Description\
> \* Searches the list of all multilingual information currently registered for the product.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseGoodsMultiLanguageResponse":{"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/GoodsMultiLanguageResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsMultiLanguageResponse":{"type":"object","description":"Product Multilingual Response","properties":{"goodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"Product Basic Information"},"goodsMultiLanguageDtoList":{"type":"array","description":"Product Multilingual DTO List","items":{"$ref":"#/components/schemas/GoodsMultiLanguageDto"}}}},"GoodsBaseResponse":{"type":"object","description":"Product Basic Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keywords"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"},"entrNm":{"type":"string","description":"Vendor Name"},"brandNm":{"type":"string","description":"Brand Name"},"stdCtgHierarchy":{"type":"string","description":"Standard Classification Hierarchy Structure"},"mdId":{"type":"string","description":"MD ID"},"mdNm":{"type":"string","description":"MD Name"},"goodsNotiLisartCd":{"type":"string","description":"Product Notification Item Code"},"safeCertiNeedYn":{"type":"string","description":"Safety Certification Required Status (Standard Category)"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002)"},"mrgnRateGbCd":{"type":"string","description":"Margin Type Code (VD008)"},"mrgnRate1":{"type":"number","description":"Margin Rate 1"},"mrgnRate2":{"type":"number","description":"Margin Rate 2"}}},"GoodsMultiLanguageDto":{"type":"object","description":"Product Multilingual DTO","properties":{"goodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"Product Basic Information"},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Product Content Information"},"prGoodsItemInfoList":{"type":"array","description":"Product Item Info List","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prAdveWrdHistList":{"type":"array","description":"Promotional Text History List","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrGoodsItemInfo":{"type":"object","description":"Product Item Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNotiLisartCd":{"type":"string","description":"Product Disclosure Item Code"},"goodsNotiItemCd":{"type":"string","description":"Product Notification Item Code"},"notiItemCmt":{"type":"string","description":"Notice Item Content"}}},"PrAdveWrdHist":{"type":"object","description":"Product Promotional Copy History","properties":{"goodsNo":{"type":"string","description":"Product No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"useYn":{"type":"string","description":"Usage Status"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo":{"get":{"tags":["Product Common"],"summary":"Search Product Multilingual Information","description":"## Function Description\n* Searches the multilingual information of a product.\n---\n## Detailed Description\n* Searches the list of all multilingual information currently registered for the product.\n","operationId":"getGoodsMultiLanguageInfo","parameters":[{"name":"goodsNo","in":"query","description":"Product No.","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Search Product Multilingual Information Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGoodsMultiLanguageResponse"}}}},"900":{"description":"Search Product Multilingual Information Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Product Category Attribute List

> \## Function Description\
> \* Searches the product category attribute list needed on the Product Registration/Modification/Detail page.\
> \---\
> \## Detailed Description\
> \* Searches the list of product attribute information mapped to the standard category.\
> \---\
> \## Revision History\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- Created a new API following the addition of standard category management attributes<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsCtgAttRequest":{"type":"object","description":"Product Category Attribute Request","properties":{"langCd":{"type":"string","default":"ko","description":"Site Language"},"goodsNo":{"type":"string","description":"Product No."},"stdCtgNo":{"type":"string","description":"Standard Category No."}}},"ResponseListGoodsCtgAttResponse":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/GoodsCtgAttResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsCtgAttResponse":{"type":"object","description":"Product Category Attribute Response","properties":{"stdCtgNo":{"type":"string","description":"Standard Category No."},"goodsNo":{"type":"string","description":"Product No."},"attValTypCd":{"type":"string","description":"Attribute Value Type Code (PR043)"},"attNm":{"type":"string","description":"Attribute Name"},"attCd":{"type":"string","description":"Attribute Code"},"attVal":{"type":"string","description":"Attribute Value"},"dispSeq":{"type":"string","description":"Display Order"},"orgnAttNm":{"type":"string","description":"(Multilingual) Existing Attribute Name"},"orgnAttVal":{"type":"string","description":"(Multilingual) Existing Attribute Value"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList":{"get":{"tags":["Product Common"],"summary":"Search Product Category Attribute List","description":"## Function Description\n* Searches the product category attribute list needed on the Product Registration/Modification/Detail page.\n---\n## Detailed Description\n* Searches the list of product attribute information mapped to the standard category.\n---\n## Revision History\n```Release v1.05_231204```\n - Created a new API following the addition of standard category management attributes\n","operationId":"getGoodsCtgAttInfoList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsCtgAttRequest"}}],"responses":{"200":{"description":"Search Product Category Attribute Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListGoodsCtgAttResponse"}}}},"900":{"description":"Search Product Category Attribute Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Product Basic Information

> \## Function Description\
> \* Searches product basic information.\
> \---\
> \## Detailed Description\
> \* Searches product basic information.\
> \---\
> \## Revision History\
> \`\`\`Release v1.04\_231120\`\`\`: Added bundle product purchaser age limit code (buyrAgeLmtCd)<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseGoodsBaseResponse":{"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/GoodsBaseResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GoodsBaseResponse":{"type":"object","description":"Product Basic Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keywords"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"},"entrNm":{"type":"string","description":"Vendor Name"},"brandNm":{"type":"string","description":"Brand Name"},"stdCtgHierarchy":{"type":"string","description":"Standard Classification Hierarchy Structure"},"mdId":{"type":"string","description":"MD ID"},"mdNm":{"type":"string","description":"MD Name"},"goodsNotiLisartCd":{"type":"string","description":"Product Notification Item Code"},"safeCertiNeedYn":{"type":"string","description":"Safety Certification Required Status (Standard Category)"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002)"},"mrgnRateGbCd":{"type":"string","description":"Margin Type Code (VD008)"},"mrgnRate1":{"type":"number","description":"Margin Rate 1"},"mrgnRate2":{"type":"number","description":"Margin Rate 2"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGoodsBaseInfo":{"get":{"tags":["Product Common"],"summary":"Search Product Basic Information","description":"## Function Description\n* Searches product basic information.\n---\n## Detailed Description\n* Searches product basic information.\n---\n## Revision History\n```Release v1.04_231120```: Added bundle product purchaser age limit code (buyrAgeLmtCd)\n","operationId":"getGoodsBaseInfo","parameters":[{"name":"goodsNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","required":false,"schema":{"type":"string","default":"ko"}}],"responses":{"200":{"description":"Product Information Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGoodsBaseResponse"}}}},"900":{"description":"Product Information Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Free Gift Information

> \## Function Description\
> \* Searches free gift information.\
> \---\
> \## Detailed Description\
> \* Searches free gift information.\
> \---\
> \## Detailed Description\
> \* Searches the product information of the free gift.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseGiftGoodsResponse":{"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/GiftGoodsResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GiftGoodsResponse":{"type":"object","description":"Gift Detail Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"Gift Basic Information"},"prItmBase":{"$ref":"#/components/schemas/PrItmBase","description":"Gift SKU Information"},"giftImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"Gift Image Information"}}},"GoodsBaseResponse":{"type":"object","description":"Product Basic Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keywords"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"},"entrNm":{"type":"string","description":"Vendor Name"},"brandNm":{"type":"string","description":"Brand Name"},"stdCtgHierarchy":{"type":"string","description":"Standard Classification Hierarchy Structure"},"mdId":{"type":"string","description":"MD ID"},"mdNm":{"type":"string","description":"MD Name"},"goodsNotiLisartCd":{"type":"string","description":"Product Notification Item Code"},"safeCertiNeedYn":{"type":"string","description":"Safety Certification Required Status (Standard Category)"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002)"},"mrgnRateGbCd":{"type":"string","description":"Margin Type Code (VD008)"},"mrgnRate1":{"type":"number","description":"Margin Rate 1"},"mrgnRate2":{"type":"number","description":"Margin Rate 2"}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"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"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"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"},"itmSaleStatCdNm":{"type":"string","description":"Unit Sales Status Code Name"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Sales Ended (Normal) 42: Sales Ended (Deleted)"},"repItmYn":{"type":"string","description":"Representative Item Status"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"addSupPcost":{"type":"number","description":"Additional Supply Cost"},"addSalePrc":{"type":"number","description":"Additional Sales Price"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Automatic out-of-stock processing due to shipment unavailable, 11: Out-of-stock processing due to 0 stock quantity, 12: Manual out-of-stock processing by administrator, 13: Automatic out-of-stock processing due to next-day delivery delay, 14: Product out-of-stock processing due to all units out of stock, 15: Reserved product out-of-stock processing, 16: Out of stock due to bundle product out of stock"},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"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","description":"Option Category No._5"},"optnNo5":{"type":"string","description":"Option No._5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGiftGoodsInfo":{"get":{"tags":["Product Common"],"summary":"Search Free Gift Information","description":"## Function Description\n* Searches free gift information.\n---\n## Detailed Description\n* Searches free gift information.\n---\n## Detailed Description\n* Searches the product information of the free gift.\n","operationId":"getGiftGoodsInfo","parameters":[{"name":"goodsNo","in":"query","required":true,"schema":{"type":"string"}},{"name":"langCd","in":"query","required":false,"schema":{"type":"string","default":"ko"}}],"responses":{"200":{"description":"Product Information Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGiftGoodsResponse"}}}},"900":{"description":"Product Information Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search General Product Information

> \## Function Description\
> \* Searches general product information.\
> \---\
> \## Detailed Description\
> \* Searches the product information of a general product.\
> \---\
> \## Revision History\
> \`\`\`Release v1.03\_231106\`\`\`\
> &#x20;\- Added size guide related columns (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts)\
> &#x20;\- Added icon (badge) settings\
> \
> \`\`\`Release v1.04\_231120\`\`\`\
> &#x20;\- Modified to return the alt text as an empty value when searching products with a sales status of "temporarily saved"\
> &#x20;\- Added regular delivery product status column (rglrDeliGoodsYn)\
> \`\`\`Release v1.05\_231204\`\`\`\
> &#x20;\- Changed the displayed product search query to an inner join<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseGeneralGoodsApiResponse":{"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/GeneralGoodsApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"GeneralGoodsApiResponse":{"type":"object","description":"General Product Detail Response","properties":{"prGoodsBase":{"$ref":"#/components/schemas/GoodsBaseResponse","description":"Product Basic Information"},"prGoodsCurrentPrce":{"$ref":"#/components/schemas/PrGoodsPrceHist","description":"Product Currently Applied Price Info"},"prRsvSaleHistList":{"type":"array","description":"Reservation Sale History","items":{"$ref":"#/components/schemas/PrRsvSaleHist"}},"prGoodsItemInfoList":{"type":"array","description":"Product Notice Item List","items":{"$ref":"#/components/schemas/PrGoodsItemInfo"}},"prGoodsSafeCertiHistList":{"type":"array","description":"Product Safety Certification History","items":{"$ref":"#/components/schemas/PrGoodsSafeCertiHist"}},"prGoodsAttInfoList":{"type":"array","description":"Product Category Attribute","items":{"$ref":"#/components/schemas/PrGoodsAttInfo"}},"prGoodsPayMeanInfoList":{"type":"array","description":"Product Payment Method Info List","items":{"$ref":"#/components/schemas/PrGoodsPayMeanInfo"}},"prItmOptnInfoList":{"type":"array","description":"Item Option List","items":{"$ref":"#/components/schemas/GoodsOptionApiResponse"}},"prItmBaseList":{"type":"array","description":"Item List","items":{"$ref":"#/components/schemas/PrItmBase"}},"prGoodsContInfoList":{"type":"array","description":"Product Content List","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"prStdCtgDispInfoList":{"type":"array","description":"Standard Category Display Information List","items":{"$ref":"#/components/schemas/PrStdCtgDispInfo"}},"prAssocGoodsInfoList":{"type":"array","description":"Related Product List","items":{"$ref":"#/components/schemas/AssociatedGoodsResponse"}},"prAdveWrdHistList":{"type":"array","description":"Promotional Text List","items":{"$ref":"#/components/schemas/PrAdveWrdHist"}},"prPrestHistList":{"type":"array","description":"Free Gift List","items":{"$ref":"#/components/schemas/PrPrestHist"}},"prGoodsIconInfoList":{"type":"array","description":"Product Icon Information List","items":{"$ref":"#/components/schemas/PrGoodsIconInfo"}}}},"GoodsBaseResponse":{"type":"object","description":"Product Basic Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"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"},"salemnNm":{"type":"string","description":"Seller Name"},"manufYm":{"type":"string","description":"Manufacture Year/Month"},"schKwdNm":{"type":"string","description":"Search Keywords"},"seoTitleNm":{"type":"string","description":"SEO Title"},"seoDesc":{"type":"string","description":"SEO Description"},"seoKwdNm":{"type":"string","description":"SEO Keywords"},"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)"},"goodsTypCd":{"type":"string","description":"Product Type Code"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"brandNo":{"type":"string","description":"Brand No."},"safeCertiTgtYn":{"type":"string","description":"Safety Certification Target Status"},"buyrAgeLmtCd":{"type":"string","description":"Purchaser Age Restriction Code (PR004)"},"dispYn":{"type":"string","description":"Display Status"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"aprvReqDt":{"type":"string","description":"Approval Request Date"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058)"},"soutCausCd":{"type":"string","description":"Sold-Out Reason Code (PR032)"},"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)"},"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":"integer","format":"int32","description":"Minimum Limit Quantity"},"maxLmtQty":{"type":"integer","format":"int32","description":"Maximum Limit Quantity"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (PR008)"},"deliGoodsGbCd":{"type":"string","description":"Delivery Product Classification Code (PR010)"},"deliWayCd":{"type":"string","description":"Delivery Method Code (PR009)"},"deliDday":{"type":"integer","format":"int32","description":"Delivery Lead Time"},"itmSoutNotiYn":{"type":"string","description":"Item Sold-Out Alert Status"},"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"deliPsbRgnCd":{"type":"string","description":"Deliverable Area Code"},"rtnPsbYn":{"type":"string","description":"Return Availability Status"},"exchPsbYn":{"type":"string","description":"Exchange Availability Status"},"prcCompaExpYn":{"type":"string","description":"Price Comparison Exposure Status"},"pkgGoodsPrioRnkCd":{"type":"string","description":"Bundled Product Priority Code (PR035)"},"bpckPsbYn":{"type":"string","description":"Combined Packaging Availability Status"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"rglrDeliGoodsYn":{"type":"string","description":"Subscription Delivery Product Status"},"regInfPathCd":{"type":"string","description":"Registration Inflow Path Code (PR029)"},"aprvDt":{"type":"string","description":"Approval Date"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name (PR042)"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnDt":{"type":"string","description":"Rejection Date"},"schPsbYn":{"type":"string","description":"Searchable Status"},"optnYn":{"type":"string","description":"Option Management Status"},"optnCDYn":{"type":"string","description":"Option Add/Delete Status"},"goodsNoArray":{"type":"array","description":"Product No. Array","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"Size Guide Usage Status"},"szGdeRegMethodCd":{"type":"string","description":"Size Guide Registration Method Code (PR023)"},"szGdeCd":{"type":"string","description":"Size Guide Code (PR024)"},"szGdeConts":{"type":"string","description":"Size Guide Content"},"gftWthdYn":{"type":"string","description":"Collection Status"},"milgRsrvPsbYn":{"type":"string","description":"Mileage Accrual Availability Status"},"gvgfPsbYn":{"type":"string","description":"Gift Option Availability 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"},"entrNm":{"type":"string","description":"Vendor Name"},"brandNm":{"type":"string","description":"Brand Name"},"stdCtgHierarchy":{"type":"string","description":"Standard Classification Hierarchy Structure"},"mdId":{"type":"string","description":"MD ID"},"mdNm":{"type":"string","description":"MD Name"},"goodsNotiLisartCd":{"type":"string","description":"Product Notification Item Code"},"safeCertiNeedYn":{"type":"string","description":"Safety Certification Required Status (Standard Category)"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002)"},"mrgnRateGbCd":{"type":"string","description":"Margin Type Code (VD008)"},"mrgnRate1":{"type":"number","description":"Margin Rate 1"},"mrgnRate2":{"type":"number","description":"Margin Rate 2"}}},"PrGoodsPrceHist":{"type":"object","description":"Product Price History","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"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"eventPrc":{"type":"number","description":"Promotional Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"prcChgCausCdNm":{"type":"string","description":"Reason for Price Change"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"PrRsvSaleHist":{"type":"object","description":"Reserved Sale History","properties":{"goodsNo":{"type":"string","description":"Product No."},"rsvStrtDtm":{"type":"string","format":"date-time","description":"Reservation Start Date/Time"},"rsvEndDtm":{"type":"string","format":"date-time","description":"Reservation End Date/Time"},"rsvEndAfProcMethCd":{"type":"string","description":"Sales Method After Reservation Ends (PR011)"},"rsvStopYn":{"type":"string","description":"Reservation Suspended Status"},"rsvStopCausCd":{"type":"string","description":"Reservation Stop Reason Code (PR034)"},"rsvStopDtm":{"type":"string","format":"date-time","description":"Reservation Suspension Date/Time"},"fwdidcPrarDy":{"type":"string","description":"Scheduled Shipment Instruction Date"}}},"PrGoodsItemInfo":{"type":"object","description":"Product Item Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"goodsNotiLisartCd":{"type":"string","description":"Product Disclosure Item Code"},"goodsNotiItemCd":{"type":"string","description":"Product Notification Item Code"},"notiItemCmt":{"type":"string","description":"Notice Item Content"}}},"PrGoodsSafeCertiHist":{"type":"object","description":"Product Safety Certification History","properties":{"goodsNo":{"type":"string","description":"Product No."},"safeCertiGbCd":{"type":"string","description":"Safety Certification Type Code"},"safeCertiNo":{"type":"string","description":"Safety Certification No."},"aplyStrDt":{"type":"string","description":"Application Start Date"},"aplyEndDt":{"type":"string","description":"Application End Date"},"safeCertiOrnNm":{"type":"string","description":"Safety Certification Agency Name"}}},"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."}}},"PrGoodsPayMeanInfo":{"type":"object","description":"Product Payment Method Information","properties":{"goodsNo":{"type":"string","description":"Product No."},"payWayCd":{"type":"string","description":"Payment Method Code"},"useYn":{"type":"string","description":"Usage Status"}}},"GoodsOptionApiResponse":{"type":"object","description":"Product Item Option Info API Response","properties":{"goodsNo":{"type":"string","description":"Product No."},"optnCatNo":{"type":"string","description":"Option Classification No."},"optnCatNm":{"type":"string","description":"Option Classification Name"},"optnNo":{"type":"string","description":"Option No."},"optnNm":{"type":"string","description":"Option Name"},"optnCatSortSeq":{"type":"string","description":"Option Category Order"},"optnCatRegGbCd":{"type":"string","description":"Option Classification Registration Type Code"},"optnCatRegGbNm":{"type":"string","description":"Option Classification Registration Type Code Name"},"optnCatTypCd":{"type":"string","description":"Option Classification Type Code (PR019)"},"optnCatTypCdNm":{"type":"string","description":"Option Classification Type Code Name"},"optnList":{"type":"array","description":"Item Option Value List","items":{"$ref":"#/components/schemas/PrItmOptnInfo"}},"optnCdList":{"type":"string","deprecated":true,"description":"Option Value List"},"optnCdNmList":{"type":"string","deprecated":true,"description":"Option Name List"},"imgPathNm":{"type":"string","description":"Image Path"},"imgFileNm":{"type":"string","description":"Image File Name"},"rgbVal":{"type":"string","description":"RGB Value"}}},"PrItmOptnInfo":{"type":"object","description":"Unit Option Information","properties":{"langCd":{"type":"string","description":"Language Code"},"goodsNo":{"type":"string","description":"Product No."},"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 Category Order"},"optnSortSeq":{"type":"integer","format":"int32","description":"Option Order"}}},"PrItmBase":{"type":"object","description":"SKU Basic","properties":{"goodsNo":{"type":"string","description":"Product No."},"itmNo":{"type":"string","description":"Item No."},"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"},"lgcItmNo":{"type":"string","description":"Internal Item No."},"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"},"itmSaleStatCdNm":{"type":"string","description":"Unit Sales Status Code Name"},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code (PR058) 41: Sales Ended (Normal) 42: Sales Ended (Deleted)"},"repItmYn":{"type":"string","description":"Representative Item Status"},"dispSeq":{"type":"integer","format":"int32","description":"Display Order"},"addSupPcost":{"type":"number","description":"Additional Supply Cost"},"addSalePrc":{"type":"number","description":"Additional Sales Price"},"soutCausCd":{"type":"string","description":"Out-of-Stock Reason Code (PR032) 10: Automatic out-of-stock processing due to shipment unavailable, 11: Out-of-stock processing due to 0 stock quantity, 12: Manual out-of-stock processing by administrator, 13: Automatic out-of-stock processing due to next-day delivery delay, 14: Product out-of-stock processing due to all units out of stock, 15: Reserved product out-of-stock processing, 16: Out of stock due to bundle product out of stock"},"limtQty":{"type":"integer","format":"int32","description":"Reserved Limited Quantity"},"stkQty":{"type":"integer","format":"int32","description":"Stock Quantity"},"safeStkNotiYn":{"type":"string","description":"Safety Stock Alert Status"},"safeStkQty":{"type":"integer","format":"int32","description":"Safety Stock Quantity"},"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","description":"Option Category No._5"},"optnNo5":{"type":"string","description":"Option No._5"},"giftRegistDefaultValue":{"type":"string","writeOnly":true},"addSupPcostByMargn":{"type":"number","writeOnly":true}}},"PrGoodsContInfo":{"type":"object","description":"Product Content Information","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."},"goodsDtlDesc":{"type":"string","description":"Product Detailed Description"},"imgGbCd":{"type":"string","description":"Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video"},"dispSeq":{"type":"integer","format":"int32","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"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"PrStdCtgDispInfo":{"type":"object","description":"Standard Category Display Information","properties":{"siteNo":{"type":"string","description":"Site No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"repCtgYn":{"type":"string","description":"Representative Category Status"},"useYn":{"type":"string","description":"Usage Status"},"dispCtgNm":{"type":"string","description":"Display Category Name","readOnly":true},"dpmlNo":{"type":"string","description":"Display Mall No."},"siteNm":{"type":"string","description":"Site Name","readOnly":true},"dpmlNm":{"type":"string","description":"Display Mall Name","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"Product BO-API_Display Category Structure","readOnly":true}}},"AssociatedGoodsResponse":{"type":"object","properties":{"goodsNo":{"type":"string","description":"Product No."},"asctGoodsNo":{"type":"string","description":"Related Product No."},"asctGbCd":{"type":"string","description":"Related Type Code"},"sortSeq":{"type":"integer","format":"int32","description":"Sort Order"},"asctGoodsNm":{"type":"string"},"saleStatCdNm":{"type":"string"}}},"PrAdveWrdHist":{"type":"object","description":"Product Promotional Copy History","properties":{"goodsNo":{"type":"string","description":"Product No."},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date"},"adveWrd":{"type":"string","description":"Promotional Text"},"useYn":{"type":"string","description":"Usage Status"}}},"PrPrestHist":{"type":"object","description":"Free Gift History","properties":{"goodsNo":{"type":"string","description":"Product No."},"prestNm":{"type":"string","description":"Gift Item Name"},"useYn":{"type":"string","description":"Usage Status"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"}}},"PrGoodsIconInfo":{"type":"object","description":"Product Icon Information","properties":{"siteNo":{"type":"string","description":"Site No."},"goodsNo":{"type":"string","description":"Product No."},"dispIconNo":{"type":"string","description":"Display Icon No."},"siteNm":{"type":"string","description":"Site Name"},"iconNm":{"type":"string","description":"Icon Name"},"dispMediaCdNm":{"type":"string","description":"Display Media"},"iconTypCdNm":{"type":"string","description":"Icon Type"},"aplyStrDtm":{"type":"string","format":"date-time","description":"Application Start Date/Time"},"aplyEndDtm":{"type":"string","format":"date-time","description":"Application End Date/Time"},"iconPathNm":{"type":"string","description":"Icon Image Path"},"delYn":{"type":"string","description":"Deletion Status"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getGeneralGoodsInfo":{"get":{"tags":["Product Common"],"summary":"Search General Product Information","description":"## Function Description\n* Searches general product information.\n---\n## Detailed Description\n* Searches the product information of a general product.\n---\n## Revision History\n```Release v1.03_231106```\n - Added size guide related columns (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts)\n - Added icon (badge) settings\n\n```Release v1.04_231120```\n - Modified to return the alt text as an empty value when searching products with a sales status of \"temporarily saved\"\n - Added regular delivery product status column (rglrDeliGoodsYn)\n```Release v1.05_231204```\n - Changed the displayed product search query to an inner join\n","operationId":"getGeneralGoodsInfo","parameters":[{"name":"goodsNo","in":"query","description":"Product No.","required":true,"schema":{"type":"String"}},{"name":"langCd","in":"query","description":"Language Code","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"Product Information Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseGeneralGoodsApiResponse"}}}},"900":{"description":"Product Information Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Vendor Basic Information

> \## Function Description\
> \* Searches the vendor basic information needed on the Product Registration/Modification/Detail page.\
> \---\
> \## Detailed Description\
> \* Searches vendor basic information according to the vendor number.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"EnEntrBaseRequest":{"type":"object","description":"Partner Inquiry Popup Request","properties":{"argSelectType":{"type":"string","description":"Selection Type","minLength":1},"argTrdStatCd":{"type":"string","description":"Transaction Status"},"argEntrGbCd":{"type":"string","description":"Partner Type"},"argTrdTypCd":{"type":"string","description":"Transaction Type Code"},"argEcpnUseYn":{"type":"string","description":"E-Coupon Usage Status"},"entrGbCd":{"type":"string","description":"Vendor Classification Code (VD001) 10: Product Supplier, 20: Affiliate Partner"},"trdStatCd":{"type":"string","description":"Transaction Status Code (VD003) 10: Pending Transaction, 20: In Transaction, 30: Transaction Ended"},"entrNo":{"type":"string","description":"Vendor No."},"entrNm":{"type":"string","description":"Vendor Name"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002)"},"ecpnUseYn":{"type":"string","description":"E-Coupon Usage Status"}},"required":["argSelectType"]},"ResponseEnEntrBaseResponse":{"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/EnEntrBaseResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"EnEntrBaseResponse":{"type":"object","description":"Vendor Basic Information Response","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":"number","format":"double","description":"Latitude"},"lngt":{"type":"number","format":"double","description":"Longitude"},"trdTypCd":{"type":"string","description":"Transaction Type Code (VD002) 10: Direct Purchase, 20: Consignment Sale, 30: Affiliate"},"buyTypCdNm":{"type":"string","description":"Purchase Type Code Name"},"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."},"bmanKindNm":{"type":"string","description":"Business Type Code Name"},"corpnNo":{"type":"string","description":"Corporate Registration No."},"btyp":{"type":"string","description":"Business Type"},"bkind":{"type":"string","description":"Business Category"},"contStrtDy":{"type":"string","format":"date","description":"Contract Start Date"},"contEndDy":{"type":"string","format":"date","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":"integer","format":"int64","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":"number","description":"Margin Rate 1"},"mrgnRate2":{"type":"number","description":"Margin Rate 2"},"singleMrgnRate":{"type":"number","description":"Single Margin Rate"},"intervalMrgnRate1":{"type":"number","description":"Tiered Margin Rate 1"},"intervalMrgnRate2":{"type":"number","description":"Tiered Margin Rate 2"},"ecpnUseYn":{"type":"string","description":"E-Coupon Usage Status"},"ecpnLinkGbCd":{"type":"string","description":"E-Coupon Integration Type Code"},"ecpnLinkGbNm":{"type":"string","description":"E-Coupon Integration Type Name"},"entrGbNm":{"type":"string","description":"Vendor Type Name"},"trdStatNm":{"type":"string","description":"Transaction Status Name"},"itmSaleStatCd":{"type":"string","description":"Item Sales Status","enum":["TEMPORARY_STORAGE","WAITING_FOR_APPROVAL","COMPANION","SALES","SOLD_OUT","SALE_END"]},"saleStatChgCausCd":{"type":"string","description":"Sales Status Change Reason Code","enum":["SALES","SOLD_OUT","SUSPEND","SALE_END","PARTNER_SALE_END"]},"rtGrpNo":{"type":"string","description":"Authorization Group No."},"endPage":{"type":"boolean","description":"Last Page Status"},"totalCount":{"type":"integer","format":"int32","description":"Total Count"},"endPartnerSaleAndAuthGroup":{"type":"string","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getEtEntrBase":{"get":{"tags":["Product Common"],"summary":"Search Vendor Basic Information","description":"## Function Description\n* Searches the vendor basic information needed on the Product Registration/Modification/Detail page.\n---\n## Detailed Description\n* Searches vendor basic information according to the vendor number.\n","operationId":"getEtEntrBase","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/EnEntrBaseRequest"}},{"name":"entrNo","in":"query","description":"Vendor No.","schema":{"type":"String"}}],"responses":{"200":{"description":"Search Vendor Basic Information Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseEnEntrBaseResponse"}}}},"900":{"description":"Search Vendor Basic Information Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Display Category List by Standard Category

> \## Function Description\
> \* Searches the display category list by standard category.\
> \---\
> \## Detailed Description\
> \* Searches the display category list by standard category.\
> \---\
> \## Revision History\
> \`\`\`Release v1.05\_231204\`\`\`\
> \- Removed cases with no goodsNo from the standard category display information list search query\
> \- Added a display category usage status condition\
> \- Added a standard-display category link deletion status condition<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"StandardCategoryDisplayRequest":{"type":"object","description":"Standard Category Display Info Request","properties":{"stdCtgNo":{"type":"string","description":"Standard Category No."}}},"ResponseListPrStdCtgDispInfo":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/PrStdCtgDispInfo"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrStdCtgDispInfo":{"type":"object","description":"Standard Category Display Information","properties":{"siteNo":{"type":"string","description":"Site No."},"stdCtgNo":{"type":"string","description":"Standard Category No."},"dispCtgNo":{"type":"string","description":"Display Category No."},"repCtgYn":{"type":"string","description":"Representative Category Status"},"useYn":{"type":"string","description":"Usage Status"},"dispCtgNm":{"type":"string","description":"Display Category Name","readOnly":true},"dpmlNo":{"type":"string","description":"Display Mall No."},"siteNm":{"type":"string","description":"Site Name","readOnly":true},"dpmlNm":{"type":"string","description":"Display Mall Name","readOnly":true},"dispCtgHierarchy":{"type":"string","description":"Product BO-API_Display Category Structure","readOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory":{"get":{"tags":["Product Common"],"summary":"Search Display Category List by Standard Category","description":"## Function Description\n* Searches the display category list by standard category.\n---\n## Detailed Description\n* Searches the display category list by standard category.\n---\n## Revision History\n```Release v1.05_231204```\n- Removed cases with no goodsNo from the standard category display information list search query\n- Added a display category usage status condition\n- Added a standard-display category link deletion status condition\n","operationId":"getDisplayCategoryListByStandardCategory","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/StandardCategoryDisplayRequest"}}],"responses":{"200":{"description":"Search Display Category List by Standard Category Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrStdCtgDispInfo"}}}},"900":{"description":"Search Display Category List by Standard Category Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````

## Search Delivery/Return Fee Policy List

> \## Function Description\
> \* Searches the delivery/return fee policy list needed on the Product Registration/Modification/Detail page.\
> \---\
> \## Detailed Description\
> \* Searches the delivery/return fee policy list according to the vendor.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListDeliveryPolicyResponse":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/DeliveryPolicyResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"DeliveryPolicyResponse":{"type":"object","description":"General Product Delivery Policy Response","properties":{"deliPolcNo":{"type":"string","description":"Delivery Policy No."},"entrNm":{"type":"string","description":"Vendor Name"},"entrNo":{"type":"string","description":"Vendor No."},"dlexRegnGrpCd":{"type":"string","description":"Delivery Region Type Code"},"dlexRegnGrpNm":{"type":"string","description":"Delivery Region Type Name"},"dlexTypCd":{"type":"string","description":"Delivery Fee Type Code (VD005)"},"dlexTypNm":{"type":"string","description":"Delivery Fee Type Code Name"},"wthdRtnAmt":{"type":"string","description":"Return Shipping Fee"},"dlexAmt":{"type":"string","description":"Delivery Fee"},"stdAmt":{"type":"string","description":"Standard Amount"},"addDlexAmt":{"type":"string","description":"Additional Delivery Fee"},"addDlexInfo":{"type":"string","description":"Additional Delivery Fee Info"},"dlexTotAmt":{"type":"string","description":"Total Delivery Fee"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/goodsCommonApi/getDeliveryPolicyList":{"get":{"tags":["Product Common"],"summary":"Search Delivery/Return Fee Policy List","description":"## Function Description\n* Searches the delivery/return fee policy list needed on the Product Registration/Modification/Detail page.\n---\n## Detailed Description\n* Searches the delivery/return fee policy list according to the vendor.\n","operationId":"getDeliveryPolicyList","parameters":[{"name":"entrNo","in":"query","description":"Vendor No.","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"Search Delivery/Return Fee Policy List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListDeliveryPolicyResponse"}}}},"900":{"description":"Search Delivery/Return Fee Policy List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Currently Applied Price

> \## Function Description\
> \* Searches the currently applied price based on the date.\
> \---\
> \## Detailed Description\
> \* Searches the promotional price information currently applied to the product based on the date.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GoodsPriceHistoryRequest":{"type":"object","description":"Product Price History Request","properties":{"goodsNo":{"type":"string","description":"Product No."},"histEndDtm":{"type":"string","format":"date-time","description":"History End Date/Time"},"histStrDtm":{"type":"string","format":"date-time","description":"History Start Date/Time"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"rsvCudStat":{"type":"string","description":"Price Change Request Code"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"ResponsePrGoodsPrceHist":{"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/PrGoodsPrceHist","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrGoodsPrceHist":{"type":"object","description":"Product Price History","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"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"eventPrc":{"type":"number","description":"Promotional Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"prcChgCausCdNm":{"type":"string","description":"Reason for Price Change"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/goodsCommontApi/getGoodsPrePriceHistory":{"get":{"tags":["Product Common"],"summary":"Search Currently Applied Price","description":"## Function Description\n* Searches the currently applied price based on the date.\n---\n## Detailed Description\n* Searches the promotional price information currently applied to the product based on the date.\n","operationId":"getGoodsPrePriceHistory","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsPriceHistoryRequest"}},{"name":"goodsNo","in":"query","description":"Product No.","schema":{"type":"String"}}],"responses":{"200":{"description":"Search Currently Applied Price Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponsePrGoodsPrceHist"}}}},"900":{"description":"Search Currently Applied Price Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Price History Information

> \## Function Description\
> \* Searches price history information.\
> \---\
> \## Detailed Description\
> \* Searches the price history of a general product.\
> \---\
> \## Revision History\
> \`\`\`Release v2.00\_240808\`\`\`\
> &#x20;\- Split from the general product information search\
> \`\`\`Release v1.06\_250609\`\`\`\
> &#x20;\- Added time deal information search<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ResponseListPrGoodsPrceHist":{"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":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/PrGoodsPrceHist"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"PrGoodsPrceHist":{"type":"object","description":"Product Price History","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"},"supPcost":{"type":"number","description":"Supply Cost"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"eventPrc":{"type":"number","description":"Promotional Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"goodsPrceTypCd":{"type":"string","description":"Product Price Type Code"},"prcChgCausCd":{"type":"string","description":"Price Change Reason Code (PR033)"},"prcChgCausCdNm":{"type":"string","description":"Reason for Price Change"},"timeDealYn":{"type":"string","description":"Time Deal Status"},"supPcostByMrgn":{"type":"number","writeOnly":true}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v1/goods/goodsCommontApi/getGeneralGoodsPriceHist":{"get":{"tags":["Product Common"],"summary":"Search Price History Information","description":"## Function Description\n* Searches price history information.\n---\n## Detailed Description\n* Searches the price history of a general product.\n---\n## Revision History\n```Release v2.00_240808```\n - Split from the general product information search\n```Release v1.06_250609```\n - Added time deal information search\n","operationId":"getGeneralGoodsPriceHist","parameters":[{"name":"goodsNo","in":"query","description":"Product No.","required":true,"schema":{"type":"String"}},{"name":"langCd","in":"query","description":"Language Code","required":false,"schema":{"type":"String"}}],"responses":{"200":{"description":"Product Information Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListPrGoodsPrceHist"}}}},"900":{"description":"Product Information Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````
