상품 공통

이미지 저장

post

기능설명

• 상품 이미지를 등록합니다.

---

상세설명

• 상품 이미지를 S3에 등록합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filesstring · binaryRequired

이미지 파일 목록

imageInfoImageInfoRequestV2Optional

이미지 정보 Request

Body

imageInfoImageInfoRequestV2Optional

이미지 정보 Request

Responses

200

OK

*/*

상품컨텐츠정보

goodsNostringOptional

상품번호

contTypCdstringOptional

컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지

contSnstringOptional

컨텐츠일련번호

goodsDtlDescstringOptional

상품상세설명

imgGbCdstringOptional

이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상

dispSeqinteger · int32Optional

전시순서

contFilePathNmstringOptional

컨텐츠파일경로명

contFileNmstringOptional

컨텐츠파일명

trnfTextContstringOptional

대체텍스트내용

useYnstringOptional

사용여부

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

OK

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

상품 다국어 정보 등록/수정

post

기능설명

• 상품의 다국어 정보를 등록/수정합니다.

---

상세설명

• 상품의 다국어 정보들 등록하거나 수정합니다.

• 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGeneralGoodsCUDRequestV2Optional

상품 다국어 정보 Request

Body

일반상품 상세 Request

Responses

200

상품 다국어 정보 등록/수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

상품 다국어 정보 등록/수정 실패

*/*

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

묶음상품 수정

post

기능설명

• 묶음상품 정보를 수정합니다.

---

상세설명

• 묶음상품 정보를 수정합니다.

• 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.

• 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.

---

수정번호

Release v1.04_231120

• 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestPackageGoodsCUDRequestOptional

묶음상품정보 Request

Body

묶음상품 상세 Requset

Responses

200

묶음상품 수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

묶음상품 수정 실패

*/*

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

상품정보 일괄수정

post

기능설명

• 선택한 상품들의 전시카테고리, 홍보문구를 일괄 수정합니다.

---

상세설명

• 선택한 상품들의 전시카테고리 또는 홍보문구를 일괄 수정합니다.

• 홍보문구를 수정하는 경우 기존 홍보문구를 삭제하고 요청한 홍보문구로 변경합니다.

---

코드정리

• target : 'dispCtg' : 전시카테고리, 'adveWrd' : 홍보문구

• state : 'U' : 업데이트, 'D' : 삭제

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGoodsMgmtInfoSaveApiRequestOptional

Body

상품관리 일관변경 Requsest

goodsNoListstring[]Optional

상품번호 목록

Responses

200

상품정보 일괄수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

상품정보 일괄수정 실패

*/*

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

사은품 수정

post

기능설명

• 사은품 정보를 수정합니다.

---

상세설명

• 사은품 정보를 수정합니다.

• 판매상태가 종료인 사은품은 사은품정보를 수정할 수 없습니다.

• 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGiftGoodsCUDRequestOptional

사은품정보 Request

Body

사은품 등록/수정 Request

Responses

200

사은품 수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

사은품 수정 실패

*/*

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

일반상품 수정

post

기능설명

• 일반상품 정보를 수정합니다.

---

상세설명

• 일반상품 정보를 수정합니다.

• 판매상태를 품절로 변경 시 상품과 상품 내 판매중인 모든 단품의 판매상태가 품절로 변경되며, 품절사유는 '관리자 품절' 사유로 저장됩니다.

• 판매상태가 종료인 상품은 상품정보를 수정할 수 없습니다.

• 예약판매 중인 상품의 판매상태가 품절인 경우 판매중으로 변경할 수 없습니다.

• 필수값을 모두 입력하지 않은 경우 오류 메시지를 보냅니다.

---

수정번호

Release v1.02_231023

• 선물하기가능여부(gvgfPsbYn) 변수추가

Release v1.03_231106

• 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가

• 아이콘(뱃지) 설정 추가

Release v1.04_231120

• 임시저장 시 validation 수정 및 대체값 추가

• 임시저장 시 단품 옵션 추가/삭제 로직 추가

• 아이콘(뱃지) 설정 기능 개선

• 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가

Release v1.05_231204

• 상품등록 및 상품상세팝업에 표준카테고리 관리속성 추가

Release v1.06_251020

• 임시저장 or 승인대기 상품의 경우 이미 등록된 상품가격 마진율에 따라 단품정보 공급가 재계산

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

requestGeneralGoodsCUDRequestV2Optional

일반상품정보 Request

Body

일반상품 상세 Request

Responses

200

일반상품 수정 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

일반상품 수정 실패

*/*

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

가격 변경 예약 등록/취소

post

기능설명

• 가격 변경 예약을 등록 또는 취소합니다.

---

상세설명

• 가격 변경 예약을 등록하거나 취소합니다.

• 가격변경요청코드(rsvCudStat)에 따라 등록과 취소를 구분합니다.

• 기존에 가격 변경 예약이 등록되어 있는 경우 기존 등록된 항목을 삭제하고 요청한 정보를 등록합니다.

• 등록의 경우 필수값을 모두 입력해야합니다.

• 공급원가, 정상가, 판매가, 마진율, 이력시작일시, 가격변경사유코드(PR033)

---

코드정리

• 가격변경요청코드 : C:등록, D:취소

수정번호

Release v2.00_240827

• 판매가/행사가 통합

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

상품가격이력 Request

goodsNostringOptional

상품번호

histEndDtmstring · date-timeOptional

이력종료일시

histStrDtmstring · date-timeOptional

이력시작일시

supPcostnumberOptional

공급원가

norPrcnumberOptional

정상가

salePrcnumberOptional

판매가

mrgnRatenumberOptional

마진율

goodsPrceTypCdstringOptional

상품가격유형코드

prcChgCausCdstringOptional

가격변경사유코드(PR033)

rsvCudStatstringOptional

가격변경요청코드

timeDealYnstringOptional

타임딜여부

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

아이콘 정보 조회

get

기능설명

• 상품에 등록된 아이콘 정보를 조회합니다.

---

상세설명

• 상품에 등록된 아이콘 정보를 조회합니다.

---

특이사항

• NEW, BEST 아이콘은 수동 등록이 아니라 쿼리 조회시마다 노출 여부가 결정됩니다.

---

수정번호

Release v1.05_231204

• 스프린트5 PO1 결함/개선 - 아이콘 이미지 쿼리 수정

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

상품 아이콘 정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품 아이콘 정보 조회 실패

*/*

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

묶음상품 정보 조회

get

기능설명

• 묶음상품 정보를 조회합니다.

---

상세설명

• 묶음상품의 상품정보를 조회합니다.

---

수정번호

Release v1.05_231204

• 전시 상품 조회 쿼리 inner join으로 변경

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

상품정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품정보 조회 실패

*/*

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

단품 옵션목록 조회

get

기능설명

• 단품 옵션목록을 조회합니다.

---

상세설명

• 단품 옵션목록을 조회합니다.

---

수정번호

Release v1.03_231106

• 이미지경로명(imgPathNm), 이미지파일명(imgFileNm), RGB값(rgbVal) 변수추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

단품 옵션목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

단품 옵션목록 조회 실패

*/*

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

단품 판매상태 목록 조회

get

기능설명

• 단품 판매상태 목록을 조회합니다.

---

상세설명

• 단품 판매상태 목록을 조회합니다.

---

수정번호

Release v1.03_231106

• 단품 판매상태 목록 조회 API 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

상품번호

Responses

200

단품 판매상태 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

단품 판매상태 목록 조회 실패

*/*

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

상품고시항목 목록 조회

get

기능설명

• 상품등록/수정/상세 페이지에서 필요한 상품고시항목 목록을 조회합니다.

---

상세설명

• 상품고시항목코드에 따른 상품고시항목의 목록을 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNotiLisartCdStringOptional

상품고시품목코드

langCdStringOptional

언어코드

Responses

200

상품고시항목 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품고시항목 조회 실패

*/*

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

상품 다국어 정보 조회

get

기능설명

• 상품의 다국어 정보를 조회합니다.

---

상세설명

• 상품에 현재 등록된 모든 다국어 정보를 리스트로 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

상품번호

Responses

200

상품 다국어 정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품 다국어 정보 조회 실패

*/*

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

상품 카테고리 속성 목록 조회

get

기능설명

• 상품등록/수정/상세 페이지에서 필요한 상품 카테고리 속성 목록을 조회합니다.

---

상세설명

• 표준카테고리에 매핑한 상품속성정보 목록을 조회합니다.

---

수정번호

Release v1.05_231204

• 표준카테고리 관리속성 추가에 따른 신규 API 생성

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

상품 카테고리 속성 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품 카테고리 속성 조회 실패

*/*

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

상품 기본 정보 조회

get

기능설명

• 상품 기본 정보를 조회합니다.

---

상세설명

• 상품 기본 정보를 조회합니다.

---

수정번호

Release v1.04_231120: 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNostringRequired

langCdstringOptionalDefault: ko

Responses

200

상품정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품정보 조회 실패

*/*

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

사은품 정보 조회

get

기능설명

• 사은품 정보를 조회합니다.

---

상세설명

• 사은품 정보를 조회합니다.

---

상세설명

• 사은품의 상품정보를 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNostringRequired

langCdstringOptionalDefault: ko

Responses

200

상품정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품정보 조회 실패

*/*

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

일반상품 정보 조회

get

기능설명

• 일반상품 정보를 조회합니다.

---

상세설명

• 일반상품의 상품정보를 조회합니다.

---

수정번호

Release v1.03_231106

• 사이즈 가이드 관련 컬럼(szGdeUseYn, szGdeRegMethodCd, szGdeCd, szGdeConts) 추가

• 아이콘(뱃지) 설정 추가

Release v1.04_231120

• 판매상태 임시저장인 상품 조회 시 대체텍스트를 빈 값으로 반환하도록 수정

• 정기배송상품여부 컬럼(rglrDeliGoodsYn) 추가 Release v1.05_231204

• 전시 상품 조회 쿼리 inner join으로 변경

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

상품번호

langCdStringOptional

언어코드

Responses

200

상품정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품정보 조회 실패

*/*

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

협력사 기본 정보 조회

get

기능설명

• 상품등록/수정/상세 페이지에서 필요한 협력사 기본 정보를 조회합니다.

---

상세설명

• 협력사 번호에 따른 협력사 기본 정보를 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringOptional

협력사번호

Responses

200

협력사 기본 정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

협력사 기본 정보 조회 실패

*/*

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

표준카테고리별 전시카테고리 목록 조회

get

기능설명

• 표준카테고리별 전시카테고리 목록을 조회합니다.

---

상세설명

• 표준카테고리별 전시카테고리 목록을 조회합니다.

---

수정번호

Release v1.05_231204

• 표준카테고리전시정보 목록 조회 쿼리 goodsNo가 없을 경우 삭제

• 전시 카테고리 사용 여부 조건 추가

• 표준 전시 카테고리 연결 삭제 여부 조건 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

표준카테고리별 전시카테고리 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

표준카테고리별 전시카테고리 목록 조회 실패

*/*

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

배송비/반품비 정책 목록 조회

get

기능설명

• 상품등록/수정/상세 페이지에서 필요한 배송비/반품비 정책 목록을 조회합니다

---

상세설명

• 협력사에 따른 배송비/반품비 정책 목록을 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringRequired

협력사번호

Responses

200

배송비/반품비 정책 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

배송비/반품비 정책 목록 조회 실패

*/*

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

적용 중인 가격 조회

get

기능설명

• 날짜 기준으로 적용 중인 가격를 조회합니다.

---

상세설명

• 상품에 날짜기준으로 적용중인 행사가 정보를 조회합니다.

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringOptional

상품번호

Responses

200

적용 중인 가격 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

적용 중인 가격 조회 실패

*/*

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

가격이력 정보 조회

get

기능설명

• 가격이력 정보를 조회합니다.

---

상세설명

• 일반상품의 가격이력을 조회합니다.

---

수정번호

Release v2.00_240808

• 일반상품 정보 조회에서 분할 Release v1.06_250609

• 타임딜 정보 조회 추가

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

상품번호

langCdStringOptional

언어코드

Responses

200

상품정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품정보 조회 실패

*/*

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