> 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/marketing-bo/undefined-1.md).

# 마일리지 지급/소멸 관리

마일리지 지급관리 서비스는 고객에게 마일리지를 제공하고 효율적으로 관리하는 기능을 제공합니다. 이를 통해 기업은 고객 충성도를 높이고 매출 및 이익을 향상시킬 수 있습니다. 또한, 클레임이나 이벤트마케팅에 필요한 마일리지를 효율적으로 처리하여 고객 서비스 품질을 향상시킵니다.

***

## 주요 기능

* **마일리지 지급 등록**
  * 새로운 마일리지 지급 정보를 등록하고, 승인권자가 승인한 건만을 효율적으로 지급 처리합니다.
  * 지급 대상 회원을 쉽게 관리하며, 지급 정보 등록 및 확인이 원활하게 이루어집니다.
* **마일리지 지급대상 회원 관리**
  * 지급 대상 회원 목록을 조회하고, 새로운 지급대상 회원을 추가 등록 또는 삭제하는 기능을 제공합니다.
  * 지급 요청자가 승인 대기 중인 건을 효율적으로 반려 처리할 수 있습니다.
* **마일리지 소멸관리**
  * 적립 및 사용된 마일리지 목록을 제공하고, 수동으로 마일리지 소멸 처리를 할 수 있습니다.
  * 마일리지의 효율적인 활용을 위해 소멸 대상을 쉽게 확인하고 처리할 수 있습니다.
* **마일리지 집계 현황**
  * 마일리지 적립/사용 집계 현황을 제공하여 간편하게 마일리지의 전반적인 상태를 확인할 수 있습니다.
  * 자산 사용사유에 따른 상세 화면을 제공하여 마일리지의 효과적인 활용을 지원합니다.

## 프로세스 정의 — 마일리지 지급

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

{% stepper %}
{% step %}

### 지급정보 등록

새로운 마일리지 지급 정보를 등록하는 기능입니다. 지급명, 지급예정일자, 지급사유, 유효기간 등을 설정한 후 마일리지 지급 정보를 저장합니다.
{% endstep %}

{% step %}

### 지급 대상자 추가

회원기준으로 지급대상자 정보를 입력하고 추가하는 기능입니다. 회원번호와 지급예정금액 등을 입력하고 저장 처리 합니다.
{% endstep %}

{% step %}

### 엑셀 일괄 등록

일괄등록 엑셀 양식을 다운로드 하거나, 양식을 이용하여 지급대상자 정보를 일괄등록 하는 기능입니다. 업로드 성공 수와 실패 수를 노출합니다.
{% endstep %}

{% step %}

### n개 등록정보 일괄 처리

2개 이상의 등록정보를 일괄로 변경하는 기능입니다. 지급예정금액이나 담당자 메모, 재무 메모 등 입력한 항목만 일괄 업데이트 처리 합니다.
{% endstep %}

{% step %}

### 지급 목록 조회

마일리지 지급 목록을 조회하는 기능입니다. 지급일자, 지급사유, 담당자, 진행상태 등을 조건으로 조회합니다.
{% endstep %}

{% step %}

### 지급 승인 요청

마일리지 지급 승인요청을 하는 기능입니다. 다음 경우에만 승인요청이 가능합니다:

* 진행상태가 임시저장 상태
* 지급대상자가 1이상인 경우
* 지급대상금액이 1이상인 경우
  {% endstep %}

{% step %}

### 지급 승인 처리

마일리지 지급 승인을 하는 기능입니다. 진행상태가 승인대기 상태인 경우에만 지급 승인이 가능합니다. 요청자와 승인자가 같은 경우 승인처리를 진행할 수 없습니다.
{% endstep %}

{% step %}

### 지급 승인 반려

마일리지 지급 승인을 반려 하는 기능입니다. 진행상태가 승인대기 상태인 경우에만 지급 반려가 가능합니다.
{% endstep %}

{% step %}

### 마일리지 지급 배치

마일리지 지급 배치를 통해 마일리지 지급을 하는 기능입니다. 적립사유는 다음과 같습니다:

* 자산지급사유코드가 이벤트인 경우: 수기지지급-이벤트
* 자산지급사유코드가 클레임인 경우: 수기지지급-클레임
  {% endstep %}
  {% endstepper %}

## 프로세스 정의 — 마일리지 소멸

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

{% stepper %}
{% step %}

### 적립/소멸 조회

마일리지 적립/소멸 목록을 조회하는 기능입니다. 기준일자, 자산적립사용구분, 자산적립사용사유, 회원번호, 자산관리번호 등을 조건으로 조회합니다.
{% endstep %}

{% step %}

### 소멸 처리

마일리지 소멸을 처리하는 기능입니다. 다음과 같은 조건을 만족해야 마일리지 소멸이 진행됩니다:

* 소멸사유가 존재해야 합니다.
* 구분이 적립이어야 합니다.
* 잔액이 0보다 커야 합니다.

마일리지적립(소멸)사유코드는 "마이너스조정(기타사유)"입니다.
{% endstep %}
{% endstepper %}

## 프로세스 정의 — 마일리지 집계

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

{% stepper %}
{% step %}

### 적립/사용 조회

마일리지 적립 목록과 사용 목록을 조회하는 기능입니다. 마일리지 적립과 마일리지 사용 테이블을 분리 하여 표시합니다. 기준일자, 자산적립사용구분, 자산적립사용사유, 회원번호, 자산관리번호 등을 조건으로 조회합니다. 자산적립사용사유 기준으로 건수가 1개 이상인 사유만 노출합니다.
{% endstep %}

{% step %}

### 집계 요약

마일리지 집계 요약(적립 요약, 사용 요약)에 노출된 건수, 마일리지를 클릭했을 시 조회되는 기능입니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="132.333251953125">API</th><th width="305.22216796875">설명</th><th width="92.4444580078125">Server</th><th width="92.4443359375">메소드</th><th>비고</th></tr></thead><tbody><tr><td>마일리지 지급 관리 목록 조회</td><td>마일리지 지급 관리 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 관리 목록 건수 조회</td><td>마일리지 지급 목록의 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 관리 승인요청</td><td>마일리지 지급 관리 승인요청을 진행합니다.</td><td>BO</td><td>PATCH</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=milgPayRequestApproval">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 관리 승인</td><td>마일리지 지급 관리 승인을 진행합니다.</td><td>BO</td><td>PATCH</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 관리 반려 팝업 정보 조회</td><td>마일리지 지급 관리 반려 팝업 정보 조회를 진행합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayRejectPopupList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 관리 반려</td><td>마일리지 지급 관리 반려 처리를 진행합니다.</td><td>BO</td><td>PATCH</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=milgPayReject">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 관리 저장</td><td>마일리지 지급 목록과 자신지급내역정보 목록의 업데이트 정보를 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=milgPaySave">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급정보 조회</td><td>마일리지 지급정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayDetail">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급정보 등록/상세 저장</td><td>마일리지 지급 정보의 업데이트 내용을 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=saveMilgPayDtl">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급대상 회원 목록 조회</td><td>마일리지 지급대상 회원 목록을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayMbrInfoList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급대상 회원 목록 건수 조회</td><td>마일리지 지급대상 회원 목록 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgPayMbrInfoListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급대상 회원 그리드 저장</td><td>지급대상 회원 그리드 수정을 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=saveMilgPayGrid">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급대상자 추가 저장</td><td>마일리지 지급대상자를 추가 저장합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=saveMilgPayMbrInfo">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급대상자 일괄등록</td><td>지급대상자 일괄등록을 진행합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=getEventMgmtMemberCheckList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 대상자 일괄변경</td><td>마일리지 지급대상자를 일괄 변경합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=updateMilgPayMbrMany">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급상세 엑셀다운로드</td><td>마일리지 지급대상 엑셀다운로드를 진행합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=downLoadExcelPayMbrList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 지급 승인 처리</td><td>마일리지 지급대상 승인을 진행합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%80%EA%B8%89%20%EA%B4%80%EB%A6%AC&#x26;path=changeAstPayPrgsStatCd">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 내역 조회</td><td>마일리지 소멸 처리를 위한 내역을 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%86%8C%EB%A9%B8%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgEtctMgmtList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 내역 개수 조회</td><td>조회 조건 별 마일리지 내역 목록 전체 개수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%86%8C%EB%A9%B8%20%EA%B4%80%EB%A6%AC&#x26;path=getMilgEtctMgmtListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 수동 소멸 처리</td><td>지급된 마일리지를 수동으로 소멸처리 합니다.</td><td>BO</td><td>POST</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%86%8C%EB%A9%B8%20%EA%B4%80%EB%A6%AC&#x26;path=saveMilgExtct">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 집계 현황 사용 목록 조회</td><td>마일리지 집계 현황 사용 리스트 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%91%EA%B3%84%20%ED%98%84%ED%99%A9&#x26;path=getMilgStatusUseList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 집계 현황 사용 목록 건수 조회</td><td>마일리지 집계 현황 사용 리스트 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%91%EA%B3%84%20%ED%98%84%ED%99%A9&#x26;path=getMilgStatusUseListCount">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 집계 현황 적립 목록 조회</td><td>마일리지 집계 현황 적립 리스트 정보를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%91%EA%B3%84%20%ED%98%84%ED%99%A9&#x26;path=getMilgStatusAccumList">🔗API 확인하기 ></a></td></tr><tr><td>마일리지 집계 현황 적립 목록 건수 조회</td><td>마일리지 집계 현황 적립 리스트 건수를 조회합니다.</td><td>BO</td><td>GET</td><td><a href="https://apibo.x2bee.com/content?bo=marketing&#x26;depth=%EB%A7%88%EC%9D%BC%EB%A6%AC%EC%A7%80%20%EC%A7%91%EA%B3%84%20%ED%98%84%ED%99%A9&#x26;path=getMilgStatusAccumListCount">🔗API 확인하기 ></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="136.22216796875">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>지급예정일자</td><td>마일리지 지급 예정 일자를 말합니다.</td><td></td></tr><tr><td>지급완료일자</td><td>실제로 마일리지 지급이 완료 된 일자를 말합니다. <br>배치로 지급완료 날짜가 저장됩니다.</td><td></td></tr><tr><td>마일리지</td><td>물품 구매나 서비스 이용에 포인트를 적립하여 나중에 사용하게 하는 제도를 통칭하는 것입니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* 마일리지 지급은 배치를 이용하며, 배치는 지급요청일을 기준으로 데이터 처리를 하도록 되어있습니다.
* 마일리지 소멸 시 입력하는 메모에 기 등록된 메모가 존재하는 경우 text merge 처리합니다. 메모 구분자는 파이프라인 “|”입니다.
* 마일리지 집계 현황에 노출되는 상세 목록은 집계요약에 있는 건수와 마일리지를 클릭하였을 시 노출됩니다.
* 합계에 있는 건수와 마일리지를 클릭하였을 시에도 상세 목록이 노출됩니다.
* 마일리지 지급 관리의 버튼 활성조건은 다음과 같습니다.

<table><thead><tr><th>진행상태</th><th>버튼(활성조건)</th><th>-</th><th>-</th><th>-</th><th>수정기능</th><th data-hidden>구분</th></tr></thead><tbody><tr><td></td><td><strong>행삭제</strong></td><td><strong>승인요청</strong></td><td><strong>승인</strong></td><td><strong>반려</strong></td><td></td><td></td></tr><tr><td></td><td><strong>(요청자/승인자)</strong></td><td></td><td><strong>(승인자)</strong></td><td><strong>(승인자)</strong></td><td></td><td></td></tr><tr><td>임시저장</td><td>O</td><td>O</td><td>X</td><td>X</td><td>O</td><td>진 행 상 태</td></tr><tr><td>승인대기</td><td>X</td><td>X</td><td>O</td><td>O</td><td>X</td><td></td></tr><tr><td>반려</td><td>X</td><td>X</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>지급승인</td><td>X</td><td>X</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>지급완료</td><td>X</td><td>X</td><td>X</td><td>X</td><td>X</td><td></td></tr></tbody></table>