# 상품 승인 관리
## 상품반려사유저장
> \## 기능설명\
> \* 상품승인관리 페이지의 반려사유등록 팝업 내용을 저장하고, 상품을 반려합니다.\
> \---\
> \## 상세설명\
> \* 판매상태가 승인대기인 상품만 반려가 가능합니다.\
> \* 반려사유, 반려사유상세 내용을 저장하고, 상품의 판매상태를 승인대기에서 반려로 변경합니다.\
> \* 상품기본 수정로그 테이블의 신규데이터를 생성합니다.
```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 테이블의 신규데이터를 생성합니다.
```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, 상품명, 상품번호에 맞는 상품을 조회합니다.\
> \* 상품 등록일 역순으로 조회합니다.
```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"}}}}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://tech.x2bee.com/api/back-office-api/goods-bo-api/undefined-19.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.