> 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/goods/undefined-5.md).

# 상품상세 배송정보

협력사번호(entrNo), 배송비 정책번호(deliPolcNo), 상품번호(goodsNo)를 기준으로 현재 사용 중인 배송 정책을 조회하며, Front 화면에서 상품상세 배송/교환/반품 레이어 팝업을 구성하기 위한 정보를 제공합니다. 또한, 협력사번호(entrNo)와 배송비 정책번호(deliPolcNo)를 기준으로 배송비와 배송교환반품 정보를 제공합니다.

***

## 주요 기능

**배송비 정책 정보 조회**

* 배송비 형태, 기준 금액, 배송비 금액, 추가 배송비, 회수 배송비, 교환 배송비 등 배송비 정책 정보를 조회합니다.
* 배송비 정책은 저장 이후 수정이 불가하며, 삭제가 불가능합니다. 사용 여부로 관리됩니다.
* 배송 관련 금액은 100원 단위로 입력 가능하며, 배송비 형태에 따라 제약이 있습니다.

**배송 관련 금액 입력 제약**

* 추가 배송비, 회수 배송비, 교환 배송비는 0원 이상 입력 가능합니다. (0원 입력 허용)
* 배송비 형태가 '무료'인 경우, 기준 금액은 0원(비활성)이며 배송비 금액은 0원 이상 입력 가능합니다. (0원 입력 허용)
* 배송비 형태가 '유료'인 경우, 기준 금액은 0원(비활성)이며 배송비 금액은 100원 이상 입력 가능합니다. (0원 입력 불가)
* 배송비 형태가 '조건부 무료'인 경우, 기준 금액은 100원 이상 입력 가능(0원 입력 불가)이며 배송비 금액은 100원 이상 입력 가능합니다. (0원 입력 불가)

**중복 저장 제한**

* 협력사 번호, 배송비 형태, 기준 금액, 배송비 금액, 추가 배송비, 회수 배송비, 교환 배송비가 동일한 경우, 배송비 정책 중복으로 저장이 불가합니다.

## 프로세스 정의

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

{% stepper %}
{% step %}

### 상품별 배송교환반품 정보 조회

상품번호 기준으로 배송방식, 배송지역, 배송정보, 배송비, 교환/반품 기간, 교환/반품 가능여부, 교환/반품 배송비, 반품지를 조회하여 배송/교환/반품 팝업 화면에 노출합니다.
{% endstep %}

{% step %}

### 배송정책번호 별 배송비 조회

배송정책번호 기준으로 배송정책정보를 조회하여 해당 정보를 타 모듈에 제공합니다.
{% endstep %}
{% endstepper %}

## API 기능 목록

<table data-full-width="false"><thead><tr><th>API</th><th width="333.4444580078125">설명</th><th width="100.22216796875">Server</th><th width="93.5555419921875">메소드</th><th>비고</th></tr></thead><tbody><tr><td><p>배송정책번호별 배송비 </p><p>조회</p></td><td><ul><li>협력사, 배송비 정책번호 기준으로 배송정책기본 정보 목록을 조회합니다. </li><li>배송정책기본 사용 여부가 Y인 배송 <br>정책에 대해 조회합니다.</li></ul></td><td>Goods</td><td>POST</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20%EB%B0%B0%EC%86%A1%EC%A0%95%EB%B3%B4&#x26;path=getDeliProcInfo">🔗API 확인하기></a></td></tr><tr><td><p>협력사별 배송교환반품 </p><p>정보 조회</p></td><td><ul><li>협력사 번호 기준으로 배송정책기본 <br>정보 목록을 조회합니다. </li><li>배송정책기본 사용 여부가 Y인 배송 <br>정책에 대해 조회합니다.</li></ul></td><td>Goods</td><td>GET</td><td><a href="http://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20%EB%B0%B0%EC%86%A1%EC%A0%95%EB%B3%B4&#x26;path=getTrReturnOrChangeInfo">🔗API 확인하기></a></td></tr><tr><td><p>상품별 배송</p><p>교환반품 정보 조회</p></td><td><ul><li>상품상세 화면의 배송/교환/반품 <br>팝업에서 사용하는 API 입니다. </li><li>상품번호 기준으로 배송정책 기본정보 및 협력사 배송지정보 목록을 조회합니다. </li><li>배송정책기본 사용 여부가 Y인 배송 <br>정책에 대해 조회합니다.</li></ul></td><td>Goods</td><td>GET</td><td><a href="https://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20%EB%B0%B0%EC%86%A1%EC%A0%95%EB%B3%B4&#x26;path=getPdReturnOrChangeInfo">🔗API 확인하기></a></td></tr><tr><td>상품 배송비 조회</td><td><ul><li>상품번호 기준으로 배송정책 기본정보 목록을 조회합니다. </li><li>배송정책기본 사용 여부가 Y인 배송 정책에 대해 조회합니다.</li></ul></td><td>Goods</td><td>GET</td><td><a href="https://api.x2bee.com/content?msa=goods&#x26;depth=%EC%83%81%ED%92%88%EC%83%81%EC%84%B8%20%EB%B0%B0%EC%86%A1%EC%A0%95%EB%B3%B4&#x26;path=getGoodsDeliPolicyInfo">🔗API 확인하기></a></td></tr></tbody></table>

## 용어 정의

<table><thead><tr><th width="148.4444580078125">명칭</th><th>설명</th><th data-hidden>비고</th></tr></thead><tbody><tr><td>협력사</td><td>쇼핑몰에 상품 및 서비스를 제공하거나 제공받는 모든 거래업체를 의미합니다.</td><td></td></tr><tr><td>상품공급업체</td><td>쇼핑몰을 통해 고객에게 상품 및 서비스를 제공하는 협력사입니다.</td><td></td></tr><tr><td>제휴업체</td><td>쇼핑몰과 제휴하여 고객에게 상품 및 서비스를 제공하는 업체입니다. <br>(ex. 네이버, 다음 등)</td><td></td></tr><tr><td>추가배송비 금액</td><td>기본 배송비 외 도서산간 지역에 붙는 추가 비용입니다.</td><td></td></tr></tbody></table>

## 기타 참고사항

* 배송정책번호별 배송비 조회 API는 body의 협력사와 배송정책번호에 해당하는 정보를 조회합니다.&#x20;

```
ex) [ { “entrNo” : 1000181, ”deliPolcNo” : 10000371 }, { “entrNo” : 1000211, ”deliPolcNo” : 10000441 } ]
```

* 협력사별 배송교환반품 정보 조회 API는 path의 협력사 번호에 해당하는 정보를 조회합니다.&#x20;

```
ex) /v1/delivery/tr/1000001
```

* 상품별 배송교환반품 정보 조회 API는 path의 상품 번호에 해당하는 정보를 조회합니다.&#x20;

```
ex) /v1/delivery/pd/10000910
```

* 상품 배송비 조회 API는 파라미터의 상품 번호에 해당하는 정보를 조회합니다.&#x20;

```
ex) ?goodsNos=10001861,10001742
```

##


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://tech.x2bee.com/api-guide/store-front/goods/undefined-5.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.