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

# 배송지 관리

회원이 주문, 반품, 교환 등의 서비스를 이용할 때 사용할 배송지 정보를 관리하는 기능입니다. 이를 통해 회원은 여러 배송지를 등록하고, 편리하게 주문 및 교환이 가능합니다.

***

## 주요 기능

* **회원 배송지 등록**
  * 로그인한 회원은 신규 배송지를 등록하여 주문 시 해당 배송지로 상품을 수령할 수 있습니다.
  * 한 회원당 최대 10개의 배송지를 등록할 수 있습니다.
* **기본 배송지 설정**
  * 기본 배송지는 필수로 1개가 존재해야 합니다.
  * 회원가입 시 입력한 배송지가 초기 기본 배송지로 설정되며, 이후에도 변경 가능합니다.
* **배송지 정보 수정 및 삭제**
  * 등록된 배송지 정보는 언제든지 수정하거나 삭제할 수 있습니다.
  * 수정된 정보는 주문서나 반품/교환 페이지에서 반영됩니다.
* **배송지 선택 및 주문**
  * 주문 시 기본 배송지가 자동으로 선택되며, 필요에 따라 다른 배송지로 변경 가능합니다.
  * 주문서 작성 시 저장된 배송지 목록 중 선택하여 사용할 수 있습니다.

## 프로세스 정의

<figure><img src="/files/phnzfth8IQPoidRtv81L" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### 비밀번호 재확인

마이페이지에서 회원 배송지정보 페이지에 접근할 시 로그인 비밀번호 재확인을 거쳐야 합니다.
{% endstep %}

{% step %}

### 회원 배송지 조회

로그인 된 회원에 대한 회원배송지 전체 목록을 조회합니다. 해당 api 는 기본배송지여부를 Y로 보내면 기본배송지만 조회할 수 있습니다.
{% endstep %}

{% step %}

### 회원 배송지 등록

로그인 된 회원에 대한 신규 배송지를 등록합니다. 기 등록된 회원배송지의 개수가 10개일 시 등록할 수 없습니다. 최초 배송지 등록일 시 기본 배송지로 등록됩니다. 이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.
{% endstep %}

{% step %}

### 회원 배송지 수정

로그인 된 회원에 대한 배송지를 수정합니다. 현재 기본배송지로 등록 되어있으면 기본배송지를 N으로 수정할 수 없습니다. 이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.
{% endstep %}

{% step %}

### 회원 배송지 삭제

로그인 된 회원에 대한 배송지를 삭제합니다. 기본배송지로 등록된 배송지는 삭제할 수 없습니다. 이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.
{% endstep %}

{% step %}

### 기본 배송지로 변경

로그인 된 회원에 대한 배송지를 기본배송지로 변경합니다. 이벤트 데이터베이스와 동기화하기 위해 이벤트 api를 호출합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table><thead><tr><th width="121.22216796875">API</th><th width="259.3333740234375">설명</th><th width="95.77783203125">Server</th><th width="93.8887939453125">메소드</th><th>비고</th></tr></thead><tbody><tr><td>회원배송지 목록 조회</td><td>로그인된 회원의 배송지 목록을 조회합니다. <br>파라미터 baseDlvpYn을 Y로 <br>할 시 기본배송지만 조회합니다.</td><td>Member</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EB%B0%B0%EC%86%A1%EC%A7%80&#x26;path=getDlvpInfoList">🔗API 확인하기 ></a></td></tr><tr><td>회원배송지 등록</td><td>로그인한 회원의 배송지를 <br>신규로 등록합니다.</td><td>Member</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EB%B0%B0%EC%86%A1%EC%A7%80&#x26;path=insertDlvpInfo">🔗API 확인하기 ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr><tr><td>회원배송지 수정</td><td>로그인한 회원의 배송지를 <br>수정합니다.</td><td>Member</td><td>PUT</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EB%B0%B0%EC%86%A1%EC%A7%80&#x26;path=updateDlvpInfo">🔗API 확인하기 ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr><tr><td>회원배송지 삭제</td><td>로그인한 회원의 배송지를 <br>삭제합니다.</td><td>Member</td><td>DELETE</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EB%B0%B0%EC%86%A1%EC%A7%80&#x26;path=deleteDlvpInfo">🔗API 확인하기 ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr><tr><td>회원 기본<br>배송지 저장</td><td>회원이 선택한 배송지를 기본 <br>배송지로 변경합니다.</td><td>Member</td><td>PUT</td><td><a href="http://api.x2bee.com/content?msa=member&#x26;depth=%ED%9A%8C%EC%9B%90%EB%B0%B0%EC%86%A1%EC%A7%80&#x26;path=dlvpDetailInfo">🔗API 확인하기 ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="109.5555419921875">명칭</th><th>설명</th><th data-hidden></th></tr></thead><tbody><tr><td>기본배송지</td><td>기본배송지는 해당 고객이 서비스를 이용할 때 자주 사용되며, 사용자가 새로운 배송지를 지정하지 않을 경우에는 기본적으로 이 주소로 상품이 배송됩니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* 배송지 목록 조회 api 에서 쿼리스트링으로 baseDlvpYn (기본배송지여부) 를 Y로 보낼 시 기본배송지만 조회합니다.
* 1개의 기본 배송지가 필수로 존재해야 합니다.
  * 배송지 삭제 시 해당 배송지가 기본배송지여부 Y이면 삭제 불가
  * 배송지 수정 시 해당 배송지가 기본배송지여부 Y인데 N으로 수정 불가
* 회원 메인 데이터베이스와 이벤트 메인 데이터베이스가 분리되어 있기 때문에 배송지 정보가 변경될 시 배송지 정보를 동기화 하는 이벤트 API 를 호출합니다.

<table><thead><tr><th width="162.8887939453125">구분</th><th>파라미터 체크 항목</th></tr></thead><tbody><tr><td>회원 배송지 등록</td><td><ul><li>회원번호</li><li>배송지명</li><li>수취인명</li><li>휴대폰번호 (구분번호, 국번번호, 끝번호)</li><li>우편번호</li><li>주소, 상세주소</li><li>기본배송지유무</li></ul></td></tr><tr><td>회원 배송지 수정</td><td><ul><li>회원번호</li><li>회원배송지순번</li><li>배송지명</li><li>수취인명</li><li>휴대폰번호 (구분번호, 국번번호, 끝번호)</li><li>우편번호</li><li>주소, 상세주소</li><li>기본배송지유무</li></ul></td></tr><tr><td>회원 배송지 삭제</td><td><ul><li>회원번호</li><li>회원배송지순번</li></ul></td></tr><tr><td>기본 배송지로 변경</td><td><ul><li>회원번호</li><li>회원배송지순번</li></ul></td></tr></tbody></table>