> 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/api-guides-en/back-office/marketing-bo/mileage-payment-expiration-management.md).

# Mileage Payment/Expiration Management

The Mileage Payment Management service provides the ability to grant mileage to customers and manage it efficiently. This lets the company increase customer loyalty and improve sales and profit. It also improves customer service quality by efficiently handling the mileage needed for claims or event marketing.

***

## Key Features

* **Mileage Payment Registration**
  * Registers new mileage payment information and efficiently pays out only the items approved by the approver.
  * Easily manages the members eligible for payment, and smoothly registers and verifies payment information.
* **Mileage Payment Target Member Management**
  * Provides the ability to look up the list of payment-target members and to add or delete new payment-target members.
  * Lets the payment requester efficiently reject items awaiting approval.
* **Mileage Expiration Management**
  * Provides a list of accrued and used mileage, and allows manual mileage expiration processing.
  * Makes it easy to check and process expiration targets for efficient mileage utilization.
* **Mileage Aggregate Status**
  * Provides an aggregate status of mileage accrual/usage so the overall mileage status can be checked at a glance.
  * Provides a detail screen by asset usage reason to support effective mileage utilization.

## Process Definition — Mileage Payment

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FxGGySY0gxjIznVFcDjcL%2F%E1%84%86%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%AF%E1%84%85%E1%85%B5%E1%84%8C%E1%85%B5%20%E1%84%8C%E1%85%B5%E1%84%80%E1%85%B3%E1%86%B8_%E1%84%89%E1%85%A9%E1%84%86%E1%85%A7%E1%86%AF.png?alt=media&#x26;token=f664f77c-838d-45cf-b0ab-0d2a5048d406" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Payment Information Registration

A function for registering new mileage payment information. Saves the mileage payment information after setting the payment name, scheduled payment date, payment reason, validity period, etc.
{% endstep %}

{% step %}

### Add Payment Target

A function for entering and adding payment target information on a per-member basis. Enters the member number and scheduled payment amount, etc., and saves them.
{% endstep %}

{% step %}

### Bulk Excel Registration

A function for downloading a bulk registration Excel template, or using the template to bulk-register payment target information. Displays the number of successful and failed uploads.
{% endstep %}

{% step %}

### Bulk Processing of N Registration Records

A function for bulk-changing two or more registration records at once. Only the entered fields, such as the scheduled payment amount, manager memo, or finance memo, are updated in bulk.
{% endstep %}

{% step %}

### Payment List Inquiry

A function for looking up the mileage payment list. Looks up using conditions such as payment date, payment reason, manager, and progress status.
{% endstep %}

{% step %}

### Payment Approval Request

A function for requesting mileage payment approval. Approval can only be requested when the following conditions are met:

* Progress status is temporarily saved
* Number of payment targets is 1 or more
* Payment target amount is 1 or more
  {% endstep %}

{% step %}

### Payment Approval Processing

A function for approving mileage payment. Payment can only be approved when the progress status is pending approval. If the requester and approver are the same person, approval processing cannot proceed.
{% endstep %}

{% step %}

### Payment Approval Rejection

A function for rejecting mileage payment approval. Payment can only be rejected when the progress status is pending approval.
{% endstep %}

{% step %}

### Mileage Payment Batch

A function that pays out mileage via a mileage payment batch. The accrual reasons are as follows:

* If the asset payment reason code is Event: Manual Payment - Event
* If the asset payment reason code is Claim: Manual Payment - Claim
  {% endstep %}
  {% endstepper %}

## Process Definition — Mileage Expiration

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FCpnFoB2gqFCo45fR2elD%2F%E1%84%86%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%AF%E1%84%85%E1%85%B5%E1%84%8C%E1%85%B5%20%E1%84%89%E1%85%A9%E1%84%86%E1%85%A7%E1%86%AF.png?alt=media&#x26;token=44f32eed-e361-4a37-9cae-91ee67b4d625" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Accrual/Expiration Inquiry

A function for looking up the mileage accrual/expiration list. Looks up using conditions such as reference date, asset accrual/usage classification, asset accrual/usage reason, member number, and asset management number.
{% endstep %}

{% step %}

### Expiration Processing

A function for processing mileage expiration. Mileage expiration proceeds only when the following conditions are met:

* An expiration reason must exist.
* The classification must be accrual.
* The balance must be greater than 0.

The mileage accrual (expiration) reason code is "Negative Adjustment (Other Reason)."
{% endstep %}
{% endstepper %}

## Process Definition — Mileage Aggregation

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FLUGGjzEZtg19WA79IUid%2F%E1%84%86%E1%85%A1%E1%84%8B%E1%85%B5%E1%86%AF%E1%84%85%E1%85%B5%E1%84%8C%E1%85%B5%20%E1%84%8C%E1%85%B5%E1%86%B8%E1%84%80%E1%85%A8.png?alt=media&#x26;token=2553ae1f-3292-4c23-b00c-cf9f2e4326b6" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Accrual/Usage Inquiry

A function for looking up the mileage accrual list and usage list. Displays the mileage accrual and mileage usage tables separately. Looks up using conditions such as reference date, asset accrual/usage classification, asset accrual/usage reason, member number, and asset management number. Only reasons with 1 or more records, based on the asset accrual/usage reason, are displayed.
{% endstep %}

{% step %}

### Aggregate Summary

A function that, when you click the count or mileage shown in the mileage aggregate summary (accrual summary, usage summary), looks up the corresponding detail.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="132.333251953125">API</th><th width="305.22216796875">Description</th><th width="92.4444580078125">Server</th><th width="92.4443359375">Method</th><th>Notes</th></tr></thead><tbody><tr><td>Mileage Payment Management List Inquiry</td><td>Looks up mileage payment management information.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Management List Count Inquiry</td><td>Looks up the count of the mileage payment list.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Management Approval Request</td><td>Requests approval for mileage payment management.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Management Approval</td><td>Processes approval for mileage payment management.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Management Rejection Popup Information Inquiry</td><td>Looks up the mileage payment management rejection popup information.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Management Rejection</td><td>Processes rejection of mileage payment management.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Management Save</td><td>Saves updates to the mileage payment list and asset payment detail information list.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Information Inquiry</td><td>Looks up mileage payment information.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Information Registration/Detail Save</td><td>Saves updated content for mileage payment information.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Target Member List Inquiry</td><td>Looks up the mileage payment target member list.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Target Member List Count Inquiry</td><td>Looks up the count of the mileage payment target member list.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Target Member Grid Save</td><td>Saves edits to the payment target member grid.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Target Addition Save</td><td>Adds and saves a mileage payment target.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Target Bulk Registration</td><td>Performs bulk registration of payment targets.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Target Bulk Update</td><td>Performs bulk updates of mileage payment targets.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Detail Excel Download</td><td>Performs an Excel download of the mileage payment target.</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">🔗View API ></a></td></tr><tr><td>Mileage Payment Approval Processing</td><td>Processes approval of the mileage payment target.</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">🔗View API ></a></td></tr><tr><td>Mileage History Inquiry</td><td>Looks up the history for mileage expiration processing.</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">🔗View API ></a></td></tr><tr><td>Mileage History Count Inquiry</td><td>Looks up the total count of the mileage history list by search condition.</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">🔗View API ></a></td></tr><tr><td>Mileage Manual Expiration Processing</td><td>Manually processes the expiration of paid mileage.</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">🔗View API ></a></td></tr><tr><td>Mileage Aggregate Status Usage List Inquiry</td><td>Looks up the mileage aggregate status usage list information.</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">🔗View API ></a></td></tr><tr><td>Mileage Aggregate Status Usage List Count Inquiry</td><td>Looks up the mileage aggregate status usage list count.</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">🔗View API ></a></td></tr><tr><td>Mileage Aggregate Status Accrual List Inquiry</td><td>Looks up the mileage aggregate status accrual list information.</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">🔗View API ></a></td></tr><tr><td>Mileage Aggregate Status Accrual List Count Inquiry</td><td>Looks up the mileage aggregate status accrual list count.</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">🔗View API ></a></td></tr></tbody></table>

## Terminology

<table><thead><tr><th width="136.22216796875">Term</th><th>Description</th><th data-hidden>Notes</th></tr></thead><tbody><tr><td>Scheduled Payment Date</td><td>The scheduled date on which mileage will be paid.</td><td></td></tr><tr><td>Payment Completion Date</td><td>The date on which mileage payment was actually completed.<br>The payment completion date is saved by the batch.</td><td></td></tr><tr><td>Mileage</td><td>A general term for a system in which points are accrued from purchasing goods or using services, to be used later.</td><td></td></tr></tbody></table>

## Other Notes

* Mileage payment uses a batch, and the batch is designed to process data based on the payment request date.
* When entering a memo during mileage expiration, if a memo already exists, the memos are merged as text. The memo delimiter is the pipe character “|”.
* The detail list shown in the mileage aggregate status is displayed when you click the count or mileage in the aggregate summary.
* The detail list is also displayed when you click the count or mileage shown in the totals.
* The button activation conditions for mileage payment management are as follows.

<table><thead><tr><th>Progress Status</th><th>Button (Activation Condition)</th><th>-</th><th>-</th><th>-</th><th>Edit Function</th><th data-hidden>Classification</th></tr></thead><tbody><tr><td></td><td><strong>Delete Row</strong></td><td><strong>Request Approval</strong></td><td><strong>Approve</strong></td><td><strong>Reject</strong></td><td></td><td></td></tr><tr><td></td><td><strong>(Requester/Approver)</strong></td><td></td><td><strong>(Approver)</strong></td><td><strong>(Approver)</strong></td><td></td><td></td></tr><tr><td>Temporarily Saved</td><td>O</td><td>O</td><td>X</td><td>X</td><td>O</td><td>Progress Status</td></tr><tr><td>Pending Approval</td><td>X</td><td>X</td><td>O</td><td>O</td><td>X</td><td></td></tr><tr><td>Rejected</td><td>X</td><td>X</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>Payment Approved</td><td>X</td><td>X</td><td>X</td><td>X</td><td>X</td><td></td></tr><tr><td>Payment Completed</td><td>X</td><td>X</td><td>X</td><td>X</td><td>X</td><td></td></tr></tbody></table>