Ctrlk
X2BEE 바로가기
For the complete documentation index, see llms.txt. This page is also available as Markdown.

주문 분석

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

post

기능설명

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

상세설명

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

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

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

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

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

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

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

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

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

수정번호

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

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

기간별 주문/매출 현황 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

현재순주문금액

post/v1/statistics/periodBasedStatus/getPeriodBasedStatusGraphData
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body

시간대 별 주문/매출 현황 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
post/v1/statistics/hourBasedStatus/getHourBasedStatusGraphData
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
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

현재순주문금액

get/v2/statistics/period/sales-status/graph-data
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
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
get/v2/statistics/period/hourly/sales-status/graph-data
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
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
get/v2/statistics/category/sales-status
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: 기간별 주문(매출) 현황 조회 최초 생성

  • Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (기간별 상품상세 유입수: SM_DAYCL_GOODS_INF_AGRT → SM_HOURCL_GOODS_INF_AGRT)

Authorizations
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
get/v1/statistics/periodBasedStatus/getPeriodBasedStatusList
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: 기간별 주문(매출) 현황 조회 최초 생성

  • Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (기간별 상품상세 유입수: SM_DAYCL_GOODS_INF_AGRT → SM_HOURCL_GOODS_INF_AGRT)

Authorizations
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
get/v1/statistics/periodBasedStatus/downloadPeriodBasedStatusExcel
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

payWayCdStringOptional

결제수단코드(OM013)

agrtGbStringRequired

집계구분

Responses
200

성공

No content
get/v1/statistics/payWayStatus/payWayStatusExcelDownload
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

payWayCdStringOptional

결제수단코드(OM013)

agrtGbStringRequired

집계구분

Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v1/statistics/payWayStatus/getPayWayStatusList
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 : 최초 생성

  • Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (시간대별 상품상세 유입수: SM_UMAMI_INF_AGRT(raw) → SM_HOURCL_GOODS_INF_AGRT(시간별 사전집계))

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
targetDateLocalDateRequired

조회일자

stdCtgNoStringOptional

표준카테고리번호

mdIdStringOptional

담당MD

entrNoStringOptional

협력사번호

brandNoStringOptional

브랜드번호

goodsNoStringOptional

상품번호

siteNoStringOptional

사이트번호

agrtGbStringRequired

집계구분코드

Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v1/statistics/hourBasedStatus/getHourBasedStatusList
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 : 최초 생성

  • Release v2.00_260512: Umami → GA4 데이터 소스 마이그레이션 (시간대별 상품상세 유입수: SM_UMAMI_INF_AGRT(raw) → SM_HOURCL_GOODS_INF_AGRT(시간별 사전집계))

Authorizations
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
get/v1/statistics/hourBasedStatus/downloadHourBasedStatusExcel
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

goodsNoStringOptional

상품번호

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v1/statistics/goodsStatus/getGoodsStatusList
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

goodsNoStringOptional

상품번호

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

fileNameStringRequired

파일명

Responses
200

엑셀 다운로드 성공

No content
get/v1/statistics/goodsStatus/downloadGoodsStatusExcel
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v1/statistics/enterpriseStatus/getEnterpriseStatusList
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

entrNoStringOptional

협력사번호

agrtGbStringRequired

집계구분

fileNameStringRequired

파일명

Responses
200

엑셀 다운로드 성공

No content
get/v1/statistics/enterpriseStatus/downloadEnterpriseStatusExcel
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

결제수단코드(OM013)

mdIdStringOptional

MD ID

agrtGbStringRequired

집계구분

Responses
200

성공

*/*
totalCountinteger · int32Optional
get/v1/statistics/categoryStatus/getCategoryStatusList
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
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
startDateLocalDateRequired

조회 시작일

endDateLocalDateRequired

조회 종료일

stdCtgNoStringOptional

결제수단코드(OM013)

mdIdStringOptional

MD ID

agrtGbStringRequired

집계구분

Responses
200

성공

No content
get/v1/statistics/categoryStatus/categoryStatusExcelDownload
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
이전통계(Statistics) BO API
다음주문 통계

마지막 업데이트