> 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-19.md).

# 상품 승인 관리

## 상품반려사유저장

> \## 기능설명\
> \* 상품승인관리 페이지의 반려사유등록 팝업 내용을 저장하고, 상품을 반려합니다.\
> \---\
> \## 상세설명\
> \* 판매상태가 승인대기인 상품만 반려가 가능합니다.\
> \* 반려사유, 반려사유상세 내용을 저장하고, 상품의 판매상태를 승인대기에서 반려로 변경합니다.\
> \* 상품기본 수정로그 테이블의 신규데이터를 생성합니다.<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":{"GoodsApprovalMgmtApiRequest":{"type":"object","description":"상품승인관리 Request","properties":{"goodsStartDtm":{"type":"string","format":"date-time","description":"시작일시"},"goodsEndDtm":{"type":"string","format":"date-time","description":"종료일시"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"buyTypCd":{"type":"string","description":"매입형태코드(PR006)"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품 여부"},"entrNo":{"type":"string","description":"협력사 번호"},"userId":{"type":"string","description":"담당 MD"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드"},"aprvRtrnId":{"type":"string","description":"승인/반려자 ID"},"goodsNoArray":{"type":"array","description":"승인상품번호배열","items":{"type":"string"}},"retnCaus":{"type":"string","description":"반려사유"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"}}},"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":{"/v1/goods/goodsApprovalMgmtApi/returnGoods":{"post":{"tags":["상품 승인 관리"],"summary":"상품반려사유저장","description":"## 기능설명\n* 상품승인관리 페이지의 반려사유등록 팝업 내용을 저장하고, 상품을 반려합니다.\n---\n## 상세설명\n* 판매상태가 승인대기인 상품만 반려가 가능합니다.\n* 반려사유, 반려사유상세 내용을 저장하고, 상품의 판매상태를 승인대기에서 반려로 변경합니다.\n* 상품기본 수정로그 테이블의 신규데이터를 생성합니다.\n","operationId":"returnGoods","parameters":[{"name":"goodsNo","in":"query","description":"상품번호","required":true,"schema":{"type":"String"}},{"name":"retnCausCd","in":"query","description":"반려사유코드","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiRequest"}}},"required":true},"responses":{"200":{"description":"상품반려사유저장 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"상품반려사유저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 상품승인

> \## 기능설명\
> \* 상품승인관리 페이지에서 상품을 승인합니다.\
> \---\
> \## 상세설명\
> \* 판매상태가 승인대기인 상품만 승인이 가능합니다.\
> \* 상품과 상품에 해당하는 단품의 판매상태를 승인대기에서 판매중으로 변경합니다.\
> \* 상품기본 수정로그, 상품기준 판매상태이력, 단품 추가 가격이력, 단품기본ML 테이블의 신규데이터를 생성합니다.<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":{"GoodsApprovalMgmtApiRequest":{"type":"object","description":"상품승인관리 Request","properties":{"goodsStartDtm":{"type":"string","format":"date-time","description":"시작일시"},"goodsEndDtm":{"type":"string","format":"date-time","description":"종료일시"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"buyTypCd":{"type":"string","description":"매입형태코드(PR006)"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품 여부"},"entrNo":{"type":"string","description":"협력사 번호"},"userId":{"type":"string","description":"담당 MD"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드"},"aprvRtrnId":{"type":"string","description":"승인/반려자 ID"},"goodsNoArray":{"type":"array","description":"승인상품번호배열","items":{"type":"string"}},"retnCaus":{"type":"string","description":"반려사유"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"}}},"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":{"/v1/goods/goodsApprovalMgmtApi/approveGoods":{"post":{"tags":["상품 승인 관리"],"summary":"상품승인","description":"## 기능설명\n* 상품승인관리 페이지에서 상품을 승인합니다.\n---\n## 상세설명\n* 판매상태가 승인대기인 상품만 승인이 가능합니다.\n* 상품과 상품에 해당하는 단품의 판매상태를 승인대기에서 판매중으로 변경합니다.\n* 상품기본 수정로그, 상품기준 판매상태이력, 단품 추가 가격이력, 단품기본ML 테이블의 신규데이터를 생성합니다.\n","operationId":"approveGoods","parameters":[{"name":"goodsNoArray","in":"query","description":"승인상품번호배열","required":true,"schema":{"type":"String[]"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiRequest"}}},"required":true},"responses":{"200":{"description":"상품승인 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"상품승인 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## 상품 승인 목록 조회

> \## 기능설명\
> \* 상품승인관리 페이지에서 조건에 맞는 상품승인목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 팬매상태가 승인대기/반려인 상품만 조회합니다.\
> \* 입력한 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사 번호/명, 담당 MD, 상품명, 상품번호에 맞는 상품을 조회합니다.\
> \* 상품 등록일 역순으로 조회합니다.<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":{"GoodsApprovalMgmtApiRequest":{"type":"object","description":"상품승인관리 Request","properties":{"goodsStartDtm":{"type":"string","format":"date-time","description":"시작일시"},"goodsEndDtm":{"type":"string","format":"date-time","description":"종료일시"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"buyTypCd":{"type":"string","description":"매입형태코드(PR006)"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품 여부"},"entrNo":{"type":"string","description":"협력사 번호"},"userId":{"type":"string","description":"담당 MD"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"brandNo":{"type":"string","description":"브랜드"},"aprvRtrnId":{"type":"string","description":"승인/반려자 ID"},"goodsNoArray":{"type":"array","description":"승인상품번호배열","items":{"type":"string"}},"retnCaus":{"type":"string","description":"반려사유"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"deliProcTypCd":{"type":"string","description":"배송처리유형코드(PR008)"}}},"ResponseRealGridListResponseGoodsApprovalMgmtApiResponse":{"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":{"$ref":"#/components/schemas/RealGridListResponseGoodsApprovalMgmtApiResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"RealGridListResponseGoodsApprovalMgmtApiResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiResponse"}}}},"GoodsApprovalMgmtApiResponse":{"type":"object","description":"상품 승인 관리 Response","properties":{"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"saleStatCdNm":{"type":"string","description":"판매상태코드명"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsCompCdNm":{"type":"string","description":"상품구성코드명"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"goodsTypCdNm":{"type":"string","description":"상품유형코드명"},"saleMethCdNm":{"type":"string","description":"판매방식코드명"},"mdNm":{"type":"string","description":"담당MD명"},"goodsNo":{"type":"string","description":"상품번호"},"goodsNm":{"type":"string","description":"상품명"},"modlNm":{"type":"string","description":"모델명"},"taxGbCdNm":{"type":"string","description":"과/면세구분코드명"},"buyTypCdNm":{"type":"string","description":"매입형태코드명"},"frgnDirPurGoodsYn":{"type":"string","description":"직구상품 여부"},"norPrc":{"type":"number","description":"정상가"},"salePrc":{"type":"number","description":"판매가"},"mrgnRate":{"type":"number","description":"마진율"},"entrNm":{"type":"string","description":"협력사"},"brandNm":{"type":"string","description":"브랜드명"},"deliProcTypCdNm":{"type":"string","description":"배송처리유형코드명"},"goodsRegDtm":{"type":"string","format":"date-time","description":"상품등록일시"},"aprvDt":{"type":"string","description":"상품승인일자"},"retnCaus":{"type":"string","description":"반려사유"},"retnCausCd":{"type":"string","description":"반려사유코드(PR042)"},"retnCausCdNm":{"type":"string","description":"반려사유코드명"},"retnDt":{"type":"string","description":"반려일자"},"stdCtgNo":{"type":"string","description":"표준카테고리"},"stdCtgNm":{"type":"string","description":"표준카테고리명"},"supPcost":{"type":"number","description":"공급원가"},"aprvReqDt":{"type":"string","description":"승인요청일시"}}},"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":{"/v1/goods/goodsApprovalMgmtApi/getGoodsApprovalList":{"get":{"tags":["상품 승인 관리"],"summary":"상품 승인 목록 조회","description":"## 기능설명\n* 상품승인관리 페이지에서 조건에 맞는 상품승인목록을 조회합니다.\n---\n## 상세설명\n* 팬매상태가 승인대기/반려인 상품만 조회합니다.\n* 입력한 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사 번호/명, 담당 MD, 상품명, 상품번호에 맞는 상품을 조회합니다.\n* 상품 등록일 역순으로 조회합니다.\n","operationId":"getGoodsApprovalList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiRequest"}}],"responses":{"200":{"description":"상품 승인 목록 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseGoodsApprovalMgmtApiResponse"}}}},"900":{"description":"상품 승인 목록 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```