# From orders to delivered

Use this page to open a saved Order, check its order details, move it through the
available confirmation and delivery actions, and continue detailed fulfillment in
Warehouse.

## Sales handoff

An Order is the saved sales commitment that the Orders work area manages from
confirmation through delivery. Orders ends when the Order reaches **Delivered**;
detailed receiving, inspection, stock, issue, and delivery-note work belongs in
Warehouse.

```mermaid
flowchart LR
    O[Order] --> C[Orders confirmation and activation]
    C --> D[Delivered]
    D --> W[Warehouse detailed delivery work]
```

The Order panel offers confirmation, activation, shipment, delivery, and correction
choices; the Orders list includes **Delivered**, while detailed delivery work continues
in Warehouse after the handoff.

| If you need to… | Go to |
|---|---|
| Find and open a saved Order | [Find and open the Order](#find-and-open-the-order) |
| Read the Order fields and item grid | [Understand the Order panel](#understand-the-order-panel) |
| Confirm or activate the Order | [Confirm and activate the Order](#confirm-and-activate-the-order) |
| Prepare shipment or record delivery | [Prepare shipment and deliver the Order](#prepare-shipment-and-deliver-the-order) |
| Correct a blocked or changed Order | [Correct the Order and handle problems](#correct-the-order-and-handle-problems) |
| Continue detailed delivery work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Follow the draft invoice created by delivery | Invoice lifecycle |

![Orders work list with the Orders and Delivered work tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a7e0b2610eb91658aa53c379c198b91a.png)

## Before you start

An Order change starts from a saved record in the right branch and supplier context.
Check these conditions before opening an action that changes the record.

| Have or check | Why it matters |
|---|---|
| A saved Order | The Order action area works on an existing saved record. |
| An editable record with no unsaved Order changes | Confirmation and other committing actions use the saved values. |
| The correct branch | Delivery actions are restricted to members of the Order's branch. |
| The applicable supplier type | Own-company and external-supplier Orders follow different shipment and delivery routes. |
| **Client**, **Vendor**, and at least one item | Confirmation requires the parties and an item. |
| Item descriptions, quantities, and prices | The Order validates item content before it progresses. |
| A passing delivery check | An ongoing PM process can block delivery. |
| The approval route, where configured | Approval actions appear only when the approval process and your capability allow them. |

Do not rely on a field being required in every company. The form can make **Client
Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery
Time**, **Delivery Term**, **Payment Method**, **Payment Period**, **L/C Number**, and
**External order no.** mandatory according to the configured rules.

## Find and open the Order

The Orders work list is the list view for saved sales jobs at the Order stage. Opening a
row takes you to that record without changing it.

**Prerequisites**

- You know which saved Order to open.
- You can open the Orders work list.

**Steps**

1. Open the Orders work list at `/sales/list/orders/view`.
2. Check that the **Orders** tab is visible.
3. Select the row for the saved Order.
4. Check the address after the row opens.

   The record opens at `/sales/edit/<record-id>`.

5. Leave the record unchanged while you review it.

After you select an Order row, the record route resolves, the panel can be expanded,
and the menu can be opened without changing the record.

**Result:** The saved Order record is open at its resolved record route.

## Understand the Order panel

The Order panel is the part of the record that holds the parties, commercial order
details, delivery and payment information, and item lines. The Order panel is available
for an Order-stage record or a later stage, and the item area is shown while the order
record is open.

**Prerequisites**

- You have opened the saved Order record.

**Steps**

1. Locate the Order panel in the opened record.
2. Check **Client** and **Vendor** to confirm the parties.
3. Review the order fields that your form displays.
4. Review the item grid before changing an item.
5. Open the Order action menu.
6. Use only the action that matches the current Order state and your task.

**Result:** The Order panel, item grid, and state-dependent action area are available for
review. After you expand the record, **Client** and **Vendor** are visible, and the menu
contains **Order amendment** and **Enable Editing**.

| Area | Fields and rules |
|---|---|
| Order references | **Client Order No.** and **Vendor Order No.** are configurable text fields. |
| Dates | **Order Date**, **Order Activation Date**, and **Forecasted Delivery Date** are date fields; the first two can be configurable requirements. |
| Delivery | **Delivery Time** is a configurable number field, and **Delivery Term** is a configurable choice. |
| Payment | **Payment Method** and **Payment Period** are configurable choices; **L/C Number** is a configurable text field. |
| External reference | **External order no.** is a configurable text field. |
| Delivery choice | **Partial delivery** is a configurable boolean field. |

The item grid contains **Item Description**, **Unit**, **Qty**, **Unit Price**,
**Item Price**, and read-only **Currency**. Package items disable **Unit**, **Qty**, and
**Unit Price**. Unitized items disable **Item Price**. The available choices for
**Delivery Term**, **Payment Method**, **Payment Period**, and **Unit** come from the
records returned to the corresponding lists, so use the choices displayed in your
Order rather than expecting a fixed list.

The action area can include the following controls, depending on state, approval,
branch, subscription, and record conditions:

| Purpose | Available control |
|---|---|
| Start or review the Order route | **Order**, **Received job**, **Received** |
| Reject or cancel acceptance | **Reject order acceptance**, **Cancelled by client**, **Cancel order** |
| Return or correct the Order | **Back to Offer**, **Order amendment**, **Enable Editing**, **Delete amendment order** |
| Save or request approval | **Save**, **Request Approval**, **Approved**, **Request approval**, **Approve**, **Reject Approval** |
| Continue supplier work | **Cancel ready for purchasing**, **Send order award to Sub-supplier** |

Use the choices displayed in the Order for the four select fields. Continue detailed
delivery work from the Warehouse handoff after the Order reaches **Delivered**.

## Confirm and activate the Order

Confirmation records that the accepted Order is ready for the next part of its route.
Activation records the activation date when the Order is waiting for activation.

| Order condition | Action to look for |
|---|---|
| The Order is waiting for activation | **Activate Order** |
| The Order has no activation conditions | **Insert activation conditions** |
| Approval is required before the Order can proceed | **Request Approval**, **Approved**, or the applicable approval action |
| The Order is ready for the next route | **Received** or the applicable action shown in the Order menu |

**Prerequisites**

- The Order is saved and editable.
- **Client**, **Vendor**, and at least one item are present.
- The configured mandatory fields and item validations pass.
- The approval process, where configured, identifies the applicable approval action.

**Steps**

1. Open the Order action menu.
2. Select the action that matches the Order condition.

   | Order condition | Select |
   |---|---|
   | The Order must enter the approval route | **Request Approval** |
   | The Order is ready for approval | **Approved** or the applicable approval action |
   | The Order is waiting for activation | **Activate Order** |
   | The Order is ready for the next route | **Received** or the applicable action shown in the Order menu |

3. Enter **Order Activation Date** when the activation form requires it.
4. Check the date before submitting the activation confirmation.
5. Select **Save** after completing the Order values.
6. Check the Order state and action menu after saving.

   A missing configured field produces `Check mandatory field(s)` or `This field is required`.

**Result:** The saved Order remains in the state permitted by its activation and approval
conditions, ready for the shipment or delivery route described next.

## Prepare shipment and deliver the Order

Shipment and delivery depend on the supplier context and on the Order being ready for
that route. The resulting business state is **Delivered** when the active Order work has
been delivered.

| Supplier or Order condition | Delivery path |
|---|---|
| Own-company supplier | The Order can pass through its readiness state before delivery. |
| External supplier | The Order can use its delivery route directly when its delivery conditions pass. |
| Delivery check fails | Delivery stops until the delivery check permits it. |
| Branch membership fails | Delivery is refused for the current branch context. |

**Prerequisites**

- The Order is confirmed or activated as required by its current state.
- The supplier context is known.
- You belong to the Order's branch.
- The delivery check permits the action.

**Steps**

1. Open the Order action menu.
2. Check the supplier context before choosing a shipment action.
3. Select **Received** when it is the available action for the ready Order.
4. Check the Order state after the action completes.
5. Open the **Delivered** work list when the Order reaches Delivered.

**Result:** The Order is in the state returned by the selected delivery action; when the
active Order work is complete, the work appears under **Delivered**, where you can follow
the post-delivery handoff.

## Correct the Order and handle problems

Use a correction action that matches the Order's current state. An amendment is the
correction route for an eligible Order; cancellation, rejection, and return actions are
separate state-dependent routes.

| Current condition | Action or response |
|---|---|
| The Order needs a permitted amendment | Select **Order amendment**. |
| The Order must become editable | Select **Enable Editing**. |
| The Order is ready for purchasing and the branch state permits it | Select **Cancel ready for purchasing**. |
| The Order must be rejected or cancelled | Use **Reject order acceptance**, **Cancelled by client**, or **Cancel order** as shown. |
| A return to the offer route is permitted | Select **Back to Offer**. |
| A delivered or ready item must be removed | Do not delete it; items labelled **Ready For Shipment** or **Delivered** cannot be deleted. |

**Prerequisites**

- The current Order state matches the correction action.
- You have the required branch, approval, and editing capability.
- You have checked the item and payment-milestone values before saving.

**Steps**

1. Open the Order action menu.
2. Select **Enable Editing** when the record is locked for editing.
3. Select **Order amendment** when the Order is eligible for an amendment.
4. Edit the field that contains the incorrect value, such as **Client Order No.**,
   **Vendor Order No.**, **Order Date**, **Delivery Term**, **Payment Method**,
   **Item Description**, **Qty**, **Unit Price**, or **Item Price**.
5. Complete every payment-milestone action when payment milestones are displayed.
6. Select **Save**.
7. Check the resulting Order state and any message on screen.

If delivery is blocked, use the message to choose the next route.

| Message | What to check |
|---|---|
| `An error occurred while processing your request` | Check the Order state, permissions, branch, and required values. |
| `No remaining items. All items have been selected` | Review the item selection before continuing. |
| `Package must have at least one item` | Add an item to the package. |
| `This action is only allowed if you belong to that branch` | Open the Order in the correct branch context. |
| `Inquiry must have at least one item` | Add an inquiry item before returning to that route. |
| `Offer must have at least one item` | Add an offer item before returning to that route. |
| `Order must have at least one item` | Add at least one Order item. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep the protected item and use an amendment route instead. |
| `Check mandatory field(s)` | Complete the configured required fields. |
| `Please select one or more items to create a RFQ.` | Select the items required for the RFQ action. |
| `Please enter action for each milstone` | Complete the action for every payment milestone. |
| `Cannot be un-delivered — a due invoice already exists` | Continue with the invoice-bound state rather than reversing delivery. |
| `All offers must be in draft status to revert to inquiry` | Return the offers to Draft before reverting. |
| `All inquiries must be in draft stage to revert to potential` | Return the inquiries to Draft before reverting. |
| `This field is required` | Complete the field marked as required. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Correct the affected quantity. |
| `Invalid input. Please enter a non-negative value` | Correct the affected price. |
| `Custom fields saved successfully` | The custom-field save completed. |
| `Job updated successfully` | The Order update completed. |
| `Job deleted successfully` | The job deletion completed; do not use deletion as a correction route for an active Order. |
| `Job regretted successfully` | The regret action completed. |
| `Job cancelled successfully` | The cancellation action completed. |
| `Job missed successfully` | The missed-job action completed. |
| `Job reactivated successfully` | The reactivation action completed. |
| `Converted to offer successfully` | The conversion to Offer completed. |
| `Converted to inquiry successfully` | The conversion to Inquiry completed. |
| `Converted To Regretted` | The conversion to Regretted completed. |
| `Converted to cancelled` | The conversion to Cancelled completed. |
| `Converted to lost` | The conversion to Lost completed. |
| `Error saving custom fields` | Review the custom-field values and save again when the route permits. |
| `Please save opened inquiry first` | Save the opened Inquiry before continuing. |
| `One or more items has ZERO quantity` | Enter a quantity greater than zero. |
| `One or more items has no unit` | Choose a unit for each affected item. |

**Result:** The Order is corrected through the available amendment, editing, approval,
rejection, cancellation, or return route, or the displayed message identifies the
condition that still blocks the action. When it reaches **Delivered**, continue with the
post-delivery steps.

## Continue after delivery

**Delivered** is the completed Order outcome for the active Order work. The Delivered
work list contains that completed work; detailed delivery work continues in Warehouse.

**Prerequisites**

- The Order has reached **Delivered**, or the delivery attempt has ended.
- You know whether delivery created a draft invoice.

**Steps**

1. Open the Delivered work list at `/sales/list/delivered/view`.
2. Check that the **Delivered** label is visible.
3. Open the delivered Order when you need to review its sales record.
4. Open the **Invoices** tab when delivery creates a draft invoice.
5. Open [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) for receiving,
   inspection, stock, issue, or delivery-note work.

The delivery response can create a draft invoice and directs you to the **Invoices**
tab. Open [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) for the detailed
delivery work.

**Result:** You can locate the completed Order, follow its draft-invoice handoff, and
continue detailed delivery work in Warehouse.
