# Create a direct purchase order

Use this page to open the direct-order form, complete the information and products it exposes,
and save the record when the form permits the action.

## Create a direct purchase order

A direct purchase order is the direct branch of the procurement flow. It places the purchase
job at the `Order` stage, which is the stage the ordinary procurement path reaches after
`Potential` and `Offer` work.

```mermaid
flowchart LR
    MRQ[MRQ] --> Potential[Potential]
    Potential --> Offer[Offer]
    Offer --> Order[Order]
    Direct[Direct purchase order] --> Order
    Order --> Delivered[Delivered]
```

The direct route begins a new record at `Unknown` before the direct-order area opens. The
record's direct-order mode then supplies the order-stage form. From the order stage, the
purchase-job lifecycle can continue to `Delivered`, or leave the main route through the
declared order exits.

| If you need to… | Go to |
| --- | --- |
| Check what must be ready before opening the form | [Before you start](#before-you-start) |
| Open the direct-order editor | [Open the direct purchase-order form](#open-the-direct-purchase-order-form) |
| Identify the main areas and visible grid | [Understand the direct-order form](#understand-the-direct-order-form) |
| Enter the purchaser, product type, package, and products | [Enter the main information and products](#enter-the-main-information-and-products) |
| Complete purchase-order values and item amounts | [Complete the order details](#complete-the-order-details) |
| Save the completed record | [Save the direct purchase order](#save-the-direct-purchase-order) |
| Correct a blocked action or message | [Resolve validation and error messages](#resolve-validation-and-error-messages) |
| Continue with approval, activation, or warehouse work | [Continue with the saved purchase order](#continue-with-the-saved-purchase-order) |

## Before you start

The direct-order form is an editable new-record route. It needs the main information, any
order fields that your company configuration makes mandatory, and at least one valid order
with valid order items before saving can call the save service.

**Prerequisites**

- You have edit access to procurement details. **Save** and **Save and Close** require edit
  access, a changed record, and no save already in progress.
- You know the branch, purchaser, product type, and package title for the order.
- You have the product rows to enter or select. A new direct order must contain at least one
  product before it can pass the save checks.
- You can reach the form through the **+ Direct P.O.** entry point.
- You know which values your company requires in the order panel. **PO No.**, **Delivery Time**,
  **Delivery Term**, **Forecasted Receiving Date**, **Payment Method**, **Payment Period**,
  **Forecasted Logistics Costs**, and **Logistics Costs** are mandatory only when the company
  configuration says so. **Rate to** is required when its local-currency popup opens.
- Continue with approval, award submission, activation, and receipt work in
  [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders).

Do not treat the absence of a required marker on an order field as a fixed optional rule. The
form asks company configuration whether those fields are mandatory.

## Open the direct purchase-order form

The direct purchase-order editor is the new-record form opened by **+ Direct P.O.**; it is not
the ordinary quotation or purchase-order list entry.

**Prerequisites**

- You are signed in.
- You have edit access to procurement details.

**Steps**

1. Open the procurement list that provides the new-record actions.
2. Select **+ Direct P.O.**.
3. Confirm that the form shows **Branch**, **Purchaser**, **Product Type**, and **Package Title**.

The authenticated purchase-work list can show **RFQs** while **Direct P.O.** is absent from
that list. When that happens, use the available **+ Direct P.O.** action instead of looking
for a separate list entry.

![The direct purchase-order form with its main fields, product area, and visible actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b1572ac4f3c331b1b75be12f8438b089.png)

**Result:** The direct purchase-order form is open in new-record mode. Its direct-order area
is shown for the `AddNewDirectPO` action. Continue with the main information and products.

<!-- test:tc-48620ea1f0 -->

## Understand the direct-order form

The form combines the purchase-job information area with a product area and an embedded
purchase-order area. The form shows the main fields and a product grid; the
order panel supplies its own fields and item values when that area is available.

| Area | What to use it for |
| --- | --- |
| Main information | Choose **Branch**, **Purchaser**, and **Product Type**, then enter **Package Title**. |
| Product area | Review product rows and use **MRQ product** to insert a product row. |
| Order panel | Enter order identification, delivery, payment, logistics, rate, and item values. |
| Product grid | Review the columns shown in the direct-order form. The grid shows **No Data** until product rows are available. |

The top-level grid has these columns:

| Group | Columns |
| --- | --- |
| Product identity | **Item No.**, **Product**, **Category**, **Group** |
| Request information | **MRQ Qty.**, **MRQ type**, **Required Receiving Date**, **Job no.**, **MRQ** |
| Quantity and status | **Qty**, **V.L.**, **Is limited V.L.**, **Stage** |

The embedded order panel has these fields:

| Area | Fields |
| --- | --- |
| Identification and delivery | **PO No.**, **Delivery Time**, **Delivery Term**, **Forecasted Receiving Date** |
| Payment and status | **Payment Method**, **Payment Period**, **Status** |
| Costs and rate | **Forecasted Logistics Costs**, **Logistics Costs**, **Rate to** |

Its item grid defines **Product**, **Unit**, **Qty**, **Unit Price**, **Item Price**,
**Currency**, **Stage**, **Discount (%)**, and **Tax (%)**. Work from the headers and controls
visible in your form; the order panel's option lists and some item columns depend on the active
configuration.

**Commissions** is not an available action on this form.

## Enter the main information and products

Complete the main information before adding products. The top-level fields identify the
purchase job and determine which product set the direct order uses.

**Prerequisites**

- The direct purchase-order form is open.
- You know the purchaser, product type, package title, and product rows.

**Steps**

1. In **Branch**, enter the applicable branch when the form presents that field.
2. In **Purchaser**, select the purchaser.
3. In **Product Type**, select the applicable displayed choice. The available choices come
   from the current configuration.

4. In **Package Title**, enter the package title.
5. Review the product area for existing rows.
6. If a product row is needed, select **MRQ product**.
7. Review the product grid and confirm that the required product row is present.

The product grid can show **No Data** before a row is inserted. Saving without a product is
blocked with `Please insert at least one product`.

**Result:** The main information is entered and the product area contains the product row or
rows required for the direct order. Continue with the order details.

## Complete the order details

The order details describe how the selected products are ordered, delivered, paid for, and
priced. Complete the fields that your company configuration makes mandatory, then check each
editable item value before saving.

**Prerequisites**

- The main information and product rows are complete.
- You know the order number, delivery and payment choices, logistics values, and item amounts
  required for this order.

| Control | What to select |
| --- | --- |
| **Product Type** | Select a product-type choice from the displayed list. |
| **Delivery Time** | Select a delivery-time choice from the displayed list. |
| **Delivery Term** | Select a delivery-term choice from the displayed list. |
| **Payment Method** | Select a payment-method choice from the displayed list. |
| **Payment Period** | Select a payment-period choice from the displayed list. |

**Steps**

1. In the order panel, enter **PO No.** when it is required by your company configuration.
2. In **Product Type**, select a product-type choice from the displayed list.
3. In **Delivery Time**, select a delivery-time choice from the displayed list.
4. In **Delivery Term**, select a delivery-term choice from the displayed list.
5. In **Payment Method**, select a payment-method choice from the displayed list.
6. In **Payment Period**, select a payment-period choice from the displayed list.
7. Enter **Forecasted Receiving Date** when it is required by your company configuration.
8. In **Status**, select the applicable displayed choice. The available choices come from the
   current configuration. A new direct order starts at `Unknown`.
9. Enter **Forecasted Logistics Costs** and **Logistics Costs** when required. Use values of
   zero or greater.
10. In the order grid, enter **Qty** from `1` through `999,999`.
11. Enter **Unit Price** from `0` through `999,999,999`.
12. Enter **Discount (%)** and **Tax (%)** from `0` through `100`.
13. Select the applicable rate, logistics, or milestone action:

    | If you need to… | Select… |
    | --- | --- |
    | Enter a local-currency rate | **Enter rate**, then enter a non-negative **Rate to** value. |
    | Open the logistics-cost rate action | **Logistics Costs** |
    | Edit payment milestones | **Payment Milestone** |

> **Note:** Choice controls use the current configuration. Select the applicable displayed
choice for each named choice control.

The order grid treats **Product**, **Unit**, **Item Price**, **Currency**, and **Stage** as
values to review. **Qty**, **Unit Price**, **Discount (%)**, and **Tax (%)** are the editable
item values.

If an item value violates its rule, the form displays the corresponding validation message:

- `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00`.
- `Invalid input. Please enter a non-negative value`.
- `Invalid input. The tax rate must be between 0 and 100`.

**Result:** The order panel contains the required order values, and each editable item value
falls within its allowed range. Continue with **Save** or **Save and Close**.

## Save the direct purchase order

Use **Save** to keep the record on the form or **Save and Close** to save and leave the page.
The save action first checks the main data, package items, order count, and order items.

**Prerequisites**

- The main information is valid.
- The package contains valid product items.
- At least one order exists.
- The order contains valid items.
- You have edit access and the form contains changes.

**Steps**

1. Select the action that matches where you want to continue:

   | If you need to… | Select… |
   | --- | --- |
   | Keep the record open | **Save** |
   | Leave the form after saving | **Save and Close** |

2. Confirm the message `Saved Successfully` when the save completes.

After a successful save, the saved procurement record opens and the message `Saved Successfully`
appears. Continue with the saved purchase order.

**Result:** A successful save opens the saved procurement record and displays `Saved Successfully`.

## Resolve validation and error messages

Use the message on screen to correct the part of the direct order that is incomplete or outside
its allowed range.

| Message | Corrective action |
| --- | --- |
| `Check PO mandatory field(s)` | Complete the mandatory order fields, including any fields made mandatory by company configuration. |
| `Please insert at least one PO` | Add at least one purchase order in the order area. |
| `Please insert at least one product` | Add a product with **MRQ product**. |
| `Check mandatory field(s)` | Review the required main or order fields and complete the missing value. |
| `Order must have at least one item` | Add at least one item to the order. |
| `Package products cannot be empty` | Add a product to the package. |
| `Please enter action for each milstone ` | Complete the action for each payment milestone. |
| `An error occurred while processing your request` | Review the values and retry the action. |
| `Saving Error` | The save did not complete. Review the form and retry **Save** or **Save and Close**. |
| `Updating Error` | The update did not complete. Review the form and retry the record action. |
| `Loading error` | The form data did not load. Reopen the direct-order form. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a quantity from `1` through `999,999`. |
| `Invalid input. Please enter a non-negative value` | Enter a zero or positive unit-price or item-price value. |
| `Invalid input. The tax rate must be between 0 and 100` | Enter **Tax (%)** from `0` through `100`. |

For approval after the order is saved, use [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders).

## Continue with the saved purchase order

A saved direct purchase order enters the purchase-order part of the procurement lifecycle. The
direct-order creation page ends when the saved record opens; approval, award submission,
activation, receipt, exceptions, and warehouse work continue on their focused pages.

1. Open the page that matches your next task:

   | If you need to… | Open… |
   | --- | --- |
   | Request approval, submit or amend the order award, activate the order, or handle order-side receipt work | [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) |
   | Review how the order stage follows `Potential` and `Offer` work and leads toward `Delivered` | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |
   | Handle physical receipt, inspection, stock, or other warehouse work after the procurement hand-off | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
   | Review the wider purchase-job workspace | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) |

The procurement lifecycle can leave the main route from `Potential`, `Offer`, or `Order` through
its declared missed, regretted, cancelled, or rejected exits. The direct-order page does not
perform those later actions.

**Result:** The saved purchase order is handed to the purchase-order page for its next action;
warehouse work is handed to the warehouse page when the order reaches that downstream boundary.
