묶음상품 등록

묶음상품 등록

post

기능설명

• 묶음상품 등록 API 입니다.

---

상품설명

• 임시저장/승인요청에 따라 묶음상품을 등록합니다.

• 승인요청 시에는 필수값을 모두 입력하지 않으면 오류를 반환합니다.

---

수정번호

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

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

임시 묶음상품 CUD Request

goodsNostringOptional

상품번호

goodsNmstringOptional

상품명

modlNmstringOptional

모델명

homeNmstringOptional

원산지명

mfcoNmstringOptional

제조사명

incomNmstringOptional

수입자명

salemnNmstringOptional

판매자명

manufYmstringOptional

제조년월

schKwdNmstringOptional

검색키워드명

lgcGoodsNostringOptional

자체상품번호

entrNostringOptional

협력사번호

stdCtgNostringOptional

표준카테고리번호

goodsCompCdstringOptional

상품구성코드(PR001)

goodsTypCdstringOptional

상품유형코드(PR002)

saleMethCdstringOptional

판매방식코드(PR003)

brandNostringOptional

브랜드번호

safeCertiTgtYnstringOptional

안전인증대상여부

buyrAgeLmtCdstringOptional

구입자나이제한코드(PR004)

dispYnstringOptional

전시여부

saleStatCdstringOptional

판매상태코드(PR005)

aprvReqDtstringOptional

승인요청일자

saleStatChgCausCdstringOptional

판매상태변경사유코드(PR058)

soutCausCdstringOptional

품절사유코드(PR032)

goodsRegDtmstring · date-timeOptional

상품등록일시

saleStrDtmstring · date-timeOptional

판매시작일시

saleEndDtmstring · date-timeOptional

판매종료일시

buyTypCdstringOptional

매입유형코드(PR006)

taxGbCdstringOptional

과면세구분코드(PR007)

stkMgrYnstringOptional

재고관리여부

buyQtyLmtYnstringOptional

구매수량제한여부

minLmtQtyinteger · int32Optional

최소제한수량

maxLmtQtyinteger · int32Optional

최대제한수량

deliProcTypCdstringOptional

배송처리유형코드(PR008)

deliGoodsGbCdstringOptional

배송상품구분코드(PR010)

deliWayCdstringOptional

배송수단코드(PR009)

deliDdayinteger · int32Optional

배송기일

itmSoutNotiYnstringOptional

단품품절알림여부

deliPolcNostringOptional

배송정책번호

deliPsbRgnCdstringOptional

배송가능지역코드

rtnPsbYnstringOptional

반품가능여부

exchPsbYnstringOptional

교환가능여부

prcCompaExpYnstringOptional

가격비교노출여부

pkgGoodsPrioRnkCdstringOptional

묶음상품우선순위코드(PR035)

bpckPsbYnstringOptional

합포가능여부

hsCdstringOptional

hsCd

safeStkNotiYnstringOptional

안전재고알림여부

rglrDeliGoodsYnstringOptional

정기배송상품여부

regInfPathCdstringOptional

등록유입경로코드(PR029)

aprvDtstringOptional

승인일자

retnCausCdstringOptional

반려사유코드(PR042)

retnCausCdNmstringOptional

반려사유코드명(PR042)

retnCausstringOptional

반려사유

retnDtstringOptional

반려일자

schPsbYnstringOptional

검색가능여부

optnYnstringOptional

옵션관리여부

optnCDYnstringOptional

옵션 추가/삭제 여부

goodsNoArraystring[]Optional

상품번호배열

szGdeUseYnstringOptional

사이즈가이드 사용여부

szGdeRegMethodCdstringOptional

사이즈가이드 등록방법 코드(PR023)

szGdeCdstringOptional

사이즈가이드코드(PR024)

szGdeContsstringOptional

사이즈가이드 내용

gftWthdYnstringOptional

회수 여부

milgRsrvPsbYnstringOptional

마일리지적립가능여부

gvgfPsbYnstringOptional

선물하기가능여부

frgnDirPurGoodsYnstringOptional

해외직구상품여부

entrGoodsNostringOptional

협력사상품번호

ordCnclPsbYnstringOptional

주문취소가능여부

wthdYnstringOptional

회수여부

ecpnAplyTermGbCdstringOptional

e-쿠폰적용기간구분코드(MK015)

ecpnIssuDdStdUseDdsinteger · int32Optional

e-쿠폰발급일기준사용일수

ecpnUsePsbStrDtstring · dateOptional

e-쿠폰사용가능시작일자

ecpnUsePsbEndDtstring · dateOptional

e-쿠폰사용가능종료일자

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/packageGoodsApi/packageGoodsRegist

HTTPcURLJavaScriptPython

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

{
  "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:20:31.111Z",
  "saleStrDtm": "2026-02-27T18:20:31.111Z",
  "saleEndDtm": "2026-02-27T18:20:31.111Z",
  "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",
  "prGoodsContInfoList": [
    {
      "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"
        ]
      }
    ]
  },
  "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
    }
  ]
}

{
  "timestamp": "2026-02-27T18:20:31.111Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": "text",
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}