> 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/back-office-api/marketing-bo-api/undefined.md).

# 마일리지 지급 관리

## 마일리지 지급 대상자 일괄변경

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 대상자 일괄변경\
> \---\
> \## 상세설명\
> \* 지급예정금액, 담당자메모, 재무메모 값이 없으면 해당 컬럼은 변경을 하지 않습니다.\
> \* 지급정보 진행상태가 '임시저장' 일 경우만, 변경이 가능합니다.\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---<br>

```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":"지급번호"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"mbrNoList":{"type":"array","description":"회원번호리스트","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":["마일리지 지급 관리"],"summary":"마일리지 지급 대상자 일괄변경","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 대상자 일괄변경\n---\n## 상세설명\n* 지급예정금액, 담당자메모, 재무메모 값이 없으면 해당 컬럼은 변경을 하지 않습니다.\n* 지급정보 진행상태가 '임시저장' 일 경우만, 변경이 가능합니다.\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n","operationId":"updateMilgPayMbrMany","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayMbrUpdateRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상자 일괄등록

> \## 기능 설명\
> \* 마일리지 지급 등록/상세 - 지급대상자 일괄등록을 합니다.\
> \---\
> \## 상세 설명\
> \* 지급정보 진행상태가 '임시저장' 일 경우만, 등록이 가능합니다.\
> \* 지급자 검증이 성공인 데이터들만 일괄등록 진행합니다.\
> \* 재검증 작업을 하며 대상자 등록이 실패할 경우, 메시지를 발생시킵니다.\
> \* 실패할 경우는 아래와 같습니다\
> &#x20;   \* 이미 지급정보에 해당 회원이 존재하는 경우\
> &#x20;   \* 회원 정보가 회원 테이블에 없는 경우\
> &#x20;   \* 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\
> &#x20;   \* 지급예정금액(payFcstAmt) 기입을 안한 경우\
> &#x20;   \* 회원번호(mbrNo) 기입을 안한 경우\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---<br>

```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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"realPayAmt":{"type":"number","description":"실지급금액"},"ordNo":{"type":"string","description":"주문번호"},"aempMemo":{"type":"string","description":"담당자 메모"},"finMemo":{"type":"string","description":"재무 메모"}}},"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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"ordNo":{"type":"string","description":"관련주문번호"},"realPayAmt":{"type":"number","description":"실지급금액"},"successYn":{"type":"string","description":"성공여부"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"},"aplyYn":{"type":"string","description":"적용여부"},"failCont":{"type":"string","description":"실패사유"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상자 일괄등록","description":"## 기능 설명\n* 마일리지 지급 등록/상세 - 지급대상자 일괄등록을 합니다.\n---\n## 상세 설명\n* 지급정보 진행상태가 '임시저장' 일 경우만, 등록이 가능합니다.\n* 지급자 검증이 성공인 데이터들만 일괄등록 진행합니다.\n* 재검증 작업을 하며 대상자 등록이 실패할 경우, 메시지를 발생시킵니다.\n* 실패할 경우는 아래와 같습니다\n    * 이미 지급정보에 해당 회원이 존재하는 경우\n    * 회원 정보가 회원 테이블에 없는 경우\n    * 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\n    * 지급예정금액(payFcstAmt) 기입을 안한 경우\n    * 회원번호(mbrNo) 기입을 안한 경우\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n","operationId":"saveMilgPayMbrInfoList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"회원 조회 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseListMilgPayDtlGridResponse"}}}},"400":{"description":"회원 저장 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 등록/상세 저장

> \## 기능설명\
> \* 마일리지 지급 정보를 저장합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 지급 정보 중, 기본정보만 등록합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 지급 예정일자는 과거일자 입력이 안됩니다.\
> &#x20;   \* 유효기간이 '일수' 일때, 입력값은 '730'이 넘으면 안됩니다.\
> &#x20;   \* 유효기간이 '개월수' 일때, 입력값은 '24'가 넘으면 안됩니다.\
> \---<br>

```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":"자산지급번호"},"astPayNm":{"type":"string","description":"자산지급명"},"astGbCd":{"type":"string","description":"자산구분코드(ME015)"},"payFcstDt":{"type":"string","description":"지급예정일자"},"astPayCausCd":{"type":"string","description":"자산지급사유코드(ME011)"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"valiTermGbCd":{"type":"string","description":"유효기간구분코드(ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"aprvReqDtm":{"type":"string","format":"date-time","description":"요청접수일시"},"cnfrConts":{"type":"string","description":"품의내용"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"delYn":{"type":"string","description":"삭제여부"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급 등록/상세 저장","description":"## 기능설명\n* 마일리지 지급 정보를 저장합니다.\n---\n## 상세설명\n* 마일리지 지급 정보 중, 기본정보만 등록합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 지급 예정일자는 과거일자 입력이 안됩니다.\n    * 유효기간이 '일수' 일때, 입력값은 '730'이 넘으면 안됩니다.\n    * 유효기간이 '개월수' 일때, 입력값은 '24'가 넘으면 안됩니다.\n---\n","operationId":"saveMilgPayDtl","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 수동 소멸 처리

> \## 기능설명\
> \* 지급된 마일리지를 수동으로 소멸처리 합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 중 오지급 된 마일리지를 수동으로 소멸 처리 합니다.\
> \---<br>

```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":"마일리지 소멸처리 Grid Request","properties":{"astMgrSeq":{"type":"string","description":"자산관리순번"},"condxAstMgrMemo":{"type":"string","description":"소멸사유"},"astRsrvUseGbCd":{"type":"string","description":"적립사용구분코드(ME016)"},"balAmt":{"type":"number","description":"잔액"},"astMgrSeqList":{"type":"array","description":"자산관리순번 목록 API-BO 전달용","items":{"type":"string"}},"astMgrMemo":{"type":"string","description":"소멸사유 API-BO 전달용"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 수동 소멸 처리","description":"## 기능설명\n* 지급된 마일리지를 수동으로 소멸처리 합니다.\n---\n## 상세설명\n* 마일리지 중 오지급 된 마일리지를 수동으로 소멸 처리 합니다.\n---\n","operationId":"saveMilgExtct","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgExtctValidateRequestV2"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/JSONResponseEntityVoid"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 저장

> \## 기능설명\
> \* 마일리지 지급 목록과 자산지급내역정보 목록의 업데이트 정보를 저장합니다.\
> \---\
> \## 상세설명\
> \* 마일리지지급 목록의 삭제여부를 업데이트하고 자산지급내역정보 목록을 삭제합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 1건씩 처리 가능합니다.\
> &#x20;   \* 진행상태가 임시저장일 경우에만 삭제 처리 합니다.\
> \---<br>

```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":"지급번호"},"sysModId":{"type":"string","description":"시스템수정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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 저장","description":"## 기능설명\n* 마일리지 지급 목록과 자산지급내역정보 목록의 업데이트 정보를 저장합니다.\n---\n## 상세설명\n* 마일리지지급 목록의 삭제여부를 업데이트하고 자산지급내역정보 목록을 삭제합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 1건씩 처리 가능합니다.\n    * 진행상태가 임시저장일 경우에만 삭제 처리 합니다.\n---\n","operationId":"milgPaySave","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestMilgPayGridSaveRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 승인요청

> \## 기능설명\
> \* 마일리지 지급 관리 승인요청을 진행 합니다.\
> \---\
> \## 상세설명\
> \* 마일리지지급 관리 승인요청을 진행 합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 진행상태가 임시저장일 경우에만 승인요청을 진행합니다.\
> &#x20;   \* 지급대상자가 1이상인 경우에만 승인요청을 진행합니다.\
> &#x20;   \* 지급대상금액이 1이상일 경우에만 승인요청을 진행합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"aprvReqmnId":{"type":"string","description":"승인요청자ID"},"sysModId":{"type":"string","description":"시스템수정ID"},"aprmnId":{"type":"string","description":"승인자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 승인요청","description":"## 기능설명\n* 마일리지 지급 관리 승인요청을 진행 합니다.\n---\n## 상세설명\n* 마일리지지급 관리 승인요청을 진행 합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 진행상태가 임시저장일 경우에만 승인요청을 진행합니다.\n    * 지급대상자가 1이상인 경우에만 승인요청을 진행합니다.\n    * 지급대상금액이 1이상일 경우에만 승인요청을 진행합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"milgPayRequestApproval","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 반려

> \## 기능설명\
> \* 마일리지 지급 관리 반려 처리를 진행합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 지급 관리 반려 처리를 진행합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 진행상태가 승인대기일 경우에만 반려를 진행합니다.<br>

```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":"시스템수정ID"},"astPayNo":{"type":"string","description":"지급번호"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"retnProcmnId":{"type":"string","description":"반려처리자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 반려","description":"## 기능설명\n* 마일리지 지급 관리 반려 처리를 진행합니다.\n---\n## 상세설명\n* 마일리지 지급 관리 반려 처리를 진행합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 진행상태가 승인대기일 경우에만 반려를 진행합니다.\n","operationId":"milgPayReject","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayRejectUpdateRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 승인

> \## 기능설명\
> \* 마일리지 지급 관리 승인을 진행합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 지급 관리 승인을 진행합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 1건씩만 처리 가능합니다.\
> &#x20;   \* 진행상태가 승인대기일 경우에만 승인을 진행합니다.\
> &#x20;   \* 요청자 ID와 승인자 ID가 동일하지 않은 경우에만 승인을 진행합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"aprvReqmnId":{"type":"string","description":"승인요청자ID"},"sysModId":{"type":"string","description":"시스템수정ID"},"aprmnId":{"type":"string","description":"승인자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 승인","description":"## 기능설명\n* 마일리지 지급 관리 승인을 진행합니다.\n---\n## 상세설명\n* 마일리지 지급 관리 승인을 진행합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 1건씩만 처리 가능합니다.\n    * 진행상태가 승인대기일 경우에만 승인을 진행합니다.\n    * 요청자 ID와 승인자 ID가 동일하지 않은 경우에만 승인을 진행합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"milgPayApproval","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상자 검증

> \## 기능 설명\
> \* 마일리지 지급 등록/상세 - 지급대상자 일괄등록 업로드 데이터를 검증합니다.\
> \---\
> \## 상세 설명\
> \* 대상자 검증이 실패할 경우, 해당 경우의 실패 메시지를 노출합니다.\
> \* 실패할 경우는 아래와 같습니다\
> &#x20;   \* 이미 지급정보에 해당 회원이 존재하는 경우\
> &#x20;   \* 회원 정보가 회원 테이블에 없는 경우\
> &#x20;   \* 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\
> &#x20;   \* 지급예정금액(payFcstAmt) 기입을 안한 경우\
> &#x20;   \* 회원번호(mbrNo) 기입을 안한 경우\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---<br>

```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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"realPayAmt":{"type":"number","description":"실지급금액"},"ordNo":{"type":"string","description":"주문번호"},"aempMemo":{"type":"string","description":"담당자 메모"},"finMemo":{"type":"string","description":"재무 메모"}}},"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":"검증성공목록","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}},"milgPayDtlFailList":{"type":"array","description":"검증실패목록","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}},"totCnt":{"type":"integer","format":"int32","description":"전체건수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공건수"},"failCnt":{"type":"integer","format":"int32","description":"실패건수"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"ordNo":{"type":"string","description":"관련주문번호"},"realPayAmt":{"type":"number","description":"실지급금액"},"successYn":{"type":"string","description":"성공여부"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"},"aplyYn":{"type":"string","description":"적용여부"},"failCont":{"type":"string","description":"실패사유"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상자 검증","description":"## 기능 설명\n* 마일리지 지급 등록/상세 - 지급대상자 일괄등록 업로드 데이터를 검증합니다.\n---\n## 상세 설명\n* 대상자 검증이 실패할 경우, 해당 경우의 실패 메시지를 노출합니다.\n* 실패할 경우는 아래와 같습니다\n    * 이미 지급정보에 해당 회원이 존재하는 경우\n    * 회원 정보가 회원 테이블에 없는 경우\n    * 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\n    * 지급예정금액(payFcstAmt) 기입을 안한 경우\n    * 회원번호(mbrNo) 기입을 안한 경우\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n","operationId":"getMilgPayMbrInfoList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"회원 검증 성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseMilgPayDtlValidResponse"}}}},"900":{"description":"회원 검증 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상자 검증

> \## 기능 설명\
> \* 마일리지 지급 등록/상세 - 지급대상자 일괄등록 업로드 데이터를 검증합니다.\
> \---\
> \## 상세 설명\
> \* 대상자 검증이 실패할 경우, 해당 경우의 실패 메시지를 노출합니다.\
> \* 실패할 경우는 아래와 같습니다\
> &#x20;   \* 이미 지급정보에 해당 회원이 존재하는 경우\
> &#x20;   \* 회원 정보가 회원 테이블에 없는 경우\
> &#x20;   \* 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\
> &#x20;   \* 지급예정금액(payFcstAmt) 기입을 안한 경우\
> &#x20;   \* 회원번호(mbrNo) 기입을 안한 경우\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---<br>

```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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"realPayAmt":{"type":"number","description":"실지급금액"},"ordNo":{"type":"string","description":"주문번호"},"aempMemo":{"type":"string","description":"담당자 메모"},"finMemo":{"type":"string","description":"재무 메모"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"ordNo":{"type":"string","description":"관련주문번호"},"realPayAmt":{"type":"number","description":"실지급금액"},"successYn":{"type":"string","description":"성공여부"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"},"aplyYn":{"type":"string","description":"적용여부"},"failCont":{"type":"string","description":"실패사유"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상자 검증","description":"## 기능 설명\n* 마일리지 지급 등록/상세 - 지급대상자 일괄등록 업로드 데이터를 검증합니다.\n---\n## 상세 설명\n* 대상자 검증이 실패할 경우, 해당 경우의 실패 메시지를 노출합니다.\n* 실패할 경우는 아래와 같습니다\n    * 이미 지급정보에 해당 회원이 존재하는 경우\n    * 회원 정보가 회원 테이블에 없는 경우\n    * 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\n    * 지급예정금액(payFcstAmt) 기입을 안한 경우\n    * 회원번호(mbrNo) 기입을 안한 경우\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n","operationId":"getEventMgmtMemberCheckList","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"회원 검증 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}}},"900":{"description":"회원 검증 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 승인 처리

> \## 기능설명\
> \* 마일리지 지급 승인 처리\
> \---\
> \## 상세설명\
> \* \*\*자산관리번호(astPayNo)\*\*는 필수로 있어야 합니다.\
> \* \*\*자산지급진행상태코드(astPayPrgsStatCd)\*\*는 필수로 있어야 합니다.\
> \* 마일리지 지급상세에서 승인대기의 마일리지를 승인 처리\
> \* 권한 : 승인자만 가능합니다.\
> \---<br>

```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":"자산지급번호"},"astPayNm":{"type":"string","description":"자산지급명"},"astGbCd":{"type":"string","description":"자산구분코드(ME015)"},"payFcstDt":{"type":"string","description":"지급예정일자"},"astPayCausCd":{"type":"string","description":"자산지급사유코드(ME011)"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"valiTermGbCd":{"type":"string","description":"유효기간구분코드(ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"aprvReqDtm":{"type":"string","format":"date-time","description":"요청접수일시"},"cnfrConts":{"type":"string","description":"품의내용"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"delYn":{"type":"string","description":"삭제여부"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급 승인 처리","description":"## 기능설명\n* 마일리지 지급 승인 처리\n---\n## 상세설명\n* **자산관리번호(astPayNo)**는 필수로 있어야 합니다.\n* **자산지급진행상태코드(astPayPrgsStatCd)**는 필수로 있어야 합니다.\n* 마일리지 지급상세에서 승인대기의 마일리지를 승인 처리\n* 권한 : 승인자만 가능합니다.\n---\n","operationId":"changeAstPayPrgsStatCd","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 대상자 일괄변경

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 대상자 일괄변경\
> \---\
> \## 상세설명\
> \* 지급예정금액, 담당자메모, 재무메모 값이 없으면 해당 컬럼은 변경을 하지 않습니다.\
> \* 지급정보 진행상태가 '임시저장' 일 경우만, 변경이 가능합니다.\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"mbrNoList":{"type":"array","description":"회원번호리스트","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":["마일리지 지급 관리"],"summary":"마일리지 지급 대상자 일괄변경","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 대상자 일괄변경\n---\n## 상세설명\n* 지급예정금액, 담당자메모, 재무메모 값이 없으면 해당 컬럼은 변경을 하지 않습니다.\n* 지급정보 진행상태가 '임시저장' 일 경우만, 변경이 가능합니다.\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"updateMilgPayMbrMany_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayMbrUpdateRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상자 추가 저장

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 지급대상자 추가 저장을 합니다.\
> \---\
> \## 상세설명\
> \* \*\*자산지급번호(astPayNo)\*\*, \*\*지급예정금 (payFcstAmt)\*\* 는 필수값입니다.\
> \* 지급정보 진행상태가 '임시저장' 일 경우만, 저장이 가능합니다.\
> \* 해당 지급 정보에 이미 동일 회원이 존재하는 경우, 등록이 안됩니다.\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"realPayAmt":{"type":"number","description":"실지급금액"},"ordNo":{"type":"string","description":"주문번호"},"aempMemo":{"type":"string","description":"담당자 메모"},"finMemo":{"type":"string","description":"재무 메모"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상자 추가 저장","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 지급대상자 추가 저장을 합니다.\n---\n## 상세설명\n* **자산지급번호(astPayNo)**, **지급예정금 (payFcstAmt)** 는 필수값입니다.\n* 지급정보 진행상태가 '임시저장' 일 경우만, 저장이 가능합니다.\n* 해당 지급 정보에 이미 동일 회원이 존재하는 경우, 등록이 안됩니다.\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"saveMilgPayMbrInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상 회원 그리드 저장

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 지급대상 회원 그리드 저장\
> \---\
> \## 상세설명\
> \* 지급대상 회원의 삭제여부를 업데이트하고 지급대상자 목록을 삭제합니다.\
> \* 지급정보 진행상태가 '임시저장' 일 경우만, 저장이 가능합니다.\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"realPayAmt":{"type":"number","description":"실지급금액"},"ordNo":{"type":"string","description":"주문번호"},"aempMemo":{"type":"string","description":"담당자 메모"},"finMemo":{"type":"string","description":"재무 메모"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상 회원 그리드 저장","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 지급대상 회원 그리드 저장\n---\n## 상세설명\n* 지급대상 회원의 삭제여부를 업데이트하고 지급대상자 목록을 삭제합니다.\n* 지급정보 진행상태가 '임시저장' 일 경우만, 저장이 가능합니다.\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"saveMilgPayGrid","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestMilgPayMbrRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 등록/상세 저장

> \## 기능설명\
> \* 마일리지 지급 정보를 저장합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 지급 정보 중, 기본정보만 등록합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 지급 예정일자는 과거일자 입력이 안됩니다.\
> &#x20;   \* 유효기간이 '일수' 일때, 입력값은 '730'이 넘으면 안됩니다.\
> &#x20;   \* 유효기간이 '개월수' 일때, 입력값은 '24'가 넘으면 안됩니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"자산지급번호"},"astPayNm":{"type":"string","description":"자산지급명"},"astGbCd":{"type":"string","description":"자산구분코드(ME015)"},"payFcstDt":{"type":"string","description":"지급예정일자"},"astPayCausCd":{"type":"string","description":"자산지급사유코드(ME011)"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"valiTermGbCd":{"type":"string","description":"유효기간구분코드(ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"aprvReqDtm":{"type":"string","format":"date-time","description":"요청접수일시"},"cnfrConts":{"type":"string","description":"품의내용"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"delYn":{"type":"string","description":"삭제여부"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급 등록/상세 저장","description":"## 기능설명\n* 마일리지 지급 정보를 저장합니다.\n---\n## 상세설명\n* 마일리지 지급 정보 중, 기본정보만 등록합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 지급 예정일자는 과거일자 입력이 안됩니다.\n    * 유효기간이 '일수' 일때, 입력값은 '730'이 넘으면 안됩니다.\n    * 유효기간이 '개월수' 일때, 입력값은 '24'가 넘으면 안됩니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"saveMilgPayDtl_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 저장

> \## 기능설명\
> \* 마일리지 지급 목록과 자산지급내역정보 목록의 업데이트 정보를 저장합니다.\
> \---\
> \## 상세설명\
> \* 마일리지지급 목록의 삭제여부를 업데이트하고 자산지급내역정보 목록을 삭제합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 1건씩 처리 가능합니다.\
> &#x20;   \* 진행상태가 임시저장일 경우에만 삭제 처리 합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"},"sysModId":{"type":"string","description":"시스템수정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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 저장","description":"## 기능설명\n* 마일리지 지급 목록과 자산지급내역정보 목록의 업데이트 정보를 저장합니다.\n---\n## 상세설명\n* 마일리지지급 목록의 삭제여부를 업데이트하고 자산지급내역정보 목록을 삭제합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 1건씩 처리 가능합니다.\n    * 진행상태가 임시저장일 경우에만 삭제 처리 합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"milgPaySave_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RealGridCUDRequestMilgPayGridSaveRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상자 일괄등록

> \## 기능 설명\
> \* 마일리지 지급 등록/상세 - 지급대상자 일괄등록을 합니다.\
> \---\
> \## 상세 설명\
> \* 지급정보 진행상태가 '임시저장' 일 경우만, 등록이 가능합니다.\
> \* 대상자 등록이 실패할 경우, 해당 경우의 실패 메시지를 노출합니다.\
> \* 실패할 경우는 아래와 같습니다\
> &#x20;   \* 이미 지급정보에 해당 회원이 존재하는 경우\
> &#x20;   \* 회원 정보가 회원 테이블에 없는 경우\
> &#x20;   \* 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\
> &#x20;   \* 지급예정금액(payFcstAmt) 기입을 안한 경우\
> &#x20;   \* 회원번호(mbrNo) 기입을 안한 경우\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"realPayAmt":{"type":"number","description":"실지급금액"},"ordNo":{"type":"string","description":"주문번호"},"aempMemo":{"type":"string","description":"담당자 메모"},"finMemo":{"type":"string","description":"재무 메모"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"ordNo":{"type":"string","description":"관련주문번호"},"realPayAmt":{"type":"number","description":"실지급금액"},"successYn":{"type":"string","description":"성공여부"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"},"aplyYn":{"type":"string","description":"적용여부"},"failCont":{"type":"string","description":"실패사유"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상자 일괄등록","description":"## 기능 설명\n* 마일리지 지급 등록/상세 - 지급대상자 일괄등록을 합니다.\n---\n## 상세 설명\n* 지급정보 진행상태가 '임시저장' 일 경우만, 등록이 가능합니다.\n* 대상자 등록이 실패할 경우, 해당 경우의 실패 메시지를 노출합니다.\n* 실패할 경우는 아래와 같습니다\n    * 이미 지급정보에 해당 회원이 존재하는 경우\n    * 회원 정보가 회원 테이블에 없는 경우\n    * 해당 회원번호로 조회된 회원ID가 기입된 회원ID와 다른 경우\n    * 지급예정금액(payFcstAmt) 기입을 안한 경우\n    * 회원번호(mbrNo) 기입을 안한 경우\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"getEventMgmtMemberCheckList_1","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayMbrRequest"}}}},"required":true},"responses":{"200":{"description":"회원 조회 성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}}},"900":{"description":"회원 조회 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 승인 처리

> \## 기능설명\
> \* 마일리지 지급 승인 처리\
> \---\
> \## 상세설명\
> \* \*\*자산관리번호(astPayNo)\*\*는 필수로 있어야 합니다.\
> \* \*\*자산지급진행상태코드(astPayPrgsStatCd)\*\*는 필수로 있어야 합니다.\
> \* 마일리지 지급상세에서 승인대기의 마일리지를 승인 처리\
> \* 권한 : 승인자만 가능합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"자산지급번호"},"astPayNm":{"type":"string","description":"자산지급명"},"astGbCd":{"type":"string","description":"자산구분코드(ME015)"},"payFcstDt":{"type":"string","description":"지급예정일자"},"astPayCausCd":{"type":"string","description":"자산지급사유코드(ME011)"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"valiTermGbCd":{"type":"string","description":"유효기간구분코드(ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"aprvReqDtm":{"type":"string","format":"date-time","description":"요청접수일시"},"cnfrConts":{"type":"string","description":"품의내용"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"delYn":{"type":"string","description":"삭제여부"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급 승인 처리","description":"## 기능설명\n* 마일리지 지급 승인 처리\n---\n## 상세설명\n* **자산관리번호(astPayNo)**는 필수로 있어야 합니다.\n* **자산지급진행상태코드(astPayPrgsStatCd)**는 필수로 있어야 합니다.\n* 마일리지 지급상세에서 승인대기의 마일리지를 승인 처리\n* 권한 : 승인자만 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"changeAstPayPrgsStatCd_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayDtlRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 승인요청

> \## 기능설명\
> \* 마일리지 지급 관리 승인요청을 진행 합니다.\
> \---\
> \## 상세설명\
> \* 마일리지지급 관리 승인요청을 진행 합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 진행상태가 임시저장일 경우에만 승인요청을 진행합니다.\
> &#x20;   \* 지급대상자가 1이상인 경우에만 승인요청을 진행합니다.\
> &#x20;   \* 지급대상금액이 1이상일 경우에만 승인요청을 진행합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"aprvReqmnId":{"type":"string","description":"승인요청자ID"},"sysModId":{"type":"string","description":"시스템수정ID"},"aprmnId":{"type":"string","description":"승인자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 승인요청","description":"## 기능설명\n* 마일리지 지급 관리 승인요청을 진행 합니다.\n---\n## 상세설명\n* 마일리지지급 관리 승인요청을 진행 합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 진행상태가 임시저장일 경우에만 승인요청을 진행합니다.\n    * 지급대상자가 1이상인 경우에만 승인요청을 진행합니다.\n    * 지급대상금액이 1이상일 경우에만 승인요청을 진행합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"milgPayRequestApproval_1","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 반려

> \## 기능설명\
> \* 마일리지 지급 관리 반려 처리를 진행합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 지급 관리 반려 처리를 진행합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 진행상태가 승인대기일 경우에만 반려를 진행합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"시스템수정ID"},"astPayNo":{"type":"string","description":"지급번호"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"retnProcmnId":{"type":"string","description":"반려처리자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 반려","description":"## 기능설명\n* 마일리지 지급 관리 반려 처리를 진행합니다.\n---\n## 상세설명\n* 마일리지 지급 관리 반려 처리를 진행합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 진행상태가 승인대기일 경우에만 반려를 진행합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"milgPayReject_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgPayRejectUpdateRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 승인

> \## 기능설명\
> \* 마일리지 지급 관리 승인을 진행합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 지급 관리 승인을 진행합니다.\
> \* 다음과 같은 유효성 체크가 있습니다.\
> &#x20;   \* 1건씩만 처리 가능합니다.\
> &#x20;   \* 진행상태가 승인대기일 경우에만 승인을 진행합니다.\
> &#x20;   \* 요청자 ID와 승인자 ID가 동일하지 않은 경우에만 승인을 진행합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"aprvReqmnId":{"type":"string","description":"승인요청자ID"},"sysModId":{"type":"string","description":"시스템수정ID"},"aprmnId":{"type":"string","description":"승인자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 승인","description":"## 기능설명\n* 마일리지 지급 관리 승인을 진행합니다.\n---\n## 상세설명\n* 마일리지 지급 관리 승인을 진행합니다.\n* 다음과 같은 유효성 체크가 있습니다.\n    * 1건씩만 처리 가능합니다.\n    * 진행상태가 승인대기일 경우에만 승인을 진행합니다.\n    * 요청자 ID와 승인자 ID가 동일하지 않은 경우에만 승인을 진행합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"milgPayApproval_1","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayUpdateRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 집계 현황 사용 목록 조회

> \## 기능설명\
> \* 마일리지 집계 현황 사용 리스트 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 마일리지 집계 현황 사용 리스트 정보를 조회합니다. 검색조건은 아래와 같습니다.\
> &#x20; \* 시작일\
> &#x20; \* 종료일\
> &#x20; \* 자산적립사용구분\
> &#x20; \* 자산적립사용사유\
> &#x20; \* 회원정보\
> &#x20; \* 자산관리번호\
> \---\
> \### 코드정리\
> \* 회원정보(mbrOpt): 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)<br>

```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":"시작일자"},"endDate":{"type":"string","format":"date","description":"종료일자"},"astRsrvUseGbCd":{"type":"string","description":"자산적립사용구분코드"},"astRsrvUseCausCd":{"type":"string","description":"자산적립사용사유코드"},"astMgrNo":{"type":"string","description":"자산관리번호"},"mbrOpt":{"type":"string","description":"회원정보(회원명, 회원ID, 회원번호) 조건"},"mbrValue":{"type":"string","description":"회원정보값"}}},"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":"기준일자"},"astRsrvUseCausNm":{"type":"string","description":"자산적립사유"},"milgCount":{"type":"integer","format":"int64","description":"건수"},"milgSum":{"type":"integer","format":"int64","description":"마일리지"},"astRsrvUseCausCd":{"type":"string","description":"자산적립사용사유코드(ME020)"},"astRsrvUseGbCd":{"type":"string","description":"자산적립사용구분코드(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":["마일리지 지급 관리"],"summary":"마일리지 집계 현황 사용 목록 조회","description":"## 기능설명\n* 마일리지 집계 현황 사용 리스트 정보를 조회합니다.\n---\n## 상세설명\n* 검색조건에 맞는 마일리지 집계 현황 사용 리스트 정보를 조회합니다. 검색조건은 아래와 같습니다.\n  * 시작일\n  * 종료일\n  * 자산적립사용구분\n  * 자산적립사용사유\n  * 회원정보\n  * 자산관리번호\n---\n### 코드정리\n* 회원정보(mbrOpt): 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)\n","operationId":"getMilgUseList","parameters":[{"name":"milgStatusGridReadRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgStatusGridReadRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgStatusGridReadResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 집계 현황 적립 목록 조회

> \## 기능설명\
> \* 마일리지 집계 현황 적립 리스트 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 마일리지 집계 현황 적립 리스트 정보를 조회합니다. 검색조건은 아래와 같습니다.\
> &#x20; \* 시작일\
> &#x20; \* 종료일\
> &#x20; \* 자산적립사용구분\
> &#x20; \* 자산적립사용사유\
> &#x20; \* 회원정보\
> &#x20; \* 자산관리번호\
> \---\
> \### 코드정리\
> \* 회원정보(mbrOpt): 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)<br>

```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":"시작일자"},"endDate":{"type":"string","format":"date","description":"종료일자"},"astRsrvUseGbCd":{"type":"string","description":"자산적립사용구분코드"},"astRsrvUseCausCd":{"type":"string","description":"자산적립사용사유코드"},"astMgrNo":{"type":"string","description":"자산관리번호"},"mbrOpt":{"type":"string","description":"회원정보(회원명, 회원ID, 회원번호) 조건"},"mbrValue":{"type":"string","description":"회원정보값"}}},"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":"기준일자"},"astRsrvUseCausNm":{"type":"string","description":"자산적립사유"},"milgCount":{"type":"integer","format":"int64","description":"건수"},"milgSum":{"type":"integer","format":"int64","description":"마일리지"},"astRsrvUseCausCd":{"type":"string","description":"자산적립사용사유코드(ME020)"},"astRsrvUseGbCd":{"type":"string","description":"자산적립사용구분코드(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":["마일리지 지급 관리"],"summary":"마일리지 집계 현황 적립 목록 조회","description":"## 기능설명\n* 마일리지 집계 현황 적립 리스트 정보를 조회합니다.\n---\n## 상세설명\n* 검색조건에 맞는 마일리지 집계 현황 적립 리스트 정보를 조회합니다. 검색조건은 아래와 같습니다.\n  * 시작일\n  * 종료일\n  * 자산적립사용구분\n  * 자산적립사용사유\n  * 회원정보\n  * 자산관리번호\n---\n### 코드정리\n* 회원정보(mbrOpt): 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)\n","operationId":"getMilgReserveList","parameters":[{"name":"milgStatusGridReadRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgStatusGridReadRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgStatusGridReadResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 목록 조회

> \## 기능설명\
> \* 마일리지 지급 관리 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 마일리지 지급 정보를 조회합니다. 검색조건은 아래와 같습니다.\
> &#x20; \* 기간(지급예정일, 지급완료일)\
> &#x20; \* 지급사유\
> &#x20; \* 담당자(요청자, 승인자, 반려자)\
> &#x20; \* 진행 상태(저장완료, 요청완료, 승인완료, 반려, 지급완료)\
> \---\
> \### 코드정리\
> &#x20; \* \`\`\` 날짜 조회 구분 코드 \`\`\` : payFcst(지급예정일), payFnshmn(지급완료일)\
> &#x20; \* \`\`\` 담당자 조회 구분 코드 \`\`\` : aprvReqmnId(요청자), aprmn(승인자), retnProcmn(반려자)<br>

````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":"지급번호"},"astPayNm":{"type":"string","description":"지급명"},"astPayCausNm":{"type":"string","description":"지급사유"},"valiTermGbNm":{"type":"string","description":"유효기간구분"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"astPayPrgsStatNm":{"type":"string","description":"진행상태"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"지급대상수"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"지급대상금액"},"realPayTgtCnt":{"type":"integer","format":"int32","description":"실지급건수"},"realPayTgtTotAmt":{"type":"integer","format":"int64","description":"실지급금액"},"aprvReqmnNm":{"type":"string","description":"승인요청자명"},"aprmnNm":{"type":"string","description":"승인자명"},"retnProcmnNm":{"type":"string","description":"반려자명"},"payFcstDt":{"type":"string","description":"지급예정일"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일"},"aprvReqDtm":{"type":"string","format":"date-time","description":"승인요청일시"},"aprvDtm":{"type":"string","format":"date-time","description":"승인일시"},"retnDtm":{"type":"string","format":"date-time","description":"반려일시"},"astPayPrgsStatCd":{"type":"string","description":"자산지급상태코드"},"aprvReqmnId":{"type":"string","description":"승인요청자ID"},"aprmnId":{"type":"string","description":"승인자ID"},"retnProcmnId":{"type":"string","description":"반려처리자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 목록 조회","description":"## 기능설명\n* 마일리지 지급 관리 정보를 조회합니다.\n---\n## 상세설명\n* 검색조건에 맞는 마일리지 지급 정보를 조회합니다. 검색조건은 아래와 같습니다.\n  * 기간(지급예정일, 지급완료일)\n  * 지급사유\n  * 담당자(요청자, 승인자, 반려자)\n  * 진행 상태(저장완료, 요청완료, 승인완료, 반려, 지급완료)\n---\n### 코드정리\n  * ``` 날짜 조회 구분 코드 ``` : payFcst(지급예정일), payFnshmn(지급완료일)\n  * ``` 담당자 조회 구분 코드 ``` : aprvReqmnId(요청자), aprmn(승인자), retnProcmn(반려자)\n","operationId":"getMilgPayList","parameters":[{"name":"searchDateType","in":"query","description":"기간(지급예정일, 지급완료일) 조건","required":false,"schema":{"type":"string","description":"기간(지급예정일, 지급완료일) 조건"}},{"name":"startDate","in":"query","description":"시작일자","required":false,"schema":{"type":"string","format":"date","description":"시작일자"}},{"name":"endDate","in":"query","description":"종료일자","required":false,"schema":{"type":"string","format":"date","description":"종료일자"}},{"name":"astPayCausCd","in":"query","description":"지급사유","required":false,"schema":{"type":"string","description":"지급사유"}},{"name":"searchManagerType","in":"query","description":"담당자(요청자, 승인자, 반려자) 조건","required":false,"schema":{"type":"string","description":"담당자(요청자, 승인자, 반려자) 조건"}},{"name":"userId","in":"query","description":"담당자 ID","required":false,"schema":{"type":"string","description":"담당자 ID"}},{"name":"astPayPrgsStatCd","in":"query","description":"진행상태","required":false,"schema":{"type":"string","description":"진행상태"}},{"name":"astPayNo","in":"query","description":"지급번호","required":false,"schema":{"type":"string","description":"지급번호"}},{"name":"astPayNm","in":"query","description":"지급명","required":false,"schema":{"type":"string","description":"지급명"}},{"name":"dateSelect","in":"query","description":"날짜선택옵션","required":false,"schema":{"type":"string","description":"날짜선택옵션"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgPayGridReadResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 마일리지 지급대상 회원 목록 조회

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 지급대상 회원 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*자산지급번호(astPayNo)\*\* 는 필수값입니다.\
> \* \*\*자산지급번호(astPayNo)\*\* 값으로 해당 지급대상 회원 목록을 조회합니다.\
> \* v2 신규 controller\
> \---<br>

```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":"지급번호"}}},"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":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"ordNo":{"type":"string","description":"관련주문번호"},"realPayAmt":{"type":"number","description":"실지급금액"},"successYn":{"type":"string","description":"성공여부"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"},"aplyYn":{"type":"string","description":"적용여부"},"failCont":{"type":"string","description":"실패사유"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상 회원 목록 조회","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 지급대상 회원 목록을 조회합니다.\n---\n## 상세설명\n* **자산지급번호(astPayNo)** 는 필수값입니다.\n* **자산지급번호(astPayNo)** 값으로 해당 지급대상 회원 목록을 조회합니다.\n* v2 신규 controller\n---\n","operationId":"saveMilgPayMbrListExcel","parameters":[{"name":"milgPayDtlGridRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgPayDtlGridRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgPayDtlGridResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 소멸 조회

> \## 기능설명\
> \* 마일리지 내역을 조회합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 소멸 처리를 위한 마일리지 내역을 조회합니다.\
> \* 검색조건에 맞는 마일리지 내역을 조회합니다. 검색조건은 아래와 같습니다.\
> &#x20;  \* 기준일자\
> &#x20;  \* 조회구분(전체, 적립, 사용)\
> &#x20;  \* 회원정보(회원명, 회원ID, 회원번호)\
> &#x20;  \* 자산관리번호\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 마일리지 적립 내역 조회\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \---\
> \## 코드정리\
> \* 회원정보(mbrOpt) : 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)\
> \* 조회구분(condxAstRsrvUseGbOpt) : 전체(ALL)<br>

```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":"마일리지 관리 Request","properties":{"condxMbrOpt":{"type":"string","description":"검색구분(회원명/회원아이디/회원번호)"},"condxMbrValue":{"type":"string","description":"검색구분 값"},"condxAstRsrvUseGbOpt":{"type":"string","description":"적립사용구분코드(ME016)"},"condxAstRsrvUseCausOpt":{"type":"string","description":"자산적립사용사유구분(ME020)"},"condxAstMgrNo":{"type":"string","description":"자산관리번호"},"frDt":{"type":"string","format":"date","description":"조회기간-시작"},"toDt":{"type":"string","format":"date","description":"조회기간-종료"},"dateSelect":{"type":"string","description":"조회기간옵션"},"sysRegUserId":{"type":"string","description":"등록자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":"자산관리순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrNm":{"type":"string","description":"회원명"},"loginId":{"type":"string","description":"로그인ID"},"astRsrvUseGbCd":{"type":"string","description":"자산적립사용구분코드(ME016)"},"astRsrvUseGbNm":{"type":"string","description":"자산적립사용구분코드명(ME016)"},"astRsrvUseCausNm":{"type":"string","description":"자산적립사용사유코드명(ME020)"},"astMgrNo":{"type":"string","description":"자산관리번호"},"ocurAmt":{"type":"number","description":"발생금액"},"balAmt":{"type":"number","description":"잔여금액"},"valiStrDt":{"type":"string","description":"유효시작일자"},"valiEndDt":{"type":"string","description":"유효종료일자"},"astMgrMemo":{"type":"string","description":"자산관리메모"},"sysRegId":{"type":"string","description":"시스템동록자ID"},"sysRegDtm":{"type":"string","format":"date-time","description":"시스템등록일시"},"sysModId":{"type":"string","description":"시스템수정ID"},"sysModDtm":{"type":"string","format":"date-time","description":"시스템수정일시"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 소멸 조회","description":"## 기능설명\n* 마일리지 내역을 조회합니다.\n---\n## 상세설명\n* 마일리지 소멸 처리를 위한 마일리지 내역을 조회합니다.\n* 검색조건에 맞는 마일리지 내역을 조회합니다. 검색조건은 아래와 같습니다.\n   * 기준일자\n   * 조회구분(전체, 적립, 사용)\n   * 회원정보(회원명, 회원ID, 회원번호)\n   * 자산관리번호\n---\n## 수정번호\n* Release v1.05_231204: 마일리지 적립 내역 조회\n* Release v2.00_240530: 날짜조회 쿼리 변경\n---\n## 코드정리\n* 회원정보(mbrOpt) : 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)\n* 조회구분(condxAstRsrvUseGbOpt) : 전체(ALL)\n","operationId":"getMilgEtctMgmtList","parameters":[{"name":"milgExtctMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgExtctMgmtRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseMilgExtctMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 반려 팝업 정보 조회

> \## 기능설명\
> \* 마일리지지급 관리 반려 팝업 정보 조회를 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 마일리지 정보를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급명"},"aprvReqDtm":{"type":"string","format":"date-time","description":"승인요청일시"},"astPayCausNm":{"type":"string","description":"지급사유"},"valiTermGbNm":{"type":"string","description":"유효기간구분"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"지급대상수"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"지급대상금액"},"astPayPrgsStatCd":{"type":"string","description":"자산지급상태코드"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 반려 팝업 정보 조회","description":"## 기능설명\n* 마일리지지급 관리 반려 팝업 정보 조회를 조회합니다.\n---\n## 상세설명\n* 검색조건에 맞는 마일리지 정보를 조회합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"getMilgPayRejectPopupList","parameters":[{"name":"astPayNo","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MilgPayRejectReadResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급 관리 목록 조회

> \## 기능설명\
> \* 마일리지 지급 관리 정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 마일리지 지급 정보를 조회합니다. 검색조건은 아래와 같습니다.\
> &#x20; \* 기간(지급예정일, 지급완료일)\
> &#x20; \* 지급사유\
> &#x20; \* 담당자(요청자, 승인자, 반려자)\
> &#x20; \* 진행 상태(저장완료, 요청완료, 승인완료, 반려, 지급완료)\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \---\
> \### 코드정리\
> &#x20; \* \`\`\` 날짜 조회 구분 코드 \`\`\` : payFcst(지급예정일), payFnshmn(지급완료일)\
> &#x20; \* \`\`\` 담당자 조회 구분 코드 \`\`\` : aprvReqmnId(요청자), aprmn(승인자), retnProcmn(반려자)<br>

````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":"지급번호"},"astPayNm":{"type":"string","description":"지급명"},"astPayCausNm":{"type":"string","description":"지급사유"},"valiTermGbNm":{"type":"string","description":"유효기간구분"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"astPayPrgsStatNm":{"type":"string","description":"진행상태"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"지급대상수"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"지급대상금액"},"realPayTgtCnt":{"type":"integer","format":"int32","description":"실지급건수"},"realPayTgtTotAmt":{"type":"integer","format":"int64","description":"실지급금액"},"aprvReqmnNm":{"type":"string","description":"승인요청자명"},"aprmnNm":{"type":"string","description":"승인자명"},"retnProcmnNm":{"type":"string","description":"반려자명"},"payFcstDt":{"type":"string","description":"지급예정일"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일"},"aprvReqDtm":{"type":"string","format":"date-time","description":"승인요청일시"},"aprvDtm":{"type":"string","format":"date-time","description":"승인일시"},"retnDtm":{"type":"string","format":"date-time","description":"반려일시"},"astPayPrgsStatCd":{"type":"string","description":"자산지급상태코드"},"aprvReqmnId":{"type":"string","description":"승인요청자ID"},"aprmnId":{"type":"string","description":"승인자ID"},"retnProcmnId":{"type":"string","description":"반려처리자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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 목록 조회","description":"## 기능설명\n* 마일리지 지급 관리 정보를 조회합니다.\n---\n## 상세설명\n* 검색조건에 맞는 마일리지 지급 정보를 조회합니다. 검색조건은 아래와 같습니다.\n  * 기간(지급예정일, 지급완료일)\n  * 지급사유\n  * 담당자(요청자, 승인자, 반려자)\n  * 진행 상태(저장완료, 요청완료, 승인완료, 반려, 지급완료)\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n* Release v2.00_240530: 날짜조회 쿼리 변경\n---\n### 코드정리\n  * ``` 날짜 조회 구분 코드 ``` : payFcst(지급예정일), payFnshmn(지급완료일)\n  * ``` 담당자 조회 구분 코드 ``` : aprvReqmnId(요청자), aprmn(승인자), retnProcmn(반려자)\n","operationId":"getMilgPayList_1","parameters":[{"name":"searchDateType","in":"query","description":"기간(지급예정일, 지급완료일) 조건","required":false,"schema":{"type":"string","description":"기간(지급예정일, 지급완료일) 조건"}},{"name":"startDate","in":"query","description":"시작일자","required":false,"schema":{"type":"string","format":"date","description":"시작일자"}},{"name":"endDate","in":"query","description":"종료일자","required":false,"schema":{"type":"string","format":"date","description":"종료일자"}},{"name":"astPayCausCd","in":"query","description":"지급사유","required":false,"schema":{"type":"string","description":"지급사유"}},{"name":"searchManagerType","in":"query","description":"담당자(요청자, 승인자, 반려자) 조건","required":false,"schema":{"type":"string","description":"담당자(요청자, 승인자, 반려자) 조건"}},{"name":"userId","in":"query","description":"담당자 ID","required":false,"schema":{"type":"string","description":"담당자 ID"}},{"name":"astPayPrgsStatCd","in":"query","description":"진행상태","required":false,"schema":{"type":"string","description":"진행상태"}},{"name":"astPayNo","in":"query","description":"지급번호","required":false,"schema":{"type":"string","description":"지급번호"}},{"name":"astPayNm","in":"query","description":"지급명","required":false,"schema":{"type":"string","description":"지급명"}},{"name":"dateSelect","in":"query","description":"날짜선택옵션","required":false,"schema":{"type":"string","description":"날짜선택옵션"}},{"name":"rowsPerPage","in":"query","description":"페이지 당 row","required":true,"schema":{"type":"string","description":"string"}},{"name":"pageIdx","in":"query","description":"현재 페이지","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayGridReadResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 마일리지 지급 관리 목록 건수 조회

> \## 기능설명\
> \* 마일리지 지급 목록의 건수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 검색조건에 맞는 마일리지 지급 목록의 건수를 조회합니다. 검색조건은 아래와 같습니다.\
> &#x20; \* 기간(지급예정일, 지급완료일)\
> &#x20; \* 지급사유\
> &#x20; \* 담당자(요청자, 승인자, 반려자)\
> &#x20; \* 진행 상태(저장완료, 요청완료, 승인완료, 반려, 지급완료)\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \---\
> \### 코드정리\
> &#x20; \* \`\`\` 날짜 조회 구분 코드 \`\`\` : payFcst(지급예정일), payFnshmn(지급완료일)\
> &#x20; \* \`\`\` 담당자 조회 구분 코드 \`\`\` : aprvReqmnId(요청자), aprmn(승인자), retnProcmn(반려자)<br>

````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":["마일리지 지급 관리"],"summary":"마일리지 지급 관리 목록 건수 조회","description":"## 기능설명\n* 마일리지 지급 목록의 건수를 조회합니다.\n---\n## 상세설명\n* 검색조건에 맞는 마일리지 지급 목록의 건수를 조회합니다. 검색조건은 아래와 같습니다.\n  * 기간(지급예정일, 지급완료일)\n  * 지급사유\n  * 담당자(요청자, 승인자, 반려자)\n  * 진행 상태(저장완료, 요청완료, 승인완료, 반려, 지급완료)\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n* Release v2.00_240530: 날짜조회 쿼리 변경\n---\n### 코드정리\n  * ``` 날짜 조회 구분 코드 ``` : payFcst(지급예정일), payFnshmn(지급완료일)\n  * ``` 담당자 조회 구분 코드 ``` : aprvReqmnId(요청자), aprmn(승인자), retnProcmn(반려자)\n","operationId":"getMilgPayListCount","parameters":[{"name":"searchDateType","in":"query","description":"기간(지급예정일, 지급완료일) 조건","required":false,"schema":{"type":"string","description":"기간(지급예정일, 지급완료일) 조건"}},{"name":"startDate","in":"query","description":"시작일자","required":false,"schema":{"type":"string","format":"date","description":"시작일자"}},{"name":"endDate","in":"query","description":"종료일자","required":false,"schema":{"type":"string","format":"date","description":"종료일자"}},{"name":"astPayCausCd","in":"query","description":"지급사유","required":false,"schema":{"type":"string","description":"지급사유"}},{"name":"searchManagerType","in":"query","description":"담당자(요청자, 승인자, 반려자) 조건","required":false,"schema":{"type":"string","description":"담당자(요청자, 승인자, 반려자) 조건"}},{"name":"userId","in":"query","description":"담당자 ID","required":false,"schema":{"type":"string","description":"담당자 ID"}},{"name":"astPayPrgsStatCd","in":"query","description":"진행상태","required":false,"schema":{"type":"string","description":"진행상태"}},{"name":"astPayNo","in":"query","description":"지급번호","required":false,"schema":{"type":"string","description":"지급번호"}},{"name":"astPayNm","in":"query","description":"지급명","required":false,"schema":{"type":"string","description":"지급명"}},{"name":"dateSelect","in":"query","description":"날짜선택옵션","required":false,"schema":{"type":"string","description":"날짜선택옵션"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
````

## 마일리지 지급대상 회원 목록 조회

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 지급대상 회원 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*자산지급번호(astPayNo)\*\* 는 필수값입니다.\
> \* \*\*자산지급번호(astPayNo)\*\* 값으로 해당 지급대상 회원 목록을 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"지급번호"}}},"MilgPayDtlGridResponse":{"type":"object","properties":{"astPayNo":{"type":"string","description":"자산지급번호"},"mbrNo":{"type":"string","description":"회원번호"},"loginId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"payFcstAmt":{"type":"number","description":"지급예정금액"},"aempMemo":{"type":"string","description":"담당자메모"},"finMemo":{"type":"string","description":"재무메모"},"ordNo":{"type":"string","description":"관련주문번호"},"realPayAmt":{"type":"number","description":"실지급금액"},"successYn":{"type":"string","description":"성공여부"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"},"aplyYn":{"type":"string","description":"적용여부"},"failCont":{"type":"string","description":"실패사유"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급대상 회원 목록 조회","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 지급대상 회원 목록을 조회합니다.\n---\n## 상세설명\n* **자산지급번호(astPayNo)** 는 필수값입니다.\n* **자산지급번호(astPayNo)** 값으로 해당 지급대상 회원 목록을 조회합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"getMilgPayMbrInfoList_1","parameters":[{"name":"milgPayDtlGridRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgPayDtlGridRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgPayDtlGridResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급대상 회원 목록 건수 조회

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 지급대상 회원 목록 건수를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*자산지급번호(astPayNo)\*\* 는 필수값입니다.\
> \* \*\*자산지급번호(astPayNo)\*\* 값으로 해당 지급대상 회원 목록 건수를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":["마일리지 지급 관리"],"summary":"마일리지 지급대상 회원 목록 건수 조회","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 지급대상 회원 목록 건수를 조회합니다.\n---\n## 상세설명\n* **자산지급번호(astPayNo)** 는 필수값입니다.\n* **자산지급번호(astPayNo)** 값으로 해당 지급대상 회원 목록 건수를 조회합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"getMilgPayMbrInfoListCount","parameters":[{"name":"astPayNo","in":"query","description":"지급번호","required":false,"schema":{"type":"string","description":"지급번호"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급정보 조회

> \## 기능설명\
> \* 마일리지 지급 등록/상세 - 지급정보를 조회합니다.\
> \---\
> \## 상세설명\
> \* \*\*자산지급번호(astPayNo)\*\* 는 필수값입니다.\
> \* \*\*자산지급번호(astPayNo)\*\* 값으로 해당 마일리지 지급정보를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":"자산지급번호"},"astPayNm":{"type":"string","description":"자산지급명"},"astGbCd":{"type":"string","description":"자산구분코드(ME015)"},"payFcstDt":{"type":"string","description":"지급예정일자"},"astPayCausCd":{"type":"string","description":"자산지급사유코드(ME011)"},"valiTermGbCd":{"type":"string","description":"유효기간구분코드(ME013)"},"valiTerm":{"type":"integer","format":"int32","description":"유효기간"},"cnfrConts":{"type":"string","description":"품의내용"},"rtrnCausConts":{"type":"string","description":"반려사유내용"},"astPayPrgsStatCd":{"type":"string","description":"자산지급진행상태코드(ME012)"},"astPayPrgsStatNm":{"type":"string","description":"자산지급진행상태"},"fcstPayTgtCnt":{"type":"integer","format":"int32","description":"지급대상수"},"fcstPayTgtTotAmt":{"type":"integer","format":"int64","description":"지급대상금액"},"realPayTgtCnt":{"type":"integer","format":"int32","description":"실지급건수"},"realPayTgtTotAmt":{"type":"integer","format":"int64","description":"실지급금액"},"payFnshmnDtm":{"type":"string","format":"date-time","description":"지급완료일시"}}},"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":["마일리지 지급 관리"],"summary":"마일리지 지급정보 조회","description":"## 기능설명\n* 마일리지 지급 등록/상세 - 지급정보를 조회합니다.\n---\n## 상세설명\n* **자산지급번호(astPayNo)** 는 필수값입니다.\n* **자산지급번호(astPayNo)** 값으로 해당 마일리지 지급정보를 조회합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"getMilgPayDetail","parameters":[{"name":"astPayNo","in":"query","description":"자산지급번호","required":true,"schema":{"type":"string","description":"string"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MilgPayDtlResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 마일리지 지급상세 엑셀다운로드

> \## 기능 설명\
> \* 마일리지 지급상세 엑셀다운로드\
> \---\
> \## 상세 설명\
> \* \*\*자산관리번호(astPayNo)\*\*는 필수로 있어야 합니다.\
> \* 마일리지 지급상세의 회원목록을 다운로드합니다.\
> \* 권한 : 요청자/승인자 모두 가능합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204 : 마일리지 지급관리<br>

```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":["마일리지 지급 관리"],"summary":"마일리지 지급상세 엑셀다운로드","description":"## 기능 설명\n* 마일리지 지급상세 엑셀다운로드\n---\n## 상세 설명\n* **자산관리번호(astPayNo)**는 필수로 있어야 합니다.\n* 마일리지 지급상세의 회원목록을 다운로드합니다.\n* 권한 : 요청자/승인자 모두 가능합니다.\n---\n## 수정번호\n* Release v1.05_231204 : 마일리지 지급관리\n","operationId":"downLoadExcelPayMbrList","parameters":[{"name":"astPayNo","in":"query","description":"자산관리번호","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"엑셀 다운로드 성공"},"900":{"description":"엑셀 다운로드 실패","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```