# Incoming inspection notes

An incoming inspection note records the inspection work associated with received products.
Use it to create a note, review a saved note, record inspection decisions, and release inspected
products to stock.

## Incoming inspection notes

An incoming inspection note is the inspection record you use after receiving work and before
the subsequent warehouse stock work.

| If you need to… | Go to |
| --- | --- |
| Create or review an inspection note | [Find an inspection note](#find-an-inspection-note) |
| Understand the fields and conditional areas | [Understand the inspection screen](#understand-the-inspection-screen) |
| Enter decisions and save the note | [Record inspection details](#record-inspection-details) |
| Understand successful and blocked saves | [Recognize completion and validation messages](#recognize-completion-and-validation-messages) |
| Continue with the broader receiving, inspection, and stock relationship | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Review receiving work before inspection | [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 inspection-base setup | [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) |
| Review inspection-checklist setup | [Inspection checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist) |
| Review inspection-document setup | [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents) |

## Before you start

An inspection note needs an order context before its product, checklist, document, defect, and
comment areas can appear. Have the order ready, and keep the receiving details available for
the fields filled from the selected order.

| Have or know | Why it matters |
| --- | --- |
| An order to inspect | **Order Number** is required on the new form. |
| The selected order's GRN details | **GRN No.** is required when an order is selected. |
| The selected order's sub-supplier details | **Sub-supplier** is required when an order is selected. |
| Whether you are leaving a new note | The new-note route uses a leave-screen guard, so leaving with unsaved changes can interrupt navigation. |
| The order source you need | The picker supports purchase, assembly, transfer, and delivery-note data sources. |

The product can replace the inspection page with an upgrade surface when the Warehouse
inspections subscription is unavailable. Access and subscription settings determine which
surface you receive.

> **Note:** A new note can use the leave-screen guard when you move away before saving.

## Find an inspection note

Choose the path that matches the work you need to do.

**Prerequisites**

- You know whether you are starting a new note or reviewing a saved note.

| Path | Step | Action |
| --- | --- | --- |
| Start a note | 1 | From the Warehouse new-record menu, select **Incoming Inspection Note**. |
| Start a note | 2 | Confirm that the page title is **Incoming Inspection Note**. |
| Review a saved note | 1 | Open the inspection list. |
| Review a saved note | 2 | Confirm that the list title is **Incoming Inspection Notes**. |
| Review a saved note | 3 | Select the row link for the note. |

![The new-note title and header area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f5609bb83340bbbe898f97e515693da0.png)

![The inspection list title, columns, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f9047bba4dd86d79823ac67a6792d9e4.png)

The list has these columns:

| Column | Use it to… |
| --- | --- |
| **Warehouse** | Identify the warehouse shown for the row. |
| **Inspection No.** | Identify the inspection note. |
| **GRN** | Identify the goods receipt reference. |
| **Purchasing job no.** | Identify the purchasing job reference. |
| **P.O. no** | Identify the purchase-order reference. |
| **Inspected by** | Identify the inspecting person shown for the row. |

The list toolbar provides **Refresh**, **Table Layout**, and **Settings**. Selecting a row opens
its edit screen.

**Result:** The new-note form or the selected saved note is open. Continue with [Understand the
inspection screen](#understand-the-inspection-screen).

## Understand the inspection screen

The inspection screen starts with header information, then shows order-dependent product,
checklist, document, defect, and comment areas. Saved notes also expose history, warehouse,
and comment surfaces.

On a new note, the header includes **Order Number**, **Inspected by**, and **Inspected on**.
**Order Number** is selectable and required. **Inspected by** is a disabled selection, and
**Inspected on** is a disabled date whose maximum is today. **GRN No.** and **Sub-supplier** are
disabled text fields that become required when an order is selected. **Sub-supplier shipment
no.** is also disabled text. **Order Number** has a required marker. **Inspected by**,
**Inspected on**, **Save**, and **Save and Close** are available on the new-note form.

![The required Order Number picker](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f5609bb83340bbbe898f97e515693da0.png)

The product area appears after an order is selected. Its grid contains **Products**, **Unit**,
**Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**, **Rejection Reason**,
**Comments**, and **Attachment**. The product add action is not available on this surface.
When a product has rejected quantity and the note is editable, **Re-inspect** is available for
that product. After release, **Re-inspect** is row-specific for a product with rejected quantity.

The checklist grid contains **Object to inspet**, **Base of inspection**, **Acceptance (YES/NO)**,
and **Comments**. The acceptance choice is **Yes** or **No**, and it is editable only when the
screen is editable. The documents grid contains **Document** and **Yes / No** choices; the
choices are editable only when the screen is editable.

The defects grid contains **Defect**, **Defect Category**, and **Attachament**. The main form
also contains the optional **Comment** text area. A defect entry requires **Defect** and provides
**Defect Category** selection.

On a saved note, the available tabs include history, warehouse areas, and comments.
**Last Modifications** opens the audit-log tab. **Finish and release to stock** and **Inspection
template** may be available when the note is saved, unchanged, and not released. Save controls
appear when the note is editable and its data has changed; they are disabled without data changes. Editable grid actions are hidden on a
read-only note.
When inspection defects exist, **Defect** is available for the defect work.

![The inspection surface with its main areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/896f620c73cc3fc71db9ffe1833f69da.png)

Continue with [Record inspection details](#record-inspection-details).

## Record inspection details

Record inspection details against a selected order. The order supplies the dependent areas; the
quantities and decisions you enter determine which conditional fields become required.

**Prerequisites**

- You have an order to inspect.
- You have the received quantity and inspection decisions for each product.
- You know any rejection reason, defect, document decision, and comment to record.

**Steps**

1. In **Order Number**, select the order to inspect.

   ![The header fields after opening a new note](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f5609bb83340bbbe898f97e515693da0.png)

2. Review the **Products**, **Checklist**, **Documents**, **Defects**, and **Comment** areas.
3. In the product grid, review **Ordered Qty.** and **Received Qty.**.
4. Open the product details and enter **Accepted qty**.
5. Keep **Accepted qty** at or below **Received Qty.**.
6. Enter **Rejected qty** for the quantity that is not accepted.
7. If **Rejected qty** is greater than zero, enter **Rejection Reason**.
8. Choose **Yes** or **No** in **Acceptance (YES/NO)** for each checklist item.
9. Choose **Yes** or **No** in the documents grid for each document decision.
10. In the defects area, enter **Defect** and select **Defect Category** when recording a defect.
11. Enter an optional note in **Comment**.
12. If accepted quantity is greater than zero during re-inspection, enter **Comment after re-inspection**.
13. Choose the save action that matches what you want to do next.

    | If you want to… | Select |
    | --- | --- |
    | Save the note and remain on its form | **Save** |
    | Save the note and leave its form | **Save and Close** |

The product grid also provides **Comments** and **Attachment** columns. Use the available
product popup fields for **Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**,
**Rejection Reason**, and **Comment**. The re-inspection popup provides **Accepted qty** and
**Comment after re-inspection** under their stated conditions.

**Result:** The note is saved with the inspection details. A new note saved without leaving opens
its edit screen. Continue with [Recognize completion and validation messages](#recognize-completion-and-validation-messages).

## Recognize completion and validation messages

The message identifies whether the save completed or which inspection condition needs correction.

| Condition | Message | What to do |
| --- | --- | --- |
| The save completes | `Your request was completed successfully` | Continue reviewing the saved note. |
| Mandatory data is missing during save | `Check mandatory field(s)` | Complete the required fields and save again. |
| A required field is empty | `This Field Is Required` | Enter the missing value in the named field. |
| Accepted quantity exceeds received quantity | `Accepted quantity cannot be greater than received quantity.` | Reduce **Accepted qty** to the received quantity or less. |
| Package-product validation rejects an empty package | `Package products cannot be empty` | Complete the package-product information before saving. |
| A product has no acceptance or rejection decision | `You have products with no decision regarding accepted or rejected quantity` | Enter the accepted or rejected quantity decision for each product. |

When a product has rejected quantity and the note remains editable, **Re-inspect** is available.
After a saved, unchanged note that is not released, **Finish and release to stock** and
**Inspection template** may be available. Continue with [When validation or saving goes wrong](#when-validation-or-saving-goes-wrong).

## When validation or saving goes wrong

Use the condition that matches what you see before changing the note.

| What you see | What it means | What to do |
| --- | --- | --- |
| `An error occurred while processing your request` | A save or load request returned an error. | Review the note and request access or service assistance before repeating the action. |
| `Check mandatory field(s)` | The save request contains invalid or incomplete mandatory data. | Complete the required header, quantity, and conditional rejection fields. |
| `Accepted quantity cannot be greater than received quantity.` | **Accepted qty** is above **Received Qty.** | Reduce **Accepted qty** and save again. |
| **Products**, **Checklist**, **Documents**, **Defects**, and **Comment** are absent | No order is selected. | Select an order in **Order Number**. |
| Editable product or defect actions are absent | The note is read-only. | Review the note without changing it, or open an editable note. |
| An upgrade surface replaces the inspection page | Warehouse inspections subscription access is unavailable. | Follow the upgrade surface available to your organization. |
| The list headers differ from the expected headers | The selected list layout determines the columns shown. | Work from the headers visible in your list and use **Table Layout** if you need to adjust the layout. |

No message or dialog appears during the passing read-only review path. Treat the absence of an
editable action as the condition to act on, rather than waiting for a confirmation.

Continue with [Release inspected products and continue](#release-inspected-products-and-continue).

## Out of scope

| Message | Where it belongs |
| --- | --- |
| `Just '_'‘-''.' And '&' Characters Accepted` | Shared file-library validation in the file popup |

## Release inspected products and continue

**Inspection completed** and **Finish and release to stock** are alternative closing actions for
an existing editable note when its products have not been released. Before release, every inspected
product needs an accepted or rejected quantity.

**Prerequisites**

- The inspection note is saved.
- The note has no unsaved changes.
- The note is not released.

**Steps**

1. Open the saved inspection note.
2. Confirm that the note has no unsaved changes.
3. Select **Finish and release to stock**.
4. Review the **Release to stock** confirmation and the message `You are about to release these
   products to stock, are you sure?`.
5. Confirm the release.

**Result:** The products are released to stock. Continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow)
and [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment).
