상품 승인 관리

상품반려사유저장

post

기능설명

• 상품승인관리 페이지의 반려사유등록 팝업 내용을 저장하고, 상품을 반려합니다.

---

상세설명

• 판매상태가 승인대기인 상품만 반려가 가능합니다.

• 반려사유, 반려사유상세 내용을 저장하고, 상품의 판매상태를 승인대기에서 반려로 변경합니다.

• 상품기본 수정로그 테이블의 신규데이터를 생성합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoStringRequired

상품번호

retnCausCdStringRequired

반려사유코드

Body

application/json

상품승인관리 Request

goodsStartDtmstring · date-timeOptional

시작일시

goodsEndDtmstring · date-timeOptional

종료일시

saleStatCdstringOptional

판매상태코드(PR005)

goodsCompCdstringOptional

상품구성코드(PR001)

goodsTypCdstringOptional

상품유형코드(PR002)

saleMethCdstringOptional

판매방식코드(PR003)

buyTypCdstringOptional

매입형태코드(PR006)

frgnDirPurGoodsYnstringOptional

직구상품 여부

entrNostringOptional

협력사 번호

userIdstringOptional

담당 MD

goodsNostringOptional

상품번호

goodsNmstringOptional

상품명

stdCtgNostringOptional

표준카테고리

brandNostringOptional

브랜드

aprvRtrnIdstringOptional

승인/반려자 ID

goodsNoArraystring[]Optional

승인상품번호배열

retnCausstringOptional

반려사유

retnCausCdstringOptional

반려사유코드(PR042)

deliProcTypCdstringOptional

배송처리유형코드(PR008)

Responses

200

상품반려사유저장 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

상품반려사유저장 실패

*/*

post

/v1/goods/goodsApprovalMgmtApi/returnGoods

HTTPcURLJavaScriptPython

POST /api/bo/v1/goods/goodsApprovalMgmtApi/returnGoods?goodsNo=null&retnCausCd=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 417

{
  "goodsStartDtm": "2026-02-27T18:16:04.615Z",
  "goodsEndDtm": "2026-02-27T18:16:04.615Z",
  "saleStatCd": "text",
  "goodsCompCd": "text",
  "goodsTypCd": "text",
  "saleMethCd": "text",
  "buyTypCd": "text",
  "frgnDirPurGoodsYn": "text",
  "entrNo": "text",
  "userId": "text",
  "goodsNo": "text",
  "goodsNm": "text",
  "stdCtgNo": "text",
  "brandNo": "text",
  "aprvRtrnId": "text",
  "goodsNoArray": [
    "text"
  ],
  "retnCaus": "text",
  "retnCausCd": "text",
  "deliProcTypCd": "text"
}

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

상품승인

post

기능설명

• 상품승인관리 페이지에서 상품을 승인합니다.

---

상세설명

• 판매상태가 승인대기인 상품만 승인이 가능합니다.

• 상품과 상품에 해당하는 단품의 판매상태를 승인대기에서 판매중으로 변경합니다.

• 상품기본 수정로그, 상품기준 판매상태이력, 단품 추가 가격이력, 단품기본ML 테이블의 신규데이터를 생성합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

goodsNoArrayString[]Required

승인상품번호배열

Body

application/json

상품승인관리 Request

goodsStartDtmstring · date-timeOptional

시작일시

goodsEndDtmstring · date-timeOptional

종료일시

saleStatCdstringOptional

판매상태코드(PR005)

goodsCompCdstringOptional

상품구성코드(PR001)

goodsTypCdstringOptional

상품유형코드(PR002)

saleMethCdstringOptional

판매방식코드(PR003)

buyTypCdstringOptional

매입형태코드(PR006)

frgnDirPurGoodsYnstringOptional

직구상품 여부

entrNostringOptional

협력사 번호

userIdstringOptional

담당 MD

goodsNostringOptional

상품번호

goodsNmstringOptional

상품명

stdCtgNostringOptional

표준카테고리

brandNostringOptional

브랜드

aprvRtrnIdstringOptional

승인/반려자 ID

goodsNoArraystring[]Optional

승인상품번호배열

retnCausstringOptional

반려사유

retnCausCdstringOptional

반려사유코드(PR042)

deliProcTypCdstringOptional

배송처리유형코드(PR008)

Responses

200

상품승인 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

payloadstringOptional

payload

errorbooleanOptional

is error

900

상품승인 실패

*/*

post

/v1/goods/goodsApprovalMgmtApi/approveGoods

HTTPcURLJavaScriptPython

POST /api/bo/v1/goods/goodsApprovalMgmtApi/approveGoods?goodsNoArray=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 417

{
  "goodsStartDtm": "2026-02-27T18:16:04.615Z",
  "goodsEndDtm": "2026-02-27T18:16:04.615Z",
  "saleStatCd": "text",
  "goodsCompCd": "text",
  "goodsTypCd": "text",
  "saleMethCd": "text",
  "buyTypCd": "text",
  "frgnDirPurGoodsYn": "text",
  "entrNo": "text",
  "userId": "text",
  "goodsNo": "text",
  "goodsNm": "text",
  "stdCtgNo": "text",
  "brandNo": "text",
  "aprvRtrnId": "text",
  "goodsNoArray": [
    "text"
  ],
  "retnCaus": "text",
  "retnCausCd": "text",
  "deliProcTypCd": "text"
}

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

상품 승인 목록 조회

get

기능설명

• 상품승인관리 페이지에서 조건에 맞는 상품승인목록을 조회합니다.

---

상세설명

• 팬매상태가 승인대기/반려인 상품만 조회합니다.

• 입력한 승인요청일자, 승인상태, 상품구성, 상품유형, 판매방식, 매입형태, 협력사 번호/명, 담당 MD, 상품명, 상품번호에 맞는 상품을 조회합니다.

• 상품 등록일 역순으로 조회합니다.

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

상품 승인 목록 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품 승인 목록 조회 실패

*/*

get

/v1/goods/goodsApprovalMgmtApi/getGoodsApprovalList

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/goodsApprovalMgmtApi/getGoodsApprovalList?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T18:16:04.615Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totalCount": 1,
    "payloads": [
      {
        "saleStatCd": "text",
        "saleStatCdNm": "text",
        "goodsCompCd": "text",
        "goodsCompCdNm": "text",
        "goodsTypCd": "text",
        "goodsTypCdNm": "text",
        "saleMethCdNm": "text",
        "mdNm": "text",
        "goodsNo": "text",
        "goodsNm": "text",
        "modlNm": "text",
        "taxGbCdNm": "text",
        "buyTypCdNm": "text",
        "frgnDirPurGoodsYn": "text",
        "norPrc": 1,
        "salePrc": 1,
        "mrgnRate": 1,
        "entrNm": "text",
        "brandNm": "text",
        "deliProcTypCdNm": "text",
        "goodsRegDtm": "2026-02-27T18:16:04.615Z",
        "aprvDt": "text",
        "retnCaus": "text",
        "retnCausCd": "text",
        "retnCausCdNm": "text",
        "retnDt": "text",
        "stdCtgNo": "text",
        "stdCtgNm": "text",
        "supPcost": 1,
        "aprvReqDt": "text"
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}