# Stock withdrawal and valuation

Use this Warehouse configuration list to record how stock is withdrawn and valued for each
product group.

## Stock withdrawal and valuation

Stock withdrawal and valuation is a configuration list for a product group. Each record brings
together the product **Group**, the **Withdrawal** method, and the **Valuation** method.

| If you need to… | Go to |
| --- | --- |
| Check access, subscription, and required fields | [Before you start](#before-you-start) |
| Open the list or a new item | [Find a setting](#find-a-setting) |
| Read the list and form together | [Understand the setting](#understand-the-setting) |
| Review choices and required messages | [Fields and choices](#fields-and-choices) |
| Create, edit, cancel, or request deletion | [Maintain a setting](#maintain-a-setting) |
| Understand why a control or field is absent | [Handle configuration and access branches](#handle-configuration-and-access-branches) |
| Respond to a validation or loading problem | [When saving or loading goes wrong](#when-saving-or-loading-goes-wrong) |
| Open another Warehouse setting | [Continue with related warehouse settings](#continue-with-related-warehouse-settings) |

## Before you start

This setting is available through the shared Warehouse configuration surface. Your subscription,
permissions, saved field configuration, and the product groups returned to the form determine what
you can do.

| Before you start | What it affects |
| --- | --- |
| The subscription includes the feature | **New** and the shared configuration surface can be available. |
| **New** is not hidden | The **New** entry point can appear. |
| Editing is allowed and the subscription includes the feature | An existing row can be edited. |
| Deletion is allowed | A row can expose its deletion action. |
| Product groups are available to you | The **Group** list can offer choices. |
| The three fields are required | The form requires **Group**, **Withdrawal**, and **Valuation** before completion. |

The product-group choices are returned when the form loads. Choose from the **Group** options
currently offered to you.

## Find a setting

The Stock withdrawal and valuation list is the Warehouse settings page for reviewing existing
product-group rules and opening the shared new-item form.

Prerequisites

- The subscription includes the feature.
- You can open Warehouse settings.

Steps

1. In Warehouse settings, select **Stock withdrawal and valuation**.
2. Confirm that the list shows the **Group**, **Withdrawal**, and **Valuation** columns.
3. Check that the list counter shows `Count: 3`.
4. Open the setting that matches your task:

   | When you want to… | Action |
   | --- | --- |
   | Open a new item | Select **New**. |
   | Open an existing setting | Select its row. |

The same Warehouse navigation shows Base Of Inspection, Inspection Checklist, Inspection Document,
Transfer Reasons, and Service Types alongside this setting.

![The Warehouse settings list with its three columns, Count: 3, and New action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e647644a244449f291f2c897771f2d16.png)

**Result:** The Stock withdrawal and valuation list or its new-item form is on screen.

## Understand the setting

The list and the new-item form show different parts of the same configuration record.

| Surface | What you see | What it is for |
| --- | --- | --- |
| List | **Group** | Identifies the product group represented by the row. |
| List | **Withdrawal** | Shows the stock-withdrawal method recorded for the row. |
| List | **Valuation** | Shows the valuation method recorded for the row. |
| New-item form | **Group**, **Withdrawal**, and **Valuation** | Supplies the three values for the configuration record. |

The configured list does not include **Group**, while the list can show **Group**. Use the headers
that are visible in your list because saved list configuration supplies the final column set.

### Fields and choices

The new-item form uses three required select boxes. In **Group**, select one of the product groups
offered by the form. In **Withdrawal** and **Valuation**, select from the choices listed below.

| Field | Control and choices |
| --- | --- |
| **Group** | Select one of the product groups offered by the form. |
| **Withdrawal** | **First In, First Out (FIFO)**, **Last In, Last Out (LIFO)**, **First Expired, First Out (FEFO)**, or **Manual**. |
| **Valuation** | **Actual Cost** or **Avrage Cost**. |

Each field carries a required marker on the form. If a required value is missing, the form uses the
following message:

| Field | Message |
| --- | --- |
| **Group** | `Group is required` |
| **Withdrawal** | `Withdrawal is required` |
| **Valuation** | `Valuation is required` |

The spelling **Avrage Cost** is the product's displayed choice. Keep it as shown when selecting a
valuation method.

Use these fields and choices when you maintain a setting.

![The new-item form with the three required select boxes](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0a8442d71b2c28aec74ad56962bf7f6b.png)

## Out of scope

Use this page for the three select boxes that belong to stock withdrawal and valuation. The page
configuration does not provide a visible **Group** list column, although the list can show that
header. It also provides no date, number, text, or currency field for this entity.

The following messages belong to other generic configuration forms, not to these three select
boxes:

| Message | Where it belongs |
| --- | --- |
| `This Field Is Required` | Generic date-box forms. |
| `Required` | Survey-answer and reference-list forms. |
| `Field is required` | Other configuration forms; it does not apply to **Group**, **Withdrawal**, or **Valuation**. |

## Maintain a setting

Use one configuration record for one product group. The form supports opening a new item, changing
an existing row, closing without saving, and requesting deletion of a row.

Prerequisites

- The Stock withdrawal and valuation list is open.
- The subscription includes the feature for a new item or edit.
- **New** is visible for a new item, editing is allowed for an existing row, or deletion is
  allowed for a deletion request.
- You know which product group, withdrawal method, and valuation method to record.

Steps

1. Open the form that matches your task:

   | When you want to… | Action |
   | --- | --- |
   | Create a setting | Select **New**. |
   | Change a setting | Select the existing row. |

2. In **Group**, select the product group.
3. In **Withdrawal**, select the withdrawal method.
4. In **Valuation**, select the valuation method.
5. Choose the action that matches your form.

   | When you want to… | Action | Result |
   | --- | --- | --- |
   | Submit a new item from the form | Select **OK** | The visible new-item form is submitted. |
   | Save a record after the save confirmation appears | Select **Save** | The popup saves and closes. |
   | Leave the form without saving | Select **Close** | The popup closes and the list remains open. |
   | Cancel the popup | Select **Cancel** | The popup closes without the save action. |

6. To request deletion, open the row's delete action.
7. Read `Are you sure you want to delete this item?`.
8. Choose the confirmation action that matches your decision:

   | When you want to… | Action |
   | --- | --- |
   | Request deletion | Select **Delete**. |
   | Leave the row unchanged | Select **Cancel**. |

![The list after Close returns from the new-item form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e647644a244449f291f2c897771f2d16.png)

**Result:** The form is submitted, closed without saving, or a deletion request is open. After
**Close**, the list is on screen without a route change.

If an action or field is absent, review the configuration and access branches.

## Handle configuration and access branches

The shared Warehouse surface changes the available actions and fields according to subscription,
permissions, visibility settings, and list configuration.

| Condition | What you can see or do |
| --- | --- |
| The subscription is included and **New** is not hidden | **New** is available. |
| Editing is allowed and the subscription is included | An existing setting can be edited. |
| Deletion is allowed | A row can expose **Delete**. |
| The form has a selected item and the field is visible in the form | That field appears in the new or edit popup. |
| Product groups are available to you | **Group** offers those product groups. |

If a condition is not met, the corresponding action or field may not appear. A missing control means
that the available subscription, permission, record, or saved configuration is different; saving or
loading failures are covered in the next section.

## When saving or loading goes wrong

| Validation message |
| --- |
| `Forbidden characters detected. Please remove them and try again.` |

The visible list headers reflect the saved list configuration.

The related Warehouse settings are listed in the next section.

## Continue with related warehouse settings

The Stock withdrawal and valuation page sits in the Warehouse settings navigation with the sibling
settings Base Of Inspection, Inspection Checklist, Inspection Document, Transfer Reasons, and
Service Types.

- [Warehouse configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view)
- [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)

Open the sibling setting that owns the warehouse data you need to maintain.
