---
title: "Configuring inventory adjustment settings"
slug: "configuring-inventory-adjustment-settings"
tags: ["config api", "platform", "stock on hand", "inventory", "fulfillment", "adjustment", "tutorial", "api"]
updated: 2025-10-30T19:44:52Z
published: 2025-10-30T19:44:52Z
canonical: "docs.newstore.com/configuring-inventory-adjustment-settings"
---

> ## 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 inventory adjustment settings

Maintain these settings to control how inventory adjustments work for a retailer on NewStore inventory management.

## Enabling inventory adjustments

To enable inventory adjustments on Associate App:

1. Use this [configuration](https://docs.newstore.net/api-portal/#/http/inventory/inventory-configuration/replace-inventory-config) method.
2. Specify the store IDs or a wild card `*` value for the `enabled_adjustments_stores` property.

## Configuring manual quantity updates

You can allow associates to update the quantity of inventory in an adjustment transaction manually. This feature is enabled by default for all retailers.

To disable manual quantity updates across stores and DCs in your business:

1. For Associate App, use this [configuration](https://docs.newstore.net/api-portal/#/http/inventory/inventory-configuration/replace-inventory-config) method.
2. Specify the value for the `allow_adjustments_manual_quantity_editing` property as `true`.

## Managing adjustment reasons

You can update or deactivate adjustment reasons configured for your business.

### Updating adjustment reasons

You can choose to update the reasons for [adjusting inventory](/v1/docs/about-inventory-management#inventory-adjustments) in stores across your business. To view the adjustment reasons that have already been configured, use the [List adjustment reasons](https://docs.newstore.net/api/integration/inventory-management/inventory_manager_api#operation/list_adjustment_reasons_inventory_adjustment_reasons_get) method.

To update an adjustment reason:

1. Use the [Update adjustment reason](https://docs.newstore.net/api/integration/inventory-management/inventory_manager_api#operation/update_adjustment_reason_inventory_adjustment_reasons__reason_id__patch) method.
2. Specify the updated values for the `subtype` and `type` properties.

For example, you can specify an updated adjustment reasons and specify the `type` as `Damaged` and the `subtype` as `Broken`.

When you update an adjustment reason, associates can start using the updated reason to adjust inventory in the store via NewStore Associate App.

If associates have used the adjustment reason before you updated it, the previous reason will still be displayed in the list of inventory adjustments or transactions that are associated with it.

### Deactivating adjustment reasons

When you create reasons to [adjust inventory](/v1/docs/about-inventory-management#inventory-adjustments) for your business, they are activated in the platform by default. However, if you do not want associates to use a specific adjustment reason to adjust inventory in the store using NewStore Associate App, you can deactivate it.

> [!TIP]
> Note
> 
> Deactivating an adjustment reason does not delete it from the platform.

If associates have used the adjustment reason before you deactivated it, the reason will still be displayed in the list of inventory adjustments or transactions that are associated with it.

To deactivate an adjustment reason:

1. Use the [Update adjustment reason](https://docs.newstore.net/api/integration/inventory-management/inventory_manager_api#operation/update_adjustment_reason_inventory_adjustment_reasons__reason_id__patch) method.
2. Specify the value for the `is_activated` property as `false`.

**Related topics**

- [Getting started with the NewStore platform](/v1/docs/getting-started-with-the-newstore-platform#noc)