> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/back-office-api/marketing-bo-api/undefined-4.md).
# 마일리지 소멸 관리
## 마일리지 수동 소멸 처리
> \## 기능설명\
> \* 지급된 마일리지를 수동으로 소멸처리 합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 중 오지급 된 마일리지를 수동으로 소멸 처리 합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 마일리지 적립 소멸 처리
```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":{"MilgExtctRequest":{"type":"object","description":"마일리지 소멸처리 Request","properties":{"astMgrSeqList":{"type":"array","description":"자산관리순번 목록","items":{"type":"string"}},"astMgrMemo":{"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/milgExtctMgmt/saveMilgExtct":{"post":{"tags":["마일리지 소멸 관리"],"summary":"마일리지 수동 소멸 처리","description":"## 기능설명\n* 지급된 마일리지를 수동으로 소멸처리 합니다.\n---\n## 상세설명\n* 마일리지 중 오지급 된 마일리지를 수동으로 소멸 처리 합니다.\n---\n## 수정번호\n* Release v1.05_231204: 마일리지 적립 소멸 처리\n","operationId":"saveMilgExtct_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MilgExtctRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 마일리지 내역 조회
> \## 기능설명\
> \* 마일리지 내역을 조회합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 소멸 처리를 위한 마일리지 내역을 조회합니다.\
> \* 검색조건에 맞는 마일리지 내역을 조회합니다. 검색조건은 아래와 같습니다.\
> \* 기준일자\
> \* 조회구분(전체, 적립, 사용)\
> \* 회원정보(회원명, 회원ID, 회원번호)\
> \* 자산관리번호\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 마일리지 적립 내역 조회\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \---\
> \## 코드정리\
> \* 회원정보(mbrOpt) : 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)\
> \* 조회구분(condxAstRsrvUseGbOpt) : 전체(ALL)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctMgmtRequest":{"type":"object","description":"마일리지 관리 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"}}},"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":{"/v1/marketing/milgExtctMgmt/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_1","parameters":[{"name":"milgExtctMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgExtctMgmtRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MilgExtctMgmtResponse"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
## 마일리지 내역 개수 조회
> \## 기능설명\
> \* 마일리지 내역 목록 개수를 조회합니다.\
> \---\
> \## 상세설명\
> \* 조회 조건별 마일리지 내역 목록 전체 개수를 조회합니다.\
> \---\
> \## 수정번호\
> \* Release v1.05\_231204: 마일리지 적립 내역 개수 조회\
> \* Release v2.00\_240530: 날짜조회 쿼리 변경\
> \---\
> \## 코드정리\
> \* 회원정보(mbrOpt) : 회원명(NAME), 회원ID(ID), 회원번호(MBRNO)\
> \* 조회구분(condxAstRsrvUseGbOpt) : 전체(ALL)
```json
{"openapi":"3.1.0","info":{"title":"X2BEE BO API","version":"v1"},"servers":[{"url":"https://api-bo.x2bee.com/api/bo/","description":"prd"}],"security":[{"accessToken":[]}],"components":{"securitySchemes":{"accessToken":{"type":"http","name":"accessToken","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"MilgExtctMgmtRequest":{"type":"object","description":"마일리지 관리 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"}}},"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/milgExtctMgmt/getMilgExtctMgmtListCount":{"get":{"tags":["마일리지 소멸 관리"],"summary":"마일리지 내역 개수 조회","description":"## 기능설명\n* 마일리지 내역 목록 개수를 조회합니다.\n---\n## 상세설명\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":"getMilgEtctMgmtListCount","parameters":[{"name":"milgExtctMgmtRequest","in":"query","required":true,"schema":{"$ref":"#/components/schemas/MilgExtctMgmtRequest"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```