# New warehouse

Use this page to enter a warehouse record and understand which configuration surfaces become
available after the record is saved.

## New warehouse at a glance

A warehouse record identifies a storage location, its description, its store type and
administrator, the branches it serves, and its address. The New warehouse page is the starting
point for recording that information before the warehouse has an existing record ID.

| If you need to… | Go to |
|---|---|
| Check the information and choices on the unsaved form | [Understand the warehouse form](#understand-the-warehouse-form) |
| Enter the warehouse information and choose how to leave the page | [Enter and save warehouse details](#enter-and-save-warehouse-details) |
| Work with areas, inventory settings, or modification history after saving | [Use the saved warehouse surfaces](#use-the-saved-warehouse-surfaces) |
| Find the warehouse list | [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) |
| Edit a saved warehouse | [Edit warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-edit-record) |
| Configure the warehouse inspection base | [Warehouse inspection base](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) |

The form can assign the warehouse to one or more branches and includes an address surface. After a
new warehouse is saved, the record stays open unless you use **Save and Close**.

![The new warehouse form with its identity, branch, and address fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bde12542f33f06954447e7580f4960dd.png)

## Before you start

Collect the name, description, store type, store administrator, branch assignment, and address
information before you begin.
The form requires **Display Name**, **Description**, **Store type**, and **Store Admin**;
the page also marks **Destination Title** as required. The branch-selection control and its
options are available on the form.

| Have or know | Why it matters |
|---|---|
| The warehouse display name and description | These are required warehouse details. |
| The store type and store administrator | These are required choices on the form. |
| The branches that use the warehouse | The warehouse can be assigned to one or more branches. |
| The destination title and address | The address surface includes **Destination Title**, **Country**, **State**, **City**, **Street**, and **Zip-code**. |
| Access to the new warehouse page | Create a warehouse record. |

The form and its save controls are available only when the warehouse data is present, the page
is not unavailable, and the subscription permits the surface. Save controls also depend on edit
permission and on unsaved data changes.

## Open the New warehouse page

The new warehouse page is the blank-record page; the warehouse list is a separate saved-record
surface.

**Prerequisites**

- Have access to the warehouse configuration area.

**Steps**

1. Open the New warehouse page.

   ![The route open with the Display Name field ready for entry](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9badca317b679745c5e4c8ca3a1c08b9.png)

**Result:** The new-warehouse form is on screen with its warehouse fields, branch-selection
control, address fields, **Save**, and **Save and Close**.

## Understand the warehouse form

The warehouse form collects the identity, assignment, store administration, and address details
that describe where warehouse work is managed. On a new record, the form shows the entry fields but
not the saved-record tabs **Areas**, **Inventory Model**, or **Last Modifications**.

### Warehouse details

| Field or control | What to enter or choose | Requirement or availability |
|---|---|---|
| **Display Name** | The warehouse's displayed name | Required |
| **Description** | A description of the warehouse | Required |
| **Store type** | Choose an option displayed in **Store type** | Required |
| **Store Admin** | Choose an option displayed in **Store Admin** | Required |
| **Warehouse belong to branch** | The branch assignment | The control and its options are displayed; the field is not marked required |

### Store type choices

**Store type** and **Store Admin** are required choices used while defining the warehouse.

### Address details

| Address field | Requirement or availability |
|---|---|
| **Destination Title** | Displayed and marked required |
| **Country** | Displayed |
| **State** | Displayed |
| **City** | Displayed |
| **Street** | Displayed |
| **Zip-code** | Displayed |

The address is part of the new-warehouse form. The address fields other than **Destination Title**
are displayed without a required marker.

![The Description field and required fields on the new warehouse form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f4eda28c56dc35522d3c879124ff19d7.png)

## Enter and save warehouse details

Enter the warehouse information, then choose how to save the record. The form saves a new warehouse
when no record ID exists; the same **Save** control updates a warehouse when an existing ID is
present. **Save and Close** saves and leaves the page.

**Prerequisites**

- Have the required warehouse information listed in [Before you start](#before-you-start).
- Have edit access to the warehouse form.

**Steps**

1. In **Display Name**, enter the warehouse name.
2. In **Description**, enter the warehouse description.
3. In **Store type**, choose an option displayed in **Store type**.
4. In **Store Admin**, choose an option displayed in **Store Admin**.
5. In **Warehouse belong to branch**, select the branches that use the warehouse.
6. In the address surface, enter **Destination Title**.
7. In the address surface, enter **Country**.
8. In the address surface, enter **State**.
9. In the address surface, enter **City**.
10. In the address surface, enter **Street**.
11. In the address surface, enter **Zip-code**.
12. Choose how to save the record.

    | If you need to… | Select |
    |---|---|
    | Keep the record open | **Save** |
    | Save the record and leave the page | **Save and Close** |

   If a required field is empty, the form uses the message `This Field Is Required`.

13. If the save succeeds, look for `Your request was completed successfully`.

**Result:** **Save** keeps the record open. **Save and Close** saves the record and leaves the page.
The success message is
`Your request was completed successfully` when that success response is shown.

## Use the saved warehouse surfaces

Saved-record surfaces extend the warehouse record beyond the initial entry form. They require an
existing warehouse record ID, so use them after saving the new record.

| Surface or action | What it provides |
|---|---|
| **Areas** | The warehouse areas surface and its area grid |
| **Inventory Model** | The warehouse inventory-model surface |
| **Last Modifications** | The audit history surface |
| New-area icon | Opens the new warehouse-area popup |
| Edit-area icon | Opens the editor for a non-default area |
| **Delete** | Deletes a non-default area |
| Inventory Model save control | Updates the warehouse model |

The Areas grid shows the columns **Name**, **Short name**, **Description**, **X position**,
**Y position**, and **Z position**. The area popup does not provide the fields **Short name**,
**Area Admin**, **X position**, **Y position**, and **Z position**.
Area edit and delete actions require an existing area row and edit permission. The New area
action also requires the Areas surface and edit permission.

The **Inventory Model** surface provides these choices:

| Inventory model option |
|---|
| **Only Storage Products/goods** |
| **Storage with on site assembly area for products/goods** |
| **Have standalone assembly area for products/goods** |

The saved-record tabs require an existing warehouse ID. Before that condition is met, the new
record shows the entry form instead.

> **Note:** Complete the new-record save before using the saved-record tabs and their actions.

## When saving or loading goes wrong

Use the message on screen to decide whether to correct a field, check access or subscription, or
return to the appropriate saved-record route.

| What you see | What it means | What to do |
|---|---|---|
| `This Field Is Required` | A required field is empty. | Return to the required field and enter or choose its value before selecting **Save** or **Save and Close**. |
| `Your request was completed successfully` | The warehouse save completed without an error. | Continue with the saved warehouse surface or the next task. |
| `An error occurred while processing your request` | The save returned an error. | Resolve the error before trying again. |
| `You cannot change or delete records developed by Pams` | The record is protected from change or deletion. | Do not attempt to change or delete that record; use a record you are permitted to administer. |
| The subscription message appears | The subscription does not include the surface. | Contact the person who manages your subscription before continuing. |
| The not-found page appears | The requested page or record cannot be found. | Return to the warehouse list and open the required saved record from there. |

## What to do next

| Your next task | Continue with |
|---|---|
| Review registered warehouses | [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) |
| Edit a saved warehouse | [Edit warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-edit-record) |
| Configure the warehouse inspection base | [Warehouse inspection base](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) |

The list page is the saved-warehouse starting point. Continue to [Edit warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-edit-record)
for a saved record, or to [Warehouse inspection base](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base)
for inspection-base configuration.
