> 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/goods/product-detail-delivery-information.md).

# Product Detail Delivery Information

Retrieves the currently active delivery policy based on the partner number (entrNo), delivery fee policy number (deliPolcNo), and product number (goodsNo), and provides the information used to compose the delivery/exchange/return popup layer on the product detail page on the front end. It also provides delivery fee and delivery/exchange/return information based on the partner number (entrNo) and delivery fee policy number (deliPolcNo).

***

## Key Features

**Retrieve Delivery Fee Policy Information**

* Retrieves delivery fee policy information such as delivery fee type, base amount, delivery fee amount, additional delivery fee, return delivery fee, and exchange delivery fee.
* Once saved, a delivery fee policy cannot be edited or deleted, and is managed by its usage status instead.
* Delivery-related amounts can be entered in units of 100 KRW, with constraints depending on the delivery fee type.

**Constraints on Entering Delivery-Related Amounts**

* Additional delivery fee, return delivery fee, and exchange delivery fee can be entered as 0 or more. (Entering 0 is allowed.)
* If the delivery fee type is 'Free', the base amount is 0 (disabled), and the delivery fee amount can be entered as 0 or more. (Entering 0 is allowed.)
* If the delivery fee type is 'Paid', the base amount is 0 (disabled), and the delivery fee amount must be entered as 100 or more. (Entering 0 is not allowed.)
* If the delivery fee type is 'Conditionally Free', the base amount must be entered as 100 or more (entering 0 is not allowed), and the delivery fee amount must be entered as 100 or more. (Entering 0 is not allowed.)

**Duplicate Save Restriction**

* Cannot save a delivery fee policy as a duplicate if the partner number, delivery fee type, base amount, delivery fee amount, additional delivery fee, return delivery fee, and exchange delivery fee are all identical to an existing one.

## Process Definition

<figure><img src="https://2999922013-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXTxKSWMmuxEkop1pvuwe%2Fuploads%2FlxcgJwKuAkMfJbOWiPbv%2F183140507.jpg?alt=media&#x26;token=7cca8163-844e-40ec-b3b2-29ce1fc7ad33" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Retrieve Delivery/Exchange/Return Information per Product

Based on the product number, retrieves the delivery method, delivery region, delivery information, delivery fee, exchange/return period, exchange/return availability, exchange/return delivery fee, and return address, and displays them on the delivery/exchange/return popup screen.
{% endstep %}

{% step %}

### Retrieve Delivery Fee by Delivery Policy Number

Retrieves delivery policy information based on the delivery policy number and provides that information to other modules.
{% endstep %}
{% endstepper %}

## API Function List

<table data-full-width="false"><thead><tr><th>API</th><th width="333.4444580078125">Description</th><th width="100.22216796875">Server</th><th width="93.5555419921875">Method</th><th>Notes</th></tr></thead><tbody><tr><td><p>Retrieve Delivery Fee</p><p>by Delivery Policy Number</p></td><td><ul><li>Retrieves the basic delivery policy information list based on the partner and delivery fee policy number.</li><li>Only retrieves delivery<br>policies whose basic usage status is Y.</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">🔗View API ></a></td></tr><tr><td><p>Retrieve Delivery/Exchange/Return</p><p>Information by Partner</p></td><td><ul><li>Retrieves the basic delivery policy<br>information list based on the partner number.</li><li>Only retrieves delivery<br>policies whose basic usage status is Y.</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">🔗View API ></a></td></tr><tr><td><p>Retrieve Delivery/</p><p>Exchange/Return Information per Product</p></td><td><ul><li>API used in the delivery/exchange/return<br>popup on the product detail screen.</li><li>Retrieves the basic delivery policy information and the partner's delivery origin information list, based on the product number.</li><li>Only retrieves delivery<br>policies whose basic usage status is 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=getPdReturnOrChangeInfo">🔗View API ></a></td></tr><tr><td>Retrieve Product Delivery Fee</td><td><ul><li>Retrieves the basic delivery policy information list based on the product number.</li><li>Only retrieves delivery policies whose basic usage status is 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">🔗View API ></a></td></tr></tbody></table>

## Terminology

<table><thead><tr><th width="148.4444580078125">Term</th><th>Description</th><th data-hidden>Notes</th></tr></thead><tbody><tr><td>Partner</td><td>Refers to any business entity that provides or receives products and services through the shopping mall.</td><td></td></tr><tr><td>Product Supplier</td><td>A partner that provides products and services to customers through the shopping mall.</td><td></td></tr><tr><td>Affiliate Company</td><td>A company that partners with the shopping mall to provide products and services to customers.<br>(e.g., Naver, Daum, etc.)</td><td></td></tr><tr><td>Additional Delivery Fee Amount</td><td>An additional charge, on top of the base delivery fee, applied for remote or island areas.</td><td></td></tr></tbody></table>

## Additional Notes

* The Retrieve Delivery Fee by Delivery Policy Number API retrieves information corresponding to the partner and delivery policy number in the body.

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

* The Retrieve Delivery/Exchange/Return Information by Partner API retrieves information corresponding to the partner number in the path.

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

* The Retrieve Delivery/Exchange/Return Information per Product API retrieves information corresponding to the product number in the path.

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

* The Retrieve Product Delivery Fee API retrieves information corresponding to the product number in the parameter.

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

##