# Create an MRQ

Create a material requisition (MRQ), find it again, and hand the saved request to the next
procurement task.

## Before you start

An MRQ is the material-requisition starting point for procurement work. It records the products
or requirements that procurement must source before the work continues through a request for
quotation (RFQ), quotation, purchase order (PO), warehouse handling, and delivery.

Use the material-requisition list and new-MRQ screen to create or find an MRQ. A bill of materials
(BOM) can supply the material need; the MRQ starts the procurement record that carries that need
into supplier and order work.

An MRQ can remain active or become cancelled:

| Status | Meaning |
|---|---|
| **Active** | The MRQ remains in active procurement work. |
| **Cancelled** | The MRQ has been converted to the cancelled state. |

Choose the type that matches the work:

| Type | Meaning |
|---|---|
| Project | **Products** and **Additional Requirements** are available. |
| Stock | **Products** and **Additional Requirements** are available. |
| Needs | **Products** and **Additional Requirements** are available. |
| Safety stock | A stock MRQ variant. |

| If you need to… | Go to |
|---|---|
| Reach the material-requisition list | [Find an MRQ](#find-an-mrq) |
| Open the blank form | [Open a new MRQ](#open-a-new-mrq) |
| Recognize the saved record | [Find a saved MRQ](#find-a-saved-mrq) |
| Learn the fields and product area | [Understand the MRQ screen](#understand-the-mrq-screen) |
| Enter products and save the request | [Enter and save the MRQ](#enter-and-save-the-mrq) |
| Work with conditional actions | [Handle MRQ variations](#handle-mrq-variations) |
| Correct a save or loading problem | [When saving goes wrong](#when-saving-goes-wrong) |
| Continue through procurement | [Continue with the saved MRQ](#continue-with-the-saved-mrq) |
| Complete a saved MRQ | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) |
| Follow the full procurement chain | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |

## Find an MRQ

The MRQ list is the starting place for locating existing material requisitions or opening a new
one. Sign in before opening the material-requisition list.

**Prerequisites**

- Your subscription includes the MRQ feature.
- Your account has the permission needed for the action you want to take.
- A list layout is available when the list needs a saved layout to draw its columns.

**Steps**

1. Open the material-requisition list.
2. Confirm that the purchasing tabs are visible: **All**, **RFQs**, **Quotations**, **POs**,
   **Archived**, and **MRQs**.
3. To start a direct purchase order from the list, select **Direct P.O.** when your subscription
   includes the feature and your account may create a new MRQ.

Selecting **Direct P.O.** opens the direct-purchase-order screen. That screen shows **Purchaser**,
**Product Type**, **Package Title**, **Products**, **+ Direct P.O.**, **Save**, and **Save and Close**.

![The direct-purchase-order screen opened from the MRQ list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e18fc404133c685d16560fa4d31cb1c7.png)

Your list layout determines which columns appear; use the headers visible in your list. The list
shows **MRQ no.**, **MRQ type**, **Title**, **Required receiving date**, **Sales**, and **Short vendor
list**. The toolbar also exposes **Refresh**, **Table Layout**, and **Settings**.

![The MRQ list tabs and identifying columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/98b50dde6cdaffad8c7c95eb0a1d4ebc.png)

> **Note:** Work from the headers visible in your list. The list layout determines which columns
> you can use to identify a saved MRQ.

**Result:** The MRQ list is open with its purchasing tabs and identifying columns.

Continue with [Open a new MRQ](#open-a-new-mrq) to create a request, or with [Find a saved
MRQ](#find-a-saved-mrq) to return to an existing one.

### Open a new MRQ

Use a new MRQ when you need to create the material-requisition record that begins procurement.

**Prerequisites**

- The MRQ list is available.
- Your account may create a new MRQ.

**Steps**

1. Open the new-MRQ form from the material-requisition list.
2. Confirm that the blank form opens.
3. Confirm that the blank form shows **MRQ title**, **Required Receiving Date**, **Products**,
   **Additional Requirements**, **Save**, and **Save and Close**.

The list's **Direct P.O.** action is a different entry point from the new-MRQ form.

**Result:** The blank MRQ form is open and ready for header entry. No MRQ is saved.

Continue with [Enter and save the MRQ](#enter-and-save-the-mrq) to record the request.

### Find a saved MRQ

A saved MRQ is the procurement request that can continue into RFQ, direct PO, and follow-up work.
Use the saved list row to return to its edit screen rather than reopening the blank form.

**Prerequisites**

- An MRQ has been saved.
- The MRQ list is available.

**Steps**

1. Open the MRQ list.
2. Choose the list tab that contains the saved record.
3. Identify the record from **MRQ no.**, **MRQ type**, **Title**, **Required receiving date**,
   **Sales**, or **Short vendor list**.
4. Open the saved row.
5. Confirm that the saved edit screen shows **RFQ**, **Direct PO**, **Last Modifications**,
   **Save**, and **Save and Close**.
6. Confirm that the attached product row remains in the product area.

The saved record is distinct from the blank form because it has the saved-MRQ actions and retains
the attached product row.

**Result:** The saved MRQ edit screen is open with its follow-up actions and attached product row.

Continue with [Understand the MRQ screen](#understand-the-mrq-screen) to review the saved record,
or with [Continue with the saved MRQ](#continue-with-the-saved-mrq) to hand it to procurement.

## Understand the MRQ screen

The MRQ screen identifies the request in its header, keeps selected vendors with it, and holds
requested products in a separate product area.

| Area | What you see |
|---|---|
| Header | **Branch**, **MRQ title**, **Required Receiving Date**, and **Short Vendors List** |
| Product area | **Products**, a grid, and **Additional Requirements** |
| Save area | **Save** and **Save and Close** |
| Empty grid | `No data` before a product is attached |

**MRQ title** and **Required Receiving Date** are required. **Required Receiving Date** cannot be
earlier than the date when the purchasing job was created. The product grid shows **#**,
**Product**, **Unit**, **Qty**, **Purchasing**, and **Forecasted Receiving Date**.

Select the **Short Vendors List** picker to see the available supplier choices. **Products** and
**Additional Requirements** are separate actions;
they are not two names for the vendor picker.

![The available supplier choices in Short Vendors List](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/485bfc2a58e51cfb76bc4e48d6d5f8e5.png)

The editable header shows the required fields and product-entry actions.

## Enter and save the MRQ

Enter and save the MRQ when the material requirement is ready to record and at least one product
is known.

**Prerequisites**

- You are on the blank MRQ form.
- You know the MRQ title.
- You know the required receiving date.
- You can select the product to attach.

**Steps**

1. Enter the request name in **MRQ title**.
2. Choose a date in **Required Receiving Date** that is not earlier than the date when the
   purchasing job was created.
3. Select **Products**.
4. In the product picker, use **Product**, **Description**, **Category**, **Group**, **Withdrawal**,
   **Valuation**, or **Internal product no.** to locate the product.
5. Select the product row.
6. Select **OK**.
7. Confirm that the product appears in the MRQ grid with its row number, description, and
    `Pieces`; the quantity cell can remain blank until a quantity is entered.
8. Select one save option:

   | If you want to… | Select |
   |---|---|
   | Keep the saved MRQ open | **Save** |
   | Save the MRQ and leave the form | **Save and Close** |

9. Confirm the message `Saved Successfully`.

The product picker also shows **Insert product** and **New product**. **New product** belongs to
the product-creation path.

![The product picker and its available-product controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/620e8d58abaea71b3013b48552be2479.png)

![The selected product attached to the MRQ grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/746c268327688a0cde809026458771d0.png)

After saving, the edit screen retains **RFQ**, **Direct PO**, **Last Modifications**, **Save**,
**Save and Close**, and the attached product row.

![The saved MRQ edit screen and its follow-up actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fd67a0c133bcc633354518930a96d95a.png)

**Result:** The MRQ is saved, `Saved Successfully` appears, and the saved MRQ edit screen is open.

Continue with [Handle MRQ variations](#handle-mrq-variations) when the MRQ type or saved state
changes, or with [Continue with the saved MRQ](#continue-with-the-saved-mrq) for the next
procurement action.

## Handle MRQ variations

Variations appear when the MRQ type, saved state, permissions, or action being taken changes. Use
the normal creation path first; popup-only fields belong to the action that opens their popup.

| Situation | Reader action or condition | Fields or result |
|---|---|---|
| Additional requirements | Select **Additional Requirements** for an eligible MRQ type | Quantity minimum `0.01` |
| Vendor restriction | Open **Short Vendors List** | The picker supplies the available supplier choice |
| Product entry | Use **Products** when the MRQ type is stock, project, or needs | The product picker opens |
| Requirement entry | Use **Additional Requirements** when the MRQ type is stock, project, or needs | The requirement-entry path opens |
| Regret | Open the regret action | **Regret Reason**, **Regret Date**, and **Comment** |
| Cancellation | Open the cancellation action | **Cancellation Reason**, **Cancellation Date**, **Amount**, and **Comment** |
| Cancellation amount | The cancellation concerns items at Order stage or an order | **Amount** is available |
| Rejection | Open the reject action | **Reject Date** and **Comment** |
| Delivery | Open the delivery-date action | **Delivery Date** cannot exceed Today |

The RFQ and Direct PO actions require a saved MRQ, the relevant permission, no unsaved changes,
and a non-child display. **Last Modifications** requires a saved MRQ.

**Result:** You use the normal product and vendor actions for initial entry, and reserve popup
fields and downstream actions for the state that makes them available.

Continue with [When saving goes wrong](#when-saving-goes-wrong) if a message blocks the action,
or with [Continue with the saved MRQ](#continue-with-the-saved-mrq) after the action succeeds.

## When saving goes wrong

Match the message on screen to the correction in this table. The list export and deletion paths
are outside this create-and-find procedure.

| Message | What to check or do |
|---|---|
| `Package must have at least one item` | Add an item to the package before saving. |
| `You cannot save without adding at least one product` | Select **Products**, attach a product, and save again. |
| `One of products has no quantity` | Enter a quantity for every product row that requires one. |
| `Check mandatory field(s)` | Review the required fields, especially **MRQ title** and **Required Receiving Date**. |
| `This Field Is Required` | Complete the required field identified beside the message. |
| `Required Receiving After` | Choose a receiving date that is not earlier than the date when the purchasing job was created. |
| `Saving Error` | The save did not complete; review the form and try the save action again. |
| `An error occurred while processing your request` | Review the form and retry after correcting the displayed issue. |
| `Server Error` | The server rejected the request; retry when the service is available. |
| `Updated Successfully` | The update completed. |
| `Updating Error` | The update did not complete; review the form and retry. |
| `Loading error` | The requested MRQ content did not load; return to the list and open the record again. |
| `Server error` | The server returned an error while processing the action. |
| `Converted to cancelled` | The MRQ was converted to the cancelled state. |

The messages `Updated Successfully`, `Updating Error`, `Saved Successfully`, and `Saving Error`
belong to update or save outcomes. The validation and error messages identify the correction for
their respective branches.

After correcting a save problem, return to [Enter and save the MRQ](#enter-and-save-the-mrq).

## Continue with the saved MRQ

After saving, the MRQ is the record from which procurement work continues. Its saved edit screen
shows **RFQ**, **Direct PO**, and **Last Modifications**, as well as **Save** and **Save and Close**.

| If you need to… | Select or open |
|---|---|
| Ask suppliers for quotations | **RFQ** |
| Create a direct purchase order | **Direct PO** |
| Review the record's change history | **Last Modifications** |
| Complete products or requirements | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) |
| Follow the MRQ-to-order route | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |

An active MRQ uses the `Active` state. A cancelled MRQ uses the `Cancelled` state. Continue with
the focused RFQ, quotation, purchase-order, direct purchase-order, or saved purchase-job page for
that next reader job.

**Result:** The saved MRQ remains available for follow-up and for the next procurement hand-off.

Use [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) for completion work, or follow the
[Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) for the wider procurement chain.

## Out of scope

This page stops at creating, finding, and handing off an MRQ. The following surfaces belong to
other reader jobs:

- Files panel: `Your request was completed successfully` belongs to the file panel.
- File and library dialogs: `Just '_'‘-''.' And '&' Characters Accepted` belongs to shared dialogs.
- Product editor: `Forbidden characters detected. Please remove them and try again.` and `The first variant cannot be deleted` belong to product maintenance.
- Bill of materials: `This product is already included in BOM`, `Sales order is archived`, `Booked quantity for this job is greater than the required BOM quantity`, `You cannot edit or delete the product after the purchase package is created`, and `You cannot edit the product after the PO is created` belong to BOM work.
- Product editor integration: `An error occurred while connecting to your CRM system.` and `Please select one product` belong to product maintenance.
- MRQ deletion procedure: `Cannot be deleted. Product is in purchasing`.
- MRQ deletion procedure: `Deleted Successfully`.
- MRQ deletion procedure: `Job deleted successfully`.
List **Export** and row **Delete** are not part of this create-and-find reader job.

## Related

- [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) — follow the procurement chain from
  MRQ through RFQ, quotation, purchase order, and received work.
- [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) — complete products, requirements, and
  Last Modifications on a saved MRQ.
- Purchase-job RFQs — continue with RFQ work.
- Purchase-job orders — continue with purchase-order work.
- Create a direct purchase order — continue from **Direct PO**.
- Purchase-job record — work with the broader saved purchase-job record.
- [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) — use the focused work-list pages.
