# Pricing Quotation RFQs

## Before you start

An RFQ (request for quotation) is an inquiry in a Pricing Quotation record that collects
the items and requirements to send to a sub-supplier for pricing. Use it when you
need a sub-supplier response before the Pricing Quotation can become quotation
work.

The RFQ moves through these stages:

| Stage | What it means for your work |
|---|---|
| Draft | The inquiry is being prepared or remains unsent. |
| SentToPrincipal | The inquiry has been sent through the permitted mail route. |
| ConsederAsSentToPrincipal | The inquiry has been marked as submitted without that mail route. |
| ConsederAsNotSentToPrincipal | The inquiry is treated as not submitted. |
| Offered | The inquiry has become quotation work. |

The path covered here is from RFQ creation through submission and conversion:

```mermaid
stateDiagram-v2
    Draft --> SentToPrincipal: Send RFQ To Sub-supplier
    Draft --> ConsederAsSentToPrincipal: Consider RFQ As Submitted To Sub-supplier
    SentToPrincipal --> Offered: Receive Offer
    ConsederAsSentToPrincipal --> Offered: Receive Offer
```

| If you need to… | Go to |
|---|---|
| Find the Pricing Quotation area and choose a record | [Pricing Quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) |
| Create or edit the RFQ information and items | [Find or start an RFQ](#find-or-start-an-rfq) |
| Save the RFQ | [Complete and save the RFQ](#complete-and-save-the-rfq) |
| Send it or mark it submitted | [Send the RFQ or mark it submitted](#send-the-rfq-or-mark-it-submitted) |
| Continue with quotation work | [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) |
| Resolve an unavailable or archived record | [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) |

## Find or start an RFQ

The RFQs tab is where you open a saved Pricing Quotation record and create an
inquiry from selected Job items. A saved record matters because the RFQ belongs
to that Pricing Quotation and its purchasing job.

**Prerequisites**

- Your subscription includes `BuyoutJobModule`.
- You have access to the Pricing Quotation area and the saved Pricing Quotation record.
- The Pricing Quotation contains the Job items you want to include.
- You know the purchaser, product type, package title, and item details to enter.

If `BuyoutJobModule` is not included, the application shows `Upgrade needed`.
When no Job items are selected for a new RFQ, the application shows:
`Please select one or more items to create a RFQ.`

**Steps**

1. Open the **Pricing Quotation** area.
2. Open the **RFQ** tab on the saved Pricing Quotation record.
3. Choose how to open the inquiry:

   | Inquiry | Action |
   |---|---|
   | New inquiry | Select **+ RFQ**. |
   | Existing inquiry | Open its record. |

![The Pricing Quotations list and its purchasing tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/34c32f33f21c9c08b82e025f39bdb8b4.png)

**Result:** The RFQ editor is open for a new inquiry, or an existing RFQ record is
open for editing.

## Enter record information and items

The RFQ panel combines record information with the Job items that the sub-supplier
must price. On the RFQ screen, you see **Pricing Quotations**, **RFQ**, **Offer**,
**Branch**, **Purchaser**, **Product Type**, **Package Title**, **Shipment Time Frame**,
**Client**, and **Job items**.

| Information | What to enter or expect |
|---|---|
| **Branch** | Optional. |
| **Purchaser** | Required. |
| **Product Type** | Required. Its choices come from the product types available to your company. |
| **Offer Type** | Select `firm` or **Budget**. |
| **Package Title** | Required. |
| **Shipment Time Frame** | Mandatory only when your company configuration requires it before Order. |
| **Item Description** | Identifies the item in the Job items grid. |
| **Unit** | Identifies the unit used for the item quantity. |
| **Qty** | Enter a value from 1 through 999999. |
| **RFQ Date** | Required. It cannot be later than today. |
| **Required Offer Type** | Mandatory only when your company configuration requires it. |
| **Required Bid Due Date** | Mandatory only when your company configuration requires it. It cannot be earlier than **RFQ Date**. |

The RFQ panel is shown for the applicable purchasing record and is read-only when
the record is not editable. Its actions also depend on the record existing, its
current stage, edit permission, and the unsaved-change check. The item columns are
not a fixed quotation-price grid: the RFQ item grid shows **Item Description**,
**Unit**, and **Qty**. Work from the headers visible in your list and record.

> **Note:** The item grid does not provide a **Category**, **Unit Price**, or **Item
> Price** column for this RFQ task.

![The RFQ record fields and Job items grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df516ae89f20fe55a83cb6d3928d8007.png)

**Steps**

1. In the RFQ panel, select the required **Purchaser**.
2. Select the required **Product Type**.
3. Enter the package name in **Package Title**.
4. If required by your company, enter the shipment value in **Shipment Time Frame**.
5. Enter today's date or an earlier date in **RFQ Date**.
6. If required by your company, select **Required Offer Type**.
7. If required by your company, enter a **Required Bid Due Date** that is on or after **RFQ Date**.
8. Review each retained row in **Job items**.
9. Enter the item text in **Item Description**.
10. Select the applicable **Unit**.
11. Enter the quantity in **Qty**.

**Result:** The RFQ panel contains the record information and at least one item row
with its description, unit, and quantity. Continue with [Complete and save the RFQ](#complete-and-save-the-rfq).

## Complete and save the RFQ

Save the RFQ after the record information and at least one item are ready. Saving
keeps the inquiry attached to the Pricing Quotation and leaves the saved record
editable while its stage and permissions allow editing.

**Prerequisites**

- You have an editable new or changed inquiry.
- At least one item remains in the inquiry.
- Each retained item has an **Item Description** and a valid **Qty**.

**Steps**

1. Retain at least one item in **Job items**.
2. Check each retained **Item Description**.
3. Check each retained **Qty** is from 1 through 999999.
4. Select **Save**.
5. If a required value is missing, enter it after the application shows
    `Check mandatory field(s)`.

![The completed RFQ panel before selecting Save](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df516ae89f20fe55a83cb6d3928d8007.png)

**Result:** A successful save keeps the RFQ in the Pricing Quotation's inquiries
and leaves it in **Draft**. Continue with [Send the RFQ or mark it submitted](#send-the-rfq-or-mark-it-submitted).

## Send the RFQ or mark it submitted

A saved unchanged RFQ in Draft can follow one of two submission paths. Use the mail
path when you have both the `SendEmail` permission and the `Send Email` subscription;
otherwise use the non-mail path to record that the inquiry was submitted.

**Prerequisites**

- The RFQ is saved and unchanged.
- The RFQ is in Draft.
- You know whether the mail permission and subscription are available.

**Steps**

1. Open the saved Draft RFQ.
2. Select the action that matches your available mail route:

   | If | Select |
   |---|---|
   | `SendEmail` permission and `Send Email` subscription are available | **Send RFQ To Sub-supplier** |
   | The permitted mail route is unavailable | **Consider RFQ As Submitted To Sub-supplier** |

If you select **Send RFQ To Sub-supplier**, PAMS prepares the RFQ content and PDF attachment,
then opens **Mail** with **Send To Principal**. Select **Send To Principal** after you enter
at least one recipient. The mail path can show `Email Successfully Sent to sup-spplier`. The
non-mail path can show `Inquiry submitted to client`.

![The list headers used to locate a saved RFQ](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b288450bbd0f90926ca84ed4aebe984e.png)

**Result:** The mail path moves the inquiry to `SentToPrincipal`; the non-mail path
records it as `ConsederAsSentToPrincipal`. Continue with [Convert the RFQ to a quotation](#convert-the-rfq-to-a-quotation).

## Change a submitted RFQ

Use the submitted-RFQ actions when the RFQ needs correction or a different outcome.

**Steps**

1. Open the action menu for a saved submitted RFQ.
2. Select the choice that matches the situation:

   | Situation | Select |
   |---|---|
   | Return a submitted RFQ to Draft | **Consider RFQ As Not Submitted** |
   | Change a submitted RFQ | **Enable Editing** |
   | Send the RFQ again from `SentToPrincipal` | **Re-send RFQ To Sub-supplier** |
   | Record a regretted submitted RFQ | **Regretted To Offer** |
   | Cancel a submitted RFQ | **Cancel RFQ** |

**Result:** The selected action changes the RFQ outcome or opens it for editing. Use the
message displayed by PAMS to confirm the result.

## Delete an RFQ

You can delete a saved RFQ only while it is in Draft and the Pricing Quotation has more
than one RFQ.

**Prerequisites**

- The RFQ is in Draft.
- The Pricing Quotation has more than one RFQ.

**Steps**

1. Open the Draft RFQ's action menu.
2. Select **Delete RFQ**.
3. Review `Are you sure you want to delete this request for quotation?`.
4. Select **OK** to confirm.

**Result:** The RFQ is deleted. PAMS prevents deletion when it would leave the Pricing
Quotation without an RFQ and shows `Purchasing job must have at least one RFQ`.

## Convert the RFQ to a quotation

Quotation work starts when a submitted RFQ is converted after a response is ready
to receive. Conversion is available for an RFQ at `SentToPrincipal` or
`ConsederAsSentToPrincipal`.

**Prerequisites**

- The RFQ has been sent or marked submitted.
- The RFQ stage is `SentToPrincipal` or `ConsederAsSentToPrincipal`.

**Steps**

1. Open the eligible RFQ.
2. Select **Receive Offer**.

The conversion uses the purchasing inquiry conversion action and can show
`Purchasing job converted to offer successfully`.

**Result:** The inquiry reaches `Offered`. Continue with [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations).

## When the RFQ cannot be completed

Use the message on screen to distinguish an incomplete RFQ from a missing action or
a company-dependent field. If a field is required in your company, complete it before saving.

| What you see | What to do |
|---|---|
| `Please select one or more items to create a RFQ.` | Return to the Pricing Quotation record. Select **Job items**. Select **+ RFQ**. |
| `Check mandatory field(s)` | Review **Purchaser**, **Product Type**, **Package Title**, and any field your company configuration makes mandatory. |
| `Inquiry must have at least one item` | Keep at least one item in **Job items**. |
| `Upgrade needed` | Ask your administrator to provide the `BuyoutJobModule` subscription. |
| **Send RFQ To Sub-supplier** is unavailable | Check the saved unchanged Draft condition, `SendEmail` permission, and `Send Email` subscription. |
| A field is required in one company but not another | Check your company's `CompanyMandatoryFields` configuration. |

### Related validation messages

| Message | What to do |
|---|---|
| `An error occurred while processing your request` | Review the RFQ information and try the action again. |
| `No remaining items. All items have been selected` | Review the selected Job items. |
| `Package must have at least one item` | Keep at least one item in the package. |
| `This action is only allowed if you belong to that branch` | Use a branch to which you belong. |
| `Please enter at least one email` | Enter at least one email address. |
| `Offer must have at least one item` | Keep at least one item in the offer. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep these items in the record. |
| `Required Offer Type` | Complete **Required Offer Type** when it is required. |
| `Required Bid Due Date` | Complete **Required Bid Due Date** when it is required. |
| `This field is required` | Complete the field marked as required. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value greater than 0 and no greater than 999,999.00. |
| `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. |
| `Please enter action for each milstone` | Enter an action for each milestone. |
| `Your request was completed successfully` | Continue after the requested operation completes. |
| `You already have a contact with this name` | Review the existing contact before entering another name. |

### Out of scope

The following message concerns order work rather than the RFQ task:

| Message | What to do |
|---|---|
| `Order must have at least one item` | Continue in the order workflow. |

The RFQ action set also includes **Enable Editing**, **Re-send RFQ To Sub-supplier**,
**Consider RFQ As Not Submitted**, **Regretted To Offer**, and **Cancel RFQ**. If one
of these actions is available, use the current RFQ stage and the message on screen to
choose the next step.
