# Shipping orders

Use a shipping order to select items from a sales job, track their shipment progress,
and review the connected order.

## Shipping orders

A shipping order records the items selected for shipment and their progress from a
sales job toward delivery. Use it after the sales job identifies what must be shipped
and before the connected shipment and delivery work is completed.

The shipping-order lifecycle uses these statuses:

```mermaid
stateDiagram-v2
    Draft --> GoodsAwaitingIssue
    GoodsAwaitingIssue --> GoodsIssued
    GoodsIssued --> GoodsInpected
    GoodsInpected --> GoodsReadyForShipemnt
    GoodsReadyForShipemnt --> GoodsReleasedForShipment
    GoodsReleasedForShipment --> GoodsDelivered
```

| Status | What it represents in the shipping-order flow |
|---|---|
| `Draft` | The shipping order has been created as a draft. |
| `GoodsAwaitingIssue` | The goods are awaiting issue. |
| `GoodsIssued` | The goods have been issued. |
| `GoodsInpected` | The goods have reached inspection. |
| `GoodsReadyForShipemnt` | The goods are ready for shipment. |
| `GoodsReleasedForShipment` | The goods have been released for shipment. |
| `GoodsDelivered` | The goods have been delivered. |

| If you need to… | Go to |
|---|---|
| Check what a shipping order is and where it fits | [Shipping orders](#shipping-orders) |
| Prepare the sales job and information needed to create one | [Before you start](#before-you-start) |
| Locate an order that already exists | [Find a shipping order](#find-a-shipping-order) |
| Open the project-management list | [Open the shipping-order list](#open-the-shipping-order-list) |
| Open a new order form | [Open a new shipping order](#open-a-new-shipping-order) |
| Read the order fields and shipment-progress areas | [Understand the shipping-order screen](#understand-the-shipping-order-screen) |
| Enter items and save the order | [Create a shipping order](#create-a-shipping-order) |
| Continue the surrounding project flow | [Project management workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/project-management-workspace) |
| Review the connected order and delivery flow | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) |
| Continue detailed warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |

## Before you start

Have a sales job that contains the items you need to ship. The shipping order uses
the selected sales job as its item source, so selecting the wrong job puts the wrong
shipment context into the order.

| Have or check | Why it matters |
|---|---|
| The sales job's **Sales Job Number** | A new shipping order requires this selection. |
| The items to ship | The order must contain at least one item before it can be saved. |
| The person and date for the order | **Shipping ordered by** and **Shipping ordered on** are required on the order screen. |
| Access to Projects Management | The shipping-order list and new-record route are in this module. |
| A saved order when reviewing progress | Existing-order fields and **Last Modifications** appear only after the order exists. |

Leaving a new or edited shipping-order form is protected when it contains unsaved
changes. Complete or cancel the form through its available controls rather than
assuming that leaving the page silently discards unsaved changes.

The available permission and subscription branches depend on your account and setup.
If the shipping-order content or edit controls are not available, use the access route
for your Projects Management administrator.

When these checks are complete, find the order or open a new order from the
**Shipping Orders** list.

## Find a shipping order

The shipping-order list groups existing orders by shipment progress. Use a status
choice when you know the work position, or select a row when you know the order or job
you need to review.

### Open the shipping-order list

Open **Shipping Orders** in **Projects Management**.

![Shipping Orders list with status choices, columns, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2cc4346af51b547073fb75c407caa739.png)

The list shows these headers:

| Header | Use it to… |
|---|---|
| **Sheet no.** | Identify the shipping-order sheet. |
| **Order date** | Compare the order dates. |
| **P.M responsible** | See the project-management responsibility shown for the row. |
| **Client order no.** | Check the client order number when the row provides one. |
| **Job no.** | Match the shipping order to its job. |

The list also provides **Refresh**, **table layout**, and **Settings**. The headers
come from the selected list layout, so work from the headers visible in your list when
another layout presents a different set of columns.

#### Prerequisites

- You have access to **Projects Management**.
- You know the sales job number, shipping-order sheet number, or status to look for.

#### Steps

1. Open **Projects Management**.
2. Select **Shipping Orders**.
3. Select a status choice from the list.

   | If you need to… | Select |
   |---|---|
   | See all shipping-order statuses | **All** |
   | See requested or draft shipments | **Requested shipments** |
   | See orders ready for shipping | **Ready for shipping** |
   | See released shipments | **Released shipments** |
   | See delivered shipments | **Delivered** |

4. Select the shipping-order row you need.

**Result:** The selected shipping order opens for review.

From the list, open an existing row to review it, or use the new-record menu to create
an order.

### Open a new shipping order

Use the project-management new-record menu when you need to create a shipping order.
The menu contains **Shipping Order**.

![New Shipping Order form with required order fields and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3456703e14011a7ed58bd41a65f16523.png)

#### Prerequisites

- You have access to **Projects Management**.
- You know the sales job whose items you need to ship.

#### Steps

1. Open the project-management new-record menu.
2. Select **Shipping Order**.
3. Confirm that **Sales Job Number**, **Shipping ordered by**, **Shipping ordered on**,
   **Save**, and **Save and Close** are on the form.

**Result:** The new shipping-order form is open.

## Understand the shipping-order screen

The shipping-order screen combines order information, shipment progress, selected
items, and saved-order history. A new order starts with the order-information area;
the item and progress surfaces change as the order is linked to a sales job and saved.

After you identify the fields, create the order in [Create a shipping order](#create-a-shipping-order)
or reopen a saved order in [Review shipment progress](#review-shipment-progress).

| Screen area | What it is for |
|---|---|
| Details | Order information and shipment-progress fields. |
| Items | The shipment items and their quantities. |
| Split an item | Select **Split** when the option is available for the selected product row. |
| Order lookup | Selecting **Sales Job Number** opens the available-item selection surface. |
| Product lookup | **Product** opens product insertion when its condition applies. |
| Warehouse detail and totals | Item-level warehouse and quantity information. |
| Comments | Comments for a saved order. |
| Last Modifications | The saved order's log history. |

The screen provides tabs, shared popups, and file surfaces. The visible **Save** and
**Save and Close** controls are part of the form.

The item-selection and lookup surfaces can be collapsed or expanded according to the
screen state. Work from the labels currently visible rather than expecting every
panel to open in the same state.

### Order information

Order information identifies the sales job, responsibility, and date for the shipping
order. On a new order, select the sales job; on an existing order, the saved order
number and linked client can also appear.

| Screen label | Rule |
|---|---|
| **Sales Job Number** | Required for a new order. It selects the sales job and its available items. |
| **Shipping ordered by** | Required. It is filled from the signed-in user and is read-only. |
| **Shipping ordered on** | Required, filled with the current date, read-only, and no later than today. |
| **Client** | Appears when the shipping order has a linked sales job. |
| Existing order number | The existing order's `SalesOrderNo` is present on a saved order. |

### Shipment progress

Shipment progress records who confirmed, released, and delivered the goods for an
order linked to a sales job. These fields connect the order screen to the status flow
from goods issue through delivery.

| Progress information | Screen label | Rule |
|---|---|---|
| Ready date | **Confirmed on** | No later than today. |
| Ready responsibility | **Confirmed by** | Disabled responsibility selection. |
| Release date | **Released on** | From **Confirmed on** through today. |
| Release responsibility | **Released by** | Disabled responsibility selection. |
| Delivery date | **Delivery Date** | No later than today. |
| Delivery responsibility | **Delivered by** | Disabled responsibility selection. |

**Client**, **Confirmed on**, **Confirmed by**, **Released on**, **Released by**,
**Delivery Date**, and **Delivered by** appear when the shipping order is linked to a
sales job. The ready and released dates preserve their stated ordering: a release date
cannot precede the ready date or extend beyond today.

## Create a shipping order

Create the order when the sales job and the items selected for shipment are known.
Selecting the sales job opens the item-selection surface; saving with no item is
blocked.

#### Prerequisites

- You have opened a new shipping-order form.
- You know the sales job to select.
- The sales job contains at least one item available for shipment.

#### Steps

1. In **Sales Job Number**, select the sales job.
2. In **Items for shipment**, select the available item rows.
3. Select **OK** in **Items for shipment**.
4. Check the **Items** area for the selected rows and quantities.
5. Check **Shipping ordered by**.
6. Check **Shipping ordered on**.
7. Select **Save and Close**.

   If the order has no item, the save validation displays `Please enter sales item(s)`.
   Add at least one item before selecting **Save and Close** again.

8. Confirm the success message `Your request was completed successfully`.

**Result:** The shipping order is saved and the form closes after the successful
**Save and Close** action.

After saving, use [Handle conditional shipping-order details](#handle-conditional-shipping-order-details)
to identify the surfaces available for the saved order.

## Handle conditional shipping-order details

The form changes as the order moves from new to saved and as the linked sales job and
edit access change. Use the condition that matches the form state rather than looking
for every surface on a new order.

| Form condition | What appears |
|---|---|
| Existing order | Existing-order fields and **Last Modifications**. |
| New order | The order picker for **Sales Job Number**. |
| Linked sales job | **Client** and shipment-progress fields. |
| New order with a sales job | **Product**. |
| Edit permission available | **Save**, **Save and Close**, and the editable close action. |
| Edit permission absent | The non-editable close action instead of the editable save controls. |

Permission and subscription branches depend on the account and setup. A missing
surface can therefore reflect access or subscription configuration rather than a
different order value.

### Work with item-selection options

The product-selection popup provides row selection, dispatch priority, quantity, and
unit choices when its conditions apply.

| Control or value | Use |
|---|---|
| **Select all** | Select every product row in the insertion popup. |
| **Unselect all** | Clear the selected product rows. |
| **Dispatch priority** | Choose how the product rows are dispatched. |
| `Manual selection` | Select rows manually; this is option ID 1. |
| `First booked first out` | Use the first-booked-first-out option; this is option ID 2. |
| **Target Qty** | Enter the target quantity; the minimum is 0. |
| **Selected Qty** | Review the selected quantity; the minimum is 0 when editable. |
| **Unit** | Read the item unit. |

**Select all** appears in the product popup, and **Unselect all** appears when rows are
selected. The responsibility and unit option names come from your current account
data.

### Split an item when the option is available

Use manual splitting only for an instant job with distribution type 1. In that state,
the selected product row provides **Split**.

#### Prerequisites

- The order is an instant job.
- Its distribution type is 1.
- The product row is selected in the product popup.

#### Steps

1. Select the product row.
2. Select **Split**.

**Result:** Manual item-splitting preparation opens for the selected product.

### Review shipment progress

Reopen a saved order from the shipping-order list when you need to compare its item
quantities with its progress fields or inspect its change history.

#### Prerequisites

- The shipping order is saved.
- You can identify its row in the shipping-order list.

#### Steps

1. Open **Shipping Orders** in **Projects Management**.
2. Select the status choice that contains the order.
3. Select the shipping-order row.
4. Review the item quantities and shipment-progress fields.
5. Select **Last Modifications**.

**Result:** The saved shipping order is open, and **Last Modifications** displays its
log history. **Last Modifications** is available only for an existing order.

## Out of scope on this screen

The shipping-order details screen does not provide the following fields or surface:

| Item | What to expect |
|---|---|
| **Inventory** | Not available as an active screen area. |
| **Moved to shipping on** | Not available on this screen. |
| **Moved to shipping by** | Not available on this screen. |
| **Client Order No.** | Not available on this screen. |
| **Contractual Delivery Date** | Not available on this screen. |

If a value blocks the save or another order action, use [When something goes wrong](#when-something-goes-wrong).

The list headers depend on the selected layout. The individual names offered for
**Shipping ordered by**, **Confirmed by**, **Released by**, **Delivered by**, and the
Target Qty and Selected Qty unit choices depend on the current account data.

Use **Requested shipments** for draft shipping orders. The initial expansion of panels
or popups depends on the current screen state.

## When something goes wrong

Use the message on screen to identify whether the order needs item information,
warehouse information, a quantity decision, access, or a compatible unit choice.

| Message | Corrective action |
|---|---|
| `Please enter the storage area and position for each product` | Enter storage-area and position information for every product, then save again. |
| `Please enter sales item(s)` | Add at least one sales item in **Items for shipment**, select **OK**, and save again. |
| `Some products are not available in stock` | Review the selected products against available stock before saving again. |
| `You have products with no decision regarding accepted or rejected quantity` | Set the accepted or rejected quantity decision for each affected product. |
| `Package products cannot be empty` | Complete the package-product contents before saving. |
| `You don’t have permission` | Ask the administrator responsible for Projects Management access to grant the required permission. |
| `This is only possible if all unit types are the same` | Select items with the same unit type before using the operation again. |
| `An error occurred while processing your request` | Check the order values and try the operation again; if it continues, ask your administrator to investigate. |

After correcting the order, return to [Create a shipping order](#create-a-shipping-order)
or [Review shipment progress](#review-shipment-progress), depending on the task.

## After you create or find the order

After a successful save, **Save and Close** closes the form. Reopen the saved order
from the **Shipping Orders** list when you need to review its items, progress fields,
or **Last Modifications**.

The shipping-order lifecycle continues through goods issue, inspection, ready for
shipment, release, and delivery. The order belongs to the connected project flow that
covers ordering, stock, and delivery. For the surrounding workspace, see [Project
management workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/project-management-workspace). For the broader order and
delivery hand-off, see [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered). For
detailed warehouse work, see [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow).
