# Complete an MRQ record

An MRQ is a material requisition request. After the first request exists, complete
its requested products and additional requirements, save the record, and review
its Last Modifications surface before continuing with purchasing work.

## Complete a saved MRQ record

The MRQ status values are `NA`, **Active**, and
**Cancelled**. The procurement stages are **MRQ**, **RFQ**, **Quotations**, **POs**,
and **Received**.

| If you need to… | Go to |
|---|---|
| Confirm what must exist before you begin | [Before you start](#before-you-start) |
| Open the saved record | [Find and open the saved MRQ](#find-and-open-the-saved-mrq) |
| Identify fields, grids, and available controls | [Understand the MRQ detail surface](#understand-the-mrq-detail-surface) |
| Review requested products or add requirements | [Complete requested products and additional requirements](#complete-requested-products-and-additional-requirements) |
| Save the record and inspect its audit history | [Save the completed MRQ and review Last Modifications](#save-the-completed-mrq-and-review-last-modifications) |
| Understand why a field or action is absent | [Handle unavailable fields and record conditions](#handle-unavailable-fields-and-record-conditions) |
| Correct a validation or save error | [Resolve validation and save errors](#resolve-validation-and-save-errors) |
| Continue to RFQ or direct purchase-order work | [Continue with purchasing work](#continue-with-purchasing-work) |
| Create the first MRQ request | Create an MRQ |
| Follow the full procurement chain | Purchase jobs procurement chain |
| Work with the downstream purchase-job record | Purchase-job record |
| Work with RFQs after the hand-off | Purchase-job RFQs |
| Work with purchase orders after the hand-off | Purchase-job orders |
| Work with comments, files, and related history | MRQ comments, files, and history |

## Before you start

Have these conditions in place before you work on a saved MRQ:

| Before you start | Why it matters |
|---|---|
| An existing MRQ record | The saved MRQ is ready for follow-up work. |
| An editable record | **Save** and **Save and Close** are available only when the record is not shown as a child, the subscription surface is available, and editing is allowed. |
| Access for the next purchasing action | **RFQ** and **Direct PO** require a saved record, an editing surface, the required permission, and no job changes. |
| A supported MRQ type | **Products** and **Additional Requirements** are available for stock, project, or needs MRQs when the record is not shown as a child. |
| A saved MRQ | **Last Modifications** is available on the saved record. |
| Leave-screen awareness | Leaving the record is guarded, so finish or save edits before leaving it. |

## Find and open the saved MRQ

Follow these steps when the first MRQ request already exists and you need to
continue its product or requirement work.

**Prerequisites**

- You have an existing MRQ and the access conditions in [Before you start](#before-you-start).

**Steps**

1. Open the Purchase jobs work area.
2. Open the saved MRQ record.
3. Check that the saved record contains the **Product** and **Qty** columns.
4. Check that the purchase-job entry surface shows **Purchaser**, **Product Type**,
   **Package Title**, **Sub-supplier**, **Required Offer Type**, **RFQ Date**,
   **Required Bid Due Date**, **MRQ product**, **+ RFQ**, **Save**, and **Save and Close**.

   ![Saved MRQ detail surface with the requested-product grid and follow-up controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/826adaa8429de79abeb045a40bf1958f.png)

**Result:** The saved MRQ is open with its product and quantity information
available for review, and the next purchasing surface is identified.

## Understand the MRQ detail surface

The MRQ detail surface is the saved record's working area: it shows the request
fields, the requested-product information, available follow-up actions, and the
Last Modifications area.

| Surface | What to look for |
|---|---|
| Record fields | **Branch**, **MRQ title**, **Required Receiving Date**, **Required Receiving After**, **Status**, **MRQ products**, and **Additional Requirements**. |
| Required fields | **MRQ title** and **Required Receiving Date** carry required rules. |
| Receiving-date rule | **Required Receiving Date** must not be earlier than the date the MRQ was created. |
| Requested-product grid | **Sales Item No.**, **Product**, **Unit**, **Qty**, **Purchasing**, and **Forecasted Receiving Date**. |
| Saved-record product grid | **Product** and **Qty** are read-only columns. |
| Available controls | **Save**, **Save and Close**, **RFQ**, **Direct PO**, **Products**, **Additional Requirements**, and **Last Modifications**. |
| Controls visible on a saved record | **Save**, **Save and Close**, **Refresh**, **RFQ**, and **Direct PO**. |
| Tab values | `comments`, `logHistory`, `subSuppliers`, and `variants`. |

The saved-record view showed **Branch**, **MRQ title**, **Required Receiving
Date**, **Short Vendors List**, and **Additional Requirements**. In that view,
**Short Vendors List** and **Additional Requirements** were readouts rather than
visible controls. The Last Modifications area showed this audit text:
`The audit log provides you with a chronological sequence of actions performed by the users`.

The complete visible product-column set can vary with the saved layout. Work from
the headers that appear in your record rather than assuming that every possible
product column is present.

## Complete requested products and additional requirements

Requested products are the products attached to the saved MRQ. Additional
requirements are extra product or quantity rows associated with that request.
Review the existing rows first, because the product grid is read-only and the
insertion actions are conditional.

**Prerequisites**

- The saved MRQ is open.
- The record is not displayed as a child.
- The MRQ type is stock, project, or needs for the insertion actions.

**Steps**

1. Review the requested-product rows in the **Product** and **Qty** columns.
2. Choose the applicable insertion path:

   | If you need to… | Select… | Then… |
   |---|---|---|
   | Insert a requested product | **Products** | Enter a quantity of at least `0.01`. |
   | Insert an additional requirement, when the action is available | **Additional Requirements** | Enter a quantity of at least `0.01`. |

3. Review the rows before saving.

The **Products** action inserts a requested-product row. The **Additional
Requirements** action inserts an additional-requirement row. Both actions depend
on the saved record, the editing surface, and the MRQ type; **Additional
Requirements** is not a universal action. When the product picker opens, choose
from the options displayed for the record.

**Result:** The saved MRQ contains the requested-product and, where available,
additional-requirement rows with quantities at or above `0.01`. Continue to the
save and audit step.

## Save the completed MRQ and review Last Modifications

Save after reviewing the product and requirement rows. Then open Last
Modifications to check the saved record's audit history.

**Prerequisites**

- You have completed the available requested-product and additional-requirement work.
- A saved MRQ.
- You have the editing and subscription conditions required for saving.

**Steps**

1. Choose **Save** or **Save and Close**:

   | If you need to… | Select… |
   |---|---|
   | Save the completed MRQ and remain on the record | **Save** |
   | Save the record and close the editing surface | **Save and Close** |

2. Select **Last Modifications** on the saved record.
3. Review the audit text `The audit log provides you with a chronological sequence of actions performed by the users`.

   ![Saved MRQ with Save controls and the Last Modifications audit surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/826adaa8429de79abeb045a40bf1958f.png)

**Result:** The MRQ is saved, and **Last Modifications** is selected through the
record's history-tab action. The saved record remains available for follow-up work.

## Handle unavailable fields and record conditions

The saved MRQ can show fewer fields or actions depending on its record context.
Use the following conditions to decide whether to continue looking for a control
or proceed with the controls that are visible.

| What you do not see | What applies |
|---|---|
| **Required Receiving After** | This field is not available on this working surface. |
| **Status** | This field is not available on this working surface. Its options are **Active** and **Cancelled**. |
| **Additional Requirements** insertion | The action depends on the MRQ type and record context; it is available for stock, project, or needs MRQs when the record is not shown as a child. |
| Initially open Last Modifications | If it is not already open, select **Last Modifications** to view it. |
| A product column | Product columns can come from saved layout configuration, so the complete set is determined by what your record displays. |
| **Short Vendors List** or **Additional Requirements** control | These appear as readouts on the saved record rather than as visible controls. |

Start with the saved-record surface and use the controls actually shown there.
The available fields and actions depend on the record context. If a save reports a
problem, use [Resolve validation and save errors](#resolve-validation-and-save-errors).

## Resolve validation and save errors

Use this table when the MRQ surface stops a save or reports a processing problem.

| Message | What to check | Next action |
|---|---|---|
| `Check mandatory field(s)` | **MRQ title** or **Required Receiving Date** is incomplete. | Complete the required field and select **Save** again. |
| `This Field Is Required` | A required date field is empty. | Complete **Required Receiving Date**, then select **Save** again. |
| `One of products has no quantity` | A requested-product row has no quantity. | Enter a quantity of at least `0.01` and select **Save** again. |
| `You cannot save without adding at least one product` | The saved request has no product row. | Add a requested product through **Products**, then select **Save** again. |
| ` Package must have at least one item` | A package has no item. | Add at least one item to the package before saving. |
| `Cannot be deleted. Product is in purchasing` | The product is already involved in purchasing. | Do not delete that product from this record; continue with the purchasing work that owns it. |
| `An error occurred while processing your request` | The requested processing operation was not completed. | Review the record conditions and retry the appropriate action. |

## Continue with purchasing work

After the MRQ is saved and reviewed, **RFQ** starts the purchase path and **Direct
PO** starts the direct purchase-order path. The procurement stages that follow
are **MRQ**, **RFQ**, **Quotations**, **POs**, and **Received**.

**Prerequisites**

- A saved MRQ.
- The required permission is available.
- The editing surface is not displayed as a child and the job has no changes.

**Steps**

1. Choose the purchasing path:

   | If you need to… | Select… |
   |---|---|
   | Continue into the purchase path | **RFQ** |
   | Continue into the direct purchase-order path | **Direct PO** |

2. Check that the purchase-job entry opens.
3. Review **Purchaser**, **Product Type**, **Package Title**, **Sub-supplier**,
   **Required Offer Type**, **RFQ Date**, **Required Bid Due Date**, **MRQ product**,
   **+ RFQ**, **Save**, and **Save and Close**.
4. Continue with the purchase-job procedure for the path you selected.

**Result:** The saved MRQ hands off to the purchase-job entry surface. The entry
surface shows **Purchaser** and **MRQ product**, and remains unsaved.
