# 배송지 관리

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

***

## 주요 기능

* **회원 배송지 등록**
  * 로그인한 회원은 신규 배송지를 등록하여 주문 시 해당 배송지로 상품을 수령할 수 있습니다.
  * 한 회원당 최대 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>


---

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