# 배송지 관리

배송지를 등록하거나 수정, 삭제 할 수 있으며, 배송지는 개수 제한 없이 등록 가능합니다.\
배송지 등록 혹은 수정 시에 '기본 배송지'를 설정할 수 있으며 기본 배송지는 1개만 설정 가능합니다.\
기본 배송지로 등록된 배송지는 주문 페이지 내 배송지데이터로 출력됩니다.

#### ◼︎ 배송지 목록

등록된 배송지 목록 조회는 아래의 API를 통해 확인 가능합니다.

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

> [GET /profile/shipping-addresses](https://docs.shopby.co.kr/?url.primaryName=order/#/ShippingAddress/get-profile-booked-shipping-addresses)
>
> ▶ 배송지 목록 조회하기\
> 배송지 관리에 등록된 배송지 목록을 조회합니다.

기본 배송지는 삭제가 불가합니다.\
기본배송지로 설정된 주소 삭제를 원하는 경우 기본 배송지 설정을 해제하고 삭제해야 합니다.\
배송지 목록 가져오기를 통해 응답된 값 중 저장된 배송지값을 배송지 관리 목록에 출력할 수 있습니다.

#### ◼︎ 배송지 등록

> [POST /profile/shipping-addresses](https://docs.shopby.co.kr/?url.primaryName=order/#/ShippingAddress/post-profile-shipping-addresses)
>
> ▶ 배송지 등록하기\
> 배송지 관리에 배송지를 등록합니다.

배송지 목록에 배송지를 추가 하는 기능을 제공할 수 있습니다.\
추가 시 <mark style="background-color:yellow;">defaultYn=Y</mark> 로 호출 하는 경우 기본 배송지로 설정됩니다.

기존에 기본 배송지가 설정되어 있는 경우 다른 배송지를 기본배송지로 설정하는 경우 기본 배송지가 변경됩니다.\
개인고유통관부호 입력이 필요한 주소의 경우 <mark style="background-color:yellow;">request body</mark> 값으로 <mark style="background-color:yellow;">customsIdNumber</mark> 값을 추가하여 배송지 등록이 가능합니다.

<figure><img src="/files/7vHcYZn1OFG1gclKn1uH" alt=""><figcaption></figcaption></figure>

\[배송지 등록] 버튼을 통해 출력한 '배송지 등록' 팝업 내 \[우편번호 찾기] 버튼 클릭 시,\
우편번호 찾기를 통한 주소 검색 기능을 제공합니다.

> [GET /addresses/search](https://docs.shopby.co.kr/?url.primaryName=manage/#/Address/search-addresses)
>
> ▶ 주소 조회하기\
> 키워드 검색을 통한 주소정보를 검색합니다.

#### ◼︎ 배송지 수정

등록한 배송지를 수정하고자 하는 경우 아래의 API를 통해 수정 가능합니다.\
배송지 수정 하기를 위해서는 선택한 배송지 정보를 먼저 조회 후 나의 배송지 관리 팝업에서 등록된 정보로 배송지를 먼처 출력하여 제공합니다.

> [GET /profile/shipping-addresses/{addressNo}](https://docs.shopby.co.kr/?url.primaryName=order/#/ShippingAddress/get-profile-shipping-addresses-address-no)
>
> ▶ 배송지 가져오기\
> 선택한 배송지의 세부 정보를 조회합니다.

등록된 정보를 기준으로 구매자가 수정을 완료 한 경우 PUT/ profile/shipping-addresses/{addressNo} 를 통해 배송지 정보를 수정합니다.

> [PUT /profile/shipping-addresses/{addressNo}](https://docs.shopby.co.kr/?url.primaryName=order/#/ShippingAddress/put-profile-shipping-addresses-address-no)
>
> ▶ 배송지 수정하기\
> 선택한 배송지 정보를 수정합니다.

배송지 수정하기 API는 나의 배송지 관리 팝업 내 저장 버튼 클릭 시 호출하여 입력 값을 저장합니다.

#### ◼︎ 배송지 삭제

배송지 관리 목록 내 \[삭제] 버튼 클릭 시 선택한 배송지를 삭제 처리 합니다.

> [DELETE /profile/shipping-addresses/{addressNo}](https://docs.shopby.co.kr/?url.primaryName=order/#/ShippingAddress/delete-profile-shipping-addresses-address-no)
>
> ▶ 배송지 삭제하기\
> 선택한 배송지 정보를 삭제합니다.

기본 배송지로 설정된 배송지는 삭제할 수 없습니다.\
기본 배송지 삭제 시도 시 응답 되는 에러 메시지를 참고 하여 안내해주시면 됩니다.


---

# 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://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-member/shipping-list.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.