상품 공통

이미지 저장

post

기능설명

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

상세설명

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

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

filesstring · binaryRequired

이미지 파일 목록

imageInfoImageInfoRequestV2Optional

이미지 정보 Request

Body

imageInfoImageInfoRequestV2Optional

이미지 정보 Request

Responses

200

*/*

상품컨텐츠정보

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

[
  {
    "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: 9545

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "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-02-27T18:14:19.431Z",
    "saleStrDtm": "2026-02-27T18:14:19.431Z",
    "saleEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27",
    "ecpnUsePsbEndDt": "2026-02-27"
  },
  "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-02-27T18:14:19.431Z",
      "aplyEndDtm": "2026-02-27T18:14:19.431Z",
      "adveWrd": "text",
      "useYn": "text"
    }
  ],
  "prPrestHistList": [
    {
      "goodsNo": "text",
      "prestNm": "text",
      "useYn": "text",
      "aplyStrDtm": "2026-02-27T18:14:19.431Z",
      "aplyEndDtm": "2026-02-27T18:14:19.431Z"
    }
  ],
  "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-02-27T18:14:19.431Z",
    "histEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27T18:14:19.431Z",
    "rsvEndDtm": "2026-02-27T18:14:19.431Z",
    "rsvEndAfProcMethCd": "text",
    "rsvStopYn": "text",
    "rsvStopCausCd": "text",
    "rsvStopDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "create": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "update": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "delete": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "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
  }
}

{
  "timestamp": "2026-02-27T18:14:19.431Z",
  "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: 3690

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "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-02-27T18:14:19.431Z",
    "saleStrDtm": "2026-02-27T18:14:19.431Z",
    "saleEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27",
    "ecpnUsePsbEndDt": "2026-02-27"
  },
  "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-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
      "aplyEndDtm": "2026-02-27T18:14:19.431Z"
    }
  ]
}

{
  "timestamp": "2026-02-27T18:14:19.431Z",
  "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: 2461

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "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-02-27T18:14:19.431Z",
    "saleStrDtm": "2026-02-27T18:14:19.431Z",
    "saleEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27",
    "ecpnUsePsbEndDt": "2026-02-27"
  },
  "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-02-27T18:14:19.431Z",
  "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: 9545

{
  "prGoodsBase": {
    "goodsNo": "text",
    "goodsNm": "text",
    "modlNm": "text",
    "homeNm": "text",
    "mfcoNm": "text",
    "incomNm": "text",
    "salemnNm": "text",
    "manufYm": "text",
    "schKwdNm": "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-02-27T18:14:19.431Z",
    "saleStrDtm": "2026-02-27T18:14:19.431Z",
    "saleEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27",
    "ecpnUsePsbEndDt": "2026-02-27"
  },
  "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-02-27T18:14:19.431Z",
      "aplyEndDtm": "2026-02-27T18:14:19.431Z",
      "adveWrd": "text",
      "useYn": "text"
    }
  ],
  "prPrestHistList": [
    {
      "goodsNo": "text",
      "prestNm": "text",
      "useYn": "text",
      "aplyStrDtm": "2026-02-27T18:14:19.431Z",
      "aplyEndDtm": "2026-02-27T18:14:19.431Z"
    }
  ],
  "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-02-27T18:14:19.431Z",
    "histEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27T18:14:19.431Z",
    "rsvEndDtm": "2026-02-27T18:14:19.431Z",
    "rsvEndAfProcMethCd": "text",
    "rsvStopYn": "text",
    "rsvStopCausCd": "text",
    "rsvStopDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "create": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "update": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "iconPathNm": "text",
        "delYn": "N"
      }
    ],
    "delete": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "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
  }
}

{
  "timestamp": "2026-02-27T18:14:19.431Z",
  "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 · dateOptional

이력종료일시

histStrDtmstring · dateOptional

이력시작일시

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: 224

{
  "goodsNo": "text",
  "histEndDtm": "2026-02-27",
  "histStrDtm": "2026-02-27",
  "supPcost": 1,
  "norPrc": 1,
  "salePrc": 1,
  "mrgnRate": 1,
  "goodsPrceTypCd": "text",
  "prcChgCausCd": "text",
  "rsvCudStat": "text",
  "timeDealYn": "text",
  "supPcostByMrgn": 1
}

{
  "timestamp": "2026-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "siteNo": "text",
      "goodsNo": "text",
      "dispIconNo": "text",
      "siteNm": "text",
      "iconNm": "text",
      "dispMediaCdNm": "text",
      "iconTypCdNm": "text",
      "aplyStrDtm": "2026-02-27T18:14:19.431Z",
      "aplyEndDtm": "2026-02-27T18:14:19.431Z",
      "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-02-27T18:14:19.431Z",
  "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",
      "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-02-27T18:14:19.431Z",
      "saleStrDtm": "2026-02-27T18:14:19.431Z",
      "saleEndDtm": "2026-02-27T18:14:19.431Z",
      "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-02-27",
      "ecpnUsePsbEndDt": "2026-02-27",
      "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-02-27T18:14:19.431Z",
  "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": "text",
          "optnSortSeq": "text"
        }
      ],
      "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-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
  "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",
      "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-02-27T18:14:19.431Z",
      "saleStrDtm": "2026-02-27T18:14:19.431Z",
      "saleEndDtm": "2026-02-27T18:14:19.431Z",
      "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-02-27",
      "ecpnUsePsbEndDt": "2026-02-27",
      "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",
          "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-02-27T18:14:19.431Z",
          "saleStrDtm": "2026-02-27T18:14:19.431Z",
          "saleEndDtm": "2026-02-27T18:14:19.431Z",
          "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-02-27",
          "ecpnUsePsbEndDt": "2026-02-27",
          "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-02-27T18:14:19.431Z",
            "aplyEndDtm": "2026-02-27T18:14:19.431Z",
            "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-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
  "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",
    "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-02-27T18:14:19.431Z",
    "saleStrDtm": "2026-02-27T18:14:19.431Z",
    "saleEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27",
    "ecpnUsePsbEndDt": "2026-02-27",
    "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-02-27T18:14:19.431Z",
  "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",
      "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-02-27T18:14:19.431Z",
      "saleStrDtm": "2026-02-27T18:14:19.431Z",
      "saleEndDtm": "2026-02-27T18:14:19.431Z",
      "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-02-27",
      "ecpnUsePsbEndDt": "2026-02-27",
      "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-02-27T18:14:19.431Z",
  "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",
      "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-02-27T18:14:19.431Z",
      "saleStrDtm": "2026-02-27T18:14:19.431Z",
      "saleEndDtm": "2026-02-27T18:14:19.431Z",
      "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-02-27",
      "ecpnUsePsbEndDt": "2026-02-27",
      "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-02-27T18:14:19.431Z",
      "histEndDtm": "2026-02-27T18:14:19.431Z",
      "supPcost": 1,
      "norPrc": 1,
      "salePrc": 1,
      "eventPrc": 1,
      "mrgnRate": 1,
      "goodsPrceTypCd": "text",
      "prcChgCausCd": "text",
      "prcChgCausCdNm": "text",
      "timeDealYn": "text"
    },
    "prRsvSaleHistList": [
      {
        "goodsNo": "text",
        "rsvStrtDtm": "2026-02-27T18:14:19.431Z",
        "rsvEndDtm": "2026-02-27T18:14:19.431Z",
        "rsvEndAfProcMethCd": "text",
        "rsvStopYn": "text",
        "rsvStopCausCd": "text",
        "rsvStopDtm": "2026-02-27T18:14:19.431Z",
        "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": "text",
            "optnSortSeq": "text"
          }
        ],
        "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-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "adveWrd": "text",
        "useYn": "text"
      }
    ],
    "prPrestHistList": [
      {
        "goodsNo": "text",
        "prestNm": "text",
        "useYn": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z"
      }
    ],
    "prGoodsIconInfoList": [
      {
        "siteNo": "text",
        "goodsNo": "text",
        "dispIconNo": "text",
        "siteNm": "text",
        "iconNm": "text",
        "dispMediaCdNm": "text",
        "iconTypCdNm": "text",
        "aplyStrDtm": "2026-02-27T18:14:19.431Z",
        "aplyEndDtm": "2026-02-27T18:14:19.431Z",
        "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-02-27T18:14:19.431Z",
  "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-02-27",
    "contEndDy": "2026-02-27",
    "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-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
  "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-02-27T18:14:19.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "goodsNo": "text",
    "histStrDtm": "2026-02-27T18:14:19.431Z",
    "histEndDtm": "2026-02-27T18:14:19.431Z",
    "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-02-27T18:14:19.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "goodsNo": "text",
      "histStrDtm": "2026-02-27T18:14:19.431Z",
      "histEndDtm": "2026-02-27T18:14:19.431Z",
      "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"
    }
  ]
}

Previous묶음상품 등록 Next상품 일괄 등록

Last updated 3 days ago

hashtag이미지 저장

hashtag기능설명

hashtag상세설명

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

hashtag기능설명

hashtag상세설명

hashtag묶음상품 수정

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag상품정보 일괄수정

hashtag기능설명

hashtag상세설명

hashtag코드정리

hashtag사은품 수정

hashtag기능설명

hashtag상세설명

hashtag일반상품 수정

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag가격 변경 예약 등록/취소

hashtag기능설명

hashtag상세설명

hashtag코드정리

hashtag수정번호

hashtag아이콘 정보 조회

hashtag기능설명

hashtag상세설명

hashtag특이사항

hashtag수정번호

hashtag묶음상품 정보 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag단품 옵션목록 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag단품 판매상태 목록 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag상품고시항목 목록 조회

hashtag기능설명

hashtag상세설명

hashtag상품 다국어 정보 조회

hashtag기능설명

hashtag상세설명

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

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag상품 기본 정보 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag사은품 정보 조회

hashtag기능설명

hashtag상세설명

hashtag상세설명

hashtag일반상품 정보 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag협력사 기본 정보 조회

hashtag기능설명

hashtag상세설명

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

hashtag기능설명

hashtag상세설명

hashtag수정번호

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

hashtag기능설명

hashtag상세설명

hashtag적용 중인 가격 조회

hashtag기능설명

hashtag상세설명

hashtag가격이력 정보 조회

hashtag기능설명

이미지 저장

기능설명

상세설명

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

기능설명

상세설명

묶음상품 수정

기능설명

상세설명

수정번호

상품정보 일괄수정

기능설명

상세설명

코드정리

사은품 수정

기능설명

상세설명

일반상품 수정

기능설명

상세설명

수정번호

가격 변경 예약 등록/취소

기능설명

상세설명

코드정리

수정번호

아이콘 정보 조회

기능설명

상세설명

특이사항

수정번호

묶음상품 정보 조회

기능설명

상세설명

수정번호

단품 옵션목록 조회

기능설명

상세설명

수정번호

단품 판매상태 목록 조회

기능설명

상세설명

수정번호

상품고시항목 목록 조회

기능설명

상세설명

상품 다국어 정보 조회

기능설명

상세설명

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

기능설명

상세설명

수정번호

상품 기본 정보 조회

기능설명

상세설명

수정번호

사은품 정보 조회

기능설명

상세설명

상세설명

일반상품 정보 조회

기능설명

상세설명

수정번호

협력사 기본 정보 조회

기능설명

상세설명

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

기능설명

상세설명

수정번호

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

기능설명

상세설명

적용 중인 가격 조회

기능설명

상세설명

가격이력 정보 조회

기능설명