# 마일리지 지급 관리

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tech.x2bee.com/api/back-office-api/marketing-bo-api/undefined.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.