상품 통계

상품분석 판매현황 목록 조회

get

기능설명

• 상품 판매 현황을 조회하는 기능 입니다.

• 페이징 없이 TOP-N 개 조회합니다.

---

상세설명

• [BO] 통계 > 상품분석 > 판매 현황 페이지에서 조회 버튼 클릭시 호출됩니다.

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

Responses

200

주문 현황 목록 조회 성공

*/*

상품분석 DTO

imgPathstringOptional

이미지경로

goodsNostringOptional

상품번호

Example: 10000001

goodsNmstringOptional

상품명

Example: 플래티어단품

siteNostringOptional

사이트번호

Example: 1

siteNmstringOptional

사이트명

Example: x2bee

stdCtgNostringOptional

표준카테고리번호

Example: EX00000000

stdCtgNmstringOptional

표준카테고리명

Example: 스마트기기>스마트액세서리>스마트액세서리

mdIdstringOptional

담당MD

mdNmstringOptional

담당MD명

entrNostringOptional

협력사번호

Example: 1000001

entrNmstringOptional

협력사명

Example: 플래티어 협력사

brandNmstringOptional

브랜드명

Example: 플래티어

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

infCntinteger · int32Optional

유입건수

Example: 100

stkQtyinteger · int32Optional

재고수량

Example: 100

cvrnumber · floatOptional

구매전환율

Example: 10

cnclRtnQtyinteger · int32Optional

취/반품수량

Example: 100

rtnRatenumber · floatOptional

반품율

Example: 10

900

업무처리 오류 내용

*/*

get

/v2/statistics/goods/sales-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/statistics/goods/sales-status?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "imgPath": "text",
    "goodsNo": 10000001,
    "goodsNm": "플래티어단품",
    "siteNo": 1,
    "siteNm": "x2bee",
    "stdCtgNo": "EX00000000",
    "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
    "mdId": "text",
    "mdNm": "text",
    "entrNo": 1000001,
    "entrNm": "플래티어 협력사",
    "brandNm": "플래티어",
    "ordAmt": 1000,
    "cnclAmt": 100,
    "ordQty": 1,
    "cnclQty": 0,
    "infCnt": 100,
    "stkQty": 100,
    "cvr": 10,
    "cnclRtnQty": 100,
    "rtnRate": 10
  }
]

상품분석 상품상세 유입정보 목록 조회

get

기능설명

• 상품상세 유입정보 목록을 조회하는 기능 입니다.

• 페이징 없이 TOP-N 개 조회합니다.

---

상세설명

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

Responses

200

주문 현황 목록 조회 성공

*/*

상품분석 DTO

imgPathstringOptional

이미지경로

goodsNostringOptional

상품번호

Example: 10000001

goodsNmstringOptional

상품명

Example: 플래티어단품

siteNostringOptional

사이트번호

Example: 1

siteNmstringOptional

사이트명

Example: x2bee

stdCtgNostringOptional

표준카테고리번호

Example: EX00000000

stdCtgNmstringOptional

표준카테고리명

Example: 스마트기기>스마트액세서리>스마트액세서리

mdIdstringOptional

담당MD

mdNmstringOptional

담당MD명

entrNostringOptional

협력사번호

Example: 1000001

entrNmstringOptional

협력사명

Example: 플래티어 협력사

brandNmstringOptional

브랜드명

Example: 플래티어

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

infCntinteger · int32Optional

유입건수

Example: 100

stkQtyinteger · int32Optional

재고수량

Example: 100

cvrnumber · floatOptional

구매전환율

Example: 10

cnclRtnQtyinteger · int32Optional

취/반품수량

Example: 100

rtnRatenumber · floatOptional

반품율

Example: 10

900

업무처리 오류 내용

*/*

get

/v2/statistics/goods/inflow-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/statistics/goods/inflow-status?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "imgPath": "text",
    "goodsNo": 10000001,
    "goodsNm": "플래티어단품",
    "siteNo": 1,
    "siteNm": "x2bee",
    "stdCtgNo": "EX00000000",
    "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
    "mdId": "text",
    "mdNm": "text",
    "entrNo": 1000001,
    "entrNm": "플래티어 협력사",
    "brandNm": "플래티어",
    "ordAmt": 1000,
    "cnclAmt": 100,
    "ordQty": 1,
    "cnclQty": 0,
    "infCnt": 100,
    "stkQty": 100,
    "cvr": 10,
    "cnclRtnQty": 100,
    "rtnRate": 10
  }
]

상품분석 취소/반품 목록 조회

get

기능설명

• 취소/반품 현황 목록을 조회하는 기능 입니다.

• 페이징 없이 TOP-N 개 조회합니다.

---

상세설명

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

Responses

200

주문 현황 목록 조회 성공

*/*

상품분석 DTO

imgPathstringOptional

이미지경로

goodsNostringOptional

상품번호

Example: 10000001

goodsNmstringOptional

상품명

Example: 플래티어단품

siteNostringOptional

사이트번호

Example: 1

siteNmstringOptional

사이트명

Example: x2bee

stdCtgNostringOptional

표준카테고리번호

Example: EX00000000

stdCtgNmstringOptional

표준카테고리명

Example: 스마트기기>스마트액세서리>스마트액세서리

mdIdstringOptional

담당MD

mdNmstringOptional

담당MD명

entrNostringOptional

협력사번호

Example: 1000001

entrNmstringOptional

협력사명

Example: 플래티어 협력사

brandNmstringOptional

브랜드명

Example: 플래티어

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

infCntinteger · int32Optional

유입건수

Example: 100

stkQtyinteger · int32Optional

재고수량

Example: 100

cvrnumber · floatOptional

구매전환율

Example: 10

cnclRtnQtyinteger · int32Optional

취/반품수량

Example: 100

rtnRatenumber · floatOptional

반품율

Example: 10

900

업무처리 오류 내용

*/*

get

/v2/statistics/goods/cancel-return-status

HTTPcURLJavaScriptPython

GET /api/bo/v2/statistics/goods/cancel-return-status?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "imgPath": "text",
    "goodsNo": 10000001,
    "goodsNm": "플래티어단품",
    "siteNo": 1,
    "siteNm": "x2bee",
    "stdCtgNo": "EX00000000",
    "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
    "mdId": "text",
    "mdNm": "text",
    "entrNo": 1000001,
    "entrNm": "플래티어 협력사",
    "brandNm": "플래티어",
    "ordAmt": 1000,
    "cnclAmt": 100,
    "ordQty": 1,
    "cnclQty": 0,
    "infCnt": 100,
    "stkQty": 100,
    "cvr": 10,
    "cnclRtnQty": 100,
    "rtnRate": 10
  }
]

상품분석 판매현황 목록 조회

get

기능설명

• 상품 판매 현황을 조회하는 기능 입니다.

---

상세설명

• [BO] 통계 > 상품분석 > 판매 현황 페이지에서 조회 버튼 클릭시 호출됩니다.

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

Responses

200

주문 현황 목록 조회 성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsAnalysis/getGoodsSalesStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsAnalysis/getGoodsSalesStatusList?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "imgPath": "text",
      "goodsNo": 10000001,
      "goodsNm": "플래티어단품",
      "siteNo": 1,
      "siteNm": "x2bee",
      "stdCtgNo": "EX00000000",
      "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
      "mdId": "text",
      "mdNm": "text",
      "entrNo": 1000001,
      "entrNm": "플래티어 협력사",
      "brandNm": "플래티어",
      "ordAmt": 1000,
      "cnclAmt": 100,
      "ordQty": 1,
      "cnclQty": 0,
      "infCnt": 100,
      "stkQty": 100,
      "cvr": 10,
      "cnclRtnQty": 100,
      "rtnRate": 10
    }
  ]
}

상품분석 상품상세 유입정보 목록 조회

get

기능설명

• 상품상세 유입정보 목록을 조회하는 기능 입니다.

---

상세설명

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

Responses

200

주문 현황 목록 조회 성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsAnalysis/getGoodsInfStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsAnalysis/getGoodsInfStatusList?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "imgPath": "text",
      "goodsNo": 10000001,
      "goodsNm": "플래티어단품",
      "siteNo": 1,
      "siteNm": "x2bee",
      "stdCtgNo": "EX00000000",
      "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
      "mdId": "text",
      "mdNm": "text",
      "entrNo": 1000001,
      "entrNm": "플래티어 협력사",
      "brandNm": "플래티어",
      "ordAmt": 1000,
      "cnclAmt": 100,
      "ordQty": 1,
      "cnclQty": 0,
      "infCnt": 100,
      "stkQty": 100,
      "cvr": 10,
      "cnclRtnQty": 100,
      "rtnRate": 10
    }
  ]
}

상품분석 취소/반품 목록 조회

get

기능설명

• 취소/반품 현황 목록을 조회하는 기능 입니다.

---

상세설명

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

Responses

200

주문 현황 목록 조회 성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsAnalysis/getGoodsCnclRtnStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsAnalysis/getGoodsCnclRtnStatusList?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "imgPath": "text",
      "goodsNo": 10000001,
      "goodsNm": "플래티어단품",
      "siteNo": 1,
      "siteNm": "x2bee",
      "stdCtgNo": "EX00000000",
      "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
      "mdId": "text",
      "mdNm": "text",
      "entrNo": 1000001,
      "entrNm": "플래티어 협력사",
      "brandNm": "플래티어",
      "ordAmt": 1000,
      "cnclAmt": 100,
      "ordQty": 1,
      "cnclQty": 0,
      "infCnt": 100,
      "stkQty": 100,
      "cvr": 10,
      "cnclRtnQty": 100,
      "rtnRate": 10
    }
  ]
}

상품분석 공통 목록 조회

get

기능설명

• 상품분석 목록을 조회하는 기능 입니다.

---

상세설명

• **집계구분코드, 조회기간(시작일자, 종료일자)**는 필수 조회 조건입니다.

• 표준분류번호, 담당MD, 상품번호, 협력사번호, 브랜드번호, 사이트번호는 선택 조회 조건입니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

agrtGbStringRequired

집계구분

Responses

200

주문 현황 목록 조회 성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsAnalysis/getGoodsAnalysisList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsAnalysis/getGoodsAnalysisList?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null&agrtGb=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "imgPath": "text",
      "goodsNo": 10000001,
      "goodsNm": "플래티어단품",
      "siteNo": 1,
      "siteNm": "x2bee",
      "stdCtgNo": "EX00000000",
      "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
      "mdId": "text",
      "mdNm": "text",
      "entrNo": 1000001,
      "entrNm": "플래티어 협력사",
      "brandNm": "플래티어",
      "ordAmt": 1000,
      "cnclAmt": 100,
      "ordQty": 1,
      "cnclQty": 0,
      "infCnt": 100,
      "stkQty": 100,
      "cvr": 10,
      "cnclRtnQty": 100,
      "rtnRate": 10
    }
  ]
}

상품분석 판매현황 그리드 엑셀 일괄 다운로드

get

기능설명

• 상품 판매 현황을 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.

---

상세설명

• 노출 항목은 그리드 목록과 동일 합니다.

• 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

fileNameStringRequired

파일명

Responses

200

주문 현황 목록 조회 성공

No content

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsAnalysis/downloadGoodsSalesStatusExcel

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsAnalysis/downloadGoodsSalesStatusExcel?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null&fileName=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

상품분석 취소/반품 그리드 엑셀 일괄 다운로드

get

기능설명

• 상품 취소/반품 현황을 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.

---

상세설명

• 노출 항목은 그리드 목록과 동일 합니다.

• 페이징 처리 없이, 검색 조건에 해당하는 모든 데이터를 조회합니다.

---

수정 번호

• Release v2.00_240827: 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

siteNoStringOptional

사이트번호

fileNameStringOptional

파일명

Responses

200

주문 현황 목록 조회 성공

No content

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsAnalysis/downloadGoodsCnclRtnStatusExcel

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsAnalysis/downloadGoodsCnclRtnStatusExcel?goodsAnalysisRequest=[object+Object]&startDate=null&endDate=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content