주문 분석

주문(매출) 현황 기간 대비

post

기능설명

• 주문(매출) 현황 기간 대비 데이터를 조회합니다.

---

상세설명

• 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지 상단의 그래프에서 조회 버튼 클릭 시 호출됩니다.

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

• calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.

• 2개의 조회결과가 막대 그래프의 형태로 나타납니다.

  • 조회기간 기준 동안의 데이터 (주문 현황: 순주문금액 / 매출 현황: 순매출금액)

  • 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문금액 / 매출 현황: 기간대비 순매출금액)

• 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.

  • 조회기간 기준 동안의 데이터 (주문 수량: 순주문수량 / 매출 수량: 순매출수량)

  • 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문수량 / 매출 현황: 기간대비 순매출수량)

---

수정번호

• Release v2.00_240827: 기간별 주문(매출) 현황 조회 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

기간별 주문/매출 현황 DTO

siteNostringOptional

사이트번호

Example: 1

calendarTypestringOptional

일간 or 월간

Example: date

startMonthstringOptional

조회기간(시작월)

Example: 2099-01

endMonthstringOptional

조회기간(종료월)

Example: 2099-01

startDatestring · dateOptional

조회기간(시작일)

Example: 2099-01-01

endDatestring · dateOptional

조회기간(종료일)

Example: 2099-01-31

stdCtgNostringOptional

표준카테고리번호

Example: 1000001

mdIdstringOptional

담당MD

Example: tester

entrNostringOptional

협력사번호

Example: 1000001

brandNostringOptional

브랜드번호

Example: 100001

goodsNostringOptional

상품번호

Example: 10002552

agrtGbstringOptional

집계구분

Example: 01

Responses

200

기간 대비 데이터 조회 성공

*/*

주문 현황/매출 현황 DTO

agrtDtstringOptional

조회일자

Example: 20990101

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: 플래티어

dcAmt2ndnumberOptional

2차할인금액

Example: 100

dcAmt3rdnumberOptional

3차할인금액

Example: 100

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

finalOrdAmtinteger · int64Optional

순주문 금액

Example: 900

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

finalOrdQtyinteger · int32Optional

순주문 수량

Example: 1

infCntinteger · int32Optional

유입건수

Example: 100

realOrdQtyinteger · int32Optional

순주문 수량

Example: 1

realOrdAmtinteger · int64Optional

순주문 금액

Example: 900

dcAmtnumberOptional

할인금액

Example: 100

currRealOrdAmtinteger · int64Optional

현재순주문금액

900

업무처리 오류 내용

*/*

post

/v1/statistics/periodBasedStatus/getPeriodBasedStatusGraphData

HTTPcURLJavaScriptPython

POST /api/bo/v1/statistics/periodBasedStatus/getPeriodBasedStatusGraphData HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 228

{
  "siteNo": 1,
  "calendarType": "date",
  "startMonth": "2099-01",
  "endMonth": "2099-01",
  "startDate": "2099-01-01",
  "endDate": "2099-01-31",
  "stdCtgNo": 1000001,
  "mdId": "tester",
  "entrNo": 1000001,
  "brandNo": 100001,
  "goodsNo": 10002552,
  "agrtGb": "01"
}

{
  "agrtDt": 20990101,
  "imgPath": "text",
  "goodsNo": 10000001,
  "goodsNm": "플래티어단품",
  "siteNo": 1,
  "siteNm": "x2bee",
  "stdCtgNo": "EX00000000",
  "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
  "mdId": "text",
  "mdNm": "text",
  "entrNo": 1000001,
  "entrNm": "플래티어 협력사",
  "brandNm": "플래티어",
  "dcAmt2nd": 100,
  "dcAmt3rd": 100,
  "ordAmt": 1000,
  "cnclAmt": 100,
  "finalOrdAmt": 900,
  "ordQty": 1,
  "cnclQty": 0,
  "finalOrdQty": 1,
  "infCnt": 100,
  "compareDataList": [
    {
      "agrtDt": 20230912,
      "realOrdAmt": 20000,
      "pwRealOrdAmt": 50000,
      "realOrdQty": 100,
      "pwRealOrdQty": 100
    }
  ],
  "realOrdQty": 1,
  "realOrdAmt": 900,
  "dcAmt": 100,
  "currRealOrdAmt": 1
}

시간대별 주문(매출) 현황 그래프 데이터 조회

post

기능 설명

• 시간대별 주문(매출) 현황 그래프 데이터를 조회합니다.

---

상세 설명

• 조회일자와 집계구분코드값은 필수 조건입니다.

• 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.

• 조회일자 기준 하루동안 발생한 주문 현황 목록을 조회합니다.

• 검색 조건이 있는 경우, 해당 값으로 목록을 필터링 합니다.

• 검색 일자에 발생한 주문 목록에 대해 시간대별 순 주문금액, 주문수량을 조회합니다.

• 검색 일자에 발생한 주문 목록에 대해 총 순 주문금액, 주문수량을 조회합니다.

• 검색 일자 -1일에 발생한 주문 목록에 대해 시간대별 기간대비 순 주문금액, 주문수량을 조회합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

시간대 별 주문/매출 현황 Request DTO

siteNostringOptional

사이트번호

Example: 1

targetDatestring · dateOptional

조회일자

Example: 2099-01-01

stdCtgNostringOptional

표준카테고리번호

Example: 1000001

mdIdstringOptional

담당MD

Example: tester

entrNostringOptional

협력사번호

Example: 1000001

brandNostringOptional

브랜드번호

Example: 100001

goodsNostringOptional

상품번호

Example: 10002552

agrtGbstringOptional

집계구분

Example: 01

Responses

200

성공

*/*

시간대 별 주문/매출 현황 Response DTO

siteNostringOptional

사이트번호

Example: 1

agrtDtstringOptional

조회시간

Example: 00시 ~ 01시

imgPathstringOptional

대표이미지

goodsNostringOptional

상품번호

Example: 10000001

goodsNmstringOptional

상품명

Example: 플래티어단품

siteNmstringOptional

사이트명

Example: x2bee

stdCtgNostringOptional

표준카테고리번호

Example: EX00000000

stdCtgNmstringOptional

표준카테고리명

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

mdIdstringOptional

담당MD

mdNmstringOptional

담당MD명

entrNostringOptional

협력사번호

Example: 1000001

entrNmstringOptional

협력사명

Example: 플래티어 협력사

brandNmstringOptional

브랜드명

Example: 플래티어

dcAmt2ndnumberOptional

2차할인금액

Example: 100

dcAmt3rdnumberOptional

3차할인금액

Example: 100

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

finalOrdAmtinteger · int64Optional

순주문금액

Example: 900

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

finalOrdQtyinteger · int32Optional

순주문수량

Example: 1

infCntinteger · int32Optional

상품상세 유입수

Example: 100

900

업무처리 오류 내용

*/*

post

/v1/statistics/hourBasedStatus/getHourBasedStatusGraphData

HTTPcURLJavaScriptPython

POST /api/bo/v1/statistics/hourBasedStatus/getHourBasedStatusGraphData HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "siteNo": 1,
  "targetDate": "2099-01-01",
  "stdCtgNo": 1000001,
  "mdId": "tester",
  "entrNo": 1000001,
  "brandNo": 100001,
  "goodsNo": 10002552,
  "agrtGb": "01"
}

{
  "siteNo": 1,
  "agrtDt": "00시 ~ 01시",
  "imgPath": "text",
  "goodsNo": 10000001,
  "goodsNm": "플래티어단품",
  "siteNm": "x2bee",
  "stdCtgNo": "EX00000000",
  "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
  "mdId": "text",
  "mdNm": "text",
  "entrNo": 1000001,
  "entrNm": "플래티어 협력사",
  "brandNm": "플래티어",
  "dcAmt2nd": 100,
  "dcAmt3rd": 100,
  "ordAmt": 1000,
  "cnclAmt": 100,
  "finalOrdAmt": 900,
  "ordQty": 1,
  "cnclQty": 0,
  "finalOrdQty": 1,
  "infCnt": 100,
  "compareDataList": [
    {
      "agrtDt": 20230912,
      "realOrdAmt": 20000,
      "pwRealOrdAmt": 50000,
      "realOrdQty": 100,
      "pwRealOrdQty": 100
    }
  ]
}

주문(매출) 현황 기간 대비

get

기능설명

• 주문(매출) 현황 기간 대비 데이터를 조회합니다.

---

상세설명

• 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지 상단의 그래프에서 조회 버튼 클릭 시 호출됩니다.

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

• calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.

• 2개의 조회결과가 막대 그래프의 형태로 나타납니다.

  • 조회기간 기준 동안의 데이터 (주문 현황: 순주문금액 / 매출 현황: 순매출금액)

  • 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문금액 / 매출 현황: 기간대비 순매출금액)

• 2개의 조회결과가 꺾은선 그래프의 형태로 나타납니다.

  • 조회기간 기준 동안의 데이터 (주문 수량: 순주문수량 / 매출 수량: 순매출수량)

  • 조회기간 전 기준 조회기간 동안의 데이터 (주문 현황: 기간대비 순주문수량 / 매출 현황: 기간대비 순매출수량)

---

수정번호

• Release v2.00_240827: 기간별 주문(매출) 현황 조회 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

기간 대비 데이터 조회 성공

*/*

주문 현황/매출 현황 DTO

agrtDtstringOptional

조회일자

Example: 20990101

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: 플래티어

dcAmt2ndnumberOptional

2차할인금액

Example: 100

dcAmt3rdnumberOptional

3차할인금액

Example: 100

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

finalOrdAmtinteger · int64Optional

순주문 금액

Example: 900

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

finalOrdQtyinteger · int32Optional

순주문 수량

Example: 1

infCntinteger · int32Optional

유입건수

Example: 100

realOrdQtyinteger · int32Optional

순주문 수량

Example: 1

realOrdAmtinteger · int64Optional

순주문 금액

Example: 900

dcAmtnumberOptional

할인금액

Example: 100

currRealOrdAmtinteger · int64Optional

현재순주문금액

900

업무처리 오류 내용

*/*

get

/v2/statistics/period/sales-status/graph-data

HTTPcURLJavaScriptPython

GET /api/bo/v2/statistics/period/sales-status/graph-data?periodBasedStatusRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "agrtDt": 20990101,
  "imgPath": "text",
  "goodsNo": 10000001,
  "goodsNm": "플래티어단품",
  "siteNo": 1,
  "siteNm": "x2bee",
  "stdCtgNo": "EX00000000",
  "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
  "mdId": "text",
  "mdNm": "text",
  "entrNo": 1000001,
  "entrNm": "플래티어 협력사",
  "brandNm": "플래티어",
  "dcAmt2nd": 100,
  "dcAmt3rd": 100,
  "ordAmt": 1000,
  "cnclAmt": 100,
  "finalOrdAmt": 900,
  "ordQty": 1,
  "cnclQty": 0,
  "finalOrdQty": 1,
  "infCnt": 100,
  "compareDataList": [
    {
      "agrtDt": 20230912,
      "realOrdAmt": 20000,
      "pwRealOrdAmt": 50000,
      "realOrdQty": 100,
      "pwRealOrdQty": 100
    }
  ],
  "realOrdQty": 1,
  "realOrdAmt": 900,
  "dcAmt": 100,
  "currRealOrdAmt": 1
}

시간대별 주문(매출) 현황 그래프 데이터 조회

get

기능 설명

• 시간대별 주문(매출) 현황 그래프 데이터를 조회합니다.

---

상세 설명

• 조회일자와 집계구분코드값은 필수 조건입니다.

• 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.

• 조회일자 기준 하루동안 발생한 주문 현황 목록을 조회합니다.

• 검색 조건이 있는 경우, 해당 값으로 목록을 필터링 합니다.

• 검색 일자에 발생한 주문 목록에 대해 시간대별 순 주문금액, 주문수량을 조회합니다.

• 검색 일자에 발생한 주문 목록에 대해 총 순 주문금액, 주문수량을 조회합니다.

• 검색 일자 -1일에 발생한 주문 목록에 대해 시간대별 기간대비 순 주문금액, 주문수량을 조회합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

성공

*/*

시간대 별 주문/매출 현황 Response DTO

siteNostringOptional

사이트번호

Example: 1

agrtDtstringOptional

조회시간

Example: 00시 ~ 01시

imgPathstringOptional

대표이미지

goodsNostringOptional

상품번호

Example: 10000001

goodsNmstringOptional

상품명

Example: 플래티어단품

siteNmstringOptional

사이트명

Example: x2bee

stdCtgNostringOptional

표준카테고리번호

Example: EX00000000

stdCtgNmstringOptional

표준카테고리명

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

mdIdstringOptional

담당MD

mdNmstringOptional

담당MD명

entrNostringOptional

협력사번호

Example: 1000001

entrNmstringOptional

협력사명

Example: 플래티어 협력사

brandNmstringOptional

브랜드명

Example: 플래티어

dcAmt2ndnumberOptional

2차할인금액

Example: 100

dcAmt3rdnumberOptional

3차할인금액

Example: 100

ordAmtnumberOptional

주문금액

Example: 1000

cnclAmtnumberOptional

취소금액

Example: 100

finalOrdAmtinteger · int64Optional

순주문금액

Example: 900

ordQtyinteger · int32Optional

주문수량

Example: 1

cnclQtyinteger · int32Optional

취소수량

Example: 0

finalOrdQtyinteger · int32Optional

순주문수량

Example: 1

infCntinteger · int32Optional

상품상세 유입수

Example: 100

900

업무처리 오류 내용

*/*

get

/v2/statistics/period/hourly/sales-status/graph-data

HTTPcURLJavaScriptPython

GET /api/bo/v2/statistics/period/hourly/sales-status/graph-data?orderStatusRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "siteNo": 1,
  "agrtDt": "00시 ~ 01시",
  "imgPath": "text",
  "goodsNo": 10000001,
  "goodsNm": "플래티어단품",
  "siteNm": "x2bee",
  "stdCtgNo": "EX00000000",
  "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
  "mdId": "text",
  "mdNm": "text",
  "entrNo": 1000001,
  "entrNm": "플래티어 협력사",
  "brandNm": "플래티어",
  "dcAmt2nd": 100,
  "dcAmt3rd": 100,
  "ordAmt": 1000,
  "cnclAmt": 100,
  "finalOrdAmt": 900,
  "ordQty": 1,
  "cnclQty": 0,
  "finalOrdQty": 1,
  "infCnt": 100,
  "compareDataList": [
    {
      "agrtDt": 20230912,
      "realOrdAmt": 20000,
      "pwRealOrdAmt": 50000,
      "realOrdQty": 100,
      "pwRealOrdQty": 100
    }
  ]
}

카테고리별 주문(매출) 현황 목록 조회 - 대시보드

get

기능설명

• 카테고리별 주문(매출) 현황 목록을 조회합니다.

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

---

상세설명

• 매일 09시 기준으로 전날 집계를 수행합니다.

• 카테고리별 주문(매출) 현황 목록을 조회합니다.

• 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

결제수단코드(OM013)

mdIdStringOptional

MD ID

agrtGbStringRequired

집계구분

Responses

200

성공

*/*

stdCtgNostringOptional

표준 카테고리 번호

Example: HT01000000

stdCtgNmstringOptional

표준 카테고리명

Example: 여성 > 의류

siteNmstringOptional

사이트명

Example: 플래티어

mdIdstringOptional

담당MD

Example: 김테스트

mdNmstringOptional

담당MD

Example: 김테스트

dcAmt2ndnumberOptional

2차 할인금액

Example: 123

dcAmt3rdnumberOptional

3차 할인금액

Example: 123

ordAmtnumberOptional

주문금액

Example: 12345

cnclAmtnumberOptional

취소금액

Example: 2345

finalOrdAmtinteger · int64Optional

순주문금액

Example: 10000

ordQtyinteger · int32Optional

주문수량

Example: 12

cnclQtyinteger · int32Optional

취소수량

Example: 2

finalOrdQtyinteger · int32Optional

순주문수량

Example: 10

900

업무처리 오류 내용

*/*

get

/v2/statistics/category/sales-status

HTTPcURLJavaScriptPython

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

[
  {
    "stdCtgNo": "HT01000000",
    "stdCtgNm": "여성 > 의류",
    "siteNm": "플래티어",
    "mdId": "김테스트",
    "mdNm": "김테스트",
    "dcAmt2nd": 123,
    "dcAmt3rd": 123,
    "ordAmt": 12345,
    "cnclAmt": 2345,
    "finalOrdAmt": 10000,
    "ordQty": 12,
    "cnclQty": 2,
    "finalOrdQty": 10
  }
]

기간별 주문(매출) 현황 목록 조회

get

기능설명

• 기간별 주문(매출) 현황을 조회하는 기능 입니다.

---

상세설명

• [BO] 통계 > 주문 분석 > 기간별 주문 현황(기간별 매출 현황) 페이지에서 조회 버튼 클릭 시 호출됩니다.

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

• calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.

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

---

수정 번호

• Release v2.00_240827: 기간별 주문(매출) 현황 조회 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

calendarTypeStringRequired

일간 or 월간

startMonthStringOptional

조회 시작월

endMonthStringOptional

조회 종료월

startDateLocalDateOptional

조회 시작일

endDateLocalDateOptional

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

goodsNoStringOptional

상품번호

siteNoStringOptional

사이트번호

agrtGbStringRequired

집계구분

Responses

200

주문 현황 목록 조회 성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/periodBasedStatus/getPeriodBasedStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/periodBasedStatus/getPeriodBasedStatusList?periodBasedStatusRequest=[object+Object]&calendarType=null&agrtGb=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "agrtDt": 20990101,
      "imgPath": "text",
      "goodsNo": 10000001,
      "goodsNm": "플래티어단품",
      "siteNo": 1,
      "siteNm": "x2bee",
      "stdCtgNo": "EX00000000",
      "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
      "mdId": "text",
      "mdNm": "text",
      "entrNo": 1000001,
      "entrNm": "플래티어 협력사",
      "brandNm": "플래티어",
      "dcAmt2nd": 100,
      "dcAmt3rd": 100,
      "ordAmt": 1000,
      "cnclAmt": 100,
      "finalOrdAmt": 900,
      "ordQty": 1,
      "cnclQty": 0,
      "finalOrdQty": 1,
      "infCnt": 100,
      "compareDataList": [
        {
          "agrtDt": 20230912,
          "realOrdAmt": 20000,
          "pwRealOrdAmt": 50000,
          "realOrdQty": 100,
          "pwRealOrdQty": 100
        }
      ],
      "realOrdQty": 1,
      "realOrdAmt": 900,
      "dcAmt": 100,
      "currRealOrdAmt": 1
    }
  ]
}

기간별 주문(매출) 현황 그리드 엑셀 일괄 다운로드

get

기능 설명

• 기간별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.

---

상세 설명

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

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

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

• calendarType이 month(월간)인 경우, **집계구분코드, 조회기간(조회 시작월, 조회 종료월)**는 필수 조회 조건입니다.

---

수정번호

• Release v2.00_240827: 기간별 주문(매출) 현황 조회 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

calendarTypeStringRequired

일간 or 월간

startMonthStringOptional

조회 시작월

endMonthStringOptional

조회 종료월

startDateLocalDateOptional

조회 시작일

endDateLocalDateOptional

조회 종료일

stdCtgNoStringOptional

표준분류번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

goodsNoStringOptional

상품번호

siteNoStringOptional

사이트번호

agrtGbStringRequired

집계구분

Responses

200

엑셀 다운로드 성공

No content

900

엑셀 다운로드 실패

*/*

get

/v1/statistics/periodBasedStatus/downloadPeriodBasedStatusExcel

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/periodBasedStatus/downloadPeriodBasedStatusExcel?periodBasedStatusRequest=[object+Object]&calendarType=null&agrtGb=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

조회 종료일

payWayCdStringOptional

결제수단코드(OM013)

agrtGbStringRequired

집계구분

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

get

/v1/statistics/payWayStatus/payWayStatusExcelDownload

HTTPcURLJavaScriptPython

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

No content

결제수단별 주문(매출) 현황 목록 조회

get

기능설명

• 결제수단별 주문(매출) 현황 목록을 조회합니다.

---

상세설명

• 매일 09시 기준으로 전날 집계를 수행합니다.

• 결제수단별 주문(매출) 현황 목록을 조회합니다.

• 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

payWayCdStringOptional

결제수단코드(OM013)

agrtGbStringRequired

집계구분

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/payWayStatus/getPayWayStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/payWayStatus/getPayWayStatusList?request=[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": [
    {
      "siteNo": 1,
      "agrtDt": 20240808,
      "agrtGb": "01",
      "payWayCd": 11,
      "payWayNm": "신용카드",
      "siteNm": "플래티어",
      "dcAmt2nd": 123,
      "dcAmt3rd": 123,
      "ordAmt": 12345,
      "cnclAmt": 2345,
      "finalOrdAmt": 10000,
      "ordQty": 12,
      "cnclQty": 2,
      "finalOrdQty": 10
    }
  ]
}

시간대별 주문(매출) 현황 그리드 목록 조회

get

기능 설명

• 시간대별 주문(매출) 현황 그리드 목록을 조회합니다.

---

상세 설명

• 조회일자와 집계구분코드값은 필수 조건입니다.

• 집계구분코드로 주문(01)/매출(02) 여부를 구분합니다.

• 조회일자 기준 24시간 내에 포함되는 주문건(주문상태일시 비교)을 시간 구간별로 구분하여 조회합니다.

• 검색 조건이 있는 경우, 해당 값으로 목록을 필터링합니다.

• 주문 내역이 없는 시간대에 대해서도 목록에 노출합니다.

• 상품상세 유입 건수의 경우, 동일 시간 구간에 상품상세유입집계 테이블에 등록된 데이터 수를 기반으로 추출합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

targetDateLocalDateRequired

조회일자

stdCtgNoStringOptional

표준카테고리번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

goodsNoStringOptional

상품번호

siteNoStringOptional

사이트번호

agrtGbStringRequired

집계구분코드

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/hourBasedStatus/getHourBasedStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/hourBasedStatus/getHourBasedStatusList?request=[object+Object]&targetDate=null&agrtGb=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "siteNo": 1,
      "agrtDt": "00시 ~ 01시",
      "imgPath": "text",
      "goodsNo": 10000001,
      "goodsNm": "플래티어단품",
      "siteNm": "x2bee",
      "stdCtgNo": "EX00000000",
      "stdCtgNm": "스마트기기>스마트액세서리>스마트액세서리",
      "mdId": "text",
      "mdNm": "text",
      "entrNo": 1000001,
      "entrNm": "플래티어 협력사",
      "brandNm": "플래티어",
      "dcAmt2nd": 100,
      "dcAmt3rd": 100,
      "ordAmt": 1000,
      "cnclAmt": 100,
      "finalOrdAmt": 900,
      "ordQty": 1,
      "cnclQty": 0,
      "finalOrdQty": 1,
      "infCnt": 100,
      "compareDataList": [
        {
          "agrtDt": 20230912,
          "realOrdAmt": 20000,
          "pwRealOrdAmt": 50000,
          "realOrdQty": 100,
          "pwRealOrdQty": 100
        }
      ]
    }
  ]
}

시간대별 주문(매출) 현황 그리드 엑셀 일괄 다운로드

get

기능 설명

• 시간대별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.

---

상세 설명

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

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

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

targetDateLocalDateRequired

조회일자

stdCtgNoStringOptional

표준카테고리번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

goodsNoStringOptional

상품번호

siteNoStringOptional

사이트번호

agrtGbStringRequired

집계구분코드

fileNameStringRequired

파일명

Responses

200

엑셀 다운로드 성공

No content

900

엑셀 다운로드 실패

*/*

get

/v1/statistics/hourBasedStatus/downloadHourBasedStatusExcel

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/hourBasedStatus/downloadHourBasedStatusExcel?request=[object+Object]&targetDate=null&agrtGb=null&fileName=null HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

상품 별 주문(매출) 현황 목록 조회

get

기능설명

• 상품 별 주문(매출) 현황 목록을 조회합니다.

---

상세 설명

• 매일 09시 기준으로 전날 집계를 수행합니다.

• 주문 별 주문(매출) 현황 목록을 조회합니다.

• 집계 구분값으로 주문(01), 매출(02)여부를 구분합니다.

---

수정 번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

goodsNoStringOptional

상품번호

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/goodsStatus/getGoodsStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/goodsStatus/getGoodsStatusList?request=[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": "files/goods/2023/09/11/06755740.png",
      "goodsNo": 1000002,
      "goodsNm": "플래티어 협력사",
      "entrNo": 1000002,
      "entrNm": "플래티어 협력사",
      "siteNm": "플래티어닷컴",
      "dcAmt2nd": 0,
      "dcAmt3rd": 0,
      "ordAmt": 50000,
      "cnclAmt": 10000,
      "realOrdAmt": 40000,
      "ordQty": 5,
      "cnclQty": 2,
      "realOrdQty": 3
    }
  ]
}

상품 별 주문(매출) 현황 그리드 엑셀 일괄 다운로드

get

기능설명

• 상품 별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.

---

상세 설명

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

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

---

수정 번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

goodsNoStringOptional

상품번호

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

fileNameStringRequired

파일명

Responses

200

엑셀 다운로드 성공

No content

900

엑셀 다운로드 실패

*/*

get

/v1/statistics/goodsStatus/downloadGoodsStatusExcel

HTTPcURLJavaScriptPython

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

No content

협력사 별 주문(매출) 현황 목록 조회

get

기능설명

• 협력사 별 주문(매출) 현황 목록을 조회합니다.

---

상세 설명

• 매일 09시 기준으로 전날 집계를 수행합니다.

• 협력사 별 주문(매출) 현황 목록을 조회합니다.

• 집계 구분값으로 주문(01), 매출(02)여부를 구분합니다.

---

수정 번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/enterpriseStatus/getEnterpriseStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/enterpriseStatus/getEnterpriseStatusList?request=[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": [
    {
      "entrNo": 1000002,
      "entrNm": "플래티어 협력사",
      "siteNm": "플래티어닷컴",
      "dcAmt2nd": 0,
      "dcAmt3rd": 0,
      "ordAmt": 50000,
      "cnclAmt": 10000,
      "finalOrdAmt": 40000,
      "ordQty": 5,
      "cnclQty": 2,
      "finalOrdQty": 3
    }
  ]
}

협력사 별 주문(매출) 현황 그리드 엑셀 일괄 다운로드

get

기능설명

• 협력사 별 주문(매출) 현황 그리드 목록을 엑셀파일로 생성하여 다운로드 합니다.

---

상세 설명

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

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

---

수정 번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

fileNameStringRequired

파일명

Responses

200

엑셀 다운로드 성공

No content

900

엑셀 다운로드 실패

*/*

get

/v1/statistics/enterpriseStatus/downloadEnterpriseStatusExcel

HTTPcURLJavaScriptPython

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

No content

카테고리별 주문(매출) 현황 목록 조회

get

기능설명

• 카테고리별 주문(매출) 현황 목록을 조회합니다.

---

상세설명

• 매일 09시 기준으로 전날 집계를 수행합니다.

• 카테고리별 주문(매출) 현황 목록을 조회합니다.

• 집계 구분값으로 주문(01), 매출(02) 여부를 구분합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

결제수단코드(OM013)

mdIdStringOptional

MD ID

agrtGbStringRequired

집계구분

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/statistics/categoryStatus/getCategoryStatusList

HTTPcURLJavaScriptPython

GET /api/bo/v1/statistics/categoryStatus/getCategoryStatusList?request=[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": [
    {
      "stdCtgNo": "HT01000000",
      "stdCtgNm": "여성 > 의류",
      "siteNm": "플래티어",
      "mdId": "김테스트",
      "mdNm": "김테스트",
      "dcAmt2nd": 123,
      "dcAmt3rd": 123,
      "ordAmt": 12345,
      "cnclAmt": 2345,
      "finalOrdAmt": 10000,
      "ordQty": 12,
      "cnclQty": 2,
      "finalOrdQty": 10
    }
  ]
}

카테고리별 주문(매출) 현황 목록 엑셀 다운로드

get

기능설명

• 카테고리별 주문(매출) 현황 목록을 엑셀 다운로드합니다.

---

상세설명

• 검색 조건에 해당하는 카테고리별 주문(매출) 현황 목록을 페이징 처리가 안된 데이터로 엑셀 다운로드 합니다.

---

수정번호

• Release v2.00_240827 : 최초 생성

Authorizations

accessToken

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

결제수단코드(OM013)

mdIdStringOptional

MD ID

agrtGbStringRequired

집계구분

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

get

/v1/statistics/categoryStatus/categoryStatusExcelDownload

HTTPcURLJavaScriptPython

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

No content