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

# 묶음상품 등록

## 묶음상품 등록

> \## 기능설명\
> \* 묶음상품 등록 API 입니다.\
> \---\
> \## 상품설명\
> \* 임시저장/승인요청에 따라 묶음상품을 등록합니다.\
> \* 승인요청 시에는 필수값을 모두 입력하지 않으면 오류를 반환합니다.\
> \---\
> \## 수정번호\
> \`\`\`Release v1.04\_231120\`\`\`: 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"TemporaryPackageGoodsCUDRequest":{"type":"object","description":"임시 묶음상품 CUD Request","properties":{"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"homeNm":{"type":"string","description":"원산지명"},"mfcoNm":{"type":"string","description":"제조사명"},"incomNm":{"type":"string","description":"수입자명"},"salemnNm":{"type":"string","description":"판매자명"},"manufYm":{"type":"string","description":"제조년월"},"schKwdNm":{"type":"string","description":"검색키워드명"},"seoTitleNm":{"type":"string","description":"SEO 타이틀명"},"seoDesc":{"type":"string","description":"SEO 설명"},"seoKwdNm":{"type":"string","description":"SEO 키워드명"},"lgcGoodsNo":{"type":"string","description":"자체상품번호"},"entrNo":{"type":"string","description":"협력사번호"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"safeCertiTgtYn":{"type":"string","description":"안전인증대상여부"},"buyrAgeLmtCd":{"type":"string","description":"구입자나이제한코드(PR004)"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"aprvReqDt":{"type":"string","description":"승인요청일자"},"saleStatChgCausCd":{"type":"string","description":"판매상태변경사유코드(PR058)"},"soutCausCd":{"type":"string","description":"품절사유코드(PR032)"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"saleStrDtm":{"type":"string","format":"date-time","description":"판매시작일시"},"saleEndDtm":{"type":"string","format":"date-time","description":"판매종료일시"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","format":"int32","description":"최소제한수량"},"maxLmtQty":{"type":"integer","format":"int32","description":"최대제한수량"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliDday":{"type":"integer","format":"int32","description":"배송기일"},"itmSoutNotiYn":{"type":"string","description":"단품품절알림여부"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"prcCompaExpYn":{"type":"string","description":"가격비교노출여부"},"pkgGoodsPrioRnkCd":{"type":"string","description":"묶음상품우선순위코드(PR035)"},"bpckPsbYn":{"type":"string","description":"합포가능여부"},"hsCd":{"type":"string","description":"hsCd"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"regInfPathCd":{"type":"string","description":"등록유입경로코드(PR029)"},"aprvDt":{"type":"string","description":"승인일자"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명(PR042)"},"retnCaus":{"type":"string","description":"반려사유"},"retnDt":{"type":"string","description":"반려일자"},"schPsbYn":{"type":"string","description":"검색가능여부"},"optnYn":{"type":"string","description":"옵션관리여부"},"optnCDYn":{"type":"string","description":"옵션 추가/삭제 여부"},"goodsNoArray":{"type":"array","description":"상품번호배열","items":{"type":"string"}},"szGdeUseYn":{"type":"string","description":"사이즈가이드 사용여부"},"szGdeRegMethodCd":{"type":"string","description":"사이즈가이드 등록방법 코드(PR023)"},"szGdeCd":{"type":"string","description":"사이즈가이드코드(PR024)"},"szGdeConts":{"type":"string","description":"사이즈가이드 내용"},"gftWthdYn":{"type":"string","description":"회수 여부"},"milgRsrvPsbYn":{"type":"string","description":"마일리지적립가능여부"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"ecpnAplyTermGbCd":{"type":"string","description":"e-쿠폰적용기간구분코드(MK015)"},"ecpnIssuDdStdUseDds":{"type":"integer","format":"int32","description":"e-쿠폰발급일기준사용일수"},"ecpnUsePsbStrDt":{"type":"string","format":"date","description":"e-쿠폰사용가능시작일자"},"ecpnUsePsbEndDt":{"type":"string","format":"date","description":"e-쿠폰사용가능종료일자"},"prGoodsContInfoList":{"type":"array","description":"상품컨텐츠정보 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"packageRelatedGoodsListGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestPrRelGoodsInfo","description":"묶음상품구성 RealGridCUD 정보"},"prDispGoodsInfoListGridCUD":{"$ref":"#/components/schemas/RealGridCUDRequestPrDispGoodsInfo","description":"전시카테고리 RealGridCUD 정보"},"prGoodsContInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 컨텐츠 정보"},"baseImageInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본이미지 정보"},"subImageInfoList":{"type":"array","description":"상품 추가 이미지 정보","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}},"baseVideoInfo":{"$ref":"#/components/schemas/PrGoodsContInfo","description":"상품 기본동영상 정보"},"deleteContsList":{"type":"array","description":"상품 컨텐츠(추가 이미지, 동영상) 삭제 목록","items":{"$ref":"#/components/schemas/PrGoodsContInfo"}}}},"PrGoodsContInfo":{"type":"object","description":"상품컨텐츠정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"contTypCd":{"type":"string","description":"컨텐츠유형코드(PR017) 01:상세설명, 02:동영상, 03:상품이미지"},"contSn":{"type":"string","description":"컨텐츠일련번호"},"goodsDtlDesc":{"type":"string","description":"상품상세설명"},"imgGbCd":{"type":"string","description":"이미지구분코드(PR031) P10:기본이미지, P20:추가이미지, M10:동영상"},"dispSeq":{"type":"integer","format":"int32","description":"전시순서"},"contFilePathNm":{"type":"string","description":"컨텐츠파일경로명"},"contFileNm":{"type":"string","description":"컨텐츠파일명"},"trnfTextCont":{"type":"string","description":"대체텍스트내용"},"useYn":{"type":"string","description":"사용여부"},"packageSubImageRegistDefaultValue":{"type":"integer","format":"int32","writeOnly":true}}},"RealGridCUDRequestPrRelGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrRelGoodsInfo"}}}},"PrRelGoodsInfo":{"type":"object","description":"관계상품정보","properties":{"baseGoodsNo":{"type":"string","description":"기준상품번호"},"tgtGoodsNo":{"type":"string","description":"대상상품번호"},"repYn":{"type":"string","description":"대표여부"},"sortSeq":{"type":"integer","format":"int32","description":"정렬순서"}}},"RealGridCUDRequestPrDispGoodsInfo":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/PrDispGoodsInfo"}}}},"PrDispGoodsInfo":{"type":"object","description":"전시카테고리기본_상품정보","properties":{"goodsNo":{"type":"string","description":"상품번호"},"dispCtgNo":{"type":"string","description":"전시카테고리번호"},"dispYn":{"type":"string","description":"전시여부"},"errorMessage":{"type":"string","description":"오류메시지","readOnly":true},"goodsList":{"type":"array","description":"상품번호 리스트","items":{"type":"string"}},"goodsArray":{"type":"array","description":"상품번호 배열","items":{"type":"string"}},"itemList":{"type":"array","description":"단품번호 리스트","items":{"type":"string"}},"itemArray":{"type":"array","description":"단품번호 배열","items":{"type":"string"}},"goodsNm":{"type":"string","description":"상품명","readOnly":true},"goodsTypCd":{"type":"string","description":"상품유형","readOnly":true},"norPrc":{"type":"number","description":"정상가","readOnly":true},"salePrc":{"type":"number","description":"판매가","readOnly":true},"saleStatCd":{"type":"string","description":"판매상태","readOnly":true},"entrNm":{"type":"string","description":"협력사명","readOnly":true},"goodsImg":{"type":"string","description":"상품이미지","readOnly":true},"moodTagVal":{"type":"string","description":"무드","readOnly":true},"wght":{"type":"string","description":"가중치","readOnly":true}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"ErrorCode":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"httpStatus":{"type":"integer","format":"int32"},"isProcess":{"type":"boolean"}}}}},"paths":{"/v2/goods/packageGoodsApi/packageGoodsRegist":{"post":{"tags":["묶음상품 등록"],"summary":"묶음상품 등록","description":"## 기능설명\n* 묶음상품 등록 API 입니다.\n---\n## 상품설명\n* 임시저장/승인요청에 따라 묶음상품을 등록합니다.\n* 승인요청 시에는 필수값을 모두 입력하지 않으면 오류를 반환합니다.\n---\n## 수정번호\n```Release v1.04_231120```: 묶음상품 구입자나이제한코드(buyrAgeLmtCd) 추가\n","operationId":"temporaryPackageGoodsRegist","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemporaryPackageGoodsCUDRequest"}}},"required":true},"responses":{"200":{"description":"묶음대상 등록 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"묶음대상 등록 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
````