# Goods issue notes

## Goods issue notes

A goods issue note records products issued from warehouse stock against a related
record. Use it to locate and review the products that left the warehouse.

| If you need to… | Go to |
|---|---|
| Understand where this work fits among warehouse activities | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Find or start a note | [Find or start a goods issue note](#find-or-start-a-goods-issue-note) |
| Read the fields and product areas | [Understand the note screen](#understand-the-note-screen) |
| Add products and quantities | [Create the note and add products](#create-the-note-and-add-products) |
| Compare a new note with a saved note | [Handle new and existing notes](#handle-new-and-existing-notes) |
| Save a note or correct a validation problem | [Save the note and recover from errors](#save-the-note-and-recover-from-errors) |
| Continue with related warehouse documents | [Know what comes next](#know-what-comes-next) |
| Review goods receipt work | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) |
| Review stock by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) |
| Review incoming inspection or delivery work | Open the related warehouse page from your warehouse navigation. |

The note identifies the related work and the products issued. The surrounding
warehouse pages cover receiving, inspection, stock, and delivery activities.

## Before you start

Have warehouse access and the related order and product details ready. You select
the related record and enter the quantity for each product before saving.

| Have ready | Why it matters |
|---|---|
| Access to the warehouse area | The goods issue notes list is in the warehouse area. |
| The order or other record related to the issue | You select it in **Related to** when creating a note. |
| The products to issue | You add them through **Products** when the new note has an issue order. |
| The quantity required for each product | The product editor requires a value in **Qty**. |
| The unit for each product | **Unit** identifies how the quantity is measured. |
| Storage area and position for each product, where required | Save validation asks for these details when they are needed. |

The available **Issued By** choices depend on your setup. Review the values shown for
**Related to**, **Issued By**, **Issued on**, and the product fields before saving.

## Find or start a goods issue note

Use the goods issue notes list to review saved notes or open a new-note form.

Prerequisites

- Have access to the warehouse area.
- Know whether you are opening a saved note or creating a new one.

Steps

1. Open the goods issue notes list.

   ![The goods issue notes list with its visible columns and toolbar controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cad5413c5e3c3320bac04e781f23bb3e.png)

2. Select the route that matches your task.

   | If you need to… | Select |
   |---|---|
   | Open a saved note | the edit control in the selected note row |
   | Start a note from the new-record menu | **Goods Issue Note** |
   | Start a note from the goods issue notes list | **Goods Issue Note new entry** |

3. If you started a new note, confirm that the page shows **Related to**, **Issued By**,
   **Issued on**, **Save**, and **Save and Close**.

**Result:**

You are viewing the selected saved note or the new goods issue note form. From the new
form, continue to [create the note and add products](#create-the-note-and-add-products).

## Understand the note screen

The note screen is headed **Goods issue note sheet**. It has header information for the
related record and issue, followed by a product area. The product columns depend on whether
the note is new or saved.

| Area | What you use it for | When it appears |
|---|---|---|
| **Related to** | Identify the order or record connected to the issue | A picker on a new note; read-only text on a saved note |
| **Issued By** | Review the issuer value | On the note form; disabled |
| **Issued on** | Review the issue date | On the note form; disabled and limited to today or earlier |
| **Products** | Open product insertion | On a new note when an issue order exists |
| **Qty** | Enter the quantity for the selected product | In the product editor |
| **Unit** | Review the product's unit | In the product editor and product-selection area |
| Product-selection information | Review the product, stage, sales item, and requested quantity | In the product-selection area when it is available |
| **Product**, **Issued Qty**, **Returned Qty** | Review products on a saved note | In the saved-note product grid |

The saved-note grid includes **Returned Qty**. When it is available, the new-note
product-selection area includes the product, requested quantity, **Stage**, and **Sales item**.
The product grid appears when the note has an issue order.

The list layout shown here has these columns:

| Column | Use it to review |
|---|---|
| **Sheet no.** | Identify the issue note. |
| **Warehouse** | Identify the warehouse. |
| **Product** | Identify the product. |
| **Qty** | Review the quantity. |
| **Unit** | Review the quantity's unit. |
| **P.M responsible** | Review the responsible person. |
| **Issued by** | Review the issuer. |
| **Issued on** | Review the issue date. |

The list toolbar shows **Refresh**, **Table Layout**, and **Settings**. The columns come
from the selected list layout, so use the headers visible in your list.

![The goods issue notes list and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1a3bf4f0e4b6e42885ded75beb11ce03.png)

The **Inventory** select, **Comments** and **Last Modifications** tabs, product deletion
action, and old product links are not part of the visible note surface.

## Create the note and add products

Use the new-note form to connect the issue to its related record and record the products
and quantities being issued.

Prerequisites

- Be on the new-note form.
- Know the related order or record.
- Know each product and the quantity to issue.

Steps

1. In **Related to**, select the order or record connected to the goods issue.

2. Select **Products** when the new note has an issue order.

   ![The new goods issue note with the related-record and product-entry areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/36d97d0eb621346c7254be86d64b7f50.png)

3. Select the product to add from the product-selection area.

4. Open the selected product with the edit control in its row.

5. In the product editor, enter the required quantity in **Qty**.

6. Review **Unit** for the selected product.

7. Close the product editor with its close control.

**Result:**

The new note contains the selected related record and product quantity. When the
product-selection area is available, it provides **Product**, requested quantity, **Unit**,
**Stage**, and **Sales item** for review. Continue to [save the note](#save-the-note-and-recover-from-errors).

## Handle new and existing notes

A new note is used to choose its related record and add products. A saved note is used to
review issued and returned quantities.

| Note state | Header behaviour | Product area | Available actions |
|---|---|---|---|
| New note | **Related to** is a required picker; **Issued By** and **Issued on** are visible and disabled | Product insertion is available when an issue order exists; **Qty** is required in the product editor | **Products**, **Save**, **Save and Close**, and the product-editor close control |
| Saved note | **Related to** is read-only | The saved grid shows **Product**, **Issued Qty**, and **Returned Qty** | The selected product-row edit control opens a product for editing; the product-editor close control leaves the page |

The product delete action, **Comments** and **Last Modifications** tabs, old **Product**
and **Final product** links, and the list import action are unavailable. Use visible
**Refresh** and **Table Layout** controls for list operations.

## Save the note and recover from errors

Review the related record, products, quantity, and unit before saving. On an editable page,
the save choices are unavailable when there are no changes or while saving is in progress.

Prerequisites

- Complete the note information.
- Correct any product details required by the form.

Steps

1. Select the save action that matches your task.

   | If you need to… | Select |
   |---|---|
   | Save and remain on the page | **Save** |
   | Save and close the page | **Save and Close** |

2. If the form asks for storage details, enter the storage area and position for each
   product.

3. If the form reports that package products are empty, add the required package products.

4. If the request fails, correct the note information.

5. Select the appropriate save action again.

| Message | Correction |
|---|---|
| `Please enter the storage area and position for each product` | Enter the storage area and position for every product. |
| `Package products cannot be empty` | Add the required package products. |
| `An error occurred while processing your request` | Correct the note information and select the save action again. |
| `Your request was completed successfully` | Continue from the saved note. |

**Result:**

The note is saved when the success message appears. **Save** returns to the saved issue edit
record, while **Save and Close** leaves the page. If a validation or request message appears,
the form remains available for correction.

## Know what comes next

After saving, use the surrounding warehouse pages to continue the receiving, inspection,
stock, or delivery work that belongs to your process.

| Continue with… | Open |
|---|---|
| The overall warehouse sequence | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Goods received into the warehouse | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) |
| Stock grouped by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) |
| Incoming inspection or delivery work | The related warehouse page from your warehouse navigation |

Continue with the related warehouse task from your warehouse navigation.
