# Manage purchase job RFQs

Use this page to create a request for quotation (RFQ) for a purchase job, send it
to a sub-supplier or record its submission, and move an eligible RFQ into the offer
stage.

## What a purchase-job RFQ is

An RFQ is the purchase-job request you send to a sub-supplier for a quotation. It
sits after the material requisition (MRQ) and before the quotation stage, so it
turns the items requested in the MRQ into a supplier-facing procurement request.

The purchase-job flow is:

| Stage | What it represents |
|---|---|
| MRQ | The material request that starts the purchase-job work. |
| RFQ | The request sent to a sub-supplier. |
| Quotations | The stage that follows an RFQ converted to an offer. |
| POs | The purchase-order stage after quotations. |
| Received | The receiving stage after the purchase order. |

An RFQ can be in one of these stages or exit states: `Draft`, `SentToPrincipal`,
`ConsederAsSentToPrincipal`, `ConsederAsNotSentToPrincipal`, `CanceledInquiry`,
`RegretToOffer`, and `Offered`. At `SentToPrincipal` or
`ConsederAsSentToPrincipal`, use **Receive Offer** to convert the RFQ to an offer.

| If you need to… | Go to |
|---|---|
| Find an RFQ in the purchase-job lists | [Find and open an RFQ](#find-and-open-an-rfq) |
| Recognize the RFQ fields and item grid | [Understand the RFQ record](#understand-the-rfq-record) |
| Create or correct a draft | [Create and correct an RFQ](#create-and-correct-an-rfq) |
| Send or record submission | [Send or record submission and receive the offer](#send-or-record-submission-and-receive-the-offer) |
| Reverse, regret, cancel, or delete an RFQ | [Correct or close an RFQ](#correct-or-close-an-rfq) |
| Continue with quotations | [Purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) |
| Work with comments, attachments, or history | [Purchase-job comments, files, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) |

## Before you start

An RFQ belongs to a saved purchase job, and the available actions depend on the
job stage, whether the RFQ has unsaved changes, and your email access.

| Confirm before you start | Why it matters |
|---|---|
| The purchase job is saved. | RFQ actions require a saved record; the read-only entry check showed **Purchaser** and **MRQ product** on the entry surface. |
| The job is a non-direct purchase job before `Order`. | **+ RFQ** is available for this route while the job is at the eligible pre-order stages. |
| At least one inquiry exists and the job is after `Unknown` and before `Offer`, or is `Deleted`. | These conditions expose the RFQ panel. |
| You can edit the saved record and the RFQ has no unsaved changes. | Saving and submission actions depend on edit access and an unchanged saved RFQ. |
| You know whether your account has `Send Email` permission and an active subscription. | These determine whether the screen offers email sending or recording submission without email. |
| You have the sub-supplier and item information. | The RFQ identifies the supplier and the items requested. |

Before creating an RFQ, open the purchase-job entry and confirm that **Purchaser** and
**MRQ product** are present.
![The Purchasing entry surface with Purchaser and MRQ product](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/206a781855b25229ce5538cc0239ce87.png)

## Find and open an RFQ

The RFQs list is the starting point for locating existing supplier requests; the
purchase-job record is where you work with the RFQ panel.

**Prerequisites**

- You have access to the **Purchasing** area.
- You know the purchase job or supplier request you need to open.

**Steps**

1. Open **Purchasing**.
2. Select **RFQs**.
3. In the Purchase Jobs list, select the tab that matches the work you need.

   | If you need to… | Select |
   |---|---|
   | Search all purchase jobs | **All** |
   | Work with RFQs | **RFQs** |
   | Work with quotations | **Quotations** |
   | Work with purchase orders | **POs** |
   | Find archived work | **Archived** |

4. Select the purchase job.
5. Open the RFQ accordion in the purchase-job record.

**Result:** The purchase-job record opens with the RFQ panel available while the job
is before `Offer` or is `Deleted`.

## Understand the RFQ record

The RFQ panel is the collapsible part of a saved purchase-job record where you choose
the supplier, review the request, and work with its items.

The **Sub-supplier** picker displays supplier names for eligible principal or sub-supplier
accounts and excludes the local branch. The panel identifies the **Sub-supplier**, the
**Client**, and the **Currency**. Its item grid shows
these three columns:

| Column | What to check |
|---|---|
| **Item Description** | The description of the requested item; this field is required. |
| **Unit** | The item's unit; the control is disabled for package items or selected products. |
| **Qty** | The requested quantity; enter a value from `1` through `999999`. |

The RFQ panel is an accordion, so open it to see its body. The RFQ body is available
only while the inquiry is open. The purchase-job tabs are available on a saved
purchase job. Follow the required markers shown on your screen.

## Create and correct an RFQ

Create a draft when the purchase job needs a supplier request, then correct its
supplier or item rows before saving it. A draft keeps the request editable until it
is submitted or otherwise staged.

The **Sub-supplier** picker displays supplier names for eligible principal or sub-supplier
accounts and excludes the local branch; **Required Offer Type** offers the exact rendered
choices **firm** and **Budget**.

**Prerequisites**

- The purchase job is saved, non-direct, and at an eligible stage before **Order**.
- You know the sub-supplier and the items to request.
- You have edit permission on the record.

**Steps**

1. In the purchase-job record, select **+ RFQ**.
2. In **Sub-supplier**, select the supplier for this request.
3. If **Required Offer Type** is shown as required, select the required offer-type choice.
4. In each draft item row, enter or correct **Item Description**.
5. In each draft item row, select **Unit** when the control is available.
6. In each draft item row, enter **Qty** from `1` through `999999`.
7. Select **Save** in the RFQ panel header.

If the form rejects the draft, correct the field or item condition named by the
message before selecting **Save** again. The RFQ panel is read-only when the record
is embedded or you do not have edit permission. An RFQ with an ID can have its draft
changes undone before it is staged. **Delete RFQ** is available only for an unstaged
RFQ when the purchase job contains more than one RFQ.

Package items and selected products can make **Unit** unavailable. Package selection
also requires at least one package item, and the item-selection action can stop when
all remaining items are already selected.

**Result:** The purchase job contains a saved, editable RFQ draft, or the displayed
validation message identifies the supplier, item, or package value that needs
correction.

## Send or record submission and receive the offer

Submission moves a saved unchanged draft from preparation into supplier follow-up.
The screen chooses between sending an email and recording submission according to
your `Send Email` permission and subscription.

**Prerequisites**

- The RFQ is saved, unchanged, and has an ID.
- The RFQ is an unsubmitted draft.
- For email sending, your account has `Send Email` permission and the required
  subscription.

**Steps**

1. Select the action that matches the RFQ state.

   | Condition | Action |
   |---|---|
   | Email sending is allowed | Select **Send RFQ To Sub-supplier**. |
   | Email sending is not allowed | Select **Consider RFQ As Submitted To Sub-supplier**. |
   | The RFQ is at `SentToPrincipal` and must be sent again | Select **Re-send RFQ To Sub-supplier**. |
   | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and the offer is ready | Select **Receive Offer**. |
   | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and the submitted state must be reversed | Select **Consider RFQ As Not Submitted**. |

**Result:** Recording submission sets the inquiry stage to
`ConsederAsSentToPrincipal` and displays `Inquiry submitted to client`. Receiving the
offer converts the purchase job to the offer stage and displays
`Converted to offer successfully`.

## Correct or close an RFQ

After submission, the RFQ exposes only the corrections and closing actions allowed
for its current stage. Use the action that matches the stage instead of assuming
that every RFQ action is available everywhere.

**Prerequisites**

- The RFQ is open in its purchase-job record.
- The current stage is visible before you choose a reversal, regret, cancellation,
  download, or deletion action.

**Steps**

1. Select the action that matches the RFQ state and the correction you need.

   | Condition | Action |
   |---|---|
   | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and needs correction | Select **Enable Editing**. |
   | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and must be marked as regretted | Select **Regretted To Offer**. |
   | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and must be cancelled | Select **Cancel RFQ**. |
   | The RFQ is at `CanceledInquiry` and must be restored | Select **Consider RFQ As Not Cancelled**. |
   | The RFQ is at `RegretToOffer` and the regret state must be reversed | Select **Consider As Not Regretted**. |
   | Printing is allowed | Select **RFQ template**. |
   | The RFQ is unstaged and the purchase job has more than one RFQ | Select **Delete RFQ**. |

**Result:** The RFQ changes only to the reversal, regret, cancellation, template, or
deletion state exposed for its current stage. The available exit states include
`CanceledInquiry`, `RegretToOffer`, and `ConsederAsNotSentToPrincipal`.

## When an RFQ action fails

Match the message on screen to the correction below before repeating the action.

| Message | Corrective action |
|---|---|
| `Check mandatory field(s)` | Complete the required RFQ fields shown on the form. |
| `Inquiry must have at least one item` | Add an item to the inquiry before saving or submitting it. |
| `Please select one or more items to create a RFQ.` | Select at least one item for the new RFQ. |
| `An error occurred while processing your request` | Check the RFQ stage and record permissions before retrying. |
| `No remaining items. All items have been selected` | Review the selected items; there are no unselected items left to add. |
| `Package must have at least one item` | Add an item to the package. |
| `This action is only allowed if you belong to that branch` | Use a branch to which your account belongs. |
| `Please enter at least one email` | Enter at least one email address before sending. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Leave those items in place and choose another item to remove. |
| `Package products cannot be empty` | Add products to the package before saving it. |

Saving validates the RFQ before committing it. If you leave with unsaved work, the
screen's deactivation guard protects that work.
![The RFQ action area and validation context](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/206a781855b25229ce5538cc0239ce87.png)

The RFQ messages also include the following messages. Apply the correction indicated
by the message before retrying the action.

| Message | When to use it |
|---|---|
| `This Field Is Required` | Complete the field marked as required. |
| `Required Offer Type` | Complete the **Required Offer Type** field. |
| `Required Bid Due Date` | Complete the **Required Bid Due Date** field. |
| `Product package deleted from all inquiries` | Confirm the package deletion result. |
| `Item(s) Regretted` | Confirm the regret result. |
| `Item(s) Cancelled` | Confirm the cancellation result. |
| `Item(s) Rejected` | Confirm the rejection result. |
| `Item(s) Reactivated` | Confirm the reactivation result. |
| `Email sent to client. Added to emails list activity` | Confirm the email-send result in the email activity. |
| `Converted to offer successfully` | Continue with the offer stage. |
| `Please insert at least one product` | Select at least one product. |
| `Please insert at least one RFQ` | Create or select at least one RFQ. |
| `Check RFQ mandatory field(s)` | Complete the required RFQ fields. |
| `Selected sub-supplier is not among the requested vendors` | Select a requested sub-supplier. |
| `This account already exists. Would you like to consider it as a sub-supplier?` | Choose the offered sub-supplier option when it matches the request. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters. |
| `You already have a contact with this name` | Use a different contact name. |
| `Your request was completed successfully` | Confirm that the requested action completed. |
| `Just '_'‘-''.' And '&' Characters Accepted` | Use only the accepted characters. |
| `Product package deleted from all offers` | Continue with the quotation-stage record. |
| `Product package deleted from all orders` | Continue with the purchase-order record. |
| `Order updated successfully. Undelivered. A draft invoice was deleted` | Continue with the updated order. |
| `Job reactivated successfully` | Continue with the reactivated job. |
| `Converted to inquiry successfully` | Continue with the inquiry record. |
| `Check PO mandatory field(s)` | Complete the required purchase-order fields. |
| `Please insert at least one PO` | Add at least one purchase order. |
| `Offer must have at least one item` | Add at least one quotation item. |
| `Order must have at least one item` | Add at least one purchase-order item. |
| `Please enter action for each milstone  ` | Enter an action for each payment milestone. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value within the displayed range. |
| `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. |
| `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from `0` through `100`. |

### Out of scope — Libraries and files, contact editing, and payment milestone editing

Use [Purchase-job comments, files, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history)
or [Libraries and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for the **Attachment** and **Last Modifications**
tabs. Use [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) for contact editing. Payment milestone editing
is outside this RFQ task.

## Continue after the RFQ

An offered RFQ becomes a quotation-stage purchase job. From there, procurement work
continues through **Quotations**, **POs**, and **Received**; RFQ work and quotation
work remain on separate pages.

Select [Purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) to continue with the
quotation stage and the quotation-to-purchase-order work.
