대시보드 상품

상품현황 조회

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

상품현황 조회 성공

*/*

대시보드 상품현황 Response

mdMatchedStdCtgCountinteger · int64Optional

900

상품현황 조회 실패

*/*

get

/v2/dashboard/goods/sale-stock-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/dashboard/goods/sale-stock-status?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "goodsStatuses": [
    {
      "saleStatCd": "text",
      "saleStatCdNm": "text",
      "cnt": 1
    }
  ],
  "mdMatchedStdCtgCount": 1
}

재입고 알림 신청 현황 조회

get

기능설명

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

---

상세설명

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

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

---

수정번호

• Release v2.00_240826 : 최초 생성getSystemNoticeInfoListByToday

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

entrNoStringOptional

협력사번호

siteNoStringRequired

사이트번호

userIdStringRequired

사용자ID

Responses

200

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

*/*

대시보드 재입고 알림 신청 현황 Response

totCntinteger · int64Optional

대시보드 재입고 알림 신청 현황 건수

900

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

*/*

get

/v2/dashboard/goods/restock-notice-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/dashboard/goods/restock-notice-status?request=[object+Object]&siteNo=null&userId=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totCnt": 1,
  "list": [
    {
      "goodsNo": "text",
      "goodsNm": "text",
      "cnt": 1
    }
  ]
}

상품문의 현황 조회

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

상품문의 현황 조회 성공

*/*

대시보드 상품현황 Response

stdCtgNoCntByUserIdinteger · int32Optional

user의 담당 카테고리 수

totalCntinteger · int32Optional

총 갯수

900

상품문의 현황 조회 실패

*/*

get

/v2/dashboard/goods/qna-answer-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/dashboard/goods/qna-answer-status?request=[object+Object]&procStatCd=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "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
    }
  ]
}

상품평 현황 조회

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

/v2/dashboard/goods/goods-review-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/dashboard/goods/goods-review-status?request=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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