# Manage purchase job quotations

## Manage purchase job quotations

A purchase-job quotation is the offer record created from a request for quotation (RFQ).
Use it to review the offer, check its required information, validate it, convert it to a
purchase order (PO), or choose a correction path when the offer needs to change.

The purchase-job flow is ordered as follows:

```mermaid
stateDiagram-v2
    MRQ --> RFQ
    RFQ --> Offer
    Offer --> Order: Valid Offer / Convert To PO
    Order --> Delivered
```

The quotation belongs to the `Offer` part of this flow. The preceding RFQ work creates the
quotation; quotation work decides whether the offer is valid and ready to become an order.
See the purchase-job RFQ page for the request stage and the purchase-jobs procurement-chain
page for the full sequence.

| If you need to… | Go to |
|---|---|
| Find the saved quotation record | Purchase-job work lists |
| Review the quotation panel and related tabs | Understand the quotation panel on this page |
| Check the job and offer values | Purchase-job fields and Offer fields on this page |
| Validate an eligible offer or convert it to a PO | Validate and convert a quotation on this page |
| Handle a rejection, cancellation, revision, alternative, or return | Create alternatives, revisions, and returns on this page |
| Work with comments, attachments, or history | Purchase-job comments, files, and history |
| Continue after the quotation becomes a PO | Purchase-job orders |
| Find exception or archived purchase-job work | Purchase-job exception lists |

The quotation task ends when `Offer` hands off to `PO`. Approval, activation, receipt,
amendments, and later purchase-order work belong in the purchase-job orders page.

## Before you start

Before you work on a quotation, have the saved purchase job and its RFQ-created quotation
available. The purchase-job record supplies the job identity; the offer area supplies the
quotation values and item list. Its required identifying fields are **Purchaser**,
**Product Type**, and **Package Title**.

| Have or know | Why it matters |
|---|---|
| The saved purchase job | The quotation is worked from the purchase-job record. |
| The RFQ-created quotation | Quotation actions belong to the offer created after RFQ work. |
| Purchaser | Identifies the purchaser responsible for the job. |
| Product Type | Identifies the product type used by the job. |
| Package Title | Identifies the package being worked. |
| The current stage | Quotation actions are stage-dependent, so the available action set changes with the record stage. |

The main record fields appear when the subscription condition and page condition both allow
the surface: `!subscriptionNotInclude && !PageNotFound`. The `IsAccepted` checkbox is limited
to the offer stage, before the order stage, and when the offer collection contains items.

Quotation actions are stage-dependent. When their stage conditions allow them, the offer
section contains **Valid Offer**, **Convert To PO**, **Alternative Offer**, **Revision**,
**Rejected Offer**, **Denied To Extend**, and **Back to RFQ**.

The next section shows how to open the saved quotation.

## Find and open a quotation

A quotation record is the saved purchase-job record that contains the RFQ-created offer,
its item grid, and the stage-dependent quotation actions.

**Prerequisites**

- Have a saved purchase job with an RFQ-created quotation.
- Start from the purchase-job work lists or another link to the saved record.

**Steps**

1. Open the purchase-job work list.
2. Select the saved purchase job that contains the quotation.
3. Open the quotation record.

   ![Identify the saved purchase-job record and its stage bar before opening quotation work.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png)

**Result:** The purchase-job quotation record is open, with its stage bar and available
quotation surfaces visible.

## Understand the quotation panel

The quotation panel is the offer area of the purchase-job record. It brings together the
stage bar, offer actions, vendor entry, item grid, and related purchase-job tabs.

The stage bar contains MRQ, RFQ, Offer, PO, and Received. Work on quotation values in
`Offer`; after conversion, continue in `PO`. The panel's contents are stage-dependent.

The vendor value is entered through the vendors popup, where **Vendor** is required. It is
not a field to look for in the shared purchase-job fields area.

The item grid shows these headers:

| Item-grid header | What to review |
|---|---|
| Product | The product on the quotation item. |
| Category | The item's category. |
| MRQ Qty. | The quantity from the material request. |
| Qty | The quoted quantity. |
| Unit | The quantity unit. |
| Unit Price | The price for one unit. |
| Discount (%) | The item discount percentage. |
| Item Price | The resulting item price. |
| Currency | The item's currency. |
| Tax (%) | The item tax percentage. |
| Stage | The item's current purchase-job stage. |

Related surfaces can include **Purchasing PO template**, **Cancel PO**, **Back to Offer**,
**Partial delivery**, **Attachment**, **Purchase Invoices**, **Last Modifications**,
**Attach File**, and **Tickets**. The files view can display **No Files**.

The quotation panel does not place **PO No.**, **Forecasted Receiving Date**, **Forecasted
Logistics Costs**, **Logistics Costs**, **Rate to**, **Category**, **File name**, **Tags**,
**Modified**, **Mail subject**, or **Priority** in its own quotation component. Use the
purchase-order surfaces for order values, and use the related tabs for files and history.

   ![Use the stage bar, item-grid headers, and related tabs to orient yourself before changing an offer.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png)

### Purchase-job fields

The shared purchase-job fields identify the job that owns the quotation. They appear only
when the main record surface is available under the subscription and page conditions.

| Field | Required | Use |
|---|---:|---|
| Branch | No | Identifies the branch associated with the purchase job. |
| Purchaser | Yes | Identifies the purchaser responsible for the job. |
| Product Type | Yes | Identifies the product type for the job. |
| Package Title | Yes | Identifies the package for the job. |

**Purchaser**, **Product Type**, and **Package Title** carry required markers. **Branch** does
not carry a required marker.

### Offer fields

The offer fields describe the supplier's quotation before it is validated or converted.
The offer field set includes **Offer No.**, **Offer Type**, **Offer Date**, **Validity
Period**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**,
**Status**, and **Vendor**.

| Field | Requirement or choice |
|---|---|
| Offer No. | Configurable in the quotation surface. |
| Offer Type | Configurable; the named choices are `Firm` and `Budget`. |
| Offer Date | Configurable. |
| Validity Period | Configurable. |
| **Delivery Time** | Select a time period from the available time-period records. Each option is shown by its `Name`. |
| **Delivery Term** | Select a delivery-term record from the list. Each option is shown by its `Code`. |
| **Payment Method** | Select a payment-method record from the list. Each option is shown by its `Code`. |
| Payment Period | Configurable. |
| **Status** | Select an offer-status record from the list. Each option is shown by its `Name`. |
| Vendor | Required in the vendors popup. |

Review the item grid using the headers listed above. Enter the values that belong to the
quotation you are working on, then continue to validation.

### Purchase-order fields

Purchase-order fields describe the record after quotation work reaches the purchase-order
stage. The purchase-order area includes the following values:

| Group | Fields |
|---|---|
| Order identity | **Sub-supplier**, **PO No.**, **Sub-Supplier Order No.** |
| Dates | **Order Date**, **Order Activation Date**, **Forecasted Receiving Date**, **Forecasted Shipping Date**, **Actual Shipping Date**, **Forecasted In-port Arrival Date**, **Actual In-port Arrival Date**, **Forecasted Out-port Leaving Date** |
| Commercial terms | **Delivery Time**, **Delivery Term**, **Payment Method**, **L/C Number**, **Payment Period**, **Status**, **External PO no.** |
| Logistics costs | **Forecasted Logistics Costs**, **Logistics Costs** |

The purchase-order readout includes `PO/Draft`, `PO No.: PO26.1021`, `Order Price: 100.00 €`,
and **Approved**. These are record values, not values to enter for a new quotation.

## Validate and convert a quotation

Validation checks whether the offer has the information needed for the next purchase-job
stage. Conversion hands an eligible offer from `Offer` to `PO`.

**Prerequisites**

- Open the saved purchase-job quotation.
- Work from the `Offer` stage.
- Complete the required purchase-job fields: **Purchaser**, **Product Type**, and **Package Title**.
- Enter the required **Vendor** in the vendors popup.
- Have at least one quotation item.
- Choose an **Offer Type**: `Firm` or `Budget`.

**Steps**

1. Review **Purchaser**, **Product Type**, and **Package Title** in the purchase-job area.
2. Review **Vendor** in the vendors popup.
3. Review the quotation item grid.
4. Choose `Firm` or `Budget` in **Offer Type**.
5. Select **Valid Offer**.

   | Message | Action |
   |---|---|
   | `Check RFQ mandatory field(s)` | Complete the required RFQ fields. |
   | `Offer must have at least one item` | Add or retain at least one quotation item. |
   | `Required Offer Type` or `Required Bid Due Date` | Complete the corresponding required value. |

6. Select **Convert To PO**.

   | Message | Action |
   |---|---|
   | `Check PO mandatory field(s)` | Complete the required purchase-order fields. |
   | `Please insert at least one PO` | Add at least one PO. |

7. Check the stage bar for the `PO` stage.

The product can display these validation messages while the offer is being checked:
`Check RFQ mandatory field(s)`, `Offer must have at least one item`, `Required Offer Type`,
and `Required Bid Due Date`. During purchase-order validation it can display `Check PO
mandatory field(s)` or `Please insert at least one PO`.

Complete the required values before selecting **Valid Offer** or **Convert To PO**. If the
record does not satisfy a required condition, follow the message shown on screen.

**Result:** The quotation is either stopped with the matching validation message, or the
record reaches the purchase-order hand-off shown by the `PO` stage. Continue purchase-order
work in the purchase-job orders page.

## Create alternatives, revisions, and returns

The offer action area provides separate branches for an alternative, a revision, rejection,
cancellation, extension denial, or return to RFQ work. Choose the branch that matches the
correction required for the quotation.

| If you need to… | Select |
|---|---|
| Create an alternative offer | **Alternative Offer** |
| Create a revision | **Revision** |
| Mark the offer as rejected | **Rejected Offer** |
| Cancel the RFQ from offer work | **Cancel RFQ** |
| Deny an extension | **Denied To Extend** |
| Return to RFQ work | **Back to RFQ** |

The relevant popup can ask for **Comment**, **Cancellation Reason**, **Regret Date**, or
**Reject Date**.

**Prerequisites**

- Open the quotation record at the stage where the required branch action is available.
- Have the reason or date information needed by the popup.

**Steps**

1. Select the branch and complete the popup fields shown for it.

   | Required branch | Select | Complete the popup field shown |
   |---|---|---|
   | Alternative offer | **Alternative Offer** | The available popup information. |
   | Revision | **Revision** | The available popup information. |
   | Rejection | **Rejected Offer** | **Comment** or **Reject Date**. |
   | Cancellation | **Cancel RFQ** | **Cancellation Reason**. |
   | Extension denial | **Denied To Extend** | The available popup information. |
   | Return to RFQ work | **Back to RFQ** | The available popup information. |

2. Complete the popup's available confirmation action.
3. Check the message shown after the action.

The corresponding success messages are `Item(s) Regretted`, `Item(s) Cancelled`,
`Item(s) Rejected`, `Item(s) Reactivated`, and `Job reactivated successfully`.

**Result:** The selected quotation branch is submitted with its available popup information,
or the record remains on the quotation surface with the message that identifies the correction.

## When a quotation action is refused

A refused action means the quotation or the current account context does not meet a required
validation, permission, subscription, or processing condition. Use the message on screen to
choose the correction.

| Message | Correction |
|---|---|
| `Check mandatory field(s)` | Review the visible required fields and complete them before selecting the action again. |
| `Please insert at least one product` | Add at least one product to the purchase-job work. |
| `Please insert at least one RFQ` | Return to the RFQ work and add at least one RFQ. |
| `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 `0` or a positive value. |
| `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from `0` through `100`. |
| `This action is only allowed if you belong to that branch` | Work in a branch to which your account belongs. |
| `No remaining products. All package products have been selected` | Review the selected package products before trying to add another one. |
| `Package products cannot be empty` | Add package products before retrying the action. |
| `An error occurred while processing your request` | Check the record values and retry the action. |
| `Product package deleted from all inquiries` | Review the inquiry records after deleting a product package. |
| `Product package deleted from all offers` | Review the offer records after deleting a product package. |
| `Product package deleted from all orders` | Review the order records after deleting a product package. |
| `Order updated successfully. Undelivered. A draft invoice was deleted` | Review the updated order and its invoice area. |
| `Email sent to client. Added to emails list activity` | Review the email activity when the message is sent. |
| `Inquiry must have at least one item` | Add an item to the inquiry before continuing. |
| `Order must have at least one item` | Add an item to the order before continuing. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep items at these stages in the record. |
| `Please enter action for each milstone ` | Enter an action for each milestone. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and retry. |
| ` You already have a contact with this name` | Use a different contact name. |
| `Your request was completed successfully` | Continue after the completed request. |
| `This Field Is Required` | Complete the field before retrying. |
| `Input contains forbidden characters(< , >). Please remove them and try again.` | Remove `<` and `>` and retry. |
| `Min value is 1` | Enter a value of at least `1`. |
| `Cannot be un-delivered — a due invoice already exists` | Review the due invoice before changing delivery status. |
| `Check validation` | Review the validation requirements before retrying. |
| `Error {{errorMsg}}` | Read the error text and correct the related value. |
| `Converted to inquiry successfully` | Continue with the converted inquiry. |
| `Converted to offer successfully` | Continue with the converted offer. |
| `Please enter at least one email` | Enter at least one email address before retrying. |

Use the named quotation actions listed above when choosing a branch. After the branch is
resolved, continue with the purchase-order hand-off when the quotation reaches `PO`.

## Continue with the purchase order

The purchase-order hand-off begins when a quotation moves from `Offer` to `PO`. The stage bar
then continues through `PO` and `Received`, and **Convert To PO** starts this hand-off.

**Prerequisites**

- Complete the quotation review and validation work.
- Confirm that the record is ready for the purchase-order stage.

**Steps**

1. Select **Convert To PO** from the eligible offer.
2. Check that the stage bar shows `PO`.
3. Open the purchase-job orders page for approval, activation, receipt, amendments, and later
   purchase-order work.

**Result:** The quotation task ends at the purchase-order hand-off, and purchase-order
procedures own the next actions.
