# Purchase job workflow

A purchase job takes requested products from a material requisition (MRQ) through requests
for quotation (RFQs), quotations, a purchase order, and received work. Use this page to
orient yourself in that route, then open the focused page for the record-level task.

## Understand the purchase job workflow

The main procurement stages are `Potential`, `Offer`, `Order`, and `Delivered`. At product
level, the route is `Active`, `Offered`, `Ordered`, `ReadyForShipment`, and `Received`.

```mermaid
flowchart LR
    MRQ[MRQ] --> Potential[Potential]
    Potential --> Offer[Offer]
    Offer --> Order[Order]
    Order --> Delivered[Delivered]
    Active[Active product] --> Offered[Offered product]
    Offered --> Ordered[Ordered product]
    Ordered --> ReadyForShipment[ReadyForShipment]
    ReadyForShipment --> Received[Received]
```

The route starts with the MRQ, follows RFQ and quotation work, and reaches the `Order`
stage before purchase-order work continues on its focused page. After that hand-off, the job
progresses to `Delivered`, while the product moves through `ReadyForShipment` to `Received`.

| If you need to… | Go to |
| --- | --- |
| Reach the active purchasing lists | [Find the MRQ and purchase work](#find-the-mrq-and-purchase-work) |
| Understand tabs, columns, and list tools | [Read the purchase work list](#read-the-purchase-work-list) |
| Create or complete an MRQ | Create an MRQ |
| Work on an RFQ | Manage purchase job RFQs |
| Work on a quotation | Manage purchase job quotations |
| Approve or activate a purchase order | Manage purchase orders |
| Find exception or archived work | Find archived and exception purchase job work |
| Continue with warehouse work | Warehouse fulfillment flow |

Work can also leave the route. From `Potential`, it can become missed, regretted, or
cancelled. From `Offer`, it can become regretted, cancelled, or rejected. From `Order`, it
can become rejected or cancelled. Find those records on the exception routes.

## Before you start

The MRQ and purchasing lists appear only when the purchasing feature, access, route state,
and saved list layout allow them to appear.

| What must be in place | What it changes |
| --- | --- |
| The purchasing feature is included | The list surface is available instead of the subscription-upgrade surface. |
| You can create new purchasing work | **RFQ** and **Direct P.O.** are available on the MRQ list. |
| A list layout is available | The list grid can display its columns. |
| You are on the purchasing list | The list opens in a current state, such as **RFQs**, **Quotations**, or **POs**. |
| Selection mode is enabled for the MRQ list | Row-selection checkboxes are available. |

The purchasing list uses the route's current tab state. The documented states include `all`,
`RFQs`, `offers`, `orders`, `received`, and `archived`, together with the declared exception
states. The route selects the state in which the list opens.

> **Note:** The list grid appears after a list layout is available. Its columns follow the
> layout selected for the current list.

## Find the MRQ and purchase work

Use the purchase-work list to orient purchasing activity and the MRQ list to start from the
requested product.

**Prerequisites**

- The purchasing feature is included.
- You have access to the purchasing list and a saved list layout is available.
- You know whether you need an RFQ, a direct purchase order, or an existing MRQ or
  purchasing record.

**Steps**

1. Choose the entry route for the work you need.

   | If you need to… | Select |
   | --- | --- |
   | Start a new RFQ | **RFQ** |
   | Start a direct purchase order | **Direct P.O.** |
   | Open the purchasing work list | The purchase-work list entry available in your application |
   | Switch to material-requisition work | **MRQs** |

2. On the purchasing list, select **MRQs** to open the MRQ list.
3. In either list, select the row link for the MRQ or purchasing record you need.

The MRQ row link opens the linked MRQ record. A purchasing-list row opens the linked
purchasing record.

**Result:** The selected MRQ or purchasing record is open for the next focused task.

![Select the purchasing tab or MRQs hand-off before opening a row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/719541cae6ab2ea8162077f0e7c070d8.png)

## Read the purchase work list

The purchase-work list groups purchasing records by work state, while the MRQ list shows
the requests that supply that work. The saved list layout determines which columns appear,
so use the visible headers when locating a row.

The purchase-work list provides these tabs:

| Tab | Use it to locate |
| --- | --- |
| **All** | All purchasing work. |
| **RFQs** | RFQ-stage work. |
| **Quotations** | Quotation-stage work. |
| **POs** | Purchase-order work. |
| **Archived** | Archived or received work available in this list. |

The purchase-work list includes these columns:

| Column | Use it to orient the row |
| --- | --- |
| **Purchasing no.** | Identify the purchasing record. |
| **MRQ no.** | Match the purchasing work to its MRQ. |
| **Purchaser** | Identify the purchaser. |
| **Job stage** | Locate the job in the procurement route. |
| **Package title** | Recognize the package. |
| **Required receiving date** | Check the required receiving date. |
| **Supplier** | Identify the supplier. |

The MRQ list includes these columns:

| Column | Use it to orient the row |
| --- | --- |
| **MRQ no.** | Identify the request. |
| **MRQ type** | Distinguish the request type. |
| **Title** | Recognize the request. |
| **Required receiving date** | Check the requested receiving date. |
| **Sales** | Relate the request to sales work. |
| **Short vendor list** | Review the short vendor list. |

Both lists provide **Refresh**, **Table Layout**, and **Settings**. Use the visible headers
as your reference because the current list layout selects the columns.

![Read the purchase-work tabs, columns, and list tools](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/719541cae6ab2ea8162077f0e7c070d8.png)

## Move an MRQ through RFQ and quotation

An MRQ begins the purchasing route. RFQ work develops the request into an offer, and
quotation work develops the offer into an order. At product level, the same part of the
route is `Active` to `Offered` to `Ordered`.

**Prerequisites**

- You have reached the MRQ or purchase-work list.
- You know whether the next work is MRQ, RFQ, or quotation work.

**Steps**

1. Select the focused page for the work that follows the current stage.

   | If you need to… | Continue to |
   | --- | --- |
   | Create an MRQ | MRQ creation |
   | Work on an RFQ | Manage purchase job RFQs |
   | Work on a quotation | Manage purchase job quotations |

**Result:** You are directed to the focused page for the MRQ, RFQ, or quotation action that
follows the current stage.

## Hand the quotation to purchase-order approval and activation

The quotation-to-purchase-order hand-off is where quotation work becomes purchase-order
work. The process map places that work at `Order` after the quotation.

**Prerequisites**

- You have reached quotation work.
- You can open the focused purchase-order page.

**Steps**

1. Continue to Manage purchase orders.

**Result:** The quotation-to-purchase-order hand-off is complete for the next focused
purchase-order task.

## Recover from a blocked list action

List filtering and loading can stop an action before the list is usable. Match the message
you see to the response below.

**Prerequisites**

- You are on the MRQ or purchasing list.
- You have a list action to perform.

**Steps**

1. In the toolbar above the list, select the control for the action you need.

   | If you need to… | Select |
   | --- | --- |
   | Refresh the list | **Refresh** |
   | Change the visible list layout | **Table Layout** |
   | Open list settings | **Settings** |
   | Export list data | **Export** |
   | Delete an MRQ | **Delete** |

2. If the action opens a dialog, select **Cancel** to close it without continuing.
3. If an error or alert appears, use the matching response below.

| What you see | What to do |
| --- | --- |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the filter, then retry the list action. |
| `Load data failed: ` + runtime error text | Treat the list load as failed and continue to the exception or troubleshooting page. |
| `Are you sure you want to delete this MRQ?` | Confirm the deletion only when the MRQ is the one you intend to remove. |
| `Data Importing completed` | The import has completed. |
| `NO Data to Export` | Return to the list. |
| `Data Deleted Successfully` | The deletion completion alert appears after the MRQ is deleted. |
| ``Translated response from `checkErrorResponse``` | Use the translated response shown by the application to correct the failed action. |
| A subscription-upgrade surface | Ask for the purchasing feature to be included before using the list. |

4. If `NO Data to Export` appears, return to the list.
5. On the list, select **Export** after data is available.
6. Continue to Find archived and exception purchase job work for exception recovery.

**Result:** The list action is closed, retried with corrected input, or handed to the
exception page for recovery.

## Continue after the purchase order hand-off

After purchase-order work, the procurement stage moves from `Order` to `Delivered`. The
product-level route continues from `Ordered` to `ReadyForShipment` and then `Received`.

| Next state | Where to continue |
| --- | --- |
| `Delivered` | Purchase-order work after the order stage. |
| `ReadyForShipment` | Warehouse fulfillment work after the purchase order. |
| `Received` | Warehouse receiving work. |

Continue with Manage purchase orders for the purchase-order record and Warehouse fulfillment
flow for the warehouse work that follows the hand-off.
