> 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/api-guides-en/store-front/member/delivery-address-management.md).

# Delivery Address Management

A feature for managing the delivery address information members use when placing orders, returns, exchanges, and similar services. This allows members to register multiple delivery addresses and conveniently place orders or process exchanges.

***

## Key Features

* **Register Member Delivery Address**
  * Logged-in members can register a new delivery address to receive products at that address when ordering.
  * Each member can register up to 10 delivery addresses.
* **Default Delivery Address Setting**
  * A default delivery address is required, and exactly 1 must always exist.
  * The delivery address entered at sign-up is initially set as the default delivery address, and can be changed afterward.
* **Modify and Delete Delivery Address Information**
  * Registered delivery address information can be modified or deleted at any time.
  * Modified information is reflected on the order form and the return/exchange page.
* **Select Delivery Address and Order**
  * The default delivery address is automatically selected when ordering, and can be changed to a different address as needed.
  * When filling out the order form, a delivery address can be selected from the saved list.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FYlMhakR3vU4CEFc5ykum%2F%E1%84%92%E1%85%AC%E1%84%8B%E1%85%AF%E1%86%AB%E1%84%87%E1%85%A2%E1%84%89%E1%85%A9%E1%86%BC%E1%84%8C%E1%85%B5.png?alt=media&#x26;token=20957217-6ec2-48ec-9d9b-a6083d9ec2c6" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Re-verify Password

When accessing the member delivery address page on My Page, the login password must be re-verified.
{% endstep %}

{% step %}

### Get Member Delivery Addresses

Retrieves the full list of member delivery addresses for the logged-in member. This API can retrieve only the default delivery address by passing Y for the default delivery address flag.
{% endstep %}

{% step %}

### Register Member Delivery Address

Registers a new delivery address for the logged-in member. Registration is not allowed once the member already has 10 registered delivery addresses. The first registered address is set as the default delivery address. The event API is called to synchronize with the event database.
{% endstep %}

{% step %}

### Modify Member Delivery Address

Modifies a delivery address for the logged-in member. If the address is currently set as the default delivery address, it cannot be changed to N for default delivery address status. The event API is called to synchronize with the event database.
{% endstep %}

{% step %}

### Delete Member Delivery Address

Deletes a delivery address for the logged-in member. An address registered as the default delivery address cannot be deleted. The event API is called to synchronize with the event database.
{% endstep %}

{% step %}

### Change to Default Delivery Address

Changes a delivery address for the logged-in member to the default delivery address. The event API is called to synchronize with the event database.
{% endstep %}
{% endstepper %}

## API Function List

<table><thead><tr><th width="121.22216796875">API</th><th width="259.3333740234375">Description</th><th width="95.77783203125">Server</th><th width="93.8887939453125">Method</th><th>Remarks</th></tr></thead><tbody><tr><td>Get Member Delivery Address List</td><td>Retrieves the list of delivery addresses for the logged-in member.<br>If the baseDlvpYn parameter is set to Y,<br>only the default delivery address is retrieved.</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">🔗View API ></a></td></tr><tr><td>Register Member Delivery Address</td><td>Registers a new delivery address<br>for the logged-in member.</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">🔗View API ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr><tr><td>Modify Member Delivery Address</td><td>Modifies a delivery address<br>for the logged-in member.</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">🔗View API ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr><tr><td>Delete Member Delivery Address</td><td>Deletes a delivery address<br>for the logged-in member.</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">🔗View API ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr><tr><td>Save Member Default<br>Delivery Address</td><td>Changes the delivery address selected by the member to the default<br>delivery address.</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">🔗View API ></a><br>api/event/v1/common/mergeMbrDlvp</td></tr></tbody></table>

## Definition of Terms

<table><thead><tr><th width="109.5555419921875">Term</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Default Delivery Address</td><td>The default delivery address is the address most frequently used by the customer when using the service; if the user does not specify a different delivery address, products are shipped to this address by default.</td><td></td></tr></tbody></table>

## Other Notes

* In the Get Delivery Address List API, if baseDlvpYn (default delivery address flag) is passed as Y in the query string, only the default delivery address is retrieved.
* Exactly 1 default delivery address must always exist.
  * When deleting a delivery address, deletion is not allowed if that address has default delivery address status Y
  * When modifying a delivery address, it cannot be changed from Y to N for default delivery address status
* Since the member main database and the event main database are separate, whenever delivery address information changes, the event API is called to synchronize the delivery address information.

<table><thead><tr><th width="162.8887939453125">Category</th><th>Parameter Check Items</th></tr></thead><tbody><tr><td>Register Member Delivery Address</td><td><ul><li>Member number</li><li>Delivery address name</li><li>Recipient name</li><li>Mobile phone number (area code, exchange number, subscriber number)</li><li>Postal code</li><li>Address, detailed address</li><li>Default delivery address status</li></ul></td></tr><tr><td>Modify Member Delivery Address</td><td><ul><li>Member number</li><li>Member delivery address sequence number</li><li>Delivery address name</li><li>Recipient name</li><li>Mobile phone number (area code, exchange number, subscriber number)</li><li>Postal code</li><li>Address, detailed address</li><li>Default delivery address status</li></ul></td></tr><tr><td>Delete Member Delivery Address</td><td><ul><li>Member number</li><li>Member delivery address sequence number</li></ul></td></tr><tr><td>Change to Default Delivery Address</td><td><ul><li>Member number</li><li>Member delivery address sequence number</li></ul></td></tr></tbody></table>