주문클레임 대시보드

대시보드 고객 여정별 구매전환율 조회

post

기능설명

• BO(MD) 대시보드의 고객 여정별 구매전환율 정보를 조회합니다.

---

상세설명

• 당일 기준 / 최근 7일 / 최근 30일 간 주문 매출 현황 정보를 제공합니다.

• 사이트 파라미터가 전체가 아닌 경우 해당 사이트에 해당하는 정보만 제공합니다.

• 구매전환율은 방문수 대비 주문완료 비율입니다.

---

수정번호

• Release v2.00_240827: 대시보드 고객 여정별 구매전환율 생성

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

대시보드 고객 여정별 구매전환율 영역 조회 요청 DTO

statusPeriodstringRequired

조회기간구분

Example: 0

siteNostringOptional

사이트번호

Example: 1

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/dashboard/getVisitToOrderDashBoard

HTTPcURLJavaScriptPython

POST /api/order/v1/dashboard/getVisitToOrderDashBoard HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "statusPeriod": "0",
  "siteNo": "1"
}

{
  "main": 30,
  "mainRate": 30,
  "goodsDetail": 30,
  "goodsDetailRate": 30,
  "basket": 30,
  "basketRate": 30,
  "orderSheet": 30,
  "orderSheetRate": 30,
  "recentWeeklyList": [
    {
      "agrtDt": "20230816",
      "visitMain": 100,
      "visitGoodsDetail": 100,
      "visitBasket": 100,
      "visitOrderSheet": 100
    }
  ]
}

대시보드 overview 조회

post

기능설명

• BO 대시보드의 overview 정보를 조회합니다.

---

상세설명

• 당일 기준 / 최근 7일 / 최근 30일 간 주문 매출 현황 정보를 제공합니다.

• 사이트 파라미터가 전체가 아닌 경우 해당 사이트에 해당하는 정보만 제공합니다.

• 구매고객수는 주문한 사용자의 수 입니다.(반품,취소는 카운트하지 않습니다.)

• 방문수는 FO에 방문한 방문자수 입니다.

• 구매전환율은 방문수 대비 주문완료 비율입니다.

• 가입전환율은 방문수 대비 회원가입 비율입니다.

• 주문평균은 조회기간 동안 발생한 모든 고객 주문의 평균 금액입니다.

---

수정번호

• Release v2.00_240827: 대시보드 overview 생성

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

대시보드 overview영역 조회 요청 DTO

statusPeriodstringRequired

조회기간구분

Example: 0

siteNostringOptional

사이트번호

Example: 1

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/dashboard/getOverviewDashBoard

HTTPcURLJavaScriptPython

POST /api/order/v1/dashboard/getOverviewDashBoard HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "statusPeriod": "0",
  "siteNo": "1"
}

{
  "ordManCnt": 100,
  "ordManCntRate": 10,
  "visitManCnt": 100,
  "visitManCntRate": 10,
  "visitToOrder": 30,
  "visitToOrderRate": 10,
  "visitToJoin": 30,
  "visitToJoinRate": 10,
  "orderAverage": 15000,
  "orderAverageRate": 10
}

주문매출현황

post

기능설명

• 주문매출현황 정보를 조회합니다.

---

상세설명

• **집계구분코드(agrtGb)**는 필수 파라미터 입니다.

• 요청 집계구분코드가 '01'일 경우, 주문 현황 정보를 제공합니다.

• 요청 집계구분코드가 '02'일 경우, 매출 현황 정보를 제공합니다.

• 당일 기준 / 최근 7일 / 최근 30일 간 주문 매출 현황 정보를 제공합니다.

• 사이트 파라미터가 전체가 아닌 경우 해당 사이트에 해당하는 정보만 제공합니다.

• PO 진입 시 해당 협력사에 해당하는 정보만 제공합니다.

---

수정번호

• Release v2.00_240711: 주문/취소금액을 표시할 때 기본 주문/취소금액에 건수를 곱하지 않도록 수정

• Release v2.00_240827: 대시보드 전체 리뉴얼에 따른 수정

---

코드정리

• 집계구분코드(agrtGb) : 01 : 주문현황집계코드, 02 : 매출현황집계코드

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

주문매출현황 조회 요청 DTO

agrtGbstringRequired

집계구분

Example: 01

statusPeriodstringRequired

조회기간구분

Example: 0

entrNostringOptional

협력사번호

Example: 1000002

siteNostringOptional

사이트번호

Example: 1

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/dashboard/getOrderSalesDashBoard

HTTPcURLJavaScriptPython

POST /api/order/v1/dashboard/getOrderSalesDashBoard HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "agrtGb": "01",
  "statusPeriod": "0",
  "entrNo": "1000002",
  "siteNo": "1"
}

{
  "ordSaleAmt": 100,
  "ordSaleAmtRate": 10,
  "ordSaleCnt": 100,
  "ordSaleCntRate": 10,
  "cnclRtnAmt": 100,
  "cnclRtnAmtRate": 10,
  "cnclRtnCnt": 100,
  "cnclRtnCntRate": 10,
  "recentWeeklyList": [
    {
      "agrtDt": "20230816",
      "ordSaleAmt": 100,
      "cnclRtnAmt": 100
    }
  ]
}

주문/클레임현황

post

기능 설명

• PO에서 주문현황/클레임현황 정보를 제공합니다.

---

상세 설명

• 주문/클레임구분(ordCntGb), **협력사명(entrNo)**은 필수 파라미터 입니다.

• **주문/클레임구분(ordCntGb)**이 주문(O) 일경우 다음의 **주문내역상태코드(OM005)**의 건 수를 노출한다.

  • 주문완료(12), 배송지시(21), 출고지시(22), 출고대기(23), 출고완료(26)

• **주문/클레임구분(ordCntGb)**이 클레임(C) 일경우 다음의 **주문내역상태코드(OM005)**의 건 수를 노출한다.

  • 클레임접수(32), 회수지시(34), 회수확인(35)

---

특이 사항

• **주문/클레임구분(ordCntGb)**이 **주문(O)**이거나 **클레임(C)**일 경우에만 해당 현황정보를 조회합니다.

---

수정 번호

• Release v2.00_240827 : 주문접수일시 최근 30일 기준 조건 추가

Header parameters

AuthorizationanyOptional

Access Token

Body

application/json

주문현황/클레임현황 요청 DTO

ordCntGbstringRequired

주문/클레임구분 O:주문, C:클레임

Default: OExample: O

entrNostringOptional

협력사번호

Example: 1000002

Responses

200

성공

*/*

900

업무처리 오류 내용

*/*

post

/v1/dashboard/getDashBoardOrderClaimCount

HTTPcURLJavaScriptPython

POST /api/order/v1/dashboard/getDashBoardOrderClaimCount HTTP/1.1
Host: api-order.x2bee.com/
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "ordCntGb": "O",
  "entrNo": "1000002"
}

[
  {
    "ordDtlStatNm": "주문완료",
    "ordDtlStatCd": "10",
    "cnt": 0
  }
]