# 마일리지 소멸 관리

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

> \## 기능설명\
> \* 지급된 마일리지를 수동으로 소멸처리 합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 중 오지급 된 마일리지를 수동으로 소멸 처리 합니다.\
> \---\
> \## 수정번호\
> \* 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":{"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"}}}}}}}}}
```

## 마일리지 내역 조회

> \## 기능설명\
> \* 마일리지 내역을 조회합니다.\
> \---\
> \## 상세설명\
> \* 마일리지 소멸 처리를 위한 마일리지 내역을 조회합니다.\
> \* 검색조건에 맞는 마일리지 내역을 조회합니다. 검색조건은 아래와 같습니다.\
> &#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"}}},"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)<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"}}},"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"}}}}}}}}}
```


---

# 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-4.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.
