> 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/api-en/back-office-api-reference/marketing-bo-api/mileage-payment-management.md).
# Mileage Payment Management
## Bulk Change of Mileage Payment Recipients
> \## Function Description\
> \* Mileage Payment Registration/Detail - Bulk Change of Recipients\
> \---\
> \## Detailed Description\
> \* If the expected payment amount, manager memo, or finance memo values are missing, the corresponding column is not changed.\
> \* Changes are only possible when the payment information's progress status is 'Temporary Save'.\
> \* Permission: Both the requester and the approver can perform this action.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrUpdateRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/updateMilgPayMbrMany":{"post":{"tags":["Mileage Payment Management"],"summary":"Bulk Change of Mileage Payment Recipients","description":"## Function Description\n* Mileage Payment Registration/Detail - Bulk Change of Recipients\n---\n## Detailed Description\n* If the expected payment amount, manager memo, or finance memo values are missing, the corresponding column is not changed.\n* Changes are only possible when the payment information's progress status is 'Temporary Save'.\n* Permission: Both the requester and the approver can perform this action.\n---\n","operationId":"updateMilgPayMbrMany","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayMbrUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Bulk Registration of Mileage Payment Recipients
> \## Function Description\
> \* Mileage Payment Registration/Detail - Bulk registration of payment recipients.\
> \---\
> \## Detailed Description\
> \* Registration is only possible when the payment information's progress status is 'Temporary Save'.\
> \* Bulk registration proceeds only for data whose recipient verification succeeded.\
> \* Performs revalidation, and if recipient registration fails, generates a message.\
> \* Failures occur in the following cases:\
> \* When the member already exists in the payment information\
> \* When the member information does not exist in the member table\
> \* When the member ID found by the member number differs from the entered member ID\
> \* When the expected payment amount (payFcstAmt) is not entered\
> \* When the member number (mbrNo) is not entered\
> \* Permission: Both the requester and the approver can perform this action.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"ordNo":{"type":"string","description":"Order No."},"aempMemo":{"type":"string","description":"Person in Charge Memo"},"finMemo":{"type":"string","description":"Finance Memo"}}},"ResponseListMilgPayDtlGridResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"array","description":"payload","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"ordNo":{"type":"string","description":"Related Order No."},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"successYn":{"type":"string","description":"Success Status"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"},"aplyYn":{"type":"string","description":"Application Status"},"failCont":{"type":"string","description":"Failure Reason"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/marketing/milgPayMgmt/saveMilgPayMbrInfoList":{"post":{"tags":["Mileage Payment Management"],"summary":"Bulk Registration of Mileage Payment Recipients","description":"## Function Description\n* Mileage Payment Registration/Detail - Bulk registration of payment recipients.\n---\n## Detailed Description\n* Registration is only possible when the payment information's progress status is 'Temporary Save'.\n* Bulk registration proceeds only for data whose recipient verification succeeded.\n* Performs revalidation, and if recipient registration fails, generates a message.\n* Failures occur in the following cases:\n * When the member already exists in the payment information\n * When the member information does not exist in the member table\n * When the member ID found by the member number differs from the entered member ID\n * When the expected payment amount (payFcstAmt) is not entered\n * When the member number (mbrNo) is not entered\n* Permission: Both the requester and the approver can perform this action.\n---\n","operationId":"saveMilgPayMbrInfoList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"Member Retrieved Successfully","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListMilgPayDtlGridResponse"}}}},"400":{"description":"Member Save Failure","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Mileage Payment Registration/Details
> \## Function Description\
> \* Saves mileage payment information.\
> \---\
> \## Detailed Description\
> \* Registers only the basic information among the mileage payment information.\
> \* The following validation checks apply:\
> \* The expected payment date cannot be a past date.\
> \* When the validity period is in 'days', the entered value cannot exceed '730'.\
> \* When the validity period is in 'months', the entered value cannot exceed '24'.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"astPayNm":{"type":"string","description":"Asset Payment Name"},"astGbCd":{"type":"string","description":"Asset Type Code (ME015)"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"astPayCausCd":{"type":"string","description":"Asset Payment Reason Code (ME011)"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"valiTermGbCd":{"type":"string","description":"Validity Period Classification Code (ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Request Received Date and Time"},"cnfrConts":{"type":"string","description":"Approval Request Details"},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"delYn":{"type":"string","description":"Deletion Status"}}},"ResponseString":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"string","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/marketing/milgPayMgmt/saveMilgPayDtl":{"post":{"tags":["Mileage Payment Management"],"summary":"Save Mileage Payment Registration/Details","description":"## Function Description\n* Saves mileage payment information.\n---\n## Detailed Description\n* Registers only the basic information among the mileage payment information.\n* The following validation checks apply:\n * The expected payment date cannot be a past date.\n * When the validity period is in 'days', the entered value cannot exceed '730'.\n * When the validity period is in 'months', the entered value cannot exceed '24'.\n---\n","operationId":"saveMilgPayDtl","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Manual Mileage Expiration Processing
> \## Function Description\
> \* Manually processes the expiration of paid mileage.\
> \---\
> \## Detailed Description\
> \* Manually processes the expiration of mileage that was paid in error.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctValidateRequestV2":{"type":"object","description":"Mileage Expiration Processing Grid Request","properties":{"astMgrSeq":{"type":"string","description":"Asset Management Sequence No."},"condxAstMgrMemo":{"type":"string","description":"Expiration Reason"},"astRsrvUseGbCd":{"type":"string","description":"Accrual/Usage Classification Code (ME016)"},"balAmt":{"type":"number","description":"Balance"},"astMgrSeqList":{"type":"array","description":"Asset Management Sequence No. List for API-BO Transfer","items":{"type":"string"}},"astMgrMemo":{"type":"string","description":"Expiration Reason for API-BO Transfer"}}},"JSONResponseEntityVoid":{"type":"object","properties":{"message":{"type":"string"},"data":{},"succeeded":{"type":"boolean"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/saveMilgExtct":{"post":{"tags":["Mileage Payment Management"],"summary":"Manual Mileage Expiration Processing","description":"## Function Description\n* Manually processes the expiration of paid mileage.\n---\n## Detailed Description\n* Manually processes the expiration of mileage that was paid in error.\n---\n","operationId":"saveMilgExtct","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgExtctValidateRequestV2"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/JSONResponseEntityVoid"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Mileage Payment Management
> \## Function Description\
> \* Saves the update information for the mileage payment list and the asset payment history info list.\
> \---\
> \## Detailed Description\
> \* Updates the deletion status of the mileage payment list and deletes the asset payment history info list.\
> \* The following validation checks apply:\
> \* Can be processed one record at a time.\
> \* Deletion is processed only when the progress status is Temporary Save.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestMilgPayGridSaveRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}}}},"MilgPayGridSaveRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"sysModId":{"type":"string","description":"System Modifier ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgPaySave":{"post":{"tags":["Mileage Payment Management"],"summary":"Save Mileage Payment Management","description":"## Function Description\n* Saves the update information for the mileage payment list and the asset payment history info list.\n---\n## Detailed Description\n* Updates the deletion status of the mileage payment list and deletes the asset payment history info list.\n* The following validation checks apply:\n * Can be processed one record at a time.\n * Deletion is processed only when the progress status is Temporary Save.\n---\n","operationId":"milgPaySave","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestMilgPayGridSaveRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Request Approval for Mileage Payment Management
> \## Function Description\
> \* Requests approval for mileage payment management.\
> \---\
> \## Detailed Description\
> \* Requests approval for mileage payment management.\
> \* The following validation checks apply.\
> \* Approval requests are processed only when the progress status is Temporarily Saved.\
> \* Approval requests are processed only when there is 1 or more payment recipient.\
> \* Approval requests are processed only when the payment target amount is 1 or more.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayUpdateRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"aprvReqmnId":{"type":"string","description":"Approval Requester ID"},"sysModId":{"type":"string","description":"System Modifier ID"},"aprmnId":{"type":"string","description":"Approver ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgPayRequestApproval":{"post":{"tags":["Mileage Payment Management"],"summary":"Request Approval for Mileage Payment Management","description":"## Function Description\n* Requests approval for mileage payment management.\n---\n## Detailed Description\n* Requests approval for mileage payment management.\n* The following validation checks apply.\n * Approval requests are processed only when the progress status is Temporarily Saved.\n * Approval requests are processed only when there is 1 or more payment recipient.\n * Approval requests are processed only when the payment target amount is 1 or more.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"milgPayRequestApproval","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Reject Mileage Payment Management
> \## Function Description\
> \* Processes the rejection of mileage payment management.\
> \---\
> \## Detailed Description\
> \* Processes the rejection of mileage payment management.\
> \* The following validation checks apply:\
> \* Rejection is processed only when the progress status is Pending Approval.
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayRejectUpdateRequest":{"type":"object","properties":{"sysModId":{"type":"string","description":"System Modifier ID"},"astPayNo":{"type":"string","description":"Payout No."},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"retnProcmnId":{"type":"string","description":"Rejection Processor ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgPayReject":{"post":{"tags":["Mileage Payment Management"],"summary":"Reject Mileage Payment Management","description":"## Function Description\n* Processes the rejection of mileage payment management.\n---\n## Detailed Description\n* Processes the rejection of mileage payment management.\n* The following validation checks apply:\n * Rejection is processed only when the progress status is Pending Approval.\n","operationId":"milgPayReject","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayRejectUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Approve Mileage Payment Management
> \## Function Description\
> \* Approves mileage payment management.\
> \---\
> \## Detailed Description\
> \* Approves mileage payment management.\
> \* The following validation checks apply.\
> \* Only one item can be processed at a time.\
> \* Approval is processed only when the progress status is Pending Approval.\
> \* Approval is processed only when the requester ID and approver ID are not the same.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayUpdateRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"aprvReqmnId":{"type":"string","description":"Approval Requester ID"},"sysModId":{"type":"string","description":"System Modifier ID"},"aprmnId":{"type":"string","description":"Approver ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgPayApproval":{"post":{"tags":["Mileage Payment Management"],"summary":"Approve Mileage Payment Management","description":"## Function Description\n* Approves mileage payment management.\n---\n## Detailed Description\n* Approves mileage payment management.\n* The following validation checks apply.\n * Only one item can be processed at a time.\n * Approval is processed only when the progress status is Pending Approval.\n * Approval is processed only when the requester ID and approver ID are not the same.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"milgPayApproval","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Validate Mileage Payment Recipients
> \## Function Description\
> \* Validates the upload data for bulk registration of payment recipients in Mileage Payment Registration/Details.\
> \---\
> \## Detailed Description\
> \* If recipient validation fails, the corresponding failure message is displayed.\
> \* Failures occur in the following cases\
> \* The member already exists in the payment information\
> \* The member information does not exist in the member table\
> \* The member ID retrieved by the member number differs from the entered member ID\
> \* The scheduled payment amount (payFcstAmt) is not entered\
> \* The member number (mbrNo) is not entered\
> \* Permission: Available to both requesters and approvers.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"ordNo":{"type":"string","description":"Order No."},"aempMemo":{"type":"string","description":"Person in Charge Memo"},"finMemo":{"type":"string","description":"Finance Memo"}}},"ResponseMilgPayDtlValidResponse":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"$ref":"#/components/schemas/MilgPayDtlValidResponse","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"MilgPayDtlValidResponse":{"type":"object","properties":{"milgPayDtlSucsList":{"type":"array","description":"Validation Success List","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}},"milgPayDtlFailList":{"type":"array","description":"Validation Failure List","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}},"totCnt":{"type":"integer","format":"int32","description":"Total Count"},"sucsCnt":{"type":"integer","format":"int32","description":"Success Count"},"failCnt":{"type":"integer","format":"int32","description":"Failure Count"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"ordNo":{"type":"string","description":"Related Order No."},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"successYn":{"type":"string","description":"Success Status"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"},"aplyYn":{"type":"string","description":"Application Status"},"failCont":{"type":"string","description":"Failure Reason"}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}}}},"paths":{"/v2/marketing/milgPayMgmt/getMilgPayMbrValidList":{"post":{"tags":["Mileage Payment Management"],"summary":"Validate Mileage Payment Recipients","description":"## Function Description\n* Validates the upload data for bulk registration of payment recipients in Mileage Payment Registration/Details.\n---\n## Detailed Description\n* If recipient validation fails, the corresponding failure message is displayed.\n* Failures occur in the following cases\n * The member already exists in the payment information\n * The member information does not exist in the member table\n * The member ID retrieved by the member number differs from the entered member ID\n * The scheduled payment amount (payFcstAmt) is not entered\n * The member number (mbrNo) is not entered\n* Permission: Available to both requesters and approvers.\n---\n","operationId":"getMilgPayMbrInfoList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"Member Validation Succeeded","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMilgPayDtlValidResponse"}}}},"900":{"description":"Member Validation Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Validate Mileage Payment Recipients
> \## Function Description\
> \* Validates the upload data for bulk registration of payment recipients in Mileage Payment Registration/Details.\
> \---\
> \## Detailed Description\
> \* If recipient validation fails, the corresponding failure message is displayed.\
> \* Failures occur in the following cases\
> \* The member already exists in the payment information\
> \* The member information does not exist in the member table\
> \* The member ID retrieved by the member number differs from the entered member ID\
> \* The scheduled payment amount (payFcstAmt) is not entered\
> \* The member number (mbrNo) is not entered\
> \* Permission: Available to both requesters and approvers.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"ordNo":{"type":"string","description":"Order No."},"aempMemo":{"type":"string","description":"Person in Charge Memo"},"finMemo":{"type":"string","description":"Finance Memo"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"ordNo":{"type":"string","description":"Related Order No."},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"successYn":{"type":"string","description":"Success Status"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"},"aplyYn":{"type":"string","description":"Application Status"},"failCont":{"type":"string","description":"Failure Reason"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/getMilgPayMbrCheckList":{"post":{"tags":["Mileage Payment Management"],"summary":"Validate Mileage Payment Recipients","description":"## Function Description\n* Validates the upload data for bulk registration of payment recipients in Mileage Payment Registration/Details.\n---\n## Detailed Description\n* If recipient validation fails, the corresponding failure message is displayed.\n* Failures occur in the following cases\n * The member already exists in the payment information\n * The member information does not exist in the member table\n * The member ID retrieved by the member number differs from the entered member ID\n * The scheduled payment amount (payFcstAmt) is not entered\n * The member number (mbrNo) is not entered\n* Permission: Available to both requesters and approvers.\n---\n","operationId":"getEventMgmtMemberCheckList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"Member Validation Succeeded","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}}},"900":{"description":"Member Validation Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Mileage Payment Approval Processing
> \## Function Description\
> \* Mileage payment approval processing\
> \---\
> \## Detailed Description\
> \* \*\*Asset Management No. (astPayNo)\*\* is required.\
> \* \*\*Asset Payment Progress Status Code (astPayPrgsStatCd)\*\* is required.\
> \* Approves mileage in Pending Approval status from the mileage payment detail\
> \* Permission: Only the approver can perform this action.\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"astPayNm":{"type":"string","description":"Asset Payment Name"},"astGbCd":{"type":"string","description":"Asset Type Code (ME015)"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"astPayCausCd":{"type":"string","description":"Asset Payment Reason Code (ME011)"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"valiTermGbCd":{"type":"string","description":"Validity Period Classification Code (ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Request Received Date and Time"},"cnfrConts":{"type":"string","description":"Approval Request Details"},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"delYn":{"type":"string","description":"Deletion Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/changeAstPayPrgsStatCd":{"post":{"tags":["Mileage Payment Management"],"summary":"Mileage Payment Approval Processing","description":"## Function Description\n* Mileage payment approval processing\n---\n## Detailed Description\n* **Asset Management No. (astPayNo)** is required.\n* **Asset Payment Progress Status Code (astPayPrgsStatCd)** is required.\n* Approves mileage in Pending Approval status from the mileage payment detail\n* Permission: Only the approver can perform this action.\n---\n","operationId":"changeAstPayPrgsStatCd","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Bulk Change of Mileage Payment Recipients
> \## Function Description\
> \* Mileage Payment Registration/Detail - Bulk Change of Recipients\
> \---\
> \## Detailed Description\
> \* If the expected payment amount, manager memo, or finance memo values are missing, the corresponding column is not changed.\
> \* Changes are only possible when the payment information's progress status is 'Temporary Save'.\
> \* Permission: Both the requester and the approver can perform this action.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrUpdateRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"mbrNoList":{"type":"array","description":"Member No. List","items":{"type":"string"}}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/updateMilgPayMbrMany":{"post":{"tags":["Mileage Payment Management"],"summary":"Bulk Change of Mileage Payment Recipients","description":"## Function Description\n* Mileage Payment Registration/Detail - Bulk Change of Recipients\n---\n## Detailed Description\n* If the expected payment amount, manager memo, or finance memo values are missing, the corresponding column is not changed.\n* Changes are only possible when the payment information's progress status is 'Temporary Save'.\n* Permission: Both the requester and the approver can perform this action.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"updateMilgPayMbrMany_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayMbrUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Additional Mileage Payment Recipient
> \## Function Description\
> \* Mileage Payment Registration/Detail - Saves an additional payment recipient.\
> \---\
> \## Detailed Description\
> \* \*\*Asset Payment No. (astPayNo)\*\* and \*\*Expected Payment Amount (payFcstAmt)\*\* are required values.\
> \* Saving is only possible when the payment information's progress status is 'Temporary Save'.\
> \* Registration is not allowed if the same member already exists in the payment information.\
> \* Permission: Both the requester and the approver can perform this action.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"ordNo":{"type":"string","description":"Order No."},"aempMemo":{"type":"string","description":"Person in Charge Memo"},"finMemo":{"type":"string","description":"Finance Memo"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/saveMilgPayMbrInfo":{"post":{"tags":["Mileage Payment Management"],"summary":"Save Additional Mileage Payment Recipient","description":"## Function Description\n* Mileage Payment Registration/Detail - Saves an additional payment recipient.\n---\n## Detailed Description\n* **Asset Payment No. (astPayNo)** and **Expected Payment Amount (payFcstAmt)** are required values.\n* Saving is only possible when the payment information's progress status is 'Temporary Save'.\n* Registration is not allowed if the same member already exists in the payment information.\n* Permission: Both the requester and the approver can perform this action.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"saveMilgPayMbrInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Mileage Payment Recipient Member Grid
> \## Function Description\
> \* Mileage Payment Registration/Detail - Saves the payment recipient member grid\
> \---\
> \## Detailed Description\
> \* Updates the deletion status of payment recipient members and deletes the recipient list.\
> \* Saving is only possible when the payment information's progress status is 'Temporary Save'.\
> \* Permission: Both the requester and the approver can perform this action.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestMilgPayMbrRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"MilgPayMbrRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"ordNo":{"type":"string","description":"Order No."},"aempMemo":{"type":"string","description":"Person in Charge Memo"},"finMemo":{"type":"string","description":"Finance Memo"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/saveMilgPayGrid":{"post":{"tags":["Mileage Payment Management"],"summary":"Save Mileage Payment Recipient Member Grid","description":"## Function Description\n* Mileage Payment Registration/Detail - Saves the payment recipient member grid\n---\n## Detailed Description\n* Updates the deletion status of payment recipient members and deletes the recipient list.\n* Saving is only possible when the payment information's progress status is 'Temporary Save'.\n* Permission: Both the requester and the approver can perform this action.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"saveMilgPayGrid","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestMilgPayMbrRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Mileage Payment Registration/Details
> \## Function Description\
> \* Saves mileage payment information.\
> \---\
> \## Detailed Description\
> \* Registers only the basic information among the mileage payment information.\
> \* The following validation checks apply:\
> \* The expected payment date cannot be a past date.\
> \* When the validity period is in 'days', the entered value cannot exceed '730'.\
> \* When the validity period is in 'months', the entered value cannot exceed '24'.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"astPayNm":{"type":"string","description":"Asset Payment Name"},"astGbCd":{"type":"string","description":"Asset Type Code (ME015)"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"astPayCausCd":{"type":"string","description":"Asset Payment Reason Code (ME011)"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"valiTermGbCd":{"type":"string","description":"Validity Period Classification Code (ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Request Received Date and Time"},"cnfrConts":{"type":"string","description":"Approval Request Details"},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"delYn":{"type":"string","description":"Deletion Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/saveMilgPayDtl":{"post":{"tags":["Mileage Payment Management"],"summary":"Save Mileage Payment Registration/Details","description":"## Function Description\n* Saves mileage payment information.\n---\n## Detailed Description\n* Registers only the basic information among the mileage payment information.\n* The following validation checks apply:\n * The expected payment date cannot be a past date.\n * When the validity period is in 'days', the entered value cannot exceed '730'.\n * When the validity period is in 'months', the entered value cannot exceed '24'.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"saveMilgPayDtl_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Save Mileage Payment Management
> \## Function Description\
> \* Saves the update information for the mileage payment list and the asset payment history info list.\
> \---\
> \## Detailed Description\
> \* Updates the deletion status of the mileage payment list and deletes the asset payment history info list.\
> \* The following validation checks apply:\
> \* Can be processed one record at a time.\
> \* Deletion is processed only when the progress status is Temporary Save.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridCUDRequestMilgPayGridSaveRequest":{"type":"object","properties":{"all":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}},"create":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}},"update":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}},"delete":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridSaveRequest"}}}},"MilgPayGridSaveRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"sysModId":{"type":"string","description":"System Modifier ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPaySave":{"post":{"tags":["Mileage Payment Management"],"summary":"Save Mileage Payment Management","description":"## Function Description\n* Saves the update information for the mileage payment list and the asset payment history info list.\n---\n## Detailed Description\n* Updates the deletion status of the mileage payment list and deletes the asset payment history info list.\n* The following validation checks apply:\n * Can be processed one record at a time.\n * Deletion is processed only when the progress status is Temporary Save.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"milgPaySave_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestMilgPayGridSaveRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Bulk Registration of Mileage Payment Recipients
> \## Function Description\
> \* Mileage Payment Registration/Detail - Bulk registration of payment recipients.\
> \---\
> \## Detailed Description\
> \* Registration is only possible when the payment information's progress status is 'Temporary Save'.\
> \* If recipient registration fails, displays the failure message for that case.\
> \* Failures occur in the following cases:\
> \* When the member already exists in the payment information\
> \* When the member information does not exist in the member table\
> \* When the member ID found by the member number differs from the entered member ID\
> \* When the expected payment amount (payFcstAmt) is not entered\
> \* When the member number (mbrNo) is not entered\
> \* Permission: Both the requester and the approver can perform this action.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayMbrRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"ordNo":{"type":"string","description":"Order No."},"aempMemo":{"type":"string","description":"Person in Charge Memo"},"finMemo":{"type":"string","description":"Finance Memo"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"ordNo":{"type":"string","description":"Related Order No."},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"successYn":{"type":"string","description":"Success Status"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"},"aplyYn":{"type":"string","description":"Application Status"},"failCont":{"type":"string","description":"Failure Reason"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/getMilgPayMbrCheckList":{"post":{"tags":["Mileage Payment Management"],"summary":"Bulk Registration of Mileage Payment Recipients","description":"## Function Description\n* Mileage Payment Registration/Detail - Bulk registration of payment recipients.\n---\n## Detailed Description\n* Registration is only possible when the payment information's progress status is 'Temporary Save'.\n* If recipient registration fails, displays the failure message for that case.\n* Failures occur in the following cases:\n * When the member already exists in the payment information\n * When the member information does not exist in the member table\n * When the member ID found by the member number differs from the entered member ID\n * When the expected payment amount (payFcstAmt) is not entered\n * When the member number (mbrNo) is not entered\n* Permission: Both the requester and the approver can perform this action.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"getEventMgmtMemberCheckList_1","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"Member Retrieved Successfully","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}}},"900":{"description":"Member Retrieval Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Mileage Payment Approval Processing
> \## Function Description\
> \* Mileage payment approval processing\
> \---\
> \## Detailed Description\
> \* \*\*Asset Management No. (astPayNo)\*\* is required.\
> \* \*\*Asset Payment Progress Status Code (astPayPrgsStatCd)\*\* is required.\
> \* Approves mileage in Pending Approval status from the mileage payment detail\
> \* Permission: Only the approver can perform this action.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage payment management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"astPayNm":{"type":"string","description":"Asset Payment Name"},"astGbCd":{"type":"string","description":"Asset Type Code (ME015)"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"astPayCausCd":{"type":"string","description":"Asset Payment Reason Code (ME011)"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"valiTermGbCd":{"type":"string","description":"Validity Period Classification Code (ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Request Received Date and Time"},"cnfrConts":{"type":"string","description":"Approval Request Details"},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"delYn":{"type":"string","description":"Deletion Status"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/changeAstPayPrgsStatCd":{"post":{"tags":["Mileage Payment Management"],"summary":"Mileage Payment Approval Processing","description":"## Function Description\n* Mileage payment approval processing\n---\n## Detailed Description\n* **Asset Management No. (astPayNo)** is required.\n* **Asset Payment Progress Status Code (astPayPrgsStatCd)** is required.\n* Approves mileage in Pending Approval status from the mileage payment detail\n* Permission: Only the approver can perform this action.\n---\n## Revision History\n* Release v1.05_231204 : Mileage payment management\n","operationId":"changeAstPayPrgsStatCd_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"Success"},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Request Approval for Mileage Payment Management
> \## Function Description\
> \* Requests approval for mileage payment management.\
> \---\
> \## Detailed Description\
> \* Requests approval for mileage payment management.\
> \* The following validation checks apply.\
> \* Approval requests are processed only when the progress status is Temporarily Saved.\
> \* Approval requests are processed only when there is 1 or more payment recipient.\
> \* Approval requests are processed only when the payment target amount is 1 or more.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayUpdateRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"aprvReqmnId":{"type":"string","description":"Approval Requester ID"},"sysModId":{"type":"string","description":"System Modifier ID"},"aprmnId":{"type":"string","description":"Approver ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPayRequestApproval":{"patch":{"tags":["Mileage Payment Management"],"summary":"Request Approval for Mileage Payment Management","description":"## Function Description\n* Requests approval for mileage payment management.\n---\n## Detailed Description\n* Requests approval for mileage payment management.\n* The following validation checks apply.\n * Approval requests are processed only when the progress status is Temporarily Saved.\n * Approval requests are processed only when there is 1 or more payment recipient.\n * Approval requests are processed only when the payment target amount is 1 or more.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"milgPayRequestApproval_1","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Reject Mileage Payment Management
> \## Function Description\
> \* Processes rejection for Mileage Payment Management.\
> \---\
> \## Detailed Description\
> \* Processes rejection for Mileage Payment Management.\
> \* The following validation check applies:\
> \* Rejection is only processed when the progress status is pending approval.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayRejectUpdateRequest":{"type":"object","properties":{"sysModId":{"type":"string","description":"System Modifier ID"},"astPayNo":{"type":"string","description":"Payout No."},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"retnProcmnId":{"type":"string","description":"Rejection Processor ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPayReject":{"patch":{"tags":["Mileage Payment Management"],"summary":"Reject Mileage Payment Management","description":"## Function Description\n* Processes rejection for Mileage Payment Management.\n---\n## Detailed Description\n* Processes rejection for Mileage Payment Management.\n* The following validation check applies:\n * Rejection is only processed when the progress status is pending approval.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"milgPayReject_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayRejectUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Approve Mileage Payment Management
> \## Function Description\
> \* Approves mileage payment management.\
> \---\
> \## Detailed Description\
> \* Approves mileage payment management.\
> \* The following validation checks apply.\
> \* Only one item can be processed at a time.\
> \* Approval is processed only when the progress status is Pending Approval.\
> \* Approval is processed only when the requester ID and approver ID are not the same.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayUpdateRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"aprvReqmnId":{"type":"string","description":"Approval Requester ID"},"sysModId":{"type":"string","description":"System Modifier ID"},"aprmnId":{"type":"string","description":"Approver ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPayApproval":{"patch":{"tags":["Mileage Payment Management"],"summary":"Approve Mileage Payment Management","description":"## Function Description\n* Approves mileage payment management.\n---\n## Detailed Description\n* Approves mileage payment management.\n* The following validation checks apply.\n * Only one item can be processed at a time.\n * Approval is processed only when the progress status is Pending Approval.\n * Approval is processed only when the requester ID and approver ID are not the same.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"milgPayApproval_1","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Aggregate Usage Status List
> \## Function Description\
> \* Retrieves the Mileage Aggregation Status usage list information.\
> \---\
> \## Detailed Description\
> \* Retrieves the Mileage Aggregation Status usage list information matching the search conditions. The search conditions are as follows:\
> \* Start date\
> \* End date\
> \* Asset accrual/usage type\
> \* Asset accrual/usage reason\
> \* Member information\
> \* Asset management No.\
> \---\
> \### Code Reference\
> \* Member Information (mbrOpt): Member Name (NAME), Member ID (ID), Member No. (MBRNO)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgStatusGridReadRequest":{"type":"object","properties":{"startDate":{"type":"string","format":"date","description":"Start Date"},"endDate":{"type":"string","format":"date","description":"End Date"},"astRsrvUseGbCd":{"type":"string","description":"Asset Accrual/Usage Classification Code"},"astRsrvUseCausCd":{"type":"string","description":"Asset Accrual/Usage Reason Code"},"astMgrNo":{"type":"string","description":"Asset Management No."},"mbrOpt":{"type":"string","description":"Member Information (Member Name, Member ID, Member No.) Condition"},"mbrValue":{"type":"string","description":"Member Information Value"}}},"RealGridListResponseMilgStatusGridReadResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MilgStatusGridReadResponse"}}}},"MilgStatusGridReadResponse":{"type":"object","properties":{"standardDate":{"type":"string","description":"Reference Date"},"astRsrvUseCausNm":{"type":"string","description":"Asset Accrual Reason"},"milgCount":{"type":"integer","format":"int64","description":"Count"},"milgSum":{"type":"integer","format":"int64","description":"Mileage"},"astRsrvUseCausCd":{"type":"string","description":"Asset Accrual/Usage Reason Code (ME020)"},"astRsrvUseGbCd":{"type":"string","description":"Asset Accrual/Usage Classification Code (ME016)"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgStatusUseList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Aggregate Usage Status List","description":"## Function Description\n* Retrieves the Mileage Aggregation Status usage list information.\n---\n## Detailed Description\n* Retrieves the Mileage Aggregation Status usage list information matching the search conditions. The search conditions are as follows:\n * Start date\n * End date\n * Asset accrual/usage type\n * Asset accrual/usage reason\n * Member information\n * Asset management No.\n---\n### Code Reference\n* Member Information (mbrOpt): Member Name (NAME), Member ID (ID), Member No. (MBRNO)\n","operationId":"getMilgUseList","parameters":[{"name":"milgStatusGridReadRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgStatusGridReadRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgStatusGridReadResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Aggregate Accrual Status List
> \## Function Description\
> \* Retrieves the Mileage Aggregation Status accrual list information.\
> \---\
> \## Detailed Description\
> \* Retrieves the Mileage Aggregation Status accrual list information matching the search conditions. The search conditions are as follows:\
> \* Start date\
> \* End date\
> \* Asset accrual/usage type\
> \* Asset accrual/usage reason\
> \* Member information\
> \* Asset management No.\
> \---\
> \### Code Reference\
> \* Member Information (mbrOpt): Member Name (NAME), Member ID (ID), Member No. (MBRNO)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgStatusGridReadRequest":{"type":"object","properties":{"startDate":{"type":"string","format":"date","description":"Start Date"},"endDate":{"type":"string","format":"date","description":"End Date"},"astRsrvUseGbCd":{"type":"string","description":"Asset Accrual/Usage Classification Code"},"astRsrvUseCausCd":{"type":"string","description":"Asset Accrual/Usage Reason Code"},"astMgrNo":{"type":"string","description":"Asset Management No."},"mbrOpt":{"type":"string","description":"Member Information (Member Name, Member ID, Member No.) Condition"},"mbrValue":{"type":"string","description":"Member Information Value"}}},"RealGridListResponseMilgStatusGridReadResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MilgStatusGridReadResponse"}}}},"MilgStatusGridReadResponse":{"type":"object","properties":{"standardDate":{"type":"string","description":"Reference Date"},"astRsrvUseCausNm":{"type":"string","description":"Asset Accrual Reason"},"milgCount":{"type":"integer","format":"int64","description":"Count"},"milgSum":{"type":"integer","format":"int64","description":"Mileage"},"astRsrvUseCausCd":{"type":"string","description":"Asset Accrual/Usage Reason Code (ME020)"},"astRsrvUseGbCd":{"type":"string","description":"Asset Accrual/Usage Classification Code (ME016)"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgStatusAccumList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Aggregate Accrual Status List","description":"## Function Description\n* Retrieves the Mileage Aggregation Status accrual list information.\n---\n## Detailed Description\n* Retrieves the Mileage Aggregation Status accrual list information matching the search conditions. The search conditions are as follows:\n * Start date\n * End date\n * Asset accrual/usage type\n * Asset accrual/usage reason\n * Member information\n * Asset management No.\n---\n### Code Reference\n* Member Information (mbrOpt): Member Name (NAME), Member ID (ID), Member No. (MBRNO)\n","operationId":"getMilgReserveList","parameters":[{"name":"milgStatusGridReadRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgStatusGridReadRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgStatusGridReadResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Payment Management List
> \## Function Description\
> \* Retrieves Mileage Payment Management information.\
> \---\
> \## Detailed Description\
> \* Retrieves mileage payment information matching the search conditions. The search conditions are as follows:\
> \* Period (scheduled payment date, payment completion date)\
> \* Payment reason\
> \* Person in charge (requester, approver, rejector)\
> \* Progress status (save completed, request completed, approval completed, rejected, payment completed)\
> \---\
> \### Code Reference\
> \* \`\`\`Date search type code\`\`\`: payFcst (scheduled payment date), payFnshmn (payment completion date)\
> \* \`\`\`Person-in-charge search type code\`\`\`: aprvReqmnId (requester), aprmn (approver), retnProcmn (rejector)
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"RealGridListResponseMilgPayGridReadResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridReadResponse"}}}},"MilgPayGridReadResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"astPayNm":{"type":"string","description":"Payout Name"},"astPayCausNm":{"type":"string","description":"Payout Reason"},"valiTermGbNm":{"type":"string","description":"Validity Period Classification"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"astPayPrgsStatNm":{"type":"string","description":"Progress Status"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"Number of Payment Recipients"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"Payment Target Amount"},"realPayTgtCnt":{"type":"integer","format":"int32","description":"Actual Payment Count"},"realPayTgtTotAmt":{"type":"integer","format":"int64","description":"Actual Payment Amount"},"aprvReqmnNm":{"type":"string","description":"Approval Requester Name"},"aprmnNm":{"type":"string","description":"Approver Name"},"retnProcmnNm":{"type":"string","description":"Rejector Name"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Approval Request Date/Time"},"aprvDtm":{"type":"string","format":"date-time","description":"Approval Date/Time"},"retnDtm":{"type":"string","format":"date-time","description":"Rejection Date/Time"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Status Code"},"aprvReqmnId":{"type":"string","description":"Approval Requester ID"},"aprmnId":{"type":"string","description":"Approver ID"},"retnProcmnId":{"type":"string","description":"Rejection Processor ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/milgPayList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Management List","description":"## Function Description\n* Retrieves Mileage Payment Management information.\n---\n## Detailed Description\n* Retrieves mileage payment information matching the search conditions. The search conditions are as follows:\n * Period (scheduled payment date, payment completion date)\n * Payment reason\n * Person in charge (requester, approver, rejector)\n * Progress status (save completed, request completed, approval completed, rejected, payment completed)\n---\n### Code Reference\n * ```Date search type code```: payFcst (scheduled payment date), payFnshmn (payment completion date)\n * ```Person-in-charge search type code```: aprvReqmnId (requester), aprmn (approver), retnProcmn (rejector)\n","operationId":"getMilgPayList","parameters":[{"name":"searchDateType","in":"query","description":"Period (Scheduled Payout Date, Payout Completion Date) Condition","required":false,"schema":{"type":"string","description":"Period (Scheduled Payout Date, Payout Completion Date) Condition"}},{"name":"startDate","in":"query","description":"Start Date","required":false,"schema":{"type":"string","format":"date","description":"Start Date"}},{"name":"endDate","in":"query","description":"End Date","required":false,"schema":{"type":"string","format":"date","description":"End Date"}},{"name":"astPayCausCd","in":"query","description":"Payout Reason","required":false,"schema":{"type":"string","description":"Payout Reason"}},{"name":"searchManagerType","in":"query","description":"Person in Charge (Requester, Approver, Rejector) Condition","required":false,"schema":{"type":"string","description":"Person in Charge (Requester, Approver, Rejector) Condition"}},{"name":"userId","in":"query","description":"Person in Charge ID","required":false,"schema":{"type":"string","description":"Person in Charge ID"}},{"name":"astPayPrgsStatCd","in":"query","description":"Progress Status","required":false,"schema":{"type":"string","description":"Progress Status"}},{"name":"astPayNo","in":"query","description":"Payout No.","required":false,"schema":{"type":"string","description":"Payout No."}},{"name":"astPayNm","in":"query","description":"Payout Name","required":false,"schema":{"type":"string","description":"Payout Name"}},{"name":"dateSelect","in":"query","description":"Date Selection Option","required":false,"schema":{"type":"string","description":"Date Selection Option"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgPayGridReadResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## Retrieve Mileage Payment Target Member List
> \## Function Description\
> \* Mileage Payment Registration/Detail - Retrieves the list of payment target members.\
> \---\
> \## Detailed Description\
> \* \*\*Asset Payment No. (astPayNo)\*\* is required.\
> \* Retrieves the list of payment target members using the \*\*Asset Payment No. (astPayNo)\*\* value.\
> \* v2 new controller\
> \---
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlGridRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."}}},"RealGridListResponseMilgPayDtlGridResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"ordNo":{"type":"string","description":"Related Order No."},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"successYn":{"type":"string","description":"Success Status"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"},"aplyYn":{"type":"string","description":"Application Status"},"failCont":{"type":"string","description":"Failure Reason"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/getMilgPayMbrInfoList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Target Member List","description":"## Function Description\n* Mileage Payment Registration/Detail - Retrieves the list of payment target members.\n---\n## Detailed Description\n* **Asset Payment No. (astPayNo)** is required.\n* Retrieves the list of payment target members using the **Asset Payment No. (astPayNo)** value.\n* v2 new controller\n---\n","operationId":"saveMilgPayMbrListExcel","parameters":[{"name":"milgPayDtlGridRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgPayDtlGridRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgPayDtlGridResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Expiration
> \## 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)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctMgmtRequest":{"type":"object","description":"Mileage Management Request","properties":{"condxMbrOpt":{"type":"string","description":"Search Type (Member Name/Member ID/Member No.)"},"condxMbrValue":{"type":"string","description":"Search Type Value"},"condxAstRsrvUseGbOpt":{"type":"string","description":"Accrual/Usage Classification Code (ME016)"},"condxAstRsrvUseCausOpt":{"type":"string","description":"Asset Accrual/Usage Reason Type (ME020)"},"condxAstMgrNo":{"type":"string","description":"Asset Management No."},"frDt":{"type":"string","format":"date","description":"Search Period - Start"},"toDt":{"type":"string","format":"date","description":"Search Period - End"},"dateSelect":{"type":"string","description":"Search Period Option"},"sysRegUserId":{"type":"string","description":"Registrant ID"}}},"RealGridListResponseMilgExtctMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/MilgExtctMgmtResponse"}}}},"MilgExtctMgmtResponse":{"type":"object","properties":{"astMgrSeq":{"type":"string","description":"Asset Management Sequence No."},"mbrNo":{"type":"string","description":"Member No."},"mbrNm":{"type":"string","description":"Member Name"},"loginId":{"type":"string","description":"Login ID"},"astRsrvUseGbCd":{"type":"string","description":"Asset Accrual/Usage Classification Code (ME016)"},"astRsrvUseGbNm":{"type":"string","description":"Asset Accrual/Usage Type Code Name (ME016)"},"astRsrvUseCausNm":{"type":"string","description":"Asset Accrual/Usage Reason Code Name (ME020)"},"astMgrNo":{"type":"string","description":"Asset Management No."},"ocurAmt":{"type":"number","description":"Amount Incurred"},"balAmt":{"type":"number","description":"Remaining Amount"},"valiStrDt":{"type":"string","description":"Validity Start Date"},"valiEndDt":{"type":"string","description":"Validity End Date"},"astMgrMemo":{"type":"string","description":"Asset Management Memo"},"sysRegId":{"type":"string","description":"System Registrant ID"},"sysRegDtm":{"type":"string","format":"date-time","description":"System Registration Date/Time"},"sysModId":{"type":"string","description":"System Modifier ID"},"sysModDtm":{"type":"string","format":"date-time","description":"System Modification Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v2/marketing/milgPayMgmt/getMilgExtctMgmtList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Expiration","description":"## Function Description\n* Retrieves mileage history.\n---\n## Detailed Description\n* Retrieves mileage history for manual mileage expiration processing.\n* Retrieves mileage history matching the search conditions. The search conditions are as follows.\n * Reference date\n * Search type (All, Accrual, Usage)\n * Member information (member name, member ID, member number)\n * Asset management number\n---\n## Revision History\n* Release v1.05_231204: Retrieve Mileage Accrual History\n* Release v2.00_240530: Changed date search query\n---\n## Code Summary\n* Member information (mbrOpt): Member Name (NAME), Member ID (ID), Member Number (MBRNO)\n* Search type (condxAstRsrvUseGbOpt): All (ALL)\n","operationId":"getMilgEtctMgmtList","parameters":[{"name":"milgExtctMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgExtctMgmtRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgExtctMgmtResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Payment Management Rejection Popup Information
> \## Function Description\
> \* Retrieves the Mileage Payment Management rejection popup information.\
> \---\
> \## Detailed Description\
> \* Retrieves mileage information matching the search conditions.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayRejectReadResponse":{"type":"object","properties":{"astPayNm":{"type":"string","description":"Payout Name"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Approval Request Date/Time"},"astPayCausNm":{"type":"string","description":"Payout Reason"},"valiTermGbNm":{"type":"string","description":"Validity Period Classification"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"Number of Payment Recipients"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"Payment Target Amount"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Status Code"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPayRejectPopupList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Management Rejection Popup Information","description":"## Function Description\n* Retrieves the Mileage Payment Management rejection popup information.\n---\n## Detailed Description\n* Retrieves mileage information matching the search conditions.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"getMilgPayRejectPopupList","parameters":[{"name":"astPayNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MilgPayRejectReadResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Payment Management List
> \## Function Description\
> \* Retrieves Mileage Payment Management information.\
> \---\
> \## Detailed Description\
> \* Retrieves mileage payment information matching the search conditions. The search conditions are as follows:\
> \* Period (scheduled payment date, payment completion date)\
> \* Payment reason\
> \* Person in charge (requester, approver, rejector)\
> \* Progress status (save completed, request completed, approval completed, rejected, payment completed)\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management\
> \* Release v2.00\_240530: Changed date query\
> \---\
> \### Code Reference\
> \* \`\`\`Date search type code\`\`\`: payFcst (scheduled payment date), payFnshmn (payment completion date)\
> \* \`\`\`Person-in-charge search type code\`\`\`: aprvReqmnId (requester), aprmn (approver), retnProcmn (rejector)
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayGridReadResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."},"astPayNm":{"type":"string","description":"Payout Name"},"astPayCausNm":{"type":"string","description":"Payout Reason"},"valiTermGbNm":{"type":"string","description":"Validity Period Classification"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"astPayPrgsStatNm":{"type":"string","description":"Progress Status"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"Number of Payment Recipients"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"Payment Target Amount"},"realPayTgtCnt":{"type":"integer","format":"int32","description":"Actual Payment Count"},"realPayTgtTotAmt":{"type":"integer","format":"int64","description":"Actual Payment Amount"},"aprvReqmnNm":{"type":"string","description":"Approval Requester Name"},"aprmnNm":{"type":"string","description":"Approver Name"},"retnProcmnNm":{"type":"string","description":"Rejector Name"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date"},"aprvReqDtm":{"type":"string","format":"date-time","description":"Approval Request Date/Time"},"aprvDtm":{"type":"string","format":"date-time","description":"Approval Date/Time"},"retnDtm":{"type":"string","format":"date-time","description":"Rejection Date/Time"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Status Code"},"aprvReqmnId":{"type":"string","description":"Approval Requester ID"},"aprmnId":{"type":"string","description":"Approver ID"},"retnProcmnId":{"type":"string","description":"Rejection Processor ID"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPayList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Management List","description":"## Function Description\n* Retrieves Mileage Payment Management information.\n---\n## Detailed Description\n* Retrieves mileage payment information matching the search conditions. The search conditions are as follows:\n * Period (scheduled payment date, payment completion date)\n * Payment reason\n * Person in charge (requester, approver, rejector)\n * Progress status (save completed, request completed, approval completed, rejected, payment completed)\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n* Release v2.00_240530: Changed date query\n---\n### Code Reference\n * ```Date search type code```: payFcst (scheduled payment date), payFnshmn (payment completion date)\n * ```Person-in-charge search type code```: aprvReqmnId (requester), aprmn (approver), retnProcmn (rejector)\n","operationId":"getMilgPayList_1","parameters":[{"name":"searchDateType","in":"query","description":"Period (Scheduled Payout Date, Payout Completion Date) Condition","required":false,"schema":{"type":"string","description":"Period (Scheduled Payout Date, Payout Completion Date) Condition"}},{"name":"startDate","in":"query","description":"Start Date","required":false,"schema":{"type":"string","format":"date","description":"Start Date"}},{"name":"endDate","in":"query","description":"End Date","required":false,"schema":{"type":"string","format":"date","description":"End Date"}},{"name":"astPayCausCd","in":"query","description":"Payout Reason","required":false,"schema":{"type":"string","description":"Payout Reason"}},{"name":"searchManagerType","in":"query","description":"Person in Charge (Requester, Approver, Rejector) Condition","required":false,"schema":{"type":"string","description":"Person in Charge (Requester, Approver, Rejector) Condition"}},{"name":"userId","in":"query","description":"Person in Charge ID","required":false,"schema":{"type":"string","description":"Person in Charge ID"}},{"name":"astPayPrgsStatCd","in":"query","description":"Progress Status","required":false,"schema":{"type":"string","description":"Progress Status"}},{"name":"astPayNo","in":"query","description":"Payout No.","required":false,"schema":{"type":"string","description":"Payout No."}},{"name":"astPayNm","in":"query","description":"Payout Name","required":false,"schema":{"type":"string","description":"Payout Name"}},{"name":"dateSelect","in":"query","description":"Date Selection Option","required":false,"schema":{"type":"string","description":"Date Selection Option"}},{"name":"rowsPerPage","in":"query","description":"Rows per Page","required":true,"schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"Current Page","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridReadResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## Retrieve Mileage Payment Management List Count
> \## Function Description\
> \* Retrieves the count of the Mileage Payment list.\
> \---\
> \## Detailed Description\
> \* Retrieves the count of the Mileage Payment list matching the search conditions. The search conditions are as follows:\
> \* Period (scheduled payment date, payment completion date)\
> \* Payment reason\
> \* Person in charge (requester, approver, rejector)\
> \* Progress status (save completed, request completed, approval completed, rejected, payment completed)\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management\
> \* Release v2.00\_240530: Changed date query\
> \---\
> \### Code Reference\
> \* \`\`\`Date search type code\`\`\`: payFcst (scheduled payment date), payFnshmn (payment completion date)\
> \* \`\`\`Person-in-charge search type code\`\`\`: aprvReqmnId (requester), aprmn (approver), retnProcmn (rejector)
````json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/milgPayListCount":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Management List Count","description":"## Function Description\n* Retrieves the count of the Mileage Payment list.\n---\n## Detailed Description\n* Retrieves the count of the Mileage Payment list matching the search conditions. The search conditions are as follows:\n * Period (scheduled payment date, payment completion date)\n * Payment reason\n * Person in charge (requester, approver, rejector)\n * Progress status (save completed, request completed, approval completed, rejected, payment completed)\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n* Release v2.00_240530: Changed date query\n---\n### Code Reference\n * ```Date search type code```: payFcst (scheduled payment date), payFnshmn (payment completion date)\n * ```Person-in-charge search type code```: aprvReqmnId (requester), aprmn (approver), retnProcmn (rejector)\n","operationId":"getMilgPayListCount","parameters":[{"name":"searchDateType","in":"query","description":"Period (Scheduled Payout Date, Payout Completion Date) Condition","required":false,"schema":{"type":"string","description":"Period (Scheduled Payout Date, Payout Completion Date) Condition"}},{"name":"startDate","in":"query","description":"Start Date","required":false,"schema":{"type":"string","format":"date","description":"Start Date"}},{"name":"endDate","in":"query","description":"End Date","required":false,"schema":{"type":"string","format":"date","description":"End Date"}},{"name":"astPayCausCd","in":"query","description":"Payout Reason","required":false,"schema":{"type":"string","description":"Payout Reason"}},{"name":"searchManagerType","in":"query","description":"Person in Charge (Requester, Approver, Rejector) Condition","required":false,"schema":{"type":"string","description":"Person in Charge (Requester, Approver, Rejector) Condition"}},{"name":"userId","in":"query","description":"Person in Charge ID","required":false,"schema":{"type":"string","description":"Person in Charge ID"}},{"name":"astPayPrgsStatCd","in":"query","description":"Progress Status","required":false,"schema":{"type":"string","description":"Progress Status"}},{"name":"astPayNo","in":"query","description":"Payout No.","required":false,"schema":{"type":"string","description":"Payout No."}},{"name":"astPayNm","in":"query","description":"Payout Name","required":false,"schema":{"type":"string","description":"Payout Name"}},{"name":"dateSelect","in":"query","description":"Date Selection Option","required":false,"schema":{"type":"string","description":"Date Selection Option"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````
## Retrieve Mileage Payment Target Member List
> \## Function Description\
> \* Mileage Payment Registration/Detail - Retrieves the list of payment target members.\
> \---\
> \## Detailed Description\
> \* \*\*Asset Payment No. (astPayNo)\*\* is required.\
> \* Retrieves the list of payment target members using the \*\*Asset Payment No. (astPayNo)\*\* value.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlGridRequest":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Payout No."}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"mbrNo":{"type":"string","description":"Member No."},"loginId":{"type":"string","description":"Member ID"},"mbrNm":{"type":"string","description":"Member Name"},"payFcstAmt":{"type":"number","description":"Scheduled Payment Amount"},"aempMemo":{"type":"string","description":"Manager Memo"},"finMemo":{"type":"string","description":"Finance Memo"},"ordNo":{"type":"string","description":"Related Order No."},"realPayAmt":{"type":"number","description":"Actual Payment Amount"},"successYn":{"type":"string","description":"Success Status"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"},"aplyYn":{"type":"string","description":"Application Status"},"failCont":{"type":"string","description":"Failure Reason"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/getMilgPayMbrInfoList":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Target Member List","description":"## Function Description\n* Mileage Payment Registration/Detail - Retrieves the list of payment target members.\n---\n## Detailed Description\n* **Asset Payment No. (astPayNo)** is required.\n* Retrieves the list of payment target members using the **Asset Payment No. (astPayNo)** value.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"getMilgPayMbrInfoList_1","parameters":[{"name":"milgPayDtlGridRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgPayDtlGridRequest"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Payment Target Member List Count
> \## Function Description\
> \* Mileage Payment Registration/Detail - Retrieves the count of payment target members.\
> \---\
> \## Detailed Description\
> \* \*\*Asset Payment No. (astPayNo)\*\* is required.\
> \* Retrieves the count of payment target members using the \*\*Asset Payment No. (astPayNo)\*\* value.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/getMilgPayMbrInfoListCount":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Target Member List Count","description":"## Function Description\n* Mileage Payment Registration/Detail - Retrieves the count of payment target members.\n---\n## Detailed Description\n* **Asset Payment No. (astPayNo)** is required.\n* Retrieves the count of payment target members using the **Asset Payment No. (astPayNo)** value.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"getMilgPayMbrInfoListCount","parameters":[{"name":"astPayNo","in":"query","description":"Payout No.","required":false,"schema":{"type":"string","description":"Payout No."}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Retrieve Mileage Payment Information
> \## Function Description\
> \* Mileage Payment Registration/Detail - Retrieves the payment information.\
> \---\
> \## Detailed Description\
> \* \*\*Asset Payment No. (astPayNo)\*\* is required.\
> \* Retrieves the mileage payment information using the \*\*Asset Payment No. (astPayNo)\*\* value.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgPayDtlResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"Asset Payment No."},"astPayNm":{"type":"string","description":"Asset Payment Name"},"astGbCd":{"type":"string","description":"Asset Type Code (ME015)"},"payFcstDt":{"type":"string","description":"Scheduled Payment Date"},"astPayCausCd":{"type":"string","description":"Asset Payment Reason Code (ME011)"},"valiTermGbCd":{"type":"string","description":"Validity Period Classification Code (ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"Validity Period"},"cnfrConts":{"type":"string","description":"Approval Request Details"},"rtrnCausConts":{"type":"string","description":"Rejection Reason Content"},"astPayPrgsStatCd":{"type":"string","description":"Asset Payment Progress Status Code (ME012)"},"astPayPrgsStatNm":{"type":"string","description":"Asset Payment Progress Status"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"Number of Payment Recipients"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"Payment Target Amount"},"realPayTgtCnt":{"type":"integer","format":"int32","description":"Actual Payment Count"},"realPayTgtTotAmt":{"type":"integer","format":"int64","description":"Actual Payment Amount"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"Payment Completion Date/Time"}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/getMilgPayDetail":{"get":{"tags":["Mileage Payment Management"],"summary":"Retrieve Mileage Payment Information","description":"## Function Description\n* Mileage Payment Registration/Detail - Retrieves the payment information.\n---\n## Detailed Description\n* **Asset Payment No. (astPayNo)** is required.\n* Retrieves the mileage payment information using the **Asset Payment No. (astPayNo)** value.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"getMilgPayDetail","parameters":[{"name":"astPayNo","in":"query","description":"Asset Payment No.","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"Success","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MilgPayDtlResponse"}}}},"900":{"description":"Business processing error details","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## Download Mileage Payment Detail Excel
> \## Function Description\
> \* Downloads the Mileage Payment Detail Excel file.\
> \---\
> \## Detailed Description\
> \* \*\*Asset Management No. (astPayNo)\*\* is required.\
> \* Downloads the member list of the mileage payment detail.\
> \* Authorization: Available to both requester and approver.\
> \---\
> \## Revision History\
> \* Release v1.05\_231204 : Mileage Payment Management
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","description":"result time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}}}}},"paths":{"/v1/marketing/milgPayMgmt/downLoadExcelPayMbrList":{"get":{"tags":["Mileage Payment Management"],"summary":"Download Mileage Payment Detail Excel","description":"## Function Description\n* Downloads the Mileage Payment Detail Excel file.\n---\n## Detailed Description\n* **Asset Management No. (astPayNo)** is required.\n* Downloads the member list of the mileage payment detail.\n* Authorization: Available to both requester and approver.\n---\n## Revision History\n* Release v1.05_231204 : Mileage Payment Management\n","operationId":"downLoadExcelPayMbrList","parameters":[{"name":"astPayNo","in":"query","description":"Asset Management No.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Excel Download Successful"},"900":{"description":"Excel Download Failed","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```