Product Common

Save Image

post

Function Description

Registers product images.

Detailed Description

Registers product images to S3.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filesstring · binaryRequired

Image File List

imageInfoImageInfoRequestV2Optional

Image Information Request

Body

imageInfoImageInfoRequestV2Optional

Image Information Request

Responses

200

*/*

Product Content Information

goodsNostringOptional

Product No.

contTypCdstringOptional

Content Type Code (PR017) 01: Detailed Description, 02: Video, 03: Product Image

contSnstringOptional

Content Serial No.

goodsDtlDescstringOptional

Product Detailed Description

imgGbCdstringOptional

Image Type Code (PR031) P10: Basic Image, P20: Additional Image, M10: Video

dispSeqinteger · int32Optional

Display Order

contFilePathNmstringOptional

Content File Path

contFileNmstringOptional

Content File Name

trnfTextContstringOptional

Alt Text Content

useYnstringOptional

Usage Status

packageSubImageRegistDefaultValueinteger · int32Write-onlyOptional

post/v2/goods/goodsCommonApi/uploadGoodsImage

POST /api/bo/v2/goods/goodsCommonApi/uploadGoodsImage?files=binary HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "imageInfo": null
}

200

[
  {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text"
  }
]

Register/Edit Product Multilingual Information

post

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.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGeneralGoodsCUDRequestV2Optional

Product Multilingual Information Request

Body

General Product Detail Request

Responses

200

Product multilingual information registered/edited successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Failed to register/edit product multilingual information

*/*

post/v2/goods/goodsCommonApi/registGoodsMultiLanguage

POST /api/bo/v2/goods/goodsCommonApi/registGoodsMultiLanguage HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 9763

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "seoTitleNm": "text",
    "seoDesc": "text",
    "seoKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-01-01T00:00:00.000Z",
    "saleStrDtm": "2026-01-01T00:00:00.000Z",
    "saleEndDtm": "2026-01-01T00:00:00.000Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01"
  },
  "prGoodsItemInfoList": [
    {
      "goodsNo": "text",
      "goodsNotiLisartCd": "text",
      "goodsNotiItemCd": "text",
      "notiItemCmt": "text"
    }
  ],
  "prGoodsSafeCertiHistList": [
    {
      "goodsNo": "text",
      "safeCertiGbCd": "text",
      "safeCertiNo": "text",
      "aplyStrDt": "text",
      "aplyEndDt": "text",
      "safeCertiOrnNm": "text"
    }
  ],
  "prGoodsAttInfoList": [
    {
      "langCd": "text",
      "goodsNo": "text",
      "attCd": "text",
      "attVal": "text",
      "stdCtgNo": "text"
    }
  ],
  "prGoodsPayMeanInfoList": [
    {
      "goodsNo": "text",
      "payWayCd": "text",
      "useYn": "text"
    }
  ],
  "prAdveWrdHistList": [
    {
      "goodsNo": "text",
      "aplyStrDtm": "2026-01-01T00:00:00.000Z",
      "aplyEndDtm": "2026-01-01T00:00:00.000Z",
      "adveWrd": "text",
      "useYn": "text"
    }
  ],
  "prPrestHistList": [
    {
      "goodsNo": "text",
      "prestNm": "text",
      "useYn": "text",
      "aplyStrDtm": "2026-01-01T00:00:00.000Z",
      "aplyEndDtm": "2026-01-01T00:00:00.000Z"
    }
  ],
  "prGoodsContInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "baseImageInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "subImageInfoList": [
    {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    }
  ],
  "baseVideoInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "deleteContsList": [
    {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    }
  ],
  "prGoodsPrceHist": {
    "goodsNo": "text",
    "histStrDtm": "2026-01-01T00:00:00.000Z",
    "histEndDtm": "2026-01-01T00:00:00.000Z",
    "supPcost": 1,
    "norPrc": 1,
    "salePrc": 1,
    "eventPrc": 1,
    "mrgnRate": 1,
    "goodsPrceTypCd": "text",
    "prcChgCausCd": "text",
    "prcChgCausCdNm": "text",
    "timeDealYn": "text",
    "supPcostByMrgn": 1
  },
  "prRsvSaleHist": {
    "goodsNo": "text",
    "rsvStrtDtm": "2026-01-01T00:00:00.000Z",
    "rsvEndDtm": "2026-01-01T00:00:00.000Z",
    "rsvEndAfProcMethCd": "text",
    "rsvStopYn": "text",
    "rsvStopCausCd": "text",
    "rsvStopDtm": "2026-01-01T00:00:00.000Z",
    "fwdidcPrarDy": "text"
  },
  "prDispGoodsInfoList": {
    "all": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "create": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "update": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "delete": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ]
  },
  "prAssocGoodsInfoList": {
    "all": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ],
    "create": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ],
    "update": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ],
    "delete": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ]
  },
  "prGoodsIconInfoList": {
    "all": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "create": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "update": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "delete": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ]
  },
  "prItmBaseList": {
    "all": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ],
    "create": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ],
    "update": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ],
    "delete": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ]
  },
  "prItmBase": {
    "goodsNo": "text",
    "itmNo": "text",
    "optnCatNm1": "text",
    "optnNm1": "text",
    "optnCatNm2": "text",
    "optnNm2": "text",
    "optnCatNm3": "text",
    "optnNm3": "text",
    "optnCatNm4": "text",
    "optnNm4": "text",
    "optnCatNm5": "text",
    "optnNm5": "text",
    "lgcItmNo": "text",
    "itmSaleStatCd": "text",
    "itmSaleStatCdNm": "text",
    "saleStatChgCausCd": "text",
    "repItmYn": "text",
    "dispSeq": 1,
    "addSupPcost": 1,
    "addSalePrc": 1,
    "soutCausCd": "text",
    "limtQty": 1,
    "stkQty": 1,
    "safeStkNotiYn": "text",
    "safeStkQty": 1,
    "optnCatNo1": "text",
    "optnNo1": "text",
    "optnCatNo2": "text",
    "optnNo2": "text",
    "optnCatNo3": "text",
    "optnNo3": "text",
    "optnCatNo4": "text",
    "optnNo4": "text",
    "optnCatNo5": "text",
    "optnNo5": "text",
    "giftRegistDefaultValue": "text",
    "addSupPcostByMargn": 1
  },
  "manualOptnInfoList": [
    {
      "langCd": "text",
      "goodsNo": "text",
      "optnCatNo": "text",
      "optnNo": "text",
      "optnCatNm": "text",
      "optnNm": "text",
      "optnCatSortSeq": 1,
      "optnSortSeq": 1
    }
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Edit Bundle Product

post

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

Added bundle product buyer age restriction code (buyrAgeLmtCd)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestPackageGoodsCUDRequestOptional

Bundle Product Information Request

Body

Bundle Product Detail Request

Responses

200

Bundle product edited successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Failed to edit bundle product

*/*

post/v2/goods/goodsCommonApi/modifyPackageGoods

POST /api/bo/v2/goods/goodsCommonApi/modifyPackageGoods HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 3745

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "seoTitleNm": "text",
    "seoDesc": "text",
    "seoKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-01-01T00:00:00.000Z",
    "saleStrDtm": "2026-01-01T00:00:00.000Z",
    "saleEndDtm": "2026-01-01T00:00:00.000Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01"
  },
  "prGoodsContInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "baseImageInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "subImageInfoList": [
    {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    }
  ],
  "baseVideoInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "deleteContsList": [
    {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    }
  ],
  "packageRelatedGoodsListGridCUD": {
    "all": [
      {
        "baseGoodsNo": "text",
        "tgtGoodsNo": "text",
        "repYn": "text",
        "sortSeq": 1
      }
    ],
    "create": [
      {
        "baseGoodsNo": "text",
        "tgtGoodsNo": "text",
        "repYn": "text",
        "sortSeq": 1
      }
    ],
    "update": [
      {
        "baseGoodsNo": "text",
        "tgtGoodsNo": "text",
        "repYn": "text",
        "sortSeq": 1
      }
    ],
    "delete": [
      {
        "baseGoodsNo": "text",
        "tgtGoodsNo": "text",
        "repYn": "text",
        "sortSeq": 1
      }
    ]
  },
  "prDispGoodsInfoListGridCUD": {
    "all": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "create": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "update": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "delete": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ]
  }
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Batch Edit Product Information

post

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

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGoodsMgmtInfoSaveApiRequestOptional

Body

Product Management Batch Change Request

goodsNoListstring[]Optional

Product No. List

Responses

200

Product information batch edited successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Failed to batch edit product information

*/*

post/v2/goods/goodsCommonApi/modifyGoodsInfo

POST /api/bo/v2/goods/goodsCommonApi/modifyGoodsInfo HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 197

{
  "goodsNoList": [
    "text"
  ],
  "goodsMgmtInfo": [
    {
      "state": "text",
      "target": "text",
      "dispCtgNoList": [
        "text"
      ],
      "adveWrd": "text",
      "aplyStrDtm": "2026-01-01T00:00:00.000Z",
      "aplyEndDtm": "2026-01-01T00:00:00.000Z"
    }
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Edit Gift

post

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.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGiftGoodsCUDRequestOptional

Gift Information Request

Body

Responses

200

Gift edited successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Failed to edit gift

*/*

post/v2/goods/goodsCommonApi/modifyGiftGoods

POST /api/bo/v2/goods/goodsCommonApi/modifyGiftGoods HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2516

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "seoTitleNm": "text",
    "seoDesc": "text",
    "seoKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-01-01T00:00:00.000Z",
    "saleStrDtm": "2026-01-01T00:00:00.000Z",
    "saleEndDtm": "2026-01-01T00:00:00.000Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01"
  },
  "prItmBase": {
    "goodsNo": "text",
    "itmNo": "text",
    "optnCatNm1": "text",
    "optnNm1": "text",
    "optnCatNm2": "text",
    "optnNm2": "text",
    "optnCatNm3": "text",
    "optnNm3": "text",
    "optnCatNm4": "text",
    "optnNm4": "text",
    "optnCatNm5": "text",
    "optnNm5": "text",
    "lgcItmNo": "text",
    "itmSaleStatCd": "text",
    "itmSaleStatCdNm": "text",
    "saleStatChgCausCd": "text",
    "repItmYn": "text",
    "dispSeq": 1,
    "addSupPcost": 1,
    "addSalePrc": 1,
    "soutCausCd": "text",
    "limtQty": 1,
    "stkQty": 1,
    "safeStkNotiYn": "text",
    "safeStkQty": 1,
    "optnCatNo1": "text",
    "optnNo1": "text",
    "optnCatNo2": "text",
    "optnNo2": "text",
    "optnCatNo3": "text",
    "optnNo3": "text",
    "optnCatNo4": "text",
    "optnNo4": "text",
    "optnCatNo5": "text",
    "optnNo5": "text",
    "giftRegistDefaultValue": "text",
    "addSupPcostByMargn": 1
  },
  "giftImageInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  }
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Edit General Product

post

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

Added gift wrapping availability variable (gvgfPsbYn)

Release v1.03_231106

Added size guide related columns (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts)
Added icon (badge) settings

Release v1.04_231120

Fixed validation and added fallback values for temporary save
Added logic for adding/removing SKU options during temporary save
Improved icon (badge) settings feature
Added recurring delivery product status column (rglrDeliGoodsYn)

Release v1.05_231204

Added standard category management attributes to product registration and product detail popup

Release v1.06_251020

For products in temporary save or pending approval, recalculates the SKU supply price based on the previously registered product price margin rate

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGeneralGoodsCUDRequestV2Optional

General Product Information Request

Body

General Product Detail Request

Responses

200

General product edited successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

Failed to edit general product

*/*

post/v2/goods/goodsCommonApi/modifyGeneralGoods

POST /api/bo/v2/goods/goodsCommonApi/modifyGeneralGoods HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 9763

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "seoTitleNm": "text",
    "seoDesc": "text",
    "seoKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-01-01T00:00:00.000Z",
    "saleStrDtm": "2026-01-01T00:00:00.000Z",
    "saleEndDtm": "2026-01-01T00:00:00.000Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01"
  },
  "prGoodsItemInfoList": [
    {
      "goodsNo": "text",
      "goodsNotiLisartCd": "text",
      "goodsNotiItemCd": "text",
      "notiItemCmt": "text"
    }
  ],
  "prGoodsSafeCertiHistList": [
    {
      "goodsNo": "text",
      "safeCertiGbCd": "text",
      "safeCertiNo": "text",
      "aplyStrDt": "text",
      "aplyEndDt": "text",
      "safeCertiOrnNm": "text"
    }
  ],
  "prGoodsAttInfoList": [
    {
      "langCd": "text",
      "goodsNo": "text",
      "attCd": "text",
      "attVal": "text",
      "stdCtgNo": "text"
    }
  ],
  "prGoodsPayMeanInfoList": [
    {
      "goodsNo": "text",
      "payWayCd": "text",
      "useYn": "text"
    }
  ],
  "prAdveWrdHistList": [
    {
      "goodsNo": "text",
      "aplyStrDtm": "2026-01-01T00:00:00.000Z",
      "aplyEndDtm": "2026-01-01T00:00:00.000Z",
      "adveWrd": "text",
      "useYn": "text"
    }
  ],
  "prPrestHistList": [
    {
      "goodsNo": "text",
      "prestNm": "text",
      "useYn": "text",
      "aplyStrDtm": "2026-01-01T00:00:00.000Z",
      "aplyEndDtm": "2026-01-01T00:00:00.000Z"
    }
  ],
  "prGoodsContInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "baseImageInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "subImageInfoList": [
    {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    }
  ],
  "baseVideoInfo": {
    "goodsNo": "text",
    "contTypCd": "text",
    "contSn": "text",
    "goodsDtlDesc": "text",
    "imgGbCd": "text",
    "dispSeq": 1,
    "contFilePathNm": "text",
    "contFileNm": "text",
    "trnfTextCont": "text",
    "useYn": "text",
    "packageSubImageRegistDefaultValue": 1
  },
  "deleteContsList": [
    {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text",
      "packageSubImageRegistDefaultValue": 1
    }
  ],
  "prGoodsPrceHist": {
    "goodsNo": "text",
    "histStrDtm": "2026-01-01T00:00:00.000Z",
    "histEndDtm": "2026-01-01T00:00:00.000Z",
    "supPcost": 1,
    "norPrc": 1,
    "salePrc": 1,
    "eventPrc": 1,
    "mrgnRate": 1,
    "goodsPrceTypCd": "text",
    "prcChgCausCd": "text",
    "prcChgCausCdNm": "text",
    "timeDealYn": "text",
    "supPcostByMrgn": 1
  },
  "prRsvSaleHist": {
    "goodsNo": "text",
    "rsvStrtDtm": "2026-01-01T00:00:00.000Z",
    "rsvEndDtm": "2026-01-01T00:00:00.000Z",
    "rsvEndAfProcMethCd": "text",
    "rsvStopYn": "text",
    "rsvStopCausCd": "text",
    "rsvStopDtm": "2026-01-01T00:00:00.000Z",
    "fwdidcPrarDy": "text"
  },
  "prDispGoodsInfoList": {
    "all": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "create": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "update": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ],
    "delete": [
      {
        "goodsNo": 10002042,
        "dispCtgNo": 242,
        "dispYn": "Y",
        "goodsList": [
          "text"
        ],
        "goodsArray": [
          "text"
        ],
        "itemList": [
          "text"
        ],
        "itemArray": [
          "text"
        ]
      }
    ]
  },
  "prAssocGoodsInfoList": {
    "all": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ],
    "create": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ],
    "update": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ],
    "delete": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1
      }
    ]
  },
  "prGoodsIconInfoList": {
    "all": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "create": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "update": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "delete": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ]
  },
  "prItmBaseList": {
    "all": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ],
    "create": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ],
    "update": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ],
    "delete": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text",
        "giftRegistDefaultValue": "text",
        "addSupPcostByMargn": 1
      }
    ]
  },
  "prItmBase": {
    "goodsNo": "text",
    "itmNo": "text",
    "optnCatNm1": "text",
    "optnNm1": "text",
    "optnCatNm2": "text",
    "optnNm2": "text",
    "optnCatNm3": "text",
    "optnNm3": "text",
    "optnCatNm4": "text",
    "optnNm4": "text",
    "optnCatNm5": "text",
    "optnNm5": "text",
    "lgcItmNo": "text",
    "itmSaleStatCd": "text",
    "itmSaleStatCdNm": "text",
    "saleStatChgCausCd": "text",
    "repItmYn": "text",
    "dispSeq": 1,
    "addSupPcost": 1,
    "addSalePrc": 1,
    "soutCausCd": "text",
    "limtQty": 1,
    "stkQty": 1,
    "safeStkNotiYn": "text",
    "safeStkQty": 1,
    "optnCatNo1": "text",
    "optnNo1": "text",
    "optnCatNo2": "text",
    "optnNo2": "text",
    "optnCatNo3": "text",
    "optnNo3": "text",
    "optnCatNo4": "text",
    "optnNo4": "text",
    "optnCatNo5": "text",
    "optnNo5": "text",
    "giftRegistDefaultValue": "text",
    "addSupPcostByMargn": 1
  },
  "manualOptnInfoList": [
    {
      "langCd": "text",
      "goodsNo": "text",
      "optnCatNo": "text",
      "optnNo": "text",
      "optnCatNm": "text",
      "optnNm": "text",
      "optnCatSortSeq": 1,
      "optnSortSeq": 1
    }
  ]
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Register/Cancel Price Change Reservation

post

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.
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

Integrated selling price/promotional price

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Product Price History Request

goodsNostringOptional

Product No.

histEndDtmstring · date-timeOptional

History End Date/Time

histStrDtmstring · date-timeOptional

History Start Date/Time

supPcostnumberOptional

Supply Cost

norPrcnumberOptional

Regular Price

salePrcnumberOptional

Selling Price

mrgnRatenumberOptional

Margin Rate

goodsPrceTypCdstringOptional

Product Price Type Code

prcChgCausCdstringOptional

Price Change Reason Code (PR033)

rsvCudStatstringOptional

Price Change Request Code

timeDealYnstringOptional

Time Deal Status

supPcostByMrgnnumberWrite-onlyOptional

Responses

200

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

*/*

post/v1/goods/goodsCommontApi/modifyGeneralGoodsPriceReservation

POST /api/bo/v1/goods/goodsCommontApi/modifyGeneralGoodsPriceReservation HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "goodsNo": "text",
  "histEndDtm": "2026-01-01T00:00:00.000Z",
  "histStrDtm": "2026-01-01T00:00:00.000Z",
  "supPcost": 1,
  "norPrc": 1,
  "salePrc": 1,
  "mrgnRate": 1,
  "goodsPrceTypCd": "text",
  "prcChgCausCd": "text",
  "rsvCudStat": "text",
  "timeDealYn": "text",
  "supPcostByMrgn": 1
}

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Icon Information

get

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

Sprint 5 PO1 defect/improvement - modified icon image query

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Search Product Icon Information Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Product Icon Information Failure

*/*

get/v2/goods/goodsCommonApi/getPrGoodsIconInfoList

GET /api/bo/v2/goods/goodsCommonApi/getPrGoodsIconInfoList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "siteNo": "text",
      "goodsNo": "text",
      "dispIconNo": "text",
      "siteNm": "text",
      "iconNm": "text",
      "dispMediaCdNm": "text",
      "iconTypCdNm": "text",
      "aplyStrDtm": "2026-01-01T00:00:00.000Z",
      "aplyEndDtm": "2026-01-01T00:00:00.000Z",
      "iconPathNm": "text",
      "delYn": "N"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Bundle Product Information

get

Function Description

Searches bundle product information.

Detailed Description

Searches the product information of the bundle product.

Revision History

Release v1.05_231204

Changed the displayed product search query to an inner join

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Product Information Retrieved Successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Product Information Retrieval Failed

*/*

get/v2/goods/goodsCommonApi/getPackageGoodsInfo

GET /api/bo/v2/goods/goodsCommonApi/getPackageGoodsInfo?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "prGoodsBase": {
      "goodsNo": "text",
      "goodsNm": "text",
      "modlNm": "text",
      "homeNm": "text",
      "mfcoNm": "text",
      "incomNm": "text",
      "salemnNm": "text",
      "manufYm": "text",
      "schKwdNm": "text",
      "seoTitleNm": "text",
      "seoDesc": "text",
      "seoKwdNm": "text",
      "lgcGoodsNo": "text",
      "entrNo": "text",
      "stdCtgNo": "text",
      "goodsCompCd": "text",
      "goodsTypCd": "text",
      "saleMethCd": "text",
      "brandNo": "text",
      "safeCertiTgtYn": "text",
      "buyrAgeLmtCd": "text",
      "dispYn": "text",
      "saleStatCd": "text",
      "aprvReqDt": "text",
      "saleStatChgCausCd": "text",
      "soutCausCd": "text",
      "goodsRegDtm": "2026-01-01T00:00:00.000Z",
      "saleStrDtm": "2026-01-01T00:00:00.000Z",
      "saleEndDtm": "2026-01-01T00:00:00.000Z",
      "buyTypCd": "text",
      "taxGbCd": "text",
      "stkMgrYn": "text",
      "buyQtyLmtYn": "text",
      "minLmtQty": 1,
      "maxLmtQty": 1,
      "deliProcTypCd": "text",
      "deliGoodsGbCd": "text",
      "deliWayCd": "text",
      "deliDday": 1,
      "itmSoutNotiYn": "text",
      "deliPolcNo": "text",
      "deliPsbRgnCd": "text",
      "rtnPsbYn": "text",
      "exchPsbYn": "text",
      "prcCompaExpYn": "text",
      "pkgGoodsPrioRnkCd": "text",
      "bpckPsbYn": "text",
      "hsCd": "text",
      "safeStkNotiYn": "text",
      "rglrDeliGoodsYn": "text",
      "regInfPathCd": "text",
      "aprvDt": "text",
      "retnCausCd": "text",
      "retnCausCdNm": "text",
      "retnCaus": "text",
      "retnDt": "text",
      "schPsbYn": "text",
      "optnYn": "text",
      "optnCDYn": "text",
      "goodsNoArray": [
        "text"
      ],
      "szGdeUseYn": "text",
      "szGdeRegMethodCd": "text",
      "szGdeCd": "text",
      "szGdeConts": "text",
      "gftWthdYn": "text",
      "milgRsrvPsbYn": "text",
      "gvgfPsbYn": "text",
      "frgnDirPurGoodsYn": "text",
      "entrGoodsNo": "text",
      "ordCnclPsbYn": "text",
      "wthdYn": "text",
      "ecpnAplyTermGbCd": "text",
      "ecpnIssuDdStdUseDds": 1,
      "ecpnUsePsbStrDt": "2026-01-01",
      "ecpnUsePsbEndDt": "2026-01-01",
      "entrNm": "text",
      "brandNm": "text",
      "stdCtgHierarchy": "text",
      "mdId": "text",
      "mdNm": "text",
      "goodsNotiLisartCd": "text",
      "safeCertiNeedYn": "text",
      "trdTypCd": "text",
      "mrgnRateGbCd": "text",
      "mrgnRate1": 1,
      "mrgnRate2": 1
    },
    "prRelGoodsInfoList": [
      {
        "baseGoodsNo": "text",
        "tgtGoodsNo": "text",
        "repYn": "text",
        "sortSeq": 1,
        "goodsNm": "text",
        "brandNm": "text",
        "entrNo": "text",
        "entrNm": "text",
        "mdId": "text",
        "mdNm": "text",
        "saleStatCdNm": "text",
        "dispYn": "text",
        "deliProcTypCdNm": "text",
        "deliGoodsGbCdNm": "text",
        "salePrc": 1,
        "dispDlexAmt": "text"
      }
    ],
    "prStdCtgDispInfoList": [
      {
        "siteNo": 1,
        "stdCtgNo": "HT01010000",
        "dispCtgNo": 212,
        "repCtgYn": "N",
        "useYn": "N",
        "dispCtgNm": "잡화>쥬얼리",
        "dpmlNo": 10001,
        "siteNm": "플래티어 닷컷",
        "dpmlNm": "통합몰",
        "dispCtgHierarchy": "text"
      }
    ],
    "prGoodsContInfoList": [
      {
        "goodsNo": "text",
        "contTypCd": "text",
        "contSn": "text",
        "goodsDtlDesc": "text",
        "imgGbCd": "text",
        "dispSeq": 1,
        "contFilePathNm": "text",
        "contFileNm": "text",
        "trnfTextCont": "text",
        "useYn": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Unit Option List

get

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)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Search Unit Option List Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Unit Option List Failure

*/*

get/v2/goods/goodsCommonApi/getItemOptionList

GET /api/bo/v2/goods/goodsCommonApi/getItemOptionList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "goodsNo": "text",
      "optnCatNo": "text",
      "optnCatNm": "text",
      "optnNo": "text",
      "optnNm": "text",
      "optnCatSortSeq": "text",
      "optnCatRegGbCd": "text",
      "optnCatRegGbNm": "text",
      "optnCatTypCd": "text",
      "optnCatTypCdNm": "text",
      "optnList": [
        {
          "langCd": "text",
          "goodsNo": "text",
          "optnCatNo": "text",
          "optnNo": "text",
          "optnCatNm": "text",
          "optnNm": "text",
          "optnCatSortSeq": 1,
          "optnSortSeq": 1
        }
      ],
      "imgPathNm": "text",
      "imgFileNm": "text",
      "rgbVal": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Unit Sales Status List

get

Function Description

Searches the unit sales status list.

Detailed Description

Searches the unit sales status list.

Revision History

Release v1.03_231106

Added the unit sales status list search API

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

Product No.

Responses

200

Search Unit Sales Status List Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Unit Sales Status List Failure

*/*

get/v2/goods/goodsCommonApi/getGoodsSaleStateList

GET /api/bo/v2/goods/goodsCommonApi/getGoodsSaleStateList?goodsNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "goodsNo": "text",
    "saleStatCd": "text",
    "saleStatChgCausCd": "text",
    "prItmBaseList": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Product Notice Item List

get

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.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNotiLisartCdStringOptional

Product Notification Item Code

langCdStringOptional

Language Code

Responses

200

Search Product Notice Item Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Product Notice Item Failure

*/*

get/v2/goods/goodsCommonApi/getGoodsNotificationItemList

GET /api/bo/v2/goods/goodsCommonApi/getGoodsNotificationItemList HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "goodsNotiItemCd": "text",
      "notiItemNm": "text",
      "notiItemDesc": "text",
      "insrtMethCd": "text",
      "useYn": "text",
      "orgnNotiItemNm": "text",
      "orgnNotiItemDesc": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Product Multilingual Information

get

Function Description

Searches the multilingual information of a product.

Detailed Description

Searches the list of all multilingual information currently registered for the product.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

Product No.

Responses

200

Search Product Multilingual Information Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Product Multilingual Information Failure

*/*

get/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo

GET /api/bo/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo?goodsNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "goodsBase": {
      "goodsNo": "text",
      "goodsNm": "text",
      "modlNm": "text",
      "homeNm": "text",
      "mfcoNm": "text",
      "incomNm": "text",
      "salemnNm": "text",
      "manufYm": "text",
      "schKwdNm": "text",
      "seoTitleNm": "text",
      "seoDesc": "text",
      "seoKwdNm": "text",
      "lgcGoodsNo": "text",
      "entrNo": "text",
      "stdCtgNo": "text",
      "goodsCompCd": "text",
      "goodsTypCd": "text",
      "saleMethCd": "text",
      "brandNo": "text",
      "safeCertiTgtYn": "text",
      "buyrAgeLmtCd": "text",
      "dispYn": "text",
      "saleStatCd": "text",
      "aprvReqDt": "text",
      "saleStatChgCausCd": "text",
      "soutCausCd": "text",
      "goodsRegDtm": "2026-01-01T00:00:00.000Z",
      "saleStrDtm": "2026-01-01T00:00:00.000Z",
      "saleEndDtm": "2026-01-01T00:00:00.000Z",
      "buyTypCd": "text",
      "taxGbCd": "text",
      "stkMgrYn": "text",
      "buyQtyLmtYn": "text",
      "minLmtQty": 1,
      "maxLmtQty": 1,
      "deliProcTypCd": "text",
      "deliGoodsGbCd": "text",
      "deliWayCd": "text",
      "deliDday": 1,
      "itmSoutNotiYn": "text",
      "deliPolcNo": "text",
      "deliPsbRgnCd": "text",
      "rtnPsbYn": "text",
      "exchPsbYn": "text",
      "prcCompaExpYn": "text",
      "pkgGoodsPrioRnkCd": "text",
      "bpckPsbYn": "text",
      "hsCd": "text",
      "safeStkNotiYn": "text",
      "rglrDeliGoodsYn": "text",
      "regInfPathCd": "text",
      "aprvDt": "text",
      "retnCausCd": "text",
      "retnCausCdNm": "text",
      "retnCaus": "text",
      "retnDt": "text",
      "schPsbYn": "text",
      "optnYn": "text",
      "optnCDYn": "text",
      "goodsNoArray": [
        "text"
      ],
      "szGdeUseYn": "text",
      "szGdeRegMethodCd": "text",
      "szGdeCd": "text",
      "szGdeConts": "text",
      "gftWthdYn": "text",
      "milgRsrvPsbYn": "text",
      "gvgfPsbYn": "text",
      "frgnDirPurGoodsYn": "text",
      "entrGoodsNo": "text",
      "ordCnclPsbYn": "text",
      "wthdYn": "text",
      "ecpnAplyTermGbCd": "text",
      "ecpnIssuDdStdUseDds": 1,
      "ecpnUsePsbStrDt": "2026-01-01",
      "ecpnUsePsbEndDt": "2026-01-01",
      "entrNm": "text",
      "brandNm": "text",
      "stdCtgHierarchy": "text",
      "mdId": "text",
      "mdNm": "text",
      "goodsNotiLisartCd": "text",
      "safeCertiNeedYn": "text",
      "trdTypCd": "text",
      "mrgnRateGbCd": "text",
      "mrgnRate1": 1,
      "mrgnRate2": 1
    },
    "goodsMultiLanguageDtoList": [
      {
        "goodsBase": {
          "goodsNo": "text",
          "goodsNm": "text",
          "modlNm": "text",
          "homeNm": "text",
          "mfcoNm": "text",
          "incomNm": "text",
          "salemnNm": "text",
          "manufYm": "text",
          "schKwdNm": "text",
          "seoTitleNm": "text",
          "seoDesc": "text",
          "seoKwdNm": "text",
          "lgcGoodsNo": "text",
          "entrNo": "text",
          "stdCtgNo": "text",
          "goodsCompCd": "text",
          "goodsTypCd": "text",
          "saleMethCd": "text",
          "brandNo": "text",
          "safeCertiTgtYn": "text",
          "buyrAgeLmtCd": "text",
          "dispYn": "text",
          "saleStatCd": "text",
          "aprvReqDt": "text",
          "saleStatChgCausCd": "text",
          "soutCausCd": "text",
          "goodsRegDtm": "2026-01-01T00:00:00.000Z",
          "saleStrDtm": "2026-01-01T00:00:00.000Z",
          "saleEndDtm": "2026-01-01T00:00:00.000Z",
          "buyTypCd": "text",
          "taxGbCd": "text",
          "stkMgrYn": "text",
          "buyQtyLmtYn": "text",
          "minLmtQty": 1,
          "maxLmtQty": 1,
          "deliProcTypCd": "text",
          "deliGoodsGbCd": "text",
          "deliWayCd": "text",
          "deliDday": 1,
          "itmSoutNotiYn": "text",
          "deliPolcNo": "text",
          "deliPsbRgnCd": "text",
          "rtnPsbYn": "text",
          "exchPsbYn": "text",
          "prcCompaExpYn": "text",
          "pkgGoodsPrioRnkCd": "text",
          "bpckPsbYn": "text",
          "hsCd": "text",
          "safeStkNotiYn": "text",
          "rglrDeliGoodsYn": "text",
          "regInfPathCd": "text",
          "aprvDt": "text",
          "retnCausCd": "text",
          "retnCausCdNm": "text",
          "retnCaus": "text",
          "retnDt": "text",
          "schPsbYn": "text",
          "optnYn": "text",
          "optnCDYn": "text",
          "goodsNoArray": [
            "text"
          ],
          "szGdeUseYn": "text",
          "szGdeRegMethodCd": "text",
          "szGdeCd": "text",
          "szGdeConts": "text",
          "gftWthdYn": "text",
          "milgRsrvPsbYn": "text",
          "gvgfPsbYn": "text",
          "frgnDirPurGoodsYn": "text",
          "entrGoodsNo": "text",
          "ordCnclPsbYn": "text",
          "wthdYn": "text",
          "ecpnAplyTermGbCd": "text",
          "ecpnIssuDdStdUseDds": 1,
          "ecpnUsePsbStrDt": "2026-01-01",
          "ecpnUsePsbEndDt": "2026-01-01",
          "entrNm": "text",
          "brandNm": "text",
          "stdCtgHierarchy": "text",
          "mdId": "text",
          "mdNm": "text",
          "goodsNotiLisartCd": "text",
          "safeCertiNeedYn": "text",
          "trdTypCd": "text",
          "mrgnRateGbCd": "text",
          "mrgnRate1": 1,
          "mrgnRate2": 1
        },
        "prGoodsContInfo": {
          "goodsNo": "text",
          "contTypCd": "text",
          "contSn": "text",
          "goodsDtlDesc": "text",
          "imgGbCd": "text",
          "dispSeq": 1,
          "contFilePathNm": "text",
          "contFileNm": "text",
          "trnfTextCont": "text",
          "useYn": "text"
        },
        "prGoodsItemInfoList": [
          {
            "goodsNo": "text",
            "goodsNotiLisartCd": "text",
            "goodsNotiItemCd": "text",
            "notiItemCmt": "text"
          }
        ],
        "prAdveWrdHistList": [
          {
            "goodsNo": "text",
            "aplyStrDtm": "2026-01-01T00:00:00.000Z",
            "aplyEndDtm": "2026-01-01T00:00:00.000Z",
            "adveWrd": "text",
            "useYn": "text"
          }
        ]
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Product Category Attribute List

get

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

Created a new API following the addition of standard category management attributes

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Search Product Category Attribute Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Product Category Attribute Failure

*/*

get/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList

GET /api/bo/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "stdCtgNo": "HT01000000",
      "goodsNo": "text",
      "attValTypCd": "text",
      "attNm": "text",
      "attCd": "text",
      "attVal": "text",
      "dispSeq": "text",
      "orgnAttNm": "text",
      "orgnAttVal": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Product Basic Information

get

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)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNostringRequired

langCdstringOptionalDefault: ko

Responses

200

Product Information Retrieved Successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Product Information Retrieval Failed

*/*

get/v2/goods/goodsCommonApi/getGoodsBaseInfo

GET /api/bo/v2/goods/goodsCommonApi/getGoodsBaseInfo?goodsNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "text",
    "seoTitleNm": "text",
    "seoDesc": "text",
    "seoKwdNm": "text",
    "lgcGoodsNo": "text",
    "entrNo": "text",
    "stdCtgNo": "text",
    "goodsCompCd": "text",
    "goodsTypCd": "text",
    "saleMethCd": "text",
    "brandNo": "text",
    "safeCertiTgtYn": "text",
    "buyrAgeLmtCd": "text",
    "dispYn": "text",
    "saleStatCd": "text",
    "aprvReqDt": "text",
    "saleStatChgCausCd": "text",
    "soutCausCd": "text",
    "goodsRegDtm": "2026-01-01T00:00:00.000Z",
    "saleStrDtm": "2026-01-01T00:00:00.000Z",
    "saleEndDtm": "2026-01-01T00:00:00.000Z",
    "buyTypCd": "text",
    "taxGbCd": "text",
    "stkMgrYn": "text",
    "buyQtyLmtYn": "text",
    "minLmtQty": 1,
    "maxLmtQty": 1,
    "deliProcTypCd": "text",
    "deliGoodsGbCd": "text",
    "deliWayCd": "text",
    "deliDday": 1,
    "itmSoutNotiYn": "text",
    "deliPolcNo": "text",
    "deliPsbRgnCd": "text",
    "rtnPsbYn": "text",
    "exchPsbYn": "text",
    "prcCompaExpYn": "text",
    "pkgGoodsPrioRnkCd": "text",
    "bpckPsbYn": "text",
    "hsCd": "text",
    "safeStkNotiYn": "text",
    "rglrDeliGoodsYn": "text",
    "regInfPathCd": "text",
    "aprvDt": "text",
    "retnCausCd": "text",
    "retnCausCdNm": "text",
    "retnCaus": "text",
    "retnDt": "text",
    "schPsbYn": "text",
    "optnYn": "text",
    "optnCDYn": "text",
    "goodsNoArray": [
      "text"
    ],
    "szGdeUseYn": "text",
    "szGdeRegMethodCd": "text",
    "szGdeCd": "text",
    "szGdeConts": "text",
    "gftWthdYn": "text",
    "milgRsrvPsbYn": "text",
    "gvgfPsbYn": "text",
    "frgnDirPurGoodsYn": "text",
    "entrGoodsNo": "text",
    "ordCnclPsbYn": "text",
    "wthdYn": "text",
    "ecpnAplyTermGbCd": "text",
    "ecpnIssuDdStdUseDds": 1,
    "ecpnUsePsbStrDt": "2026-01-01",
    "ecpnUsePsbEndDt": "2026-01-01",
    "entrNm": "text",
    "brandNm": "text",
    "stdCtgHierarchy": "text",
    "mdId": "text",
    "mdNm": "text",
    "goodsNotiLisartCd": "text",
    "safeCertiNeedYn": "text",
    "trdTypCd": "text",
    "mrgnRateGbCd": "text",
    "mrgnRate1": 1,
    "mrgnRate2": 1
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Free Gift Information

get

Function Description

Searches free gift information.

Detailed Description

Searches free gift information.

Detailed Description

Searches the product information of the free gift.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNostringRequired

langCdstringOptionalDefault: ko

Responses

200

Product Information Retrieved Successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Product Information Retrieval Failed

*/*

get/v2/goods/goodsCommonApi/getGiftGoodsInfo

GET /api/bo/v2/goods/goodsCommonApi/getGiftGoodsInfo?goodsNo=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "prGoodsBase": {
      "goodsNo": "text",
      "goodsNm": "text",
      "modlNm": "text",
      "homeNm": "text",
      "mfcoNm": "text",
      "incomNm": "text",
      "salemnNm": "text",
      "manufYm": "text",
      "schKwdNm": "text",
      "seoTitleNm": "text",
      "seoDesc": "text",
      "seoKwdNm": "text",
      "lgcGoodsNo": "text",
      "entrNo": "text",
      "stdCtgNo": "text",
      "goodsCompCd": "text",
      "goodsTypCd": "text",
      "saleMethCd": "text",
      "brandNo": "text",
      "safeCertiTgtYn": "text",
      "buyrAgeLmtCd": "text",
      "dispYn": "text",
      "saleStatCd": "text",
      "aprvReqDt": "text",
      "saleStatChgCausCd": "text",
      "soutCausCd": "text",
      "goodsRegDtm": "2026-01-01T00:00:00.000Z",
      "saleStrDtm": "2026-01-01T00:00:00.000Z",
      "saleEndDtm": "2026-01-01T00:00:00.000Z",
      "buyTypCd": "text",
      "taxGbCd": "text",
      "stkMgrYn": "text",
      "buyQtyLmtYn": "text",
      "minLmtQty": 1,
      "maxLmtQty": 1,
      "deliProcTypCd": "text",
      "deliGoodsGbCd": "text",
      "deliWayCd": "text",
      "deliDday": 1,
      "itmSoutNotiYn": "text",
      "deliPolcNo": "text",
      "deliPsbRgnCd": "text",
      "rtnPsbYn": "text",
      "exchPsbYn": "text",
      "prcCompaExpYn": "text",
      "pkgGoodsPrioRnkCd": "text",
      "bpckPsbYn": "text",
      "hsCd": "text",
      "safeStkNotiYn": "text",
      "rglrDeliGoodsYn": "text",
      "regInfPathCd": "text",
      "aprvDt": "text",
      "retnCausCd": "text",
      "retnCausCdNm": "text",
      "retnCaus": "text",
      "retnDt": "text",
      "schPsbYn": "text",
      "optnYn": "text",
      "optnCDYn": "text",
      "goodsNoArray": [
        "text"
      ],
      "szGdeUseYn": "text",
      "szGdeRegMethodCd": "text",
      "szGdeCd": "text",
      "szGdeConts": "text",
      "gftWthdYn": "text",
      "milgRsrvPsbYn": "text",
      "gvgfPsbYn": "text",
      "frgnDirPurGoodsYn": "text",
      "entrGoodsNo": "text",
      "ordCnclPsbYn": "text",
      "wthdYn": "text",
      "ecpnAplyTermGbCd": "text",
      "ecpnIssuDdStdUseDds": 1,
      "ecpnUsePsbStrDt": "2026-01-01",
      "ecpnUsePsbEndDt": "2026-01-01",
      "entrNm": "text",
      "brandNm": "text",
      "stdCtgHierarchy": "text",
      "mdId": "text",
      "mdNm": "text",
      "goodsNotiLisartCd": "text",
      "safeCertiNeedYn": "text",
      "trdTypCd": "text",
      "mrgnRateGbCd": "text",
      "mrgnRate1": 1,
      "mrgnRate2": 1
    },
    "prItmBase": {
      "goodsNo": "text",
      "itmNo": "text",
      "optnCatNm1": "text",
      "optnNm1": "text",
      "optnCatNm2": "text",
      "optnNm2": "text",
      "optnCatNm3": "text",
      "optnNm3": "text",
      "optnCatNm4": "text",
      "optnNm4": "text",
      "optnCatNm5": "text",
      "optnNm5": "text",
      "lgcItmNo": "text",
      "itmSaleStatCd": "text",
      "itmSaleStatCdNm": "text",
      "saleStatChgCausCd": "text",
      "repItmYn": "text",
      "dispSeq": 1,
      "addSupPcost": 1,
      "addSalePrc": 1,
      "soutCausCd": "text",
      "limtQty": 1,
      "stkQty": 1,
      "safeStkNotiYn": "text",
      "safeStkQty": 1,
      "optnCatNo1": "text",
      "optnNo1": "text",
      "optnCatNo2": "text",
      "optnNo2": "text",
      "optnCatNo3": "text",
      "optnNo3": "text",
      "optnCatNo4": "text",
      "optnNo4": "text",
      "optnCatNo5": "text",
      "optnNo5": "text"
    },
    "giftImageInfo": {
      "goodsNo": "text",
      "contTypCd": "text",
      "contSn": "text",
      "goodsDtlDesc": "text",
      "imgGbCd": "text",
      "dispSeq": 1,
      "contFilePathNm": "text",
      "contFileNm": "text",
      "trnfTextCont": "text",
      "useYn": "text"
    }
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search General Product Information

get

Function Description

Searches general product information.

Detailed Description

Searches the product information of a general product.

Revision History

Release v1.03_231106

Added size guide related columns (szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts)
Added icon (badge) settings

Release v1.04_231120

Modified to return the alt text as an empty value when searching products with a sales status of "temporarily saved"
Added regular delivery product status column (rglrDeliGoodsYn) Release v1.05_231204
Changed the displayed product search query to an inner join

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

Product No.

langCdStringOptional

Language Code

Responses

200

Product Information Retrieved Successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Product Information Retrieval Failed

*/*

get/v2/goods/goodsCommonApi/getGeneralGoodsInfo

GET /api/bo/v2/goods/goodsCommonApi/getGeneralGoodsInfo?goodsNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "prGoodsBase": {
      "goodsNo": "text",
      "goodsNm": "text",
      "modlNm": "text",
      "homeNm": "text",
      "mfcoNm": "text",
      "incomNm": "text",
      "salemnNm": "text",
      "manufYm": "text",
      "schKwdNm": "text",
      "seoTitleNm": "text",
      "seoDesc": "text",
      "seoKwdNm": "text",
      "lgcGoodsNo": "text",
      "entrNo": "text",
      "stdCtgNo": "text",
      "goodsCompCd": "text",
      "goodsTypCd": "text",
      "saleMethCd": "text",
      "brandNo": "text",
      "safeCertiTgtYn": "text",
      "buyrAgeLmtCd": "text",
      "dispYn": "text",
      "saleStatCd": "text",
      "aprvReqDt": "text",
      "saleStatChgCausCd": "text",
      "soutCausCd": "text",
      "goodsRegDtm": "2026-01-01T00:00:00.000Z",
      "saleStrDtm": "2026-01-01T00:00:00.000Z",
      "saleEndDtm": "2026-01-01T00:00:00.000Z",
      "buyTypCd": "text",
      "taxGbCd": "text",
      "stkMgrYn": "text",
      "buyQtyLmtYn": "text",
      "minLmtQty": 1,
      "maxLmtQty": 1,
      "deliProcTypCd": "text",
      "deliGoodsGbCd": "text",
      "deliWayCd": "text",
      "deliDday": 1,
      "itmSoutNotiYn": "text",
      "deliPolcNo": "text",
      "deliPsbRgnCd": "text",
      "rtnPsbYn": "text",
      "exchPsbYn": "text",
      "prcCompaExpYn": "text",
      "pkgGoodsPrioRnkCd": "text",
      "bpckPsbYn": "text",
      "hsCd": "text",
      "safeStkNotiYn": "text",
      "rglrDeliGoodsYn": "text",
      "regInfPathCd": "text",
      "aprvDt": "text",
      "retnCausCd": "text",
      "retnCausCdNm": "text",
      "retnCaus": "text",
      "retnDt": "text",
      "schPsbYn": "text",
      "optnYn": "text",
      "optnCDYn": "text",
      "goodsNoArray": [
        "text"
      ],
      "szGdeUseYn": "text",
      "szGdeRegMethodCd": "text",
      "szGdeCd": "text",
      "szGdeConts": "text",
      "gftWthdYn": "text",
      "milgRsrvPsbYn": "text",
      "gvgfPsbYn": "text",
      "frgnDirPurGoodsYn": "text",
      "entrGoodsNo": "text",
      "ordCnclPsbYn": "text",
      "wthdYn": "text",
      "ecpnAplyTermGbCd": "text",
      "ecpnIssuDdStdUseDds": 1,
      "ecpnUsePsbStrDt": "2026-01-01",
      "ecpnUsePsbEndDt": "2026-01-01",
      "entrNm": "text",
      "brandNm": "text",
      "stdCtgHierarchy": "text",
      "mdId": "text",
      "mdNm": "text",
      "goodsNotiLisartCd": "text",
      "safeCertiNeedYn": "text",
      "trdTypCd": "text",
      "mrgnRateGbCd": "text",
      "mrgnRate1": 1,
      "mrgnRate2": 1
    },
    "prGoodsCurrentPrce": {
      "goodsNo": "text",
      "histStrDtm": "2026-01-01T00:00:00.000Z",
      "histEndDtm": "2026-01-01T00:00:00.000Z",
      "supPcost": 1,
      "norPrc": 1,
      "salePrc": 1,
      "eventPrc": 1,
      "mrgnRate": 1,
      "goodsPrceTypCd": "text",
      "prcChgCausCd": "text",
      "prcChgCausCdNm": "text",
      "timeDealYn": "text"
    },
    "prRsvSaleHistList": [
      {
        "goodsNo": "text",
        "rsvStrtDtm": "2026-01-01T00:00:00.000Z",
        "rsvEndDtm": "2026-01-01T00:00:00.000Z",
        "rsvEndAfProcMethCd": "text",
        "rsvStopYn": "text",
        "rsvStopCausCd": "text",
        "rsvStopDtm": "2026-01-01T00:00:00.000Z",
        "fwdidcPrarDy": "text"
      }
    ],
    "prGoodsItemInfoList": [
      {
        "goodsNo": "text",
        "goodsNotiLisartCd": "text",
        "goodsNotiItemCd": "text",
        "notiItemCmt": "text"
      }
    ],
    "prGoodsSafeCertiHistList": [
      {
        "goodsNo": "text",
        "safeCertiGbCd": "text",
        "safeCertiNo": "text",
        "aplyStrDt": "text",
        "aplyEndDt": "text",
        "safeCertiOrnNm": "text"
      }
    ],
    "prGoodsAttInfoList": [
      {
        "langCd": "text",
        "goodsNo": "text",
        "attCd": "text",
        "attVal": "text",
        "stdCtgNo": "text"
      }
    ],
    "prGoodsPayMeanInfoList": [
      {
        "goodsNo": "text",
        "payWayCd": "text",
        "useYn": "text"
      }
    ],
    "prItmOptnInfoList": [
      {
        "goodsNo": "text",
        "optnCatNo": "text",
        "optnCatNm": "text",
        "optnNo": "text",
        "optnNm": "text",
        "optnCatSortSeq": "text",
        "optnCatRegGbCd": "text",
        "optnCatRegGbNm": "text",
        "optnCatTypCd": "text",
        "optnCatTypCdNm": "text",
        "optnList": [
          {
            "langCd": "text",
            "goodsNo": "text",
            "optnCatNo": "text",
            "optnNo": "text",
            "optnCatNm": "text",
            "optnNm": "text",
            "optnCatSortSeq": 1,
            "optnSortSeq": 1
          }
        ],
        "imgPathNm": "text",
        "imgFileNm": "text",
        "rgbVal": "text"
      }
    ],
    "prItmBaseList": [
      {
        "goodsNo": "text",
        "itmNo": "text",
        "optnCatNm1": "text",
        "optnNm1": "text",
        "optnCatNm2": "text",
        "optnNm2": "text",
        "optnCatNm3": "text",
        "optnNm3": "text",
        "optnCatNm4": "text",
        "optnNm4": "text",
        "optnCatNm5": "text",
        "optnNm5": "text",
        "lgcItmNo": "text",
        "itmSaleStatCd": "text",
        "itmSaleStatCdNm": "text",
        "saleStatChgCausCd": "text",
        "repItmYn": "text",
        "dispSeq": 1,
        "addSupPcost": 1,
        "addSalePrc": 1,
        "soutCausCd": "text",
        "limtQty": 1,
        "stkQty": 1,
        "safeStkNotiYn": "text",
        "safeStkQty": 1,
        "optnCatNo1": "text",
        "optnNo1": "text",
        "optnCatNo2": "text",
        "optnNo2": "text",
        "optnCatNo3": "text",
        "optnNo3": "text",
        "optnCatNo4": "text",
        "optnNo4": "text",
        "optnCatNo5": "text",
        "optnNo5": "text"
      }
    ],
    "prGoodsContInfoList": [
      {
        "goodsNo": "text",
        "contTypCd": "text",
        "contSn": "text",
        "goodsDtlDesc": "text",
        "imgGbCd": "text",
        "dispSeq": 1,
        "contFilePathNm": "text",
        "contFileNm": "text",
        "trnfTextCont": "text",
        "useYn": "text"
      }
    ],
    "prStdCtgDispInfoList": [
      {
        "siteNo": 1,
        "stdCtgNo": "HT01010000",
        "dispCtgNo": 212,
        "repCtgYn": "N",
        "useYn": "N",
        "dispCtgNm": "잡화>쥬얼리",
        "dpmlNo": 10001,
        "siteNm": "플래티어 닷컷",
        "dpmlNm": "통합몰",
        "dispCtgHierarchy": "text"
      }
    ],
    "prAssocGoodsInfoList": [
      {
        "goodsNo": "text",
        "asctGoodsNo": "text",
        "asctGbCd": "text",
        "sortSeq": 1,
        "asctGoodsNm": "text",
        "saleStatCdNm": "text"
      }
    ],
    "prAdveWrdHistList": [
      {
        "goodsNo": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "adveWrd": "text",
        "useYn": "text"
      }
    ],
    "prPrestHistList": [
      {
        "goodsNo": "text",
        "prestNm": "text",
        "useYn": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z"
      }
    ],
    "prGoodsIconInfoList": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-01-01T00:00:00.000Z",
        "aplyEndDtm": "2026-01-01T00:00:00.000Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Vendor Basic Information

get

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.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringOptional

Vendor No.

Responses

200

Search Vendor Basic Information Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Vendor Basic Information Failure

*/*

get/v2/goods/goodsCommonApi/getEtEntrBase

GET /api/bo/v2/goods/goodsCommonApi/getEtEntrBase?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "entrNo": "text",
    "entrNm": "text",
    "entrGbCd": "text",
    "latt": 1,
    "lngt": 1,
    "trdTypCd": "text",
    "buyTypCdNm": "text",
    "trdStatCd": "text",
    "lgcEntrNo": "text",
    "rpstmnNm": "text",
    "bmanNo": "text",
    "bmanKindNm": "text",
    "corpnNo": "text",
    "btyp": "text",
    "bkind": "text",
    "contStrtDy": "2026-01-01",
    "contEndDy": "2026-01-01",
    "aempNm": "text",
    "aempTelRgnNo": "text",
    "aempTelTxnoNo": "text",
    "aempTelEndNo": "text",
    "aempCellSctNo": "text",
    "aempCellTxnoNo": "text",
    "aempCellEndNo": "text",
    "faxRgnNo": "text",
    "faxTxnoNo": "text",
    "faxEndNo": "text",
    "bmanKindCd": "text",
    "zipNoSeq": 1,
    "zipNo": "text",
    "zipAddr": "text",
    "dtlAddr": "text",
    "rmkCont": "text",
    "mrgnRateGbCd": "text",
    "mrgnRate1": 1,
    "mrgnRate2": 1,
    "singleMrgnRate": 1,
    "intervalMrgnRate1": 1,
    "intervalMrgnRate2": 1,
    "ecpnUseYn": "text",
    "ecpnLinkGbCd": "text",
    "ecpnLinkGbNm": "text",
    "entrGbNm": "text",
    "trdStatNm": "text",
    "itmSaleStatCd": 40,
    "saleStatChgCausCd": 43,
    "rtGrpNo": "text",
    "endPage": true,
    "totalCount": 1
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Display Category List by Standard Category

get

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

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Search Display Category List by Standard Category Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Display Category List by Standard Category Failure

*/*

get/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory

GET /api/bo/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "siteNo": 1,
      "stdCtgNo": "HT01010000",
      "dispCtgNo": 212,
      "repCtgYn": "N",
      "useYn": "N",
      "dispCtgNm": "잡화>쥬얼리",
      "dpmlNo": 10001,
      "siteNm": "플래티어 닷컷",
      "dpmlNm": "통합몰",
      "dispCtgHierarchy": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Delivery/Return Fee Policy List

get

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.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringRequired

Vendor No.

Responses

200

Search Delivery/Return Fee Policy List Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Delivery/Return Fee Policy List Failure

*/*

get/v2/goods/goodsCommonApi/getDeliveryPolicyList

GET /api/bo/v2/goods/goodsCommonApi/getDeliveryPolicyList?entrNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "deliPolcNo": "text",
      "entrNm": "text",
      "entrNo": "text",
      "dlexRegnGrpCd": "text",
      "dlexRegnGrpNm": "text",
      "dlexTypCd": "text",
      "dlexTypNm": "text",
      "wthdRtnAmt": "text",
      "dlexAmt": "text",
      "stdAmt": "text",
      "addDlexAmt": "text",
      "addDlexInfo": "text",
      "dlexTotAmt": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Currently Applied Price

get

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.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringOptional

Product No.

Responses

200

Search Currently Applied Price Success

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Search Currently Applied Price Failure

*/*

get/v1/goods/goodsCommontApi/getGoodsPrePriceHistory

GET /api/bo/v1/goods/goodsCommontApi/getGoodsPrePriceHistory?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "goodsNo": "text",
    "histStrDtm": "2026-01-01T00:00:00.000Z",
    "histEndDtm": "2026-01-01T00:00:00.000Z",
    "supPcost": 1,
    "norPrc": 1,
    "salePrc": 1,
    "eventPrc": 1,
    "mrgnRate": 1,
    "goodsPrceTypCd": "text",
    "prcChgCausCd": "text",
    "prcChgCausCdNm": "text",
    "timeDealYn": "text"
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

Search Price History Information

get

Function Description

Searches price history information.

Detailed Description

Searches the price history of a general product.

Revision History

Release v2.00_240808

Split from the general product information search Release v1.06_250609
Added time deal information search

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

Product No.

langCdStringOptional

Language Code

Responses

200

Product Information Retrieved Successfully

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

Product Information Retrieval Failed

*/*

get/v1/goods/goodsCommontApi/getGeneralGoodsPriceHist

GET /api/bo/v1/goods/goodsCommontApi/getGeneralGoodsPriceHist?goodsNo=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-01-01T00:00:00.000Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "goodsNo": "text",
      "histStrDtm": "2026-01-01T00:00:00.000Z",
      "histEndDtm": "2026-01-01T00:00:00.000Z",
      "supPcost": 1,
      "norPrc": 1,
      "salePrc": 1,
      "eventPrc": 1,
      "mrgnRate": 1,
      "goodsPrceTypCd": "text",
      "prcChgCausCd": "text",
      "prcChgCausCdNm": "text",
      "timeDealYn": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

PreviousRegister Bundle Product

NextProduct Bulk Registration