매출내역조회

마감확정

post

기능설명

매출일자별 마감확정 처리를 합니다.

상세설명

마감확정 처리 후 해당 매출일자에 대한 매출집계 재작업이 불가능 합니다.
마감확정 일자는 전일까지 선택 가능합니다.

코드정리

정산상태코드 : 10: 정산등록, 20: 마감확정

수정번호

Release v1.04_231120: 마감확정 최초 개발

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

매출 마감확정/마감취소 처리 Request

sysModIdstringOptional

수정자ID

Example: tester

adjStdDtstringRequired

정산기준일자

Example: 20231001

adjStatCdstringOptional

정산상태코드(AC002)
10:정산등록, 20:마감확정

Example: 10

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/adjust/acSaleInfo/saveSaleClose

POST /api/bo/v1/adjust/acSaleInfo/saveSaleClose HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "sysModId": "tester",
  "adjStdDt": 20231001,
  "adjStatCd": 10
}

No content

마감확정취소

post

기능설명

매출일자별 마감확정취소 처리를 합니다.

상세설명

마감확정취소 처리 후 해당 매출일자에 대한 매출집계 재작업이 가능 합니다.
매출전송 건이 존재할 경우 마감확정 취소 불가능합니다.
마감확정 일자는 전일까지 선택 가능합니다.

코드정리

정산상태코드 : 10: 정산등록, 20: 마감확정

수정번호

Release v1.04_231120: 마감확정취소 최초 개발

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

매출 마감확정/마감취소 처리 Request

sysModIdstringOptional

수정자ID

Example: tester

adjStdDtstringRequired

정산기준일자

Example: 20231001

adjStatCdstringOptional

정산상태코드(AC002)
10:정산등록, 20:마감확정

Example: 10

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post/v1/adjust/acSaleInfo/saveSaleCloseCancel

POST /api/bo/v1/adjust/acSaleInfo/saveSaleCloseCancel HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "sysModId": "tester",
  "adjStdDt": 20231001,
  "adjStatCd": 10
}

No content

매출내역 요약 조회

get

기능설명

매출내역에 대해 협력사별 요약내용을 조회 합니다.

상세설명

화면에서 넘어온 조건에 맞는 매출내역을 협력사별로 요약하여 조회 합니다.
매출시작일자, 매출종료일자는 필수값 입니다.
조회 기간에 해당하는 협력사별 총판매금액, 할인분담금, 배송분담금, 순매출금액, 판매수수료, 정산금액을 조회 합니다.

코드정리

매출구분 : 10: 주문, 20: 반품

수정번호

Release v1.04_231120: 매출내역조회 최초 개발
Release v2.00_240613: 기간 검색 조건 개선

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateRequired

매출시작일자

Example: 20231001

endDatestring · dateRequired

매출종료일자

Example: 20231031

entrNostringOptional

요약조회용 협력사번호

Example: 1000002

searchEntrNostringOptional

상세조회용 협력사번호

Example: 1000002

ordNostringOptional

요약조회용 주문번호

Example: 20231127O066055

searchOrdNostringOptional

상세조회용 주문번호

Example: 20231127O066055

saleGbstringOptional

매출구분(AC004)
10:주문, 20:반품

Example: 10

saleCloseYnstringOptional

매출마감여부

Example: Y

userGbCdstringOptional

사용자구분코드(UR001)
10:임직원, 30:협력업체

Example: 10

userEntrNostringOptional

사용자 협력사번호

Example: 1000002

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get/v1/adjust/acSaleInfo/getAcSaleInfoSummary

GET /api/bo/v1/adjust/acSaleInfo/getAcSaleInfoSummary?startDate=20231001&endDate=20231031 HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "ordNo": "text",
      "saleGb": "text",
      "saleDt": "text",
      "entrNo": "text",
      "entrNm": "text",
      "goodsNo": "text",
      "goodsNm": "text",
      "itmNm": "text",
      "siteNo": "text",
      "siteNm": "text",
      "supPcost": 1,
      "salePrc": 1,
      "salesQty": 1,
      "saleSum": 1,
      "ourGoodsDcCpn": 1,
      "entrGoodsDcCpn": 1,
      "ourGoodsImmedDc": 1,
      "entrGoodsImmedDc": 1,
      "ourCartCpn": 1,
      "entrCartCpn": 1,
      "ourDupDcCpn": 1,
      "entrDupDcCpn": 1,
      "ourStafDc": 1,
      "entrStafDc": 1,
      "cmsnRate": 1,
      "ourDcBrdnSum": 1,
      "entrDcBrdnSum": 1,
      "dlexAmt": 1,
      "ourFreeDlexCpn": 1,
      "entrFreeDlexCpn": 1,
      "ourFreeRtnDlexCpn": 1,
      "entrFreeRtnDlexCpn": 1,
      "ourDlexBrdnSum": 1,
      "entrDlexBrdnSum": 1,
      "purSaleSum": 1,
      "salesCmsn": 1,
      "adjAmt": 1,
      "saleCloseYn": "text",
      "startDate": "text",
      "endDate": "text",
      "goodsTypCd": "text",
      "saleStatCd": "text"
    }
  ]
}

매출내역 목록 조회

get

기능설명

매출내역 대한 목록을 주문번호 및 상품 단위로 조회합니다.

상세설명

화면에서 넘어온 조건에 맞는 매출내역 목록을 조회합니다.
조회 날짜에 해당하는 매출에 대해 주문번호 및 상품 단위로 총판매금액, 할인분담금, 배송분담금, 순매출금액, 판매수수료, 정산금액을 조회합니다.
금액계산
- 총판매금액 : 판매가 * 판매수량
- 순매출금액 : 총판매금액 - 협력사할인분담금
- 판매수수료 : (총판매금액 - (당사할인분담금 + 협력사할인분담금)) * 수수료율
- 정산금액 : 순매출금액 - (판매수수료 + 배송비 + 당사배송분담금)

코드정리

매출구분 : 10: 주문, 20: 반품

수정번호

Release v1.04_231120: 매출내역조회 최초 개발
Release v2.00_240613: 기간 검색 조건 개선

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateRequired

매출시작일자

Example: 20231001

endDatestring · dateRequired

매출종료일자

Example: 20231031

entrNostringOptional

요약조회용 협력사번호

Example: 1000002

searchEntrNostringOptional

상세조회용 협력사번호

Example: 1000002

ordNostringOptional

요약조회용 주문번호

Example: 20231127O066055

searchOrdNostringOptional

상세조회용 주문번호

Example: 20231127O066055

saleGbstringOptional

매출구분(AC004)
10:주문, 20:반품

Example: 10

saleCloseYnstringOptional

매출마감여부

Example: Y

userGbCdstringOptional

사용자구분코드(UR001)
10:임직원, 30:협력업체

Example: 10

userEntrNostringOptional

사용자 협력사번호

Example: 1000002

Responses

200

성공

*/*

totalCountinteger · int32Optional

900

업무처리 오류 내용

*/*

get/v1/adjust/acSaleInfo/getAcSaleInfoList

GET /api/bo/v1/adjust/acSaleInfo/getAcSaleInfoList?startDate=20231001&endDate=20231031 HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "payloads": [
    {
      "ordNo": "text",
      "saleGb": "text",
      "saleDt": "text",
      "entrNo": "text",
      "entrNm": "text",
      "goodsNo": "text",
      "goodsNm": "text",
      "itmNm": "text",
      "siteNo": "text",
      "siteNm": "text",
      "supPcost": 1,
      "salePrc": 1,
      "salesQty": 1,
      "saleSum": 1,
      "ourGoodsDcCpn": 1,
      "entrGoodsDcCpn": 1,
      "ourGoodsImmedDc": 1,
      "entrGoodsImmedDc": 1,
      "ourCartCpn": 1,
      "entrCartCpn": 1,
      "ourDupDcCpn": 1,
      "entrDupDcCpn": 1,
      "ourStafDc": 1,
      "entrStafDc": 1,
      "cmsnRate": 1,
      "ourDcBrdnSum": 1,
      "entrDcBrdnSum": 1,
      "dlexAmt": 1,
      "ourFreeDlexCpn": 1,
      "entrFreeDlexCpn": 1,
      "ourFreeRtnDlexCpn": 1,
      "entrFreeRtnDlexCpn": 1,
      "ourDlexBrdnSum": 1,
      "entrDlexBrdnSum": 1,
      "purSaleSum": 1,
      "salesCmsn": 1,
      "adjAmt": 1,
      "saleCloseYn": "text",
      "startDate": "text",
      "endDate": "text",
      "goodsTypCd": "text",
      "saleStatCd": "text"
    }
  ]
}

매출내역 엑셀 다운로드

get

기능설명

대량 데이터 엑셀 다운로드 목록을 조회 합니다.

상세설명

매출내역조회 화면에서 목록 데이터를 대량 데이터 엑셀로 다운로드합니다.
매출시작일자, 매출종료일자는 필수값 입니다.

코드정리

매출구분 : 10: 주문, 20: 반품

수정번호

Release v1.04_231120: 매출내역조회 최초 개발
Release v2.00_240613: 기간 검색 조건 개선

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

startDatestring · dateRequired

매출시작일자

Example: 20231001

endDatestring · dateRequired

매출종료일자

Example: 20231031

entrNostringOptional

요약조회용 협력사번호

Example: 1000002

searchEntrNostringOptional

상세조회용 협력사번호

Example: 1000002

ordNostringOptional

요약조회용 주문번호

Example: 20231127O066055

searchOrdNostringOptional

상세조회용 주문번호

Example: 20231127O066055

saleGbstringOptional

매출구분(AC004)
10:주문, 20:반품

Example: 10

saleCloseYnstringOptional

매출마감여부

Example: Y

userGbCdstringOptional

사용자구분코드(UR001)
10:임직원, 30:협력업체

Example: 10

userEntrNostringOptional

사용자 협력사번호

Example: 1000002

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

get/v1/adjust/acSaleInfo/getAcSaleInfoExcelDown

GET /api/bo/v1/adjust/acSaleInfo/getAcSaleInfoExcelDown?startDate=20231001&endDate=20231031 HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

매출 마감상태별 건수 조회

get

기능설명

매출일자별 매출 마감상태별 건수를 조회 합니다.

상세설명

마감확정 처리 전에 매출일자별 정산등록건수, 마감확정건수, 매출전송건수를 조회 합니다.
마감확정 일자는 전일까지 선택 가능합니다.

수정번호

Release v1.04_231120: 매출내역조회 최초 개발

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

adjStdDtstringRequired

마감확정일자

Responses

200

성공

*/*

마감상태별 건수 Response

saleCloseCntstringOptional

saleRegisterCntstringOptional

saleTransCntstringOptional

900

업무처리 오류 내용

*/*

get/v1/adjust/acSaleInfo/getAcSaleInfoCount

GET /api/bo/v1/adjust/acSaleInfo/getAcSaleInfoCount?adjStdDt=text HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "saleCloseCnt": "text",
  "saleRegisterCnt": "text",
  "saleTransCnt": "text"
}

이전PG정산대사

다음마일리지 조회

마지막 업데이트 6개월 전