# Edit warehouse

## Overview

A warehouse record defines a storage location for warehouse work. It brings together the
warehouse's identity, branch association, address, areas, inventory model, and modification
history.

| Task | Go to |
| --- | --- |
| Find an existing warehouse | [Find and open a warehouse record](#find-and-open-a-warehouse-record) |
| Review the warehouse identity and address | [Understand the warehouse screen](#understand-the-warehouse-screen) |
| Change and save warehouse details | [Review and save warehouse details](#review-and-save-warehouse-details) |
| Add, change, or remove an area | [Maintain warehouse areas](#maintain-warehouse-areas) |
| Choose a storage model or inspect changes | [Choose an inventory model and review history](#choose-an-inventory-model-and-review-history) |
| Return to the warehouse list | [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) |
| Create a warehouse | [New warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-new) |
| Configure inspection or transfer-related settings | [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base), [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents), or [Transfer reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons) |

The **Comments** tab holds record comments. The **Areas** tab holds the warehouse areas,
**Inventory Model** holds the storage model, and **Last Modifications** provides the record
history.

## Before you start

**Prerequisites**

- Sign in to PAMS.
- Identify the existing warehouse you need to review or change.
- Have permission to edit the warehouse. **Save**, **Save and Close**, area changes, and inventory
  model changes depend on edit permission.
- Have the correct warehouse identity, responsible administrator, branch association, and address
  information available.
- Review the required markers on the current form. **Country**, **State**, **City**, **Street**, and
  **Zip-code** are required only when the current address configuration makes them mandatory.
- Save before leaving if you change a value. Leaving the page is protected when unsaved changes are
  present.

## Find and open a warehouse record

The warehouse list is the starting point for finding an existing storage location in the
**Configuration** area. Use an existing warehouse row when you need its edit record.

**Prerequisites**

- You are signed in and can open the warehouse list.
- You know which existing warehouse row you need to open.

**Steps**

1. Open the warehouse list from the **Configuration** area.
2. Identify the existing warehouse row.
3. Select the warehouse row to open its edit record.

The list includes **New** for opening the separate warehouse-creation page. Use [New
warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-new) when you need to create a record.

**Result:** The selected warehouse edit record is on screen.

## Understand the warehouse screen

The warehouse screen identifies a storage location and its warehouse rules. The main form contains
identity, responsibility, branch, and address information. Saved records also expose the areas,
inventory model, and modification-history surfaces.

### Warehouse details

| Field | What to review |
| --- | --- |
| **Display Name** | The warehouse name shown to users. |
| **Description** | The warehouse description. |
| **Store type** | The warehouse type: `Physical`, `Virtual`, or `Partner`. |
| **Store Admin** | The responsible warehouse administrator. |
| **Warehouse belong to branch** | The branch association checkboxes. |

The address area contains **Destination Title**, **Country**, **State**, **City**, **Street**, and
**Zip-code**. **Destination Title** is required when an address is selected. The other address
fields are required only where the current address configuration marks them as mandatory.

### Tabs and areas

| Tab | Use it for |
| --- | --- |
| **Comments** | Review comments associated with the warehouse record. |
| **Areas** | Review and maintain warehouse-area rows. |
| **Inventory Model** | Review and separately save the warehouse storage model. |
| **Last Modifications** | Open the warehouse modification history. |

The main form appears when the subscription includes the feature, the record is not marked as not
found, and warehouse details are available. The three tabs require an existing warehouse record.
Save controls appear only when editing is allowed, and become enabled only after a data change.

The **Areas** grid has these columns:

| Column | Use it for |
| --- | --- |
| **Name** | The warehouse-area name. |
| **Short name** | The short area name. |
| **Description** | The area description. |
| **X position** | The X position value. |
| **Y position** | The Y position value. |
| **Z position** | The Z position value. |

The area form provides **Name** and **Description** controls. It does not provide **Short name**,
**Area Admin**, **X position**, **Y position**, or **Z position** as editable dialog controls.

## Review and save warehouse details

Review the warehouse identity, branch association, or address before committing a change. **Save**
updates the existing record. **Save and Close** updates it and leaves the page after a successful
save.

**Prerequisites**

- An existing warehouse record is open and its details have loaded.
- You have edit permission for the warehouse.
- You have the approved identity, responsible administrator, branch, and address values.

**Steps**

1. Review the warehouse details that you need to change.
2. Enter the corrected text in the field you want to change.

   | Value to change | Action |
   | --- | --- |
   | **Display Name**, **Description**, **Destination Title**, **State**, **City**, **Street**, or **Zip-code** | Enter the corrected text in the named field. |
   | **Store type**, **Store Admin**, or **Country** | Select the corrected value in the named field. |
   | **Warehouse belong to branch** | Select or clear the applicable branch checkbox. |

3. Select **Save** to validate and update the warehouse while staying on the record.
4. Select **Save and Close** instead when the validated update should also leave the record.

Use only one of the two save controls for a change. Both controls require edit permission and a data
change, and are disabled when the form has no changes. The form validates the warehouse and address
values before submitting the update.

After a successful update, PAMS displays `Your request was completed successfully`. When the update
cannot be processed, PAMS displays `An error occurred while processing your request`. If the record
is protected, PAMS displays `You cannot change or delete records developed by Pams`.

**Result:** The warehouse details remain on screen after **Save**, or the page closes after a
successful **Save and Close**.

## Maintain warehouse areas

A warehouse area is a named part of the warehouse used to organise storage within the location.
Open **Areas** to review its rows and to add, change, or remove an area when editing is allowed.
Treat default areas as protected rows: do not edit or delete them.

**Prerequisites**

- An existing warehouse record is open.
- **Areas** is available on the record.
- You have edit permission for an add, edit, or delete action.

**Steps**

1. Select **Areas**.
2. Choose the required area action from this table.

   | Action | What to select |
   | --- | --- |
   | Add an area | Select the plus icon beside **Areas**. |
   | Change an existing non-default area | Select the edit action for the area. |
   | Remove an existing non-default area | Open the area’s actions. |
   | Keep a default area unchanged | Do not select an edit or delete control. |

3. If you are removing an area, select **Delete**.
4. For an add or edit action, enter the area name in **Name**.
5. For an add or edit action, enter the area explanation in **Description**.
6. For an add or edit action, select the completion control in the open area dialog.

The add and edit icons appear only for an existing warehouse on **Areas** when editing is allowed.
The **Delete** action requires edit permission. Default areas cannot be changed or removed.

**Result:** The **Areas** surface shows the warehouse-area rows after the allowed add, edit, or
delete action.

## Choose an inventory model and review history

The inventory model describes how the warehouse stores and assembles products. It is maintained
separately from the main warehouse details. **Last Modifications** is the audit-history surface for
reviewing changes to the record.

**Prerequisites**

- An existing warehouse record is open.
- You can open **Inventory Model** or **Last Modifications** on the record.
- You have edit permission before changing and saving the inventory model.

**Steps**

1. Select **Inventory Model**.
2. Choose the model that matches the warehouse.

   | Warehouse condition | Select |
   | --- | --- |
   | Uses storage only | The storage-only option. |
   | Stores products and has an on-site assembly area | The storage-with-assembly-area option. |
   | Has a stand-alone assembly area | The storage-with-stand-alone assembly-area option. |

3. In **Inventory Model**, select the save control after changing the model.
4. Select **Last Modifications**.
5. Select **Registration** when it is available to review a history entry.

The inventory-model save control is disabled until the model changes. If saving the model fails, PAMS
displays `An error occurred while processing your request`.

**Result:** The selected inventory model is saved separately from the main warehouse details, or the
**Last Modifications** history is open for review.

## When an action is unavailable or fails

Use this table to match the screen condition to the rule that controls it.

| What you see | What it means | What to do |
| --- | --- | --- |
| The warehouse form is not available. | The subscription is not included, the record is marked not found, or warehouse details are not present. | Check the record and subscription access before continuing. |
| **Save** and **Save and Close** are unavailable. | Editing is not allowed, or the form has no data changes. | Confirm edit permission and change an allowed value before saving. |
| **Areas**, **Inventory Model**, or **Last Modifications** is unavailable. | The record is not an existing warehouse, or the page condition for the tab is not met. | Open a saved warehouse record. |
| The add action beside **Areas** or the edit action for an area is unavailable. | The record is not saved, **Areas** is not selected, or editing is not allowed. | Open an existing record, select **Areas**, and confirm edit permission. |
| The inventory-model save control is unavailable. | The selected model has no changes. | Change the inventory model before saving it. |
| The page cannot load the warehouse details. | PAMS displays `An error occurred while processing your request`. | Return to the warehouse list and reopen the existing record. |
| A warehouse update fails. | PAMS displays `An error occurred while processing your request`. | Review the required fields and permission, then submit the allowed change again. |
| An inventory-model update fails. | PAMS displays `An error occurred while processing your request`. | Review the selected model and edit permission, then save the model again. |
| You leave with unsaved changes. | The screen's deactivation protection handles the unsaved-change state. | Save the change before leaving, or use the page's close action after deciding whether to keep it. |

### Out of scope messages

| Message | Why it is out of scope |
| --- | --- |
| `You cannot change or delete records developed by Pams` | PAMS uses this message for protected records; warehouse deletion steps are not part of this task. |
| `Just '_'‘-''.' And '&' Characters Accepted` | The embedded Files dialog displays this file-name validation message. |

The embedded Files dialog can display the file-name validation message when it validates the
file-name characters.

## Continue after reviewing the warehouse

After reviewing or maintaining the record, return to [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view)
to choose another existing warehouse or select **New** for a separate warehouse-creation task.

For related configuration work, continue with [New warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-new),
[Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base), [Inspection checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist),
[Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents), [Transfer reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons),
[Service types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-service-types), or [Stock withdrawal and valuation](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-stock-withdrawal).

**Result:** You are back at the warehouse configuration flow or on the related configuration page
that matches the next warehouse task.
