# Delivery notes

## Delivery notes

A delivery note is the warehouse surface for recording delivery work after the
sales-order hand-off. Use this page to create a delivery note, find delivery
notes, and continue with the saved record on its edit surface. The warehouse
flow follows Purchase Order and precedes the detailed delivery work.

| If you need to… | Go to |
|---|---|
| Prepare the information and access needed for delivery-note work | [Before you start](#before-you-start) |
| Open a new delivery note or locate the delivery-note list | [Find a delivery note](#find-a-delivery-note) |
| Identify the information areas and conditional controls | [Understand the delivery note screen](#understand-the-delivery-note-screen) |
| Enter delivery information and save the note | [Create and save a delivery note](#create-and-save-a-delivery-note) |
| Review when completion or printing can appear | [Complete or print a delivery note](#complete-or-print-a-delivery-note) |
| Correct a validation or request error | [When delivery-note validation goes wrong](#when-delivery-note-validation-goes-wrong) |
| Continue warehouse fulfilment work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Follow the upstream order-to-delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) |
| Work with a goods issue note | [Goods issue notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-issue-notes) |

## Before you start

The delivery-note details area appears when subscription access is available, the
page is present, and a delivery note exists. On a new note, the shipping-order
area appears after a shipping order is present on the note.

**Prerequisites**

- Have the shipping-order information needed to choose **Shipping order**.
- Have the warehouse responsibility and permission required for the action you
  are about to use.
- Check the controls and fields displayed by your company configuration before
  entering values.
- Confirm the approval arrangement used by your organization before saving or
  completing a delivery note.

The list layout determines which columns you see. Work from the headers visible
in your list rather than expecting a fixed set of columns. New-list actions also
depend on the corresponding warehouse responsibility and permission checks.

> **Note:** The headers and configurable fields available to you depend on the
> company configuration and the list layout selected for your account.

## Find a delivery note

A delivery note has three reader-facing surfaces: the new surface for starting
the record, the list for locating records, and the edit surface for a saved
record.

**Prerequisites**

- Have warehouse access.
- For a new note, have the related shipping order available.
- For an existing note, know enough of its displayed list information to
  distinguish the correct record.

**Steps**

1. In the main navigation, select **Warehouse**.

2. In the warehouse area, select **Delivery Notes**.

   Choose the surface you need:

   | If you need to… | Open |
   |---|---|
   | Start a delivery note | The new delivery-note surface |
   | Locate a saved note | The **Delivery Notes** list |

   The new surface displays **Shipping order**, **Save**, and **Save and Close**.
   **Delivery completed** and **Print** are not displayed on this surface.

   ![The new delivery-note surface with Shipping order and the save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba0e5df62aa661bb158668ce0a0d72bd.png)

   The list displays these headers:

   | Header | What it helps you locate |
   |---|---|
   | **Sheet no.** | The note number |
   | **Warehouse** | The warehouse connected to the note |
   | **Client** | The client connected to the note |
   | **Client order no.** | The client's order reference |
   | **Vendor order no.** | The vendor's order reference |
   | **P.M responsible** | The responsible project-management person |
   | **Delivered by** | The delivery person |
   | **Total weight** | The recorded total weight |

     The list also displays **Refresh**, **Table Layout**, and **Settings**.
   **Delivery completed** is not displayed on the list.

   ![The delivery-note list with its displayed headers and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b62bfcbcc856b3dcb4d3884a505299be.png)

3. In the **Delivery Notes** list, select the saved note you want to open.

**Result:** You are on the new delivery-note surface, the **Delivery Notes**
list, or the selected saved note, with the controls and list headers available
for that surface.

Continue to [Understand the delivery note screen](#understand-the-delivery-note-screen)
to identify the areas and controls available on the surface you opened.

## Understand the delivery note screen

A delivery note brings together the selected shipping order, delivery details,
product quantities, issue-goods information, and a delivery destination. Some
areas appear only for a saved note, a selected address, a matching product
condition, or a company configuration.

The shipping-order area contains these fields:

| Area | Fields |
|---|---|
| Shipping order | **Branch**, **Sales Job Number**, **Invoice**, **Phone**, **Client**, **Client Order No.**, **Carrier**, **Delivery Date**, **Delivery Destination**, **Total Weight**, **Invoice Date**, **Delivery Terms** |
| Product edit | **Returned Qty** (required), **Unit** (optional) |
| Issue-goods details | **Issued By** (disabled), **Issued on** (no later than today), **Qty** (required) |
| Address | **Destination Title** (required), plus **Country**, **State**, **City**, **Street**, and **Zip-code** where your configuration requires them |

The shipping-order fields appear when the delivery note has a shipping order.
The product area appears when the issue-goods record has an issue order and is
new, or when the current user is a developer. The issue-goods details include a
disabled **Issued By** control and a date-limited **Issued on** field.

When an address is selected, enter the required **Destination Title**. The
address may also ask for **Country**, **State**, **City**, **Street**, and
  **Zip-code**, depending on your configuration. Use the options displayed in
  the corresponding lists.

The details action area can show **Delivery completed** when the note has an ID,
has no unsaved data, and is not complete. It can show **Print** when the note is
complete, has no unsaved data, and printing is allowed. The new surface does not
show either control.

The active details surface does not provide the **Comments**, **Receiving
sheet**, **Inspection sheet**, **Transfer history**, or **Last Modifications**
areas.

![The delivery-note list and the visible locating controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/13d0a0d2b7a0d1721453b7d7e193b143.png)

Continue to [Create and save a delivery note](#create-and-save-a-delivery-note)
to enter the displayed information.

## Create and save a delivery note

Record and save the delivery note as follows.

**Prerequisites**

- Have warehouse access and the related shipping order.
- Confirm the warehouse responsibility and permission checks for the new-list
  action.
- Have the delivery information and product quantities needed for the fields
  displayed on your note.

Use the field table while entering information:

| Field | Rule on the delivery-note surface |
|---|---|
| **Shipping order** | Required on the new surface |
| **Branch**, **Sales Job Number**, **Invoice**, **Client Order No.**, **Invoice Date**, **Delivery Terms** | Display with the shipping-order area and are not marked required by the field table |
| **Phone**, **Client**, **Carrier**, **Delivery Date**, **Delivery Destination**, **Total Weight** | Required only where your company configuration says so |
| **Returned Qty** | Required in the product-edit popup |
| **Unit** | Optional in the product-edit popup |
| **Issued By** | Disabled in issue-goods details |
| **Issued on** | Cannot be later than today |
| **Qty** | Required in the inspected-product edit popup |
| **Destination Title** | Required after an address is selected |
| **Country**, **State**, **City**, **Street**, **Zip-code** | Required only where your company configuration says so after an address is selected |

**Steps**

1. On the new delivery-note surface, select the related shipping order in
   **Shipping order**.

2. Enter the displayed shipping-order and delivery values in their matching
   fields.

3. In the product-edit popup, enter the returned amount in **Returned Qty**.

4. Optional: Enter the product's unit in **Unit**.

5. In the issue-goods details, enter the inspected product amount in **Qty**.

6. If an address is selected, enter the destination in **Destination Title**.

7. If the address form displays them, complete **Country**, **State**, **City**,
   **Street**, and **Zip-code** according to your configuration.

8. Select a save choice from the following alternatives:

   | If you need to… | Select |
   |---|---|
   | Save the note and remain in the save popup mode | **Save** |
   | Save while leaving the form or completing the task | **Save and Close** |
   | Leave without keeping the changes | **Don't Save** |
   | Return from the save popup without saving | **Cancel** |

   Saving validates the form and product list before creating or updating the
   record. If the record is new and the service returns an identifier, the
  application opens the saved record as the saved note.

9. Confirm the result before leaving the page. A successful save uses
   `Your request was completed successfully`.

   Leaving with unsaved changes is protected by the page's navigation guard.

**Result:** The delivery note is saved when the success message appears, and the
new record is available as a saved note.

Continue to [Complete or print a delivery note](#complete-or-print-a-delivery-note)
to use the actions available after saving.

## Complete or print a delivery note

Completion and printing apply to a saved delivery note, not to the new-record
surface. **Delivery completed** requires a note ID, no unsaved data, and an
incomplete note. **Print** requires a complete note, no unsaved data, and
printing permission.

**Prerequisites**

- Have a saved delivery note open on its edit surface.
- For **Delivery completed**, the note must have an ID, no unsaved data, and be
  incomplete.
- For **Print**, the note must be complete, have no unsaved data, and allow
  printing.

**Steps**

1. On the saved note, select **Delivery completed** when its conditions are met.

2. On the completed note, select **Print** when its conditions are met.

**Result:** The applicable action has been selected on a saved delivery note.
**Delivery completed** and **Print** are absent on the new surface.

If a save or request is refused, continue to [When delivery-note validation goes
wrong](#when-delivery-note-validation-goes-wrong).

## When delivery-note validation goes wrong

Use the message on screen to choose the correction. Product checks can stop a
save before the request is completed; a server refusal can instead show a
general error or permission message.

| Message | What to do |
|---|---|
| `Please review the validation error for each product` | Review each product row and correct the product validation error before selecting a save control again. |
| `Please enter the storage area and position for each product` | Enter the storage area and position for every product, then save again. |
| `Package products cannot be empty` | Add the required package-product information before saving. |
| `An error occurred while processing your request` | Check the entered delivery-note information and retry the save. Escalate the request if the message persists. |
| `Error {{errorMsg}}` | Read the displayed error detail and correct the named condition or escalate it to your support contact. |
| `You don’t have permission` | Confirm the warehouse responsibility and permission for the action with your administrator. |

If the page does not show a result after a save attempt, do not treat the record
as saved; verify it in the **Delivery Notes** list or ask your administrator to
check the request.

### Out of scope

This page owns the delivery-note create, locate, and saved-record surfaces. The
following items belong elsewhere:

- The option names in **Issued By** belong to the issue-goods data source.
- The option names in **Country** belong to the shared address data source.
- Comment actions, log-history actions, and file-library actions belong to their
  shared surfaces.
- The inventory control is inactive markup and is not an available delivery-note
  action.
- The list action-column delete markup is commented out and is not an available
  list action.
- Print activity and assembled-product popup actions belong to their owning
  surfaces.

## After the delivery note

After a successful save, return to **Warehouse** and **Delivery Notes** to locate
the saved record later. Select the saved note from the list to open it.

| Continue with… | Use this page |
|---|---|
| The broader warehouse fulfilment flow | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| The upstream order-to-delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) |
| Goods issue work as a separate warehouse document | [Goods issue notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-issue-notes) |
