Deactivating a store consists of removing all employees, stock, and routing configuration that point to the store. You must also update the status of the store to inactive. Use this tutorial when a store is permanently closing in your business.
Important
This tutorial assumes you have an authentication token stored in the
AUTH_TOKENvariable. Retrieve one with the following call:export AUTH_TOKEN=$(curl -s <url>/v0/token -d \ "grant_type=password&username=<myusername>&password=<mypassword>" | jq -r.access_token)
Important
Once you create a store in NewStore, you cannot delete it from the platform. Deactivation marks the store as inactive but keeps its historical data. To temporarily stop a store from fulfilling orders without deactivating it, see Enabling or disabling a store for order fulfillment.
For the scope of this this tutorial, you will deactivate store1_NYC, the store you created in Tutorial: Setting up a store. The store is closing permanently at the end of the day.
Removing stock from the store
Transfer or decommission all inventory at the store before you proceed. Deactivating a store that still holds stock can cause order routing inconsistencies and inventory discrepancies across your business.
Select one of the following approaches depending on the items in the store:
Transfer salable items to another store or warehouse. Create a transfer order and ship the items to a receiving location. See Managing transfer orders.
Move damaged or unsalable items to a non-salable stock location, such as
damaged, so the items are excluded from stock on hand. See (Optional) Creating stock locations.Submit a Full count of
0to clear the remaining quantity for products at the store. See Creating stock data.If relevant for your store, also force close any open ASNs, delete any open inventory transactions, and delete Adjustment and Cycle count, and Runner tasks. Open tasks can lead to incorrect data in Omnichannel Manager reports or Insights.
Important
Confirm in Omnichannel Manager that stock on hand for
store1_NYCis0before you continue. See Managing locations in NewStore.
Removing the store from the fulfillment configuration
Stop the store from receiving new fulfillment requests by turning off order fulfillment at the location, then remove the store's fulfillment_node_id from any routing rules that reference it.
In Omnichannel Manager, select
Routing>Locations. Select the location group that containsstore1_NYC, select Edit for the location, clear the checkbox Accept Fulfillment Orders, and click Save. See Managing fulfillment location groups.Remove the store's
fulfillment_node_idfrom any routing rulesets or location groups that reference it. See Tutorial: Setting up a fulfillment configuration.
Note
For orders routed to the store before you switched off fulfillment, NewStore follows the usual workflow to process these orders. Use Associate App to reject these orders if needed.
For fulfillment requests that are pending for the store or are in the fulfilment queue, use the mispick option to remove them from the fulfillment queue for the store.
Important
After you turn off fulfillment at a store, NewStore resets ATP for products at the store to
0within 12 hours. The values for stock on hand, allocations, reservations, and safety stock stay unchanged until you also remove the stock.
Removing employees from the store
Before you deactivate the store, unassign all employees from it. Active assignments prevent:
Associates from signing in or completing in-progress operations against a deactivated store
The update store API call fails fails if you have employees still assigned to the store.
To unassign or delete user accounts associated with the store, work with the NewStore team. See the user management API.
Note
To review which user accounts are currently assigned to the store, in Omnichannel Manager, select
Locations, and then select the store. See Managing locations in NewStore.
(Optional) Deactivating the fiscal cashbox
If the store operates in a country with fiscal regulations, such as Germany, Austria, France, Sweden, Norway, or Ireland, deactivate the fiscal cashbox before you deactivate the store.
Note
Fiscal cashbox deactivation is required only for production tenants. For non-production tenants, you can skip this step.
To deactivate the fiscal cashbox in the NewStore platform, raise a NewStore support request. Depending on the country, additional steps are required:
Germany and Austria: Deactivate the cashbox in the fiskaltrust portal. NewStore automatically generates a closing receipt when you deactivate the fiscal cashbox. See Fiscal regulations in Germany and Fiscal regulations in Austria.
France and Monaco: Deactivate the cashbox in the fiskaltrust portal. See Fiscal regulations in France & Monaco.
Sweden: Submit a de-registration form for the cash register to Skatteverket. See Fiscal regulations in Sweden.
Norway: Contact NewStore support to complete the deactivation. See Fiscal regulations in Norway.
For details on fiscal requirements in other countries, see Fiscal activations.
Deactivating the store
Update the store's active_status to false using the update store method. The request changes only the attributes you provide in the payload.
Save the following sample as data.json.
{
"active_status": false
}Run:
curl -X PATCH "https://<tenant>.x.newstore.net/v0/d/stores/store1_NYC" \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $AUTH_TOKEN" \
-d @data.jsonImportant
Using the update store method to deactivate the store fails if:
The store still has employees assigned
You have not cleared stock
You have not switched off routing for the store
Confirm that the previous steps are complete before deactivation.
You have now deactivated store1_NYC.
The store remains in the platform for historical reference, along with all historical data related to the store. However, the store can no longer fulfill orders or support new cash operations.
Related topics