# 회원배송지

## 회원배송지 목록 조회

> \## 기능설명\
> \* 회원의 배송지 목록을 조회합니다.\
> \---\
> \## 상세설명\
> \* 로그인은 필수입니다.\
> \* 파라미터인 \*\*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"}}}}}}
```


---

# 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/store-front-api/member-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.
