상품 대시보드

재입고 알림 신청 현황 조회

get

기능설명

• 대시보드에 노출될 재입고 알림 신청 현황 조회합니다.

---

상세설명

• 로그인한 사용자의 협력사 값이 있는 경우 해당 협력사의 재입고 알림 신청 현황이 조회됩니다.

• 최근 30일 기준 재입고 알림 최다 신청 순으로 5건 조회합니다.

---

수정번호

• Release v2.00_240826 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringOptional

협력사번호

siteNoStringRequired

사이트번호

userIdStringRequired

사용자ID

Responses

200

재입고 알림 신청 현황 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

재입고 알림 신청 현황 조회 실패

*/*

get

/v1/goods/dashboardApi/getReWhsgNotiSgtStatus

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/dashboardApi/getReWhsgNotiSgtStatus?request=[object+Object]&siteNo=null&userId=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "totCnt": 1,
    "list": [
      {
        "goodsNo": "text",
        "goodsNm": "text",
        "cnt": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품문의 현황 조회

get

기능설명

• 대시보드에 노출될 상품문의 현황을 조회합니다.

---

상세설명

• 로그인한 사용자의 협력사 값이 있는 경우 해당 협력사의 상품들만 조회됩니다.

• procStatCd: 이관처리상태코드(PR039)가 있는 경우 해당코드에 해당하는 문의 목록을 조회합니다.

• 최신 등록일 순으로 상위 5건의 문의 목록과 총 문의 건수를 조회합니다.

수정번호

• Release v2.00_240827 : 사용자의 업무그룹이 'BO_MD'이면서 맵핑된 표준카테고리가 있는경우, 해당 카테고리 상품만을 대상으로 조회

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

procStatCdstring[]Required

entrNoStringOptional

협력사번호

Responses

200

상품문의 현황 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품문의 현황 조회 실패

*/*

get

/v1/goods/dashboardApi/getQnASicuations

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/dashboardApi/getQnASicuations?request=[object+Object]&procStatCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": {
    "stdCtgNoCntByUserId": 1,
    "totalCnt": 1,
    "list": [
      {
        "questNo": 1,
        "siteNo": 1,
        "mbrNo": 1,
        "goodsNo": 100000001,
        "entrNo": 1,
        "questTypCd": 10,
        "questTitle": "상품문의",
        "questCont": "상품문의",
        "questDtm": "2021-01-01 00:00:00",
        "procStatCd": 10,
        "procStatDtm": "2021-01-01 00:00:00",
        "questTypCdNm": "text",
        "procStatCdNm": "text",
        "totalCnt": 1
      }
    ]
  },
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품요약 정보 조회

get

기능설명

• 대시보드에 노출될 상품요약 정보를 조회합니다.

---

상세설명

• 로그인한 사용자의 협력사 값이 있는 경우 해당 협력사의 상품들만 조회됩니다.

• 각 구분값(주문, 찜, 장바구니)에 대하여 가장 많은 이벤트가 발생한 상품을 조회합니다.

• 최근 7일 이내의 상품으로 조회합니다.

---

코드정리

• 구분값(gbValue) : ORDER 주문, WISH 찜, CART 장바구니

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringOptional

협력사번호

Responses

200

상품요약 정보 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품요약 정보 조회 실패

*/*

get

/v1/goods/dashboardApi/getGoodsSummary

HTTPcURLJavaScriptPython

GET /api/bo/v1/goods/dashboardApi/getGoodsSummary HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "gbValue": "text",
      "goodsNm": "text",
      "goodsNo": "text"
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}

상품평 현황 조회

get

기능설명

• 대시보드에 노출될 상품평 현황 정보를 조회 합니다.

---

상세설명

• 최근 7일간 작성된 리뷰를 대상 으로, '신규 상품평(10), '평점 높은 상품평(20)', '평점 낮은 상품평(30)' 갯수를 집계합니다.

• 사용자의 업무그룹이 'BO_MD'이면서 맵핑된 표준카테고리가 있는경우, 해당 카테고리 상품만을 대상으로 집계합니다.

• 사이트별로 상품을 필터링 합니다.

• '평점 높은 상품평'의 집계 기준은 별점이 4개(혹은 4점) 이상인 경우에 한해 조회합니다.

• '평점 낮은 상품평'의 집계 기준은 별점이 2개(혹은 2점) 이하인 경우에 한해 조회합니다.

• 삭제 여부가 'Y'이거나, 리뷰전시상태코드(PR022)값이 전시처리(20) 상태가 아닌 경우, 대상에서 제외합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

userIdStringOptional

사용자ID

siteNoStringOptional

사이트번호

Responses

200

상품평 현황 조회 성공

*/*

상품평 현황 응답 DTO

revStateCdstring · enumOptional

리뷰 상태 코드

Example: 10Possible values:

revStatestring · enumOptional

리뷰 싱테

Example: 신규 상품평Possible values:

revCntinteger · int64Optional

리뷰 건수

Example: 3

900

상품평 현황 조회 실패

*/*

get

/v1/goods/dashboardApi/getGoodsReviewSituations

HTTPcURLJavaScriptPython

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

[
  {
    "revStateCd": 10,
    "revState": "신규 상품평",
    "revCnt": 3
  }
]

상품현황 조회

get

기능설명

• 대시보드에 노출될 상품현황을 조회합니다.

---

상세설명

• 로그인한 사용자의 협력사 값이 있는 경우 해당 협력사의 상품들만 조회됩니다.

• 재고관리하는 상품의 경우 안전재고수량보다 재고가 적은 상품의 상품상태는 재고부족으로 조회됩니다.

---

코드정리

• 상품상태(saleStatCd) : 00 재고부족, 02 승인대기, 03 반려, 10 판매중, 20 품절

---

수정번호

• Release v2.00_240827 : 재고부족 -> 안전재고 이하, 파라메터 변경(String -> Request DTO) 사용자의 업무그룹이 'BO_MD'이면서 맵핑된 표준카테고리가 있는경우, 해당 카테고리 상품만을 대상으로 조회

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringOptional

협력사번호

userIdStringOptional

사용자ID

Responses

200

상품현황 조회 성공

*/*

timestampstring · date-timeOptional

result time

codestringOptional

result code

messagestringOptional

result message

isProcessbooleanOptional

process check

errorbooleanOptional

is error

900

상품현황 조회 실패

*/*

get

/v1/goods/dashboardApi/getGoodsCurrentSicuations

HTTPcURLJavaScriptPython

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

{
  "timestamp": "2026-02-27T20:07:44.431Z",
  "code": "text",
  "message": "text",
  "isProcess": true,
  "payload": [
    {
      "saleStatCd": "text",
      "saleStatCdNm": "text",
      "cnt": 1
    }
  ],
  "error": true,
  "errors": [
    {
      "field": "text",
      "message": "text"
    }
  ]
}