> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api-guide/back-office/settlement-bo/undefined.md).

# 매출정산 관리

매출 정산 관리 서비스는 사이트의 주문내역을 체계적으로 파악하고 업체와의 소통을 위해 사용됩니다. 주요 기능으로는 매출내역 조회, 일자별 매출 집계, 마일리지 조회, 배송비 조회, 협력사별 매출수수료 조회 등이 제공됩니다.

***

## 주요 기능

* **일자별 매출 집계**
  * 00시 10분에 배치로 매출 정보, 주문 혜택 정보, 배송비 정보, 결제 정보를 일자별로 집계 처리합니다.
  * 정산 매출 집계된 정보로 협력사별 판매금액, 할인분담금, 배송분담금, 순매출금액, 판매 수수료, 정산 금액을 조회합니다.
* **마일리지 조회**
  * 마일리지 적립 및 사용 내역을 조회합니다.
  * 적립은 기본 적립, 등급 추가 적립, 프로모션 적립으로 구분됩니다.
  * 사용은 결제 및 환불로 구분됩니다.
* **배송비 조회**
  * 협력사별로 발생한 배송비 내역을 조회합니다.
  * 시스템에 로그인된 사용자의 협력사 이외의 협력사는 조회할 수 없습니다.
* **협력사별 매출 수수료 조회**
  * 협력사별로 발생한 매출 수수료 내역을 조회합니다.
  * 시스템에 로그인된 사용자의 협력사 이외의 협력사는 조회할 수 없습니다.
* **마감확정 및 취소**
  * 선택한 기간의 매출을 마감확정하거나 취소합니다.
  * 마감확정 이후 해당 일자에 대한 매출 집계는 재작업이 불가능하며, 취소 후에는 재작업이 가능합니다.
* **매출전송 건 확인**
  * 매출전송 건이 존재하는 경우 마감확정 취소가 불가능합니다.

{% hint style="warning" %}
**유의사항**

* 일자별 매출 집계는 매일 자정 10분에 배치로 처리됩니다.
* 시스템에 로그인된 사용자의 협력사 이외의 협력사는 특정 조회 기능에서 조회할 수 없습니다.
  {% endhint %}

## 프로세스 정의

매출내역 조회, 마감 확정, 배송비 조회, 마일리지 조회 및 협력사별 매출수수료 조회에 대한 프로세스를 의미합니다.

<figure><img src="/files/NY5PKukTm7ldPcu9wjok" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 매출집계

매일 00시 10분에 일자별 매출집계 배치가 수행되어 매출정보, 주문혜택정보, 배송비정보, 결제정보를 집계합니다.
{% endstep %}

{% step %}

### 매출내역조회

매출내역조회 화면에서 매출정보, 배송비정보, 할인정보 등을 검증합니다. 배송비조회 화면과 협력사별 매출수수료 조회 화면과 데이터가 일치하는지도 체크합니다.
{% endstep %}

{% step %}

### 마감확정

매출내역 검증이 완료되면 해당 일자에 대해 마감확정 처리를 합니다.
{% endstep %}

{% step %}

### 마감확정 취소

매출집계 재작업이 필요한 경우 마감확정취소 처리를 하고 해당일자의 매출집계 배치를 실행합니다. 단, 매출전송 건이 존재할 경우 마감확정 취소가 불가능합니다.
{% endstep %}

{% step %}

### 마일리지 조회

마일리지 화면은 마일리지 적립, 마일리지 사용 두 개의 탭으로 나누어집니다. 각각의 탭에서 해당하는 구분별로 요약 목록과 상세 목록을 조회할 수 있고 대용량 엑셀 다운로드 기능이 제공됩니다.
{% endstep %}

{% step %}

### 배송비 조회

배송비 조회 화면은 협력사별 배송비 요약 목록과 상세 목록을 조회할 수 있으며 대용량 엑셀 다운로드 기능이 제공됩니다. PO시스템 유입 시 시스템에 로그인 되어 있는 사용자의 협력사 이외의 협력사는 조회할 수 없습니다.
{% endstep %}

{% step %}

### 협력사별 매출수수료 조회

협력사별 매출수수료 조회 화면은 협력사별 매출수수료 요약 목록과 상세 목록을 조회할 수 있으며 대용량 엑셀 다운로드 기능이 제공됩니다. PO시스템 유입 시 시스템에 로그인 되어 있는 사용자의 협력사 이외의 협력사는 조회할 수 없습니다.
{% endstep %}
{% endstepper %}

## API 기능 목록\_매출내역 조회

<table><thead><tr><th width="129">API</th><th width="352.888916015625">설명</th><th width="92.4444580078125" align="center">Server</th><th width="89.111083984375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>마감확정</td><td>매출일자별 마감확정 처리를 합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="http://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%A4%EC%B6%9C%EB%82%B4%EC%97%AD%EC%A1%B0%ED%9A%8C&#x26;path=saveSaleClose">🔗API 확인하기 ></a></td></tr><tr><td>마감확정취소</td><td>매출일자별 마감확정취소 처리를 합니다.</td><td align="center">BO</td><td align="center">POST</td><td><a href="http://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%A4%EC%B6%9C%EB%82%B4%EC%97%AD%EC%A1%B0%ED%9A%8C&#x26;path=saveSaleCloseCancel">🔗API 확인하기 ></a></td></tr><tr><td>매출내역 요약조회</td><td>매출내역에 대해 협력사별 요약내용을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="http://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%A4%EC%B6%9C%EB%82%B4%EC%97%AD%EC%A1%B0%ED%9A%8C&#x26;path=getAcSaleInfoSummary">🔗API 확인하기 ></a></td></tr><tr><td>매출내역 목록조회</td><td>매출내역 대한 목록을 주문번호 및 상품 단위로 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="http://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%A4%EC%B6%9C%EB%82%B4%EC%97%AD%EC%A1%B0%ED%9A%8C&#x26;path=getAcSaleInfoList">🔗API 확인하기 ></a></td></tr><tr><td>매출내역 엑셀다운로드</td><td>매출내역조회 화면에서 목록 데이터를 대량 데이터 엑셀로 다운로드합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="http://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%A4%EC%B6%9C%EB%82%B4%EC%97%AD%EC%A1%B0%ED%9A%8C&#x26;path=getAcSaleInfoExcelDown">🔗API 확인하기 ></a></td></tr><tr><td>매출 마감상태별 건수 조회</td><td>마감확정 처리 전에 매출일자별 정산등록건수, 마감확정건수, 매출전송건수를 조회 합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="http://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%A4%EC%B6%9C%EB%82%B4%EC%97%AD%EC%A1%B0%ED%9A%8C&#x26;path=getAcSaleInfoCount">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록\_마일리지 조회

<table><thead><tr><th width="135.6666259765625">API</th><th width="304.111083984375">설명</th><th width="94.666748046875" align="center">Server</th><th width="99.111083984375" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>마일리지 적립 요약 목록 조회</td><td>마일리지 적립 요약 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileageRsrvSummaryList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 적립 목록 조회</td><td>마일리지 적립 목록을 적립구분 단위로 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileageRsrvDetailList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 적립 목록 건수 조회</td><td>마일리지 적립 목록 건수를 적립구분 단위로 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileageRsrvDetailListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 적립 목록 엑셀 다운로드</td><td>마일리지 적립 목록 데이터를 대량 데이터 엑셀로 다운로드합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=downloadMileageRsrvExcel">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 사용 요약 목록 조회</td><td>마일리지 사용 요약 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileageUseSummaryList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 사용 목록 조회</td><td>마일리지 사용 목록을 사용구분 단위로 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileageUseDetailList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 사용 목록 건수 조회</td><td>마일리지 사용 목록 건수를 사용구분 단위로 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=getMileageUseDetailListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 사용 목록 엑셀 다운로드</td><td>마일리지 사용 목록 데이터를 대량 데이터 엑셀로 다운로드합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A1%B0%ED%9A%8C&#x26;path=downloadMileageUseExcel">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록\_배송비 조회

<table><thead><tr><th width="145.6666259765625">API</th><th width="336.666748046875">설명</th><th width="93.5555419921875" align="center">Server</th><th width="94.6666259765625" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>협력사별 배송비 요약 조회</td><td>협력사별 배송비 요약 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%B0%B0%EC%86%A1%EB%B9%84%20%EC%A1%B0%ED%9A%8C&#x26;path=getAcDeliveryAmountSummaryList">🔗API 확인하기 ></a></td></tr><tr><td>협력사별 배송비 목록 조회</td><td>협력사별 배송비 목록을 조회합니다</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%B0%B0%EC%86%A1%EB%B9%84%20%EC%A1%B0%ED%9A%8C&#x26;path=getAcDeliveryAmountDetailList">🔗API 확인하기 ></a></td></tr><tr><td>협력사별 배송비 목록 건수 조회</td><td>협력사별 배송비 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%B0%B0%EC%86%A1%EB%B9%84%20%EC%A1%B0%ED%9A%8C&#x26;path=getAcDeliveryAmountDetailListCount">🔗API 확인하기 ></a></td></tr><tr><td>협력사별 배송비 엑셀 다운로드</td><td>협력사별 배송비 목록 데이터를 대량 데이터 엑셀로 다운로드합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%EB%B0%B0%EC%86%A1%EB%B9%84%20%EC%A1%B0%ED%9A%8C&#x26;path=downloadAcDeliveryAmountExcel">🔗API 확인하기 ></a></td></tr></tbody></table>

## API 기능 목록\_협력사별 매출수수료 조회

<table><thead><tr><th width="126.77783203125">API</th><th width="356.111083984375">설명</th><th width="93.5555419921875" align="center">Server</th><th width="95.77783203125" align="center">메소드</th><th>비고</th></tr></thead><tbody><tr><td>협력사별 매출수수료 요약 조회</td><td>협력사별 매출수수료 요약 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%ED%98%91%EB%A0%A5%EC%82%AC%EB%B3%84%20%EB%A7%A4%EC%B6%9C%EC%88%98%EC%88%98%EB%A3%8C%20%EC%A1%B0%ED%9A%8C&#x26;path=getEntrCommisionSummaryList">🔗API 확인하기 ></a></td></tr><tr><td>협력사별 매출수수료 목록 조회</td><td>협력사별 매출수수료 목록을 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%ED%98%91%EB%A0%A5%EC%82%AC%EB%B3%84%20%EB%A7%A4%EC%B6%9C%EC%88%98%EC%88%98%EB%A3%8C%20%EC%A1%B0%ED%9A%8C&#x26;path=getEntrCommissionDetailList">🔗API 확인하기 ></a></td></tr><tr><td>협력사별 매출수수료 목록 건수 조회</td><td>협력사별 매출수수료 목록 건수를 조회합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%ED%98%91%EB%A0%A5%EC%82%AC%EB%B3%84%20%EB%A7%A4%EC%B6%9C%EC%88%98%EC%88%98%EB%A3%8C%20%EC%A1%B0%ED%9A%8C&#x26;path=getEntrCommissionDetailListCount">🔗API 확인하기 ></a></td></tr><tr><td>협력사별 매출수수료 목록 엑셀 다운로드</td><td>협력사별 매출수수료 목록 데이터를 대량 <br>데이터 엑셀로 다운로드합니다.</td><td align="center">BO</td><td align="center">GET</td><td><a href="https://apibo.x2bee.com/content?bo=settlement&#x26;depth=%ED%98%91%EB%A0%A5%EC%82%AC%EB%B3%84%20%EB%A7%A4%EC%B6%9C%EC%88%98%EC%88%98%EB%A3%8C%20%EC%A1%B0%ED%9A%8C&#x26;path=entrCommissionDetailExcelDownload">🔗API 확인하기 ></a></td></tr></tbody></table>

## 기타 참고사항

* 혜택정보는 매출인식하는 주문의 주문순번, 주문처리순번이 동일한 내역 집계

<table><thead><tr><th width="105.888916015625">주문내역 구분</th><th width="220.6666259765625">매출인식시점 (주문내역상태)</th><th>배송비 정보</th><th>결제 정보</th></tr></thead><tbody><tr><td>주문일반</td><td>배송완료</td><td>취소 주문으로 인한 초도배송비 발생 시 동일 배송번호에 속한 주문이 배송완료 될 경우 초도배송비 정보 포함하여 집계</td><td>취소 주문 발생 시 동일 배송번호에 속한 주문이 배송완료 될 경우 환불 금액 및 초도배송비 결제 정보 포함하여 집계</td></tr><tr><td>교환</td><td>교환 배송완료 시점에 교환 회수완료 주문까지 인식</td><td>회수배송비 및 교환배송비 발생 시 교환 배송완료될 경우 동일 클레임 번호에 속한 주문의 회수배송비 및 교환배송비 포함하여 집계</td><td>회수배송비 및 교환배송비 발생 시 교환 배송완료될 경우 동일 클레임 번호에 속한 주문의 회수배송비 및 교환배송비 결제 정보 포함하여 집계</td></tr><tr><td>반품</td><td>반품완료</td><td>회수배송비 발생 시 동일 클레임 번호에 속한 주문이 반품완료될 경우 회수배송비 정보 포함하여 집계</td><td>동일 클레임 번호에 속한 주문이 반품완료될 경우 환불 금액 및 회수배송비 결제 정보 포함하여 집계</td></tr><tr><td>교환중반품</td><td>반품완료<br><mark style="color:red;">(교환중 반품으로 발생한</mark> <br><mark style="color:red;">교환 및 교환취소 주문은</mark> <br><mark style="color:red;">미포함)</mark></td><td></td><td>교환 중 반품으로 인해 발생한 교환 및 교환취소 금액은 결제 정보에 미 포함</td></tr></tbody></table>

* 매출내역 조회 화면에서 사용되는 공통코드는 아래와 같습니다.
  * 판매구분코드(AC004)
  * 사용자구분코드(UR001)
* 마일리지 조회 화면에서 사용되는 공통코드는 아래와 같습니다.
  * 부가비용상세구분코드(OM019)
  * 결제구분코드(OM012)
  * 주문내역구분(OM003)
* 배송비 조회 화면에서 사용되는 공통코드는 아래와 같습니다.
  * 배송유형(LO002)
  * 배송처리유형(PR008)
  * 비용구분코드(OM043)
  * 발생구분코드(OM017)
  * 사용자구분코드(UR001)
* 협력사별 매출수수료 조회 화면에서 사용되는 공통코드는 아래와 같습니다.
  * 사용자구분코드(UR001)