# Pricing Quotation quotations

Use a quotation panel to complete a supplier quotation that came from an RFQ, save its commercial
details, and choose an available quotation outcome.

## Quotation work from an RFQ

A quotation is the supplier response recorded against an RFQ. Quotation work starts after RFQ work
and remains available from the **Offer** stage up to, but not including, **Order**.

```mermaid
flowchart LR
    RFQ[RFQ work] -->|quotation panel becomes available| Offer[Offer]
    Offer -->|**Valid Offer**| Valid[Valid offer]
    Offer -->|**Alternative Offer**| Alternative[Alternative offer]
    Offer -->|**Revision**| Revision[Revision]
    Offer -->|**Rejected Offer**| Rejected[Rejected offer]
    Offer -->|**Cancel RFQ**| Cancelled[Cancelled RFQ]
    Offer -->|**Regretted To Offer**| Regretted[Regretted offer]
    Offer -->|**Back to RFQ**| RFQ
    Valid -->|quotation work ends before| Order[Order]
```

The quotation panel carries the supplier response and item values while the work is in the quotation
range: **Offer** is the quotation stage and **Order** is the downstream boundary for this page.

| If you need to… | Go to |
|---|---|
| Check whether quotation editing is available | [Before you start](#before-you-start) |
| Find the quotation list and open a row | [Find and open a quotation](#find-and-open-a-quotation) |
| Read the quotation fields and item columns | [Understand the quotation editor](#understand-the-quotation-editor) |
| Enter details and save the quotation | [Save a quotation](#save-a-quotation) |
| Mark a draft valid or start another offer | [Choose a quotation outcome](#choose-a-quotation-outcome) |
| Recover rejected, cancelled, or regretted work | [When quotation work does not proceed](#when-quotation-work-does-not-proceed) |
| Find active quotation rows | [Pricing Quotation active lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-active-lists) |
| Review archived quotation exceptions | [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) |
| Maintain attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) |

## Before you start

Quotation editing applies to a saved RFQ-created quotation in the quotation stage range. The
subscription and your edit permission must expose the editor; outcome actions require a saved,
unchanged quotation, while a new or changed quotation uses **Save** first.

**Prerequisites**

- The current record is an RFQ-created quotation at **Offer** or later and before **Order**.
- The Buyout Job Module subscription is available.
- Your account has quotation edit permission when you need to change fields or save.
- The quotation is saved and unchanged when you need **Valid Offer**, **Alternative Offer**,
  **Revision**, an exception action, a restore control, or **Back to RFQ**.
- You have the supplier, offer details, delivery and payment choices, and item values needed for
  the quotation.

The required fields and allowed periods depend on company configuration. A configured field can be
required even when another company's quotation editor does not require it. The configured maximum
for offer-number length and the maximum period are also applied by the editor.

## Find and open a quotation

The **Quotations** list is the active list for supplier quotations. Use it when you need to identify
a saved quotation row before opening its quotation panel.

**Prerequisites**

- The **Sales** menu contains **Pricing Quotations**.
- The Pricing Quotation list shell and its table are available.
- A saved quotation row exists.

**Steps**

1. Open **Sales**.
2. Select **Pricing Quotations**.
3. Select **Quotations**.
4. Identify the row using the visible quotation-list columns.

   | Column | Use it to identify the quotation |
   |---|---|
   | **Package no.** | Package number |
   | **Sales job No.** | Related sales job number |
   | **Purchaser** | Purchaser responsible for the work |
    | **Offer type** | Offer classification |
    | **Bid due date** | Deadline for the bid |
    | **Sub-supplier** | Supplier associated with the row |
    | **Client** | Client associated with the row |
    | RFQ stage | Stage of the related RFQ |
    | **Package title** | Package description |

5. Select the quotation row.

   ![The Pricing Quotations list with Quotations selected and its visible row headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec955c6b33e9e33145da17096327086d.png)

The list provides **Refresh**, **Table Layout**, and **Settings**.

**Result:** The selected quotation record opens for inspection.

Use the visible list and row to open the quotation rather than relying on a saved-record address.

## Understand the quotation editor

The quotation editor records the supplier response, its commercial terms, and the values of each
quotation item. The editor can be read-only when the subscription or edit-permission check does not
allow editing.

The quotation header includes **Sub-supplier**, **Offer No.**, **Offer Type**, **Offer Date**,
**Validity Period**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**,
**Partial delivery**, and **PO No.** The offer fields describe the response and the terms under
which it is valid.

| Area | Field | Rule |
|---|---|---|
| Quotation | **Sub-supplier** | Required |
| Quotation | **Offer No.** | Required only when configured; configured maximum length |
| Quotation | **Offer Type** | Required only when configured |
| Quotation | **Offer Date** | Required only when configured; no later than today |
| Terms | **Validity Period** | Required only when configured; number from 1 through the configured maximum |
| Terms | **Delivery Time** | Required only when configured; number from 1 through the configured maximum |
| Terms | **Delivery Term** | Required only when configured |
| Terms | **Payment Method** | Required only when configured |
| Terms | **Payment Period** | Required only when configured; number from 1 through the configured maximum |
| Terms | **Partial delivery** | Optional checkbox |
| Purchasing | **PO No.** | Required only when configured |

The item grid uses **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, and
**Currency**. **Item Description** is required. **Unit** is optional and can be disabled for
package and product rows. **Qty** must be greater than 0 and no more than 999999. **Unit Price**
and **Item Price** must be non-negative; **Item Price** can be disabled for package rows.
**Currency** is read-only.

**Offer Type** has the options `Firm` and `Budget`. **Validity Period** and **Payment Period** each
use a number from 1 through `maximumPeriodAllowed` and a period from `AllTimePeriods`.
**Payment Method** uses the entries in `paymentMethodList`. The available supplier, delivery-term,
purchase-order, item, and unit choices depend on your company's configured values.

The item grid can also expose split-row columns and icon-only actions according to the current
configuration. Work from the columns and controls visible in your editor. When shown, use
**Item Description**, **Unit**, **Qty**, **Save**, and **Save and Close** as displayed.

![The quotation work area and the visible quotation-list context before opening a row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec955c6b33e9e33145da17096327086d.png)

![The quotation editor with its fields and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df516ae89f20fe55a83cb6d3928d8007.png)

The quotation editor includes **Branch**, **Purchaser**, **Product Type**, **Package Title**,
**Shipment Time Frame**, **Client**, and **Job items**.
**Purchaser**, **Product Type**, and **Package Title** carried required markers. The visible item
columns were **Item Description**, **Unit**, and **Qty**, and the visible controls were **Save** and
**Save and Close**.

![The quotation item grid with its available columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/947020b6a13ec3059ed7405f0b75b9bd.png)

## Save a quotation

Save a quotation after entering its supplier response, applicable terms, and at least one complete
item row. Saving creates or updates the quotation.

**Prerequisites**

- An editable quotation panel is open.
- You have the supplier, configured offer fields, and quotation item information.
- You know the quantity, unit, unit price, and currency for each item.

**Steps**

1. Complete the quotation fields and item row as follows.

   | Area | Action |
   |---|---|
   | **Sub-supplier** | Choose the supplier. |
   | **Offer No.** | Enter the quotation number when required by your configuration. |
   | **Offer Type** | Choose `Firm` or `Budget` when required by your configuration. |
   | **Offer Date** | Enter the offer date when required by your configuration. |
   | **Validity Period** | Enter the configured validity number and period when required. |
   | **Delivery Time** | Enter the configured delivery number and period when required. |
   | **Delivery Term** | Choose a value when required. |
   | **Payment Method** | Choose a value when required. |
   | **Payment Period** | Enter the configured payment number and period when required. |
   | **Partial delivery** | Select it when the quotation permits partial delivery. |
   | **PO No.** | Choose a value when required. |
   | **Item Description** | Choose an item in the item grid. |
   | **Unit** | Choose a unit when the row permits one. |
   | **Qty** | Enter a quantity greater than 0 and no more than 999999. |
   | **Unit Price** | Enter a non-negative value. |
   | **Item Price** | Enter a non-negative value when the row permits it. |
   | **Currency** | Check the read-only value. |

2. Select **Save**.
3. If **Save** displays a validation message, correct the value named in the message table.
4. Select **Save** again after correcting a validation error.

The editor uses these messages at the point of correction:

| Message | Correction |
|---|---|
| `This field is required` | Complete the field named by the validation marker. When the RFQ validation identifies them, complete **Required Offer Type** and **Required Bid Due Date**. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Correct **Qty**. |
| `Invalid input. Please enter a non-negative value` | Correct **Unit Price** or **Item Price**. |
| `Offer must have at least one item` | Add at least one quotation item. |
| `No remaining items. All items have been selected` | Use the available item choices; all remaining items are already selected. |
| `Package must have at least one item` | Add at least one item to the package. |
| `Please enter at least one email` | Enter at least one email address where the quotation action requires one. |
| `Inquiry must have at least one item` | Add an item to the inquiry before continuing with quotation work. |
| `Order must have at least one item` | Add an item before handing work to the order stage. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep those items in the quotation. |
| `Please select one or more items to create a RFQ.` | Select one or more items before creating the RFQ. |

**Result:** The quotation is saved and the screen displays `Saved Successfully`. If the save request
fails, the screen displays `Saving Error`; correct the quotation values and select **Save** again.

## Choose a quotation outcome

An outcome moves saved quotation work to its next available quotation state. The available control
depends on whether the quotation is a saved unchanged draft, a saved valid offer, a saved
`ConsederAsValid` offer, or an expired offer.

| Quotation condition | Available outcome |
|---|---|
| Saved unchanged **Draft** offer | **Valid Offer** |
| Saved unchanged **Valid**, `ConsederAsValid`, or **Expired** offer | **Alternative Offer** or **Revision** |
| Saved unchanged **Valid**, `ConsederAsValid`, or **Expired** offer | **Rejected Offer**, **Cancel RFQ**, or **Regretted To Offer** |
| Saved unchanged quotation that is not **Ordered** | **Back to RFQ** |

**Prerequisites**

- The quotation is saved with no unsaved changes.
- The quotation is at a state listed in the outcome table.

**Steps**

1. Read the quotation's current state in the open quotation panel.
2. Select the outcome that matches the work you need.

   | If you need to… | Select |
   |---|---|
   | Mark a saved draft as valid | **Valid Offer** |
   | Start another offer from an eligible quotation | **Alternative Offer** |
   | Start a revision from an eligible quotation | **Revision** |
   | Reject the offer | **Rejected Offer** |
   | Cancel the RFQ for the selected offer | **Cancel RFQ** |
   | Record regret for the offer | **Regretted To Offer** |

3. Complete the details requested by the selected outcome.

   | Selected outcome | Complete these fields when shown |
   |---|---|
   | **Rejected Offer** | **Reject Date** and **Comment** |
   | **Cancel RFQ** | **Cancellation Reason**, **Cancellation Date**, and **Comment** |
   | **Regretted To Offer** | **Regret Reason**, **Regret Date**, and **Comment** |

4. Read the confirmation message for the selected outcome.

   | Selected outcome | Message |
   |---|---|
   | **Rejected Offer** | `Offer rejected` |
   | **Cancel RFQ** | `Purchasing offer cancelled` |
   | **Regretted To Offer** | `Purchasing offer regretted` |

**Result:** The selected quotation-outcome action starts from the saved quotation state that permits
it. A control is unavailable when its state guard is not met.

## When quotation work does not proceed

A quotation exception state records why the normal quotation path stopped. Restore controls return
the corresponding saved exception to quotation work when that state permits restoration.

| Work stopped as… | Restore control |
|---|---|
| Rejected offer | **Consider Offer as Not Rejected** |
| Cancelled RFQ | **Consider RFQ As Not Cancelled** |
| Regretted offer | **Consider As Not Regretted** |

Use the following procedure when an action is unavailable or a save is blocked.

**Prerequisites**

- The quotation panel is open.
- The quotation is saved and unchanged when you need an exception or restore action.

**Steps**

1. Read the quotation state shown in the panel.
2. Select the restore control that matches the exception shown in the panel.

   | If the panel shows… | Select |
   |---|---|
   | A rejected offer | **Consider Offer as Not Rejected** |
   | A cancelled RFQ | **Consider RFQ As Not Cancelled** |
   | A regretted offer | **Consider As Not Regretted** |

3. Sign in with an account that belongs to the quotation's branch, then retry the action.
4. If a mandatory field blocks saving, complete the required field.
5. If an item error appears, add the required quotation item or correct the item row.

| What you see | What to do |
|---|---|
| `This action is only allowed if you belong to that branch` | Use an account that belongs to the quotation's branch. |
| `Check mandatory field(s)` | Complete the mandatory fields, then select **Save**. |
| `Inquiry must have at least one item` | Add an item to the inquiry before continuing with quotation work. |
| `Offer must have at least one item` | Add an item to the offer before continuing. |
| `Order must have at least one item` | Add an item before handing work to the order stage. |
| `Please select one or more items to create a RFQ.` | Select one or more items before creating the RFQ. |
| `Please enter at least one email` | Enter at least one email address where the quotation action requires one. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep those items in the quotation. |
| `An error occurred while processing your request` | Review the quotation state and values, then retry the supported action. |

The quotation panel includes **Payment Milestone**. **Commissions**, **Technical Notes**, and
**Commercial Notes** are not available as quotation controls.

**Result:** The blocking condition is corrected, the matching restore control is used, or the work
remains with the page that owns the blocked RFQ, item, branch, or downstream order condition.

### Out of scope messages

The following message belongs to order payment-milestone work rather than quotation work:

| Message | Owning area |
|---|---|
| `Please enter action for each milstone  ` | Order payment milestones |

## Continue after quotation work

After quotation work, **Back to RFQ** returns a saved unchanged quotation that is not **Ordered** to
RFQ work. **Attachment** and **Last Modifications** are shared saved-record surfaces; use their
own pages for file maintenance and audit-history details.

**Prerequisites**

- The quotation panel is open.
- The quotation is saved and unchanged for **Back to RFQ**.

**Steps**

1. Select the control that matches your next task.

   | When you need to… | Select |
   |---|---|
   | Return the quotation work to RFQ work | **Back to RFQ** |
   | Open the saved record's attached documents | **Attachment** |
   | Open the saved record's audit history | **Last Modifications** |

2. Open the downstream order page after quotation work reaches the order boundary.

**Result:** RFQ work, shared file work, audit-history work, or downstream order work is on screen at
the page that owns that next task.
