Mileage Expiration Management

Manual Mileage Expiration Processing

post

Function Description

Manually processes the expiration of paid mileage.

Detailed Description

Manually processes the expiration of mileage that was paid in error.

Revision History

Release v1.05_231204: Mileage accrual expiration processing

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Mileage Expiration Processing Request

astMgrSeqListstring[]Optional

Asset Management Sequence No. List

astMgrMemostringOptional

Expiration Reason

Responses

200

Success

No content

900

Business processing error details

*/*

post/v1/marketing/milgExtctMgmt/saveMilgExtct

POST /api/bo/v1/marketing/milgExtctMgmt/saveMilgExtct HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "astMgrSeqList": [
    "text"
  ],
  "astMgrMemo": "text"
}

No content

Retrieve Mileage History

get

Function Description

Retrieves mileage history.

Detailed Description

Retrieves mileage history for manual mileage expiration processing.
Retrieves mileage history matching the search conditions. The search conditions are as follows.
- Reference date
- Search type (All, Accrual, Usage)
- Member information (member name, member ID, member number)
- Asset management number

Revision History

Release v1.05_231204: Retrieve Mileage Accrual History
Release v2.00_240530: Changed date search query

Code Summary

Member information (mbrOpt): Member Name (NAME), Member ID (ID), Member Number (MBRNO)
Search type (condxAstRsrvUseGbOpt): All (ALL)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Success

*/*

astMgrSeqstringOptional

Asset Management Sequence No.

Example: 4369084

mbrNostringOptional

Member No.

Example: 100000390

mbrNmstringOptional

Member Name

Example: 홍*동

loginIdstringOptional

Example: tes****

astRsrvUseGbCdstringOptional

Asset Accrual/Usage Classification Code (ME016)

Example: 20

astRsrvUseGbNmstringOptional

Asset Accrual/Usage Type Code Name (ME016)

Example: 사용

astRsrvUseCausNmstringOptional

Asset Accrual/Usage Reason Code Name (ME020)

Example: 주문사용

astMgrNostringOptional

Asset Management No.

Example: 20231101O062955

ocurAmtnumberOptional

Amount Incurred

Example: -260000

balAmtnumberOptional

Remaining Amount

Example: 0

valiStrDtstringOptional

Validity Start Date

Example: 2023-11-01

valiEndDtstringOptional

Validity End Date

Example: 2023-11-01

astMgrMemostringOptional

Asset Management Memo

sysRegIdstringOptional

System Registrant ID

Example: 999999999

sysRegDtmstring · date-timeOptional

System Registration Date/Time

Example: 2023-11-01 09:04:53

sysModIdstringOptional

System Modifier ID

Example: 999999999

sysModDtmstring · date-timeOptional

System Modification Date/Time

Example: 2023-11-01 09:04:53

900

Business processing error details

*/*

get/v1/marketing/milgExtctMgmt/getMilgExtctMgmtList

GET /api/bo/v1/marketing/milgExtctMgmt/getMilgExtctMgmtList?milgExtctMgmtRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "astMgrSeq": 4369084,
    "mbrNo": 100000390,
    "mbrNm": "홍*동",
    "loginId": "tes****",
    "astRsrvUseGbCd": 20,
    "astRsrvUseGbNm": "사용",
    "astRsrvUseCausNm": "주문사용",
    "astMgrNo": "20231101O062955",
    "ocurAmt": -260000,
    "balAmt": 0,
    "valiStrDt": "2023-11-01",
    "valiEndDt": "2023-11-01",
    "astMgrMemo": "text",
    "sysRegId": 999999999,
    "sysRegDtm": "2023-11-01 09:04:53",
    "sysModId": 999999999,
    "sysModDtm": "2023-11-01 09:04:53"
  }
]

Retrieve Mileage History Count

get

Function Description

Retrieves the total count of the mileage history list.

Detailed Description

Retrieves the total count of the mileage history list by search condition.

Revision History

Release v1.05_231204: Retrieve mileage accrual history count
Release v2.00_240530: Changed date query

Code Reference

Member Information (mbrOpt) : Member Name (NAME), Member ID (ID), Member No. (MBRNO)
Search Type (condxAstRsrvUseGbOpt) : All (ALL)

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

Responses

200

Success

*/*

integer · int32Optional

900

Business processing error details

*/*

get/v1/marketing/milgExtctMgmt/getMilgExtctMgmtListCount

GET /api/bo/v1/marketing/milgExtctMgmt/getMilgExtctMgmtListCount?milgExtctMgmtRequest=[object+Object] HTTP/1.1
Host: api-bo.x2bee.com/
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

PreviousMileage Aggregation Status

NextMileage Payment Management