> 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/api-en/back-office-api-reference/goods-bo-api/product-approval-management.md).

# Product Approval Management

## Save Product Rejection Reason

> \## Function Description\
> \* Saves the content of the Rejection Reason Registration popup on the Product Approval Management page and rejects the product.\
> \---\
> \## Detailed Description\
> \* Only products with a sales status of "pending approval" can be rejected.\
> \* Saves the rejection reason and detailed rejection reason, and changes the product's sales status from "pending approval" to "rejected."\
> \* Generates a new record in the product basic modification log table.<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":"Product Approval Management Request","properties":{"goodsStartDtm":{"type":"string","format":"date-time","description":"Start Date/Time"},"goodsEndDtm":{"type":"string","format":"date-time","description":"End Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006)"},"frgnDirPurGoodsYn":{"type":"string","description":"Direct Purchase Product Status"},"entrNo":{"type":"string","description":"Vendor No."},"userId":{"type":"string","description":"Assigned MD"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand"},"aprvRtrnId":{"type":"string","description":"Approver/Rejecter ID"},"goodsNoArray":{"type":"array","description":"Approved Product No. Array","items":{"type":"string"}},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (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":["Product Approval Management"],"summary":"Save Product Rejection Reason","description":"## Function Description\n* Saves the content of the Rejection Reason Registration popup on the Product Approval Management page and rejects the product.\n---\n## Detailed Description\n* Only products with a sales status of \"pending approval\" can be rejected.\n* Saves the rejection reason and detailed rejection reason, and changes the product's sales status from \"pending approval\" to \"rejected.\"\n* Generates a new record in the product basic modification log table.\n","operationId":"returnGoods","parameters":[{"name":"goodsNo","in":"query","description":"Product No.","required":true,"schema":{"type":"String"}},{"name":"retnCausCd","in":"query","description":"Rejection Reason Code","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiRequest"}}},"required":true},"responses":{"200":{"description":"Save Product Rejection Reason Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Save Product Rejection Reason Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Approve Product

> \## Function Description\
> \* Approves a product on the Product Approval Management page.\
> \---\
> \## Detailed Description\
> \* Only products with a sales status of "pending approval" can be approved.\
> \* Changes the sales status of the product and its units from "pending approval" to "on sale."\
> \* Generates new records in the Product Basic Modification Log, Product Sales Status History, Unit Additional Price History, and Unit Basic ML tables.<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":"Product Approval Management Request","properties":{"goodsStartDtm":{"type":"string","format":"date-time","description":"Start Date/Time"},"goodsEndDtm":{"type":"string","format":"date-time","description":"End Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006)"},"frgnDirPurGoodsYn":{"type":"string","description":"Direct Purchase Product Status"},"entrNo":{"type":"string","description":"Vendor No."},"userId":{"type":"string","description":"Assigned MD"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand"},"aprvRtrnId":{"type":"string","description":"Approver/Rejecter ID"},"goodsNoArray":{"type":"array","description":"Approved Product No. Array","items":{"type":"string"}},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (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":["Product Approval Management"],"summary":"Approve Product","description":"## Function Description\n* Approves a product on the Product Approval Management page.\n---\n## Detailed Description\n* Only products with a sales status of \"pending approval\" can be approved.\n* Changes the sales status of the product and its units from \"pending approval\" to \"on sale.\"\n* Generates new records in the Product Basic Modification Log, Product Sales Status History, Unit Additional Price History, and Unit Basic ML tables.\n","operationId":"approveGoods","parameters":[{"name":"goodsNoArray","in":"query","description":"Approved Product No. Array","required":true,"schema":{"type":"String[]"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiRequest"}}},"required":true},"responses":{"200":{"description":"Approve Product Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Approve Product Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```

## Search Product Approval List

> \## Function Description\
> \* Searches the product approval list matching the conditions on the Product Approval Management page.\
> \---\
> \## Detailed Description\
> \* Searches only products with a sales status of "pending approval" or "rejected."\
> \* Searches products matching the entered approval request date, approval status, product composition, product type, sales method, purchase type, vendor number/name, assigned MD, product name, and product number.\
> \* Searched in reverse order of product registration date.<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":"Product Approval Management Request","properties":{"goodsStartDtm":{"type":"string","format":"date-time","description":"Start Date/Time"},"goodsEndDtm":{"type":"string","format":"date-time","description":"End Date/Time"},"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"saleMethCd":{"type":"string","description":"Sales Method Code (PR003)"},"buyTypCd":{"type":"string","description":"Purchase Type Code (PR006)"},"frgnDirPurGoodsYn":{"type":"string","description":"Direct Purchase Product Status"},"entrNo":{"type":"string","description":"Vendor No."},"userId":{"type":"string","description":"Assigned MD"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"stdCtgNo":{"type":"string","description":"Standard Category"},"brandNo":{"type":"string","description":"Brand"},"aprvRtrnId":{"type":"string","description":"Approver/Rejecter ID"},"goodsNoArray":{"type":"array","description":"Approved Product No. Array","items":{"type":"string"}},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"deliProcTypCd":{"type":"string","description":"Delivery Processing Type Code (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":"Product Approval Management Response","properties":{"saleStatCd":{"type":"string","description":"Sales Status Code (PR005)"},"saleStatCdNm":{"type":"string","description":"Sales Status Code Name"},"goodsCompCd":{"type":"string","description":"Product Composition Code (PR001)"},"goodsCompCdNm":{"type":"string","description":"Product Composition Code Name"},"goodsTypCd":{"type":"string","description":"Product Type Code (PR002)"},"goodsTypCdNm":{"type":"string","description":"Product Type Code Name"},"saleMethCdNm":{"type":"string","description":"Sales Method Code Name"},"mdNm":{"type":"string","description":"MD in Charge Name"},"goodsNo":{"type":"string","description":"Product No."},"goodsNm":{"type":"string","description":"Product Name"},"modlNm":{"type":"string","description":"Model Name"},"taxGbCdNm":{"type":"string","description":"Taxable/Tax-Exempt Type Code Name"},"buyTypCdNm":{"type":"string","description":"Purchase Type Code Name"},"frgnDirPurGoodsYn":{"type":"string","description":"Direct Purchase Product Status"},"norPrc":{"type":"number","description":"Regular Price"},"salePrc":{"type":"number","description":"Selling Price"},"mrgnRate":{"type":"number","description":"Margin Rate"},"entrNm":{"type":"string","description":"Vendor"},"brandNm":{"type":"string","description":"Brand Name"},"deliProcTypCdNm":{"type":"string","description":"Delivery Processing Type Code Name"},"goodsRegDtm":{"type":"string","format":"date-time","description":"Product Registration Date/Time"},"aprvDt":{"type":"string","description":"Product Approval Date"},"retnCaus":{"type":"string","description":"Rejection Reason"},"retnCausCd":{"type":"string","description":"Rejection Reason Code (PR042)"},"retnCausCdNm":{"type":"string","description":"Rejection Reason Code Name"},"retnDt":{"type":"string","description":"Rejection Date"},"stdCtgNo":{"type":"string","description":"Standard Category"},"stdCtgNm":{"type":"string","description":"Standard Category Name"},"supPcost":{"type":"number","description":"Supply Cost"},"aprvReqDt":{"type":"string","description":"Approval Request Date/Time"}}},"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":["Product Approval Management"],"summary":"Search Product Approval List","description":"## Function Description\n* Searches the product approval list matching the conditions on the Product Approval Management page.\n---\n## Detailed Description\n* Searches only products with a sales status of \"pending approval\" or \"rejected.\"\n* Searches products matching the entered approval request date, approval status, product composition, product type, sales method, purchase type, vendor number/name, assigned MD, product name, and product number.\n* Searched in reverse order of product registration date.\n","operationId":"getGoodsApprovalList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GoodsApprovalMgmtApiRequest"}}],"responses":{"200":{"description":"Search Product Approval List Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseRealGridListResponseGoodsApprovalMgmtApiResponse"}}}},"900":{"description":"Search Product Approval List Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ErrorCode"}}}}}}}}}
```