> 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/store-front-api/member-api/undefined-4.md).

# 회원배송지

## 회원배송지 목록 조회

> \## 기능설명\
> \* 회원의 배송지 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 파라미터인 \*\*baseDlvpYn을 Y\*\*로 보내면 \*\*기본배송지\*\*로 등록된 회원배송지만 조회합니다.\
> \* 파라미터인 \*\*baseDlvpYn을 N/null\*\*로 보내면 \*\*전체 배송지 목록\*\*을 조회합니다.\
> \---\
> \## 수정번호\
> \* \`\`\`Release v2.00\_240401\`\`\`: Response DTO 내 배송지 최대 저장 가능 건수 추가<br>

````json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/front/dlvpInfo":{"get":{"tags":["회원배송지"],"summary":"회원배송지 목록 조회","description":"## 기능설명\n* 회원의 배송지 목록을 조회합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 파라미터인 **baseDlvpYn을 Y**로 보내면 **기본배송지**로 등록된 회원배송지만 조회합니다.\n* 파라미터인 **baseDlvpYn을 N/null**로 보내면 **전체 배송지 목록**을 조회합니다.\n---\n## 수정번호\n* ```Release v2.00_240401```: Response DTO 내 배송지 최대 저장 가능 건수 추가\n","operationId":"getDlvpInfoList","parameters":[{"name":"baseDlvpYn","in":"query","description":"기본배송지여부","required":false,"schema":{"type":"String","enum":["Y","N"]}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EtMbrDlvpInfoResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtMbrDlvpInfoResponse":{"type":"object","description":"배송지조회 Response","properties":{"totCnt":{"type":"string","description":"전체건수"},"dlvpList":{"type":"array","description":"배송지리스트","items":{"$ref":"#/components/schemas/EtMbrDlvpInfoDtoResponse"}},"maxDlvpCnt":{"type":"integer","format":"int32","description":"배송지 최대 저장 가능건수"}}},"EtMbrDlvpInfoDtoResponse":{"type":"object","description":"배송지관리 - 배송지리스트 Dto Response","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrDlvpSeq":{"type":"string","description":"회원배송지순번"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"zipNoSeq":{"type":"integer","format":"int32","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"emailAddr":{"type":"string","description":"이메일"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"deliMsgCd":{"type":"string","description":"배송지코드(ME039)"},"deliMsg":{"type":"string","description":"배송메세지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"마스킹되지 않은 공동현관비밀번호"},"useYn":{"type":"string","description":"사용여부"},"userSortSeq":{"type":"integer","format":"int32","description":"사용자정렬순서"},"comnFrdrPwdMask":{"type":"string","description":"마스킹된 공동현관비밀번호"},"pcccSeq":{"type":"string","description":"회원통관고유부호순번"},"persCstmCd":{"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"}}}}}}
````

## 회원배송지 등록

> \## 기능설명\
> \* 회원배송지를 등록합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 배송지는 최대 10개까지 등록 가능합니다.\
> \* 등록 후 등록된 회원배송지의 순번을 반환합니다.\
> \---\
> \## 특이사항\
> \* 정상 등록 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.\
> \## 수정번호\
> \* Release v1.06\_231218: 배송지는 최대 공통코드 ST017의 참조1값 까지 등록 가능합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/front/dlvpInfo":{"post":{"tags":["회원배송지"],"summary":"회원배송지 등록","description":"## 기능설명\n* 회원배송지를 등록합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 배송지는 최대 10개까지 등록 가능합니다.\n* 등록 후 등록된 회원배송지의 순번을 반환합니다.\n---\n## 특이사항\n* 정상 등록 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.\n## 수정번호\n* Release v1.06_231218: 배송지는 최대 공통코드 ST017의 참조1값 까지 등록 가능합니다.\n","operationId":"insertDlvpInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtMbrDlvpInfo":{"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrDlvpSeq":{"type":"string","description":"회원배송지순번"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"zipNoSeq":{"type":"integer","format":"int32","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"emailAddr":{"type":"string","description":"이메일"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"deliMsgCd":{"type":"string","description":"배송지코드(ME039)"},"deliMsg":{"type":"string","description":"배송메세지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"useYn":{"type":"string","description":"사용여부"},"userSortSeq":{"type":"integer","format":"int32","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"}}}}}}
```

## 회원배송지 수정

> \## 기능설명\
> \* 회원배송지를 수정합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 존재하지 않는 회원배송지순번일 경우에는 수정할 수 없습니다.\
> \* 기본배송지로 등록되어 있는 경우에는 기본배송지 해제 처리할 수 없습니다. (최소 1개의 기본배송지가 존재해야합니다.)\
> \* 수정 후 수정된 회원배송지의 순번을 반환합니다.\
> \---\
> \## 특이사항\
> \* 정상 수정 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/front/dlvpInfo":{"put":{"tags":["회원배송지"],"summary":"회원배송지 수정","description":"## 기능설명\n* 회원배송지를 수정합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 존재하지 않는 회원배송지순번일 경우에는 수정할 수 없습니다.\n* 기본배송지로 등록되어 있는 경우에는 기본배송지 해제 처리할 수 없습니다. (최소 1개의 기본배송지가 존재해야합니다.)\n* 수정 후 수정된 회원배송지의 순번을 반환합니다.\n---\n## 특이사항\n* 정상 수정 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.\n","operationId":"updateDlvpInfo","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EtMbrDlvpInfo"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"EtMbrDlvpInfo":{"type":"object","properties":{"mbrNo":{"type":"string","description":"회원번호"},"mbrDlvpSeq":{"type":"string","description":"회원배송지순번"},"dlvpNm":{"type":"string","description":"배송지명"},"rcvmnNm":{"type":"string","description":"수취인명"},"baseDlvpYn":{"type":"string","description":"기본배송지여부"},"zipNoSeq":{"type":"integer","format":"int32","description":"우편번호순번"},"zipNo":{"type":"string","description":"우편번호"},"zipAddr":{"type":"string","description":"우편주소"},"dtlAddr":{"type":"string","description":"상세주소"},"emailAddr":{"type":"string","description":"이메일"},"cellSctNo":{"type":"string","description":"휴대폰구분번호"},"cellTxnoNo":{"type":"string","description":"휴대폰국번번호"},"cellEndNo":{"type":"string","description":"휴대폰끝번호"},"telRgnNo":{"type":"string","description":"전화지역번호"},"telTxnoNo":{"type":"string","description":"전화국번번호"},"telEndNo":{"type":"string","description":"전화끝번호"},"deliMsgCd":{"type":"string","description":"배송지코드(ME039)"},"deliMsg":{"type":"string","description":"배송메세지"},"comnFrdrCogoMethodCd":{"type":"string","description":"공동현관출입방법코드(ME040)"},"comnFrdrEtcMethod":{"type":"string","description":"공동현관기타방법"},"comnFrdrPwd":{"type":"string","description":"공동현관비밀번호"},"useYn":{"type":"string","description":"사용여부"},"userSortSeq":{"type":"integer","format":"int32","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"}}}}}}
```

## 회원배송지 삭제

> \## 기능설명\
> \* 회원배송지를 삭제합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 파라미터로 넘어온 회원배송지순번에 맞는 회원배송지를 삭제합니다.\
> \* 존재하지 않는 회원배송지순번일 경우에는 삭제할 수 없습니다.\
> \* 기본배송지로 등록되어 있는 경우에는 삭제 처리할 수 없습니다. (최소 1개의 기본배송지가 존재해야합니다.)\
> \---\
> \## 특이사항\
> \* 정상 삭제 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/front/dlvpInfo":{"delete":{"tags":["회원배송지"],"summary":"회원배송지 삭제","description":"## 기능설명\n* 회원배송지를 삭제합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 파라미터로 넘어온 회원배송지순번에 맞는 회원배송지를 삭제합니다.\n* 존재하지 않는 회원배송지순번일 경우에는 삭제할 수 없습니다.\n* 기본배송지로 등록되어 있는 경우에는 삭제 처리할 수 없습니다. (최소 1개의 기본배송지가 존재해야합니다.)\n---\n## 특이사항\n* 정상 삭제 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.\n","operationId":"deleteDlvpInfo","parameters":[{"name":"mbrDlvpSeq","in":"query","description":"회원배송지순번","required":true,"schema":{"type":"string"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"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"}}}}}}
```

## 회원 기본배송지 저장

> \## 기능설명\
> \* 넘어온 회원배송지순번의 배송지를 기본배송지로 변경합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 기본배송지로 등록되어 있는 경우에는 기본배송지 해제 처리할 수 없습니다. (최소 1개의 기본배송지가 존재해야합니다.)\
> \* 존재하지 않는 회원배송지순번일 경우에는 기본배송지로 변경할 수 없습니다.\
> \---\
> \## 특이사항\
> \* 정상 변경 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.\
> \* 기본배송지여부(baseDlvpYn)는 Y, N 만 가능합니다.<br>

```json
{"openapi":"3.1.0","info":{"title":"X2BEE Member API","version":"v1"},"servers":[{"url":"https://api-member.x2bee.com/api/member/","description":"prd"}],"paths":{"/v1/front/dlvpDetailInfo":{"put":{"tags":["회원배송지"],"summary":"회원 기본배송지 저장","description":"## 기능설명\n* 넘어온 회원배송지순번의 배송지를 기본배송지로 변경합니다.\n---\n## 상세설명\n* 로그인은 필수입니다.\n* 기본배송지로 등록되어 있는 경우에는 기본배송지 해제 처리할 수 없습니다. (최소 1개의 기본배송지가 존재해야합니다.)\n* 존재하지 않는 회원배송지순번일 경우에는 기본배송지로 변경할 수 없습니다.\n---\n## 특이사항\n* 정상 변경 후 이벤트DB에 해당 배송지순번 및 배송지 정보를 동기화 처리합니다.\n* 기본배송지여부(baseDlvpYn)는 Y, N 만 가능합니다.\n","operationId":"dlvpDetailInfo","parameters":[{"name":"changeBaseDlvpRequest","in":"query","description":"기등록된 배송지 정보","required":true,"schema":{"type":"string","description":"ChangeBaseDlvpRequest"}},{"name":"userDetail","in":"query","description":"회원 정보","required":true,"schema":{"type":"string","description":"UserDetail"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeBaseDlvpRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ChangeBaseDlvpRequest":{"type":"object","description":"기본배송지 변경 Request","properties":{"mbrDlvpSeq":{"type":"string","description":"회원배송지순번","minLength":1},"baseDlvpYn":{"type":"string","description":"기본배송지여부","minLength":1}},"required":["baseDlvpYn","mbrDlvpSeq"]},"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"}}}}}}
```