---
title: "Configuring returns"
slug: "configuring-returns"
tags: ["config api", "Associate App", "shipping", "platform", "exchange", "refund", "api", "omnichannel manager ", "return"]
updated: 2024-11-27T11:00:03Z
published: 2024-11-27T11:00:03Z
canonical: "docs.newstore.com/configuring-returns"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newstore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring returns

## Configuring returns

Use these configurations to set up options that apply to returns in the NewStore platform. These include:

- [Configuring a return window](/v1/docs/configuring-returns#configuring-a-return-window)
- [Specifying a return fee](/v1/docs/configuring-returns#configuring-return-fees)
- [Configuring automatic shipping cost refunds](/v1/docs/configuring-automatic-shipping-cost-refunds#config-shipping-refunds)

To set up these configurations, use the [Update item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/updateConfig) or [Replace item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/ReplaceConfiguration) method.

To view the return configuration set up for returns in the platform, use the [Get item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/GetConfiguration) method.

### Configuring a return window

You can configure a time period for returns for orders in your business. For example, you can specify that items can only be returned within 30 days from purchase.

If enabled, if items are returned after the return time window expires, an error is displayed in NewStore Associate App.

To configure a time window for returns:

1. Use the [Update item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/updateConfig) or [Replace item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/ReplaceConfiguration) method.
2. Specify the value of the time window in `return_window`.

For example, specify `90` to enable items to be returned in your business within 90 days from the date of purchase.

### Configuring return fees

You can set up fees for returns made in your business. This return fee may be used for re-stocking or other operations in the store.

To specify a fee for returns:

1. Use the [Update item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/updateConfig) or [Replace item return config](https://docs.newstore.net/api/configuration/checkout/item_return_config#operation/ReplaceConfiguration) method.
2. Specify the fees for returns to be made in your business in `return_fee`. The fees assume the same currency that is specified for the order.

For example, specify `10` to enable items to be returned in your business for a fee of USD 10, if the order currency is in USD.

### Configuring automatic shipping cost refunds

When all items in an order are returned, you can specify that the shipping cost for the order is refunded to the customer. To set up automatic shipping cost refunds, see [Configuring automatic shipping cost refunds](/v1/docs/configuring-automatic-shipping-cost-refunds#config-shipping-refunds).

## Configuring returns in Associate App

### Enabling blind returns

To enable `blind return`s in NewStore Associate App:

1. Use the [Update app configuration](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#operation/putConfig) method.
2. Set `return_process_configuration` > `blind_return_enabled` to `true`.

#### Configuring blind returns

You can set refund methods for blind returns or normal returns via NewStore Associate App.

### Configuring condition codes

When processing returns in NewStore Associate App, associates must specify the condition of an item being returned. To do this, they must select the relevant code and a description of the condition of the item.

To configure condition codes for associates to select in NewStore Associate App:

1. Use the [Update app configuration](https://docs.newstore.net/api/configuration/apps/associate-app-config-api_config#operation/putConfig) method.
2. In `return_process_configuration` > `quality_inspection_options`, add a field for each condition code.
3. Set a code for the condition of the item in `code` and a description of the condition in `option`.

For example, set `1` as the condition code for an item that is `Sellable`, and `2` for an item that is `Damaged`.