> 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/system-bo-api/undefined-16.md).

# 이메일 발송 관리

## 이메일 정보를 검증합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 정보를 검증합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 이메일 정보를 검증합니다.\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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":{"/v1/system/sendEmailMgmt/validateSendEmailBaseInfo":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 정보를 검증합니다.","description":"  ## 기능 설명\n  * 이메일 정보를 검증합니다.\n  ---\n  ## 상세 설명\n  * 이메일 정보를 검증합니다.\n  * 이메일 정보를 수정하기 전 이메일 정보를 검증합니다.\n","operationId":"validateSendEmailBaseInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 발송 대상 정보를 검증합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 발송 대상 정보를 검증합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 이메일 발송 대상 정보를 검증합니다.\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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":{"/v1/system/sendEmailMgmt/validateInsertSendEmailTargetMember":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 발송 대상 정보를 검증합니다.","description":"  ## 기능 설명\n  * 이메일 발송 대상 정보를 검증합니다.\n  ---\n  ## 상세 설명\n  * 이메일 발송 대상 정보를 검증합니다.\n  * 이메일 발송 대상 정보를 등록하기 전에 해당 대상이 이미 등록된 회원인지 체크합니다.\n","operationId":"validateInsertSendEmailTargetMember","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 테스트 이메일을 발송합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 테스트 이메일을 발송합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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":{"/v1/system/sendEmailMgmt/sendTestEmail":{"post":{"tags":["이메일 발송 관리"],"summary":"테스트 이메일을 발송합니다.","description":"  ## 기능 설명\n  * 테스트 이메일을 발송합니다.\n  ---\n  ## 상세 설명\n  * 테스트 이메일을 발송합니다.\n","operationId":"sendTestEmail","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 수신 대상 등록

> &#x20;   \## 기능 설명\
> &#x20;   \* 수신 대상 일괄 등록 시 데이터롤 저장합니다.\
> &#x20;   \---\
> &#x20;   \## 상세 설명\
> &#x20;   \* 수신 대상 일괄 등록 시 최초에 발송 여부 'N'으로 저장합니다.<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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"ResponseInteger":{"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":"integer","format":"int32","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":{"/v1/system/sendEmailMgmt/saveStEmailTgtMbrInfoExcel":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 수신 대상 등록","description":"    ## 기능 설명\n    * 수신 대상 일괄 등록 시 데이터롤 저장합니다.\n    ---\n    ## 상세 설명\n    * 수신 대상 일괄 등록 시 최초에 발송 여부 'N'으로 저장합니다.\n","operationId":"saveStEmailTgtMbrInfoExcel","parameters":[{"name":"emailSndNo","in":"query","description":"이메일 발송 번호","required":true,"schema":{"type":"String"}},{"name":"mbrId","in":"query","description":"회원ID","required":true,"schema":{"type":"String"}},{"name":"applyYn","in":"query","description":"적용여부","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseInteger"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 대상 회원을 등록합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 대상 회원을 등록합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#x20; \* 이메일 대상 회원을 등록합니다.\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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/system/sendEmailMgmt/insertSendEmailTargetMember":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 대상 회원을 등록합니다.","description":"  ## 기능 설명\n  * 이메일 대상 회원을 등록합니다.\n  ---\n  ## 상세 설명\n  * 이메일 대상 회원을 등록합니다.\n  * 이메일에 등록되지 않은 회원 정보를 등록합니다.\n","operationId":"insertSendEmailTargetMember","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}},"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; \* 등록하려는 이메일 번호가 기등록되어있는 경우 수정합니다.<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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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/system/sendEmailMgmt/insertSendEmailBaseInfo":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 기본 정보를 등록/수정합니다.","description":"  ## 기능 설명\n  * 이메일 기본 정보를 등록/수정합니다.\n  ---\n  ## 상세 설명\n  * 이메일 기본 정보를 등록/수정합니다.\n  * 등록하려는 이메일 번호가 기등록되어있는 경우 수정합니다.\n","operationId":"insertSendEmailBaseInfo","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 수신 대상 유효성 검증

> &#x20;   \## 기능 설명\
> &#x20;   \* 수신 대상 일괄 등록 시 대상 회원의 유효성을 검증합니다.\
> &#x20;   \---\
> &#x20;   \## 상세 설명\
> &#x20;   \* 수신 대상 일괄 등록 유효성 검증 후 applyYn, errorCode, errorMsg 결과를 반환합니다.<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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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/system/sendEmailMgmt/getMbrInfoValidation":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 수신 대상 유효성 검증","description":"    ## 기능 설명\n    * 수신 대상 일괄 등록 시 대상 회원의 유효성을 검증합니다.\n    ---\n    ## 상세 설명\n    * 수신 대상 일괄 등록 유효성 검증 후 applyYn, errorCode, errorMsg 결과를 반환합니다.\n","operationId":"getMbrInfoValidation_1","parameters":[{"name":"emailSndNo","in":"query","description":"이메일 발송 번호","required":true,"schema":{"type":"String"}},{"name":"mbrId","in":"query","description":"회원ID","required":true,"schema":{"type":"String"}},{"name":"mbrNm","in":"query","description":"회원명","required":true,"schema":{"type":"String"}},{"name":"validationType","in":"query","description":"유효성 검증 타입","required":true,"schema":{"type":"String"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 대상 회원을 삭제합니다.

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 대상 회원을 삭제합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"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":{"/v1/system/sendEmailMgmt/deleteSendEmailTargetMember":{"post":{"tags":["이메일 발송 관리"],"summary":"이메일 대상 회원을 삭제합니다.","description":"  ## 기능 설명\n  * 이메일 대상 회원을 삭제합니다.\n  ---\n  ## 상세 설명\n  * 이메일 대상 회원을 삭제합니다.\n","operationId":"deleteSendEmailTargetMember","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResponseString"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 발송 대상 정보 목록 조회

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 발송 대상 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"RealGridListResponseSendEmailMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtResponse"}}}},"SendEmailMgmtResponse":{"type":"object","description":"이메일 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일번호"},"emailTitle":{"type":"string","description":"이메일제목"},"emailConts":{"type":"string","description":"이메일내용"},"emailSndMethCd":{"type":"string","description":"발송방식코드"},"emailSndMethCdNm":{"type":"string","description":"발송방식"},"emailSndStatCd":{"type":"string","description":"발송상태코드"},"emailSndStatCdNm":{"type":"string","description":"발송상태"},"emailTypCd":{"type":"string","description":"이메일유형코드"},"emailTypCdNm":{"type":"string","description":"이메일유형"},"emailTrgmnTypCd":{"type":"string","description":"대상자유형코드"},"emailTrgmnTypCdNm":{"type":"string","description":"대상자유형"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"emailSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"emailSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"emailAddr":{"type":"string","description":"이메일 주소"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"mbrEmailSndTrgCount":{"type":"integer","format":"int32","description":"이메일 발송 대상 Count"},"siteNm":{"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/system/sendEmailMgmt/getSendEmailTargetMemberList":{"get":{"tags":["이메일 발송 관리"],"summary":"이메일 발송 대상 정보 목록 조회","description":"  ## 기능 설명\n  * 이메일 발송 대상 목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 이메일 발송 대상 목록을 조회합니다.\n","operationId":"getSendEmailTargetMemberList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}},{"name":"mbrNo","in":"query","description":"회원번호","schema":{"type":"String"}},{"name":"sndRes","in":"query","description":"발송결과","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSendEmailMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 발송 정보 목록 조회

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 발송 목록을 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"RealGridListResponseSendEmailMgmtResponse":{"type":"object","properties":{"totalCount":{"type":"integer","format":"int32"},"payloads":{"type":"array","items":{"$ref":"#/components/schemas/SendEmailMgmtResponse"}}}},"SendEmailMgmtResponse":{"type":"object","description":"이메일 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일번호"},"emailTitle":{"type":"string","description":"이메일제목"},"emailConts":{"type":"string","description":"이메일내용"},"emailSndMethCd":{"type":"string","description":"발송방식코드"},"emailSndMethCdNm":{"type":"string","description":"발송방식"},"emailSndStatCd":{"type":"string","description":"발송상태코드"},"emailSndStatCdNm":{"type":"string","description":"발송상태"},"emailTypCd":{"type":"string","description":"이메일유형코드"},"emailTypCdNm":{"type":"string","description":"이메일유형"},"emailTrgmnTypCd":{"type":"string","description":"대상자유형코드"},"emailTrgmnTypCdNm":{"type":"string","description":"대상자유형"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"emailSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"emailSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"emailAddr":{"type":"string","description":"이메일 주소"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"mbrEmailSndTrgCount":{"type":"integer","format":"int32","description":"이메일 발송 대상 Count"},"siteNm":{"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/system/sendEmailMgmt/getSendEmailList":{"get":{"tags":["이메일 발송 관리"],"summary":"이메일 발송 정보 목록 조회","description":"  ## 기능 설명\n  * 이메일 발송 목록을 조회합니다.\n  ---\n  ## 상세 설명\n  * 이메일 발송 목록을 조회합니다.\n","operationId":"getSendEmailList","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}},{"name":"searchPeriod","in":"query","description":"조회기간 타입","schema":{"type":"String"}},{"name":"sndStrDtm","in":"query","description":"조회기간 시작일","schema":{"type":"LocalDate"}},{"name":"sndEndDtm","in":"query","description":"조회기간 종료일","schema":{"type":"LocalDate"}},{"name":"msgSndMethCd","in":"query","description":"발송 방식(CM023)","schema":{"type":"String"}},{"name":"searchCondition","in":"query","description":"조회 조건(이메일제목/번호)","schema":{"type":"String"}},{"name":"searchConditionContents","in":"query","description":"조회 조건 내용","schema":{"type":"String"}},{"name":"msgSndStatCd","in":"query","description":"발송 상태(CM022)","schema":{"type":"String"}},{"name":"msgTypCd","in":"query","description":"이메일 유형(CM025)","schema":{"type":"String"}},{"name":"msgSndTypCd","in":"query","description":"대상자 유형(CM028)","schema":{"type":"String"}},{"name":"siteNo","in":"query","description":"사이트 번호","schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RealGridListResponseSendEmailMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 이메일 기본 정보 조회

> &#x20; \## 기능 설명\
> &#x20; \* 이메일 기본 정보를 조회합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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":{"SendEmailMgmtRequest":{"type":"object","description":"이메일 발송 Request","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일발송번호"},"searchPeriod":{"type":"string","description":"조회기간 타입"},"sndStrDtm":{"type":"string","format":"date-time","description":"조회기간 시작일"},"sndEndDtm":{"type":"string","format":"date-time","description":"조회기간 종료일"},"emailSndMethCd":{"type":"string","description":"발송 방식(CM023)"},"searchCondition":{"type":"string","description":"조회 조건(이메일제목/번호)"},"searchConditionContents":{"type":"string","description":"조회 조건 내용"},"emailSndStatCd":{"type":"string","description":"발송 상태(CM022)"},"emailTypCd":{"type":"string","description":"이메일 유형(CM025)"},"emailTrgmnTypCd":{"type":"string","description":"대상자 유형(CM028)"},"siteNm":{"type":"string","description":"사이트명"},"sndRes":{"type":"string","description":"발송결과"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송 예약 일시"},"emailNo":{"type":"string","description":"이메일 번호"},"emailTitle":{"type":"string","description":"이메일 제목"},"emailConts":{"type":"string","description":"이메일 내용"},"emailAddr":{"type":"string","description":"이메일 주소"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrMgrNm":{"type":"string","description":"회원관리코드명"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"mbrEmail":{"type":"string","description":"이메일 주소"},"mbrStatCd":{"type":"string","description":"회원상태"},"emailRecvAgrYn":{"type":"string","description":"이메일 수신동의"},"applyYn":{"type":"string","description":"적용여부"},"errorCode":{"type":"string","description":"에러코드"},"errorMsg":{"type":"string","description":"에러메세지"},"duplicationEmailCnt":{"type":"integer","format":"int32","description":"이메일 중복 수"},"validationType":{"type":"string","description":"유효성 검증 타입"},"loginId":{"type":"string","description":"로그인ID"},"tgtMbrNo":{"type":"string","description":"대상자 중복 회원번호"},"dateSelect":{"type":"string","description":"조회기간 선택"}}},"SendEmailMgmtResponse":{"type":"object","description":"이메일 발송 Response","properties":{"siteNo":{"type":"string","description":"사이트 번호"},"emailSndNo":{"type":"string","description":"이메일번호"},"emailTitle":{"type":"string","description":"이메일제목"},"emailConts":{"type":"string","description":"이메일내용"},"emailSndMethCd":{"type":"string","description":"발송방식코드"},"emailSndMethCdNm":{"type":"string","description":"발송방식"},"emailSndStatCd":{"type":"string","description":"발송상태코드"},"emailSndStatCdNm":{"type":"string","description":"발송상태"},"emailTypCd":{"type":"string","description":"이메일유형코드"},"emailTypCdNm":{"type":"string","description":"이메일유형"},"emailTrgmnTypCd":{"type":"string","description":"대상자유형코드"},"emailTrgmnTypCdNm":{"type":"string","description":"대상자유형"},"emailSndRsvDtm":{"type":"string","format":"date-time","description":"발송예약일시"},"sndCnt":{"type":"integer","format":"int32","description":"대상 수"},"notSentCnt":{"type":"integer","format":"int32","description":"미발송 수"},"sucsCnt":{"type":"integer","format":"int32","description":"성공 수"},"failCnt":{"type":"integer","format":"int32","description":"실패 수"},"emailSndStrDtm":{"type":"string","format":"date-time","description":"발송시작일시"},"emailSndEndDtm":{"type":"string","format":"date-time","description":"발송종료일시"},"emailSndSeq":{"type":"string","description":"이메일발송순번"},"mbrNo":{"type":"string","description":"회원번호"},"mbrId":{"type":"string","description":"회원ID"},"mbrNm":{"type":"string","description":"회원명"},"mbrGradeNm":{"type":"string","description":"회원등급명"},"emailAddr":{"type":"string","description":"이메일 주소"},"sendResult":{"type":"string","description":"발송 결과"},"sendResultNm":{"type":"string","description":"발송 결과 명"},"failCaus":{"type":"string","description":"실패 사유"},"mbrEmailSndTrgCount":{"type":"integer","format":"int32","description":"이메일 발송 대상 Count"},"siteNm":{"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/system/sendEmailMgmt/getSendEmailBaseInfo":{"get":{"tags":["이메일 발송 관리"],"summary":"이메일 기본 정보 조회","description":"  ## 기능 설명\n  * 이메일 기본 정보를 조회합니다.\n  ---\n  ## 상세 설명\n  * 이메일 기본 정보를 조회합니다.\n","operationId":"getSendEmailBaseInfo","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/SendEmailMgmtRequest"}},{"name":"emailSndNo","in":"query","description":"이메일 번호","required":true,"schema":{"type":"String"}}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SendEmailMgmtResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```

## 신규 이메일 번호 채번

> &#x20; \## 기능 설명\
> &#x20; \* 신규 이메일 번호를 채번합니다.\
> &#x20; \---\
> &#x20; \## 상세 설명\
> &#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":{"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/system/sendEmailMgmt/getNextEmailSndNo":{"get":{"tags":["이메일 발송 관리"],"summary":"신규 이메일 번호 채번","description":"  ## 기능 설명\n  * 신규 이메일 번호를 채번합니다.\n  ---\n  ## 상세 설명\n  * 신규 이메일 번호를 채번합니다.\n","operationId":"getNextEmailSndNo","responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}}}
```
