# Offers

## Offers

An Offer is the priced proposal for one Client and one Vendor. It follows an
Inquiry after conversion and sits before an Order in the sales flow. The Offer
holds the commercial details, item prices, approval work, sending choices, and
document surfaces for that proposal.

```mermaid
flowchart LR
    Inquiry -->|convert| Offer
    Offer -->|Convert To Order| Order
```

| If you need to… | Go to |
|---|---|
| prepare the records and commercial information | [Before you start](#before-you-start) |
| locate a saved proposal | [Find and open an Offer](#find-and-open-an-offer) |
| enter parties, dates, and terms | [Enter the Offer details](#enter-the-offer-details) |
| price items and related commercial work | [Add item values and related commercial work](#add-item-values-and-related-commercial-work) |
| approve or send the proposal | [Approve and send an Offer](#approve-and-send-an-offer) |
| handle a loss, regret, cancellation, or return | [Revise, close, or return an Offer](#revise-close-or-return-an-offer) |
| continue after an eligible Offer | [What happens next](#what-happens-next) |
| work with the Inquiry that created the Offer | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) |
| work with the Order created from an Offer | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) |

## Before you start

An Offer starts with a saved Inquiry that can still be edited and has the
parties, items, and commercial expectations needed to price a proposal. Confirm
the route before entering values: a Vendor can be an external principal or your
own-company legal entity, and the available pricing work depends on that route.

**Prerequisites**

| Have or confirm | Why it matters |
|---|---|
| A saved, editable Inquiry | Offer work starts after Inquiry conversion; an unsaved source record cannot provide a reliable starting point. |
| The correct **Client** and **Vendor** | The Offer is priced for these two parties, so a wrong party changes who receives or supplies the proposal. |
| Currency, delivery terms, and payment terms | These values determine how the commercial proposal is expressed and reviewed. |
| Items, quantities, prices, dates, and commercial expectations | The Offer panel and item grid use these values to form the proposal and its total. |
| Permission to edit the sales job | Offer editing and most commands require edit permission. |
| Access to the configured approval process and a person with approval permission | A requester sees **Request approval**; a person with approval permission approves the Offer. |
| The Vendor route | For an external principal, use the Commissions route; for your own-company legal entity, use the own-company pricing route. |

## Find and open an Offer

The Offers list is the sales-job list filtered to Offer work. Its tabs are:

| Tab | Use it to |
|---|---|
| **All** | View all sales-job work. |
| **Potentials** | View early opportunities. |
| **Inquiries** | View inquiry work. |
| **Offers** | View priced proposals. |
| **Orders** | View converted orders. |
| **Archived** | View archived sales jobs. |

Its columns are **Job No.**, **File No.**, **Sales
responsible**, **Vendor**, **Client**, **Job title**, **Offer price (€)**,
**Offer type**, Job status, and **Offer stage**. The list also has
**Refresh**, `Table Layout`, and **Settings**.

![The Offers list with its tabs and the first record row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5d2c834bed841b22a36c36c73466eacd.png)

**Prerequisites**

- Have access to the sales-job lists.
- Know which saved Offer you need to open.

**Steps**

1. Open the sales-job list from the application navigation.
2. Select **Offers** in the sales-job tabs.
3. Use the headers visible in the grid to identify the record.
4. Select the first record row when it is the Offer you need.
5. Expand the **Offer** panel.

The Offers list does not show `Show archived`. Use the headers visible in your
list because saved layouts can change which columns appear.

**Result:** The Offer record opens and its **Offer** panel is available to
expand.

With the panel open, review the workspace before pricing the proposal.

## Open the Direct order entry from the Offers list

**Direct order** is a separate entry surface for creating an order directly;
it is not an existing Offer record.

**Prerequisites**

- Be on the Offers list.
- Have access to create records and an available Sales subscription.

**Steps**

1. Select **Add new** on the Offers list.
2. Select **Direct order**.

The Direct order entry contains **Save** and **Save and Close**, plus fields
including **Status**, **Branch**,
**Salesperson Responsible**, **Product Type**, **Job Title**, **End User**,
**File Number**, **Client**, **Vendor**, **Client Order No.**, **Vendor Order
No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Forecasted
Delivery Date**, **Shipping Address**, **Delivery Term**, **Payment Method**,
**Payment Period**, **Partial Delivery**, **L/C Number**, and **External order no.**
The item grid has **Item Description**, **Unit**, **Qty**, and **Unit Price**,
**Discount (%)**, **Item Price**, and **Currency**.

**Result:** The Direct order entry surface is open; no record has been saved by
these steps.

Return to the Offers list when you need an existing Offer rather than a direct
order.

## Understand the Offer workspace

The Offer workspace is a shared sales-job record with an Offer panel. The panel
contains the Offer fields and item grid, while related sections hold the
commercial and follow-up work around the proposal.

![The expanded Offer panel with fields, item grid, and header actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/65d2d089d3de3d3bbade113e960d84b0.png)

The Offer panel includes **Order chance**, **Status**, **Branch**, **Product
Type**, **Job Title**, **End User Account**, **File Number**, **Expected Order
Date**, **Client**, **Vendor**, **Offer No.**, **Offer Type**, **Bid Due Date**,
**Offer Date**, **Validity Period**, **Delivery Time**, **Delivery Term**,
**Payment Method**, **Payment Period**, and **Partial Delivery**. The item grid
includes **Item Description**, **Unit**, **Qty**, **Unit Price**, **Discount limit
(%)**, **Discount (%)**, **Item Price**, **Currency**, and **Tax (%)**.

The header contains **Save**, **Save and Close**, `Undo`, and `Redo`. The
record also provides `Bold`, `Italic`, `Strikethrough`, `Underline`,
`Ordered List`, `Bullet List`, `Font Color`, `Clear Formatting`, and
`Post` for the related text surface.

| Surface | Use it for |
|---|---|
| **Margin** | Review or enter margin values. |
| **Payment Milestone** | Record staged payment information. |
| **Technical Notes** | Keep technical proposal notes. |
| **Commercial Notes** | Keep commercial proposal notes. |
| **Comments** | Add record discussion. |
| **Tasks** | Follow up with assigned work. |
| **Activities** | Track related activities. |
| **Attachment** | Keep related files. |
| **Contacts** | Keep people related to the sales job. |
| **LGs** | Open letters-of-guarantee work. |
| **Pricing Quotations** | Open pricing quotation work. |
| **Last Modifications** | Review record changes. |
| **Tickets** | Open related tickets. |

The three-dot command menu is state-dependent. It can include
**Alternative Offer**, **Print**, **Cover letter template**, **Commercial offer
template**, **Technical offer template**, **Regret To Offer**, **Inquiry
Cancelled By Client**, **Back to Inquiry**, and **Delete**. Other commands appear
only when their stage, approval, permission, supplier, mail, alternative-offer,
print, or extension conditions allow them.

![The three-dot Offer command menu with state-dependent commands](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df97be0447a90c24830f5a3ce232a88c.png)

Selecting **Margin** opens a dialog with **Default**, **Margin**, and **Ok**.

![The Margin dialog with Default, Margin, and Ok](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/99558f59301faa97ca58594524972f77.png)

## Price and save an Offer

Pricing is the work of turning the Inquiry's item and commercial information into
an Offer that can be reviewed, approved, and sent. Choose the route that matches
the Vendor before entering or reviewing prices.

| Vendor route | Pricing surface |
|---|---|
| External principal | **Commissions** and the external-vendor pricing route. |
| Own-company legal entity | The own-company pricing route, including the available calculation and margin work. |

**Prerequisites**

- Have an editable Offer with the correct Vendor.
- Have the commercial terms and item information ready.
- Have pricing and approval access where the configured process requires it.

**Steps**

1. In the Offer panel, confirm the **Vendor**.
2. If the Vendor is an external principal, open **Commissions**.
3. If the Vendor is your own-company legal entity, open **Calculation Sheet**.
4. Review **Margin** for the applicable route.
5. Record staged terms in **Payment Milestone** when they apply.
6. Add supporting information in **Technical Notes**.
7. Add commercial information in **Commercial Notes**.
8. Select **Save** after the Offer values and item rows are ready.

Editing and pricing commands are controlled by the Offer stage, edit permission,
approval process, approval permission, Vendor identity, and whether the record
has unsaved changes. An approved Offer can require a new approval request before
it can be edited again.

**Result:** The applicable pricing route is open or the Offer values are ready
for the Offer-header save.

For an own-company Vendor, the available pricing commands can also include
**Request Pricing** or **Release Prices**. **Request Pricing** is used when pricing
must be requested from another person; **Release Prices** releases the prices when
the item rows have default unit prices.

### Enter the Offer details

The Offer details describe the proposal number, type, dates, validity, delivery,
and payment terms. Required markers are configurable, so a field is mandatory
only where your company configuration requires it.

**Prerequisites**

- Have the saved Inquiry and correct parties selected.
- Know the agreed proposal dates, validity, delivery, and payment terms.

**Steps**

1. In the Offer panel, enter the proposal identifier in **Offer No.** when your configuration requires it.
2. Select `Firm` or `Budget` in **Offer Type**.
3. Enter **Bid Due Date** on or after the Inquiry date.
4. Enter **Offer Date** on or after the Inquiry date.
5. Enter **Validity Period** from `0` through the configured maximum period.
6. Enter **Delivery Time** from `1` through the configured maximum period.
7. Select the applicable company value in **Delivery Term**.
8. Select the applicable company value in **Payment Method**.
9. Enter **Payment Period** from `1` through the configured maximum period.
10. Set **Partial Delivery** when the commercial agreement permits partial delivery.

**Result:** The Offer panel contains the available party, date, validity,
delivery, payment, and partial-delivery values.

### Add item values and related commercial work

The item grid turns the commercial request into priced Offer lines. Add at least
one complete item row; a missing quantity or unit prevents a valid save.

**Prerequisites**

- Have the item description, unit, quantity, unit price, currency, discount,
  and tax information.
- Have the Offer panel open.

**Steps**

1. In an `Item row`, enter the item in **Item Description**.
2. Select the item **Unit**.
3. Enter a positive **Qty**.
4. Enter the **Unit Price**.
5. Review **Discount limit (%)** before entering a **Discount (%)**.
6. Review the calculated **Item Price**.
7. Confirm the line **Currency**.
8. Enter **Tax (%)** when the line requires it.
9. If the grid is locked, select **Enable Editing** before changing a row.
10. Complete **Payment Milestone** and the applicable commercial notes.

The quantity and price controls enforce non-negative or positive bounds. A
percentage field can be limited to `0` through `100`, and price fields can be
limited to `0` through the Offer total price.

**Result:** The Offer has at least one item with a description, unit, quantity,
and price, plus the applicable commercial values.

### Save the Offer

Saving commits the Offer details and item rows after the form checks the fields,
items, and totals.

**Prerequisites**

- Complete the Offer details and at least one item row.
- Have permission to edit the Offer.
- If an approval process applies, know who must approve the saved Offer before
  it can progress.

**Steps**

1. Review the Offer-currency total in the Offer header.
2. Review **In Branch Currency** and the exchange rate when they are shown.
3. Select **Save** in the Offer header.
4. If a required-field message appears, enter a value in the field with the
   required marker; if an item message appears, enter a positive value in **Qty**
   or select a **Unit** as the message requires; otherwise, correct the named
   value.
5. Select **Save** again.

**Result:** The Offer-header save has been submitted with the validated Offer
details and item rows. A successful save displays `Offer updated successfully`.

After the Offer is saved, use its approval and sending commands.

## Approve and send an Offer

Approval moves a saved Offer through the configured approval route. Sending is a
separate action: it can send the Offer to the client by mail or record that it
was sent without sending mail.

**Prerequisites**

- Have a saved Offer.
- Have the configured approval permission, or know the approval role that must
  act next.
- Confirm the Offer values and item prices before approval or sending.

| Current work | Control or outcome |
|---|---|
| Submit for approval | **Request approval**; the Offer moves to **Awaiting Approval**. |
| Approve a submitted Offer | **Approve**; the Offer moves to **Approved** or **Valid**, as configured. |
| Withdraw an approval request | **Cancel approval request**. |
| Reject an approval request | **Reject approval request**, then use **Consider as not approved** where that command is available. |
| Send by email | Select **Send offer to client**. Select **Mail** or **Send to Client**. |
| Record a send without email | Select **Consider Offer As Sent To Client**. |

**Steps**

1. Select the command that matches the Offer's current work:

   | If you need to… | Select… |
   |---|---|
   | submit the Offer for approval | **Request approval** |
   | approve a submitted Offer | **Approve** |
   | withdraw an approval request | **Cancel approval request** |
   | reject an approval request | **Reject approval request**, then **Consider as not approved** when it is available |
   | send the Offer by email | **Send offer to client**, then **Mail** or **Send to Client** |
   | record a send without email | **Consider Offer As Sent To Client** |

2. Confirm the resulting approval state or sent state in the Offer record.

If a zero-price Offer triggers a confirmation, review the item prices before
confirming. The dialog displays `Your Offer Price Is Zero!` and
`Are you sure you want to deliver free of charge?`; select **Yes** only when the
Offer is intended to be free of charge. The available approval and sending
commands depend on the Offer stage, approval process, approval permission, mail
permission, and edit state.

**Result:** The Offer is submitted for approval, approved, rejected, withdrawn,
or recorded as sent through the route available to your role.

## Revise, close, or return an Offer

These commands change how an Offer continues or ends. Their availability depends
on the current Offer stage and permissions; use the command that matches the
record's current state rather than treating the three-dot menu as a fixed list.

| Need | Available command |
|---|---|
| Create a revised proposal | **Revision** |
| Create an alternative proposal | **Alternative Offer** |
| Reopen editing | **Enable Editing** |
| Extend validity | **Extend Offer Validity** or **Request Extension Validity** |
| Return to the Inquiry | **Back to Inquiry** |
| Record regret | **Regret To Offer** |
| Record client cancellation | **Inquiry Cancelled By Client** |
| Record a lost proposal | **Lost** |
| Approve or disapprove an outcome | **Approve Regretted**, **Disapprove Regretted**, **Approve Cancelled**, **Disapprove Cancelled**, **Aprove Lost**, or **Disapprove Lost** |
| Cancel or remove the record | **Cancel** or **Delete** |
| Remove prices from the consideration | **Consider Offer without prices again** |
| Remove the sent-to-client consideration | **Consider Offer As Not Sent To Client** |
| Return an approved Offer to an unapproved state | **Consider as not approved** |
| Return a lost Offer to Offer work | **Consider as not lost** |

**Prerequisites**

- Have a saved Offer.
- Confirm the current stage and the command's permission in the Offer header or
  three-dot menu.
- Before deleting, confirm that deletion is the intended action; deletion is not
  a correction for a current proposal.

**Steps**

1. Open the three-dot command menu on the Offer.
2. Select the command that matches the required revision, extension, return, or outcome.
3. Complete any dialog or reason fields shown by that command.
4. Select **Enable Editing** before changing a locked Offer.
5. Select **Delete** only when the Offer itself must be removed.
6. Confirm the resulting stage or command state in the Offer record.

**Result:** The permitted revision, extension, return, outcome, cancellation,
deletion, or consideration change is applied to the Offer.

**Consider Offer without prices again** has no dialog. It returns the Offer to
Draft and clears the default item unit prices. **Consider Offer As Not Sent To
Client** returns a sent Offer to **Approved** when approval applies, or to Draft
when it does not. Before selecting **Delete**, confirm that the Offer itself must
be removed; deletion is not a correction for a current proposal.

## When Offer work goes wrong

Correct the value named by the message, then save again. Commands also disappear
when the current Offer stage, approval state, permission, Vendor route, or edit
state does not allow them. Required markers and prefilled values can vary by
company configuration and the current Offer.

**Steps**

1. When `This field is required` appears, enter a value in the field with the
   required marker. If no field is identified, review all required markers.

| Message | Correction |
|---|---|
| `This field is required` | Enter a value in the field with the required marker; if no field is identified, review all required markers. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value above zero and no greater than `999,999.00`. |
| `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. |
| `Please enter action for each milstone` | Complete the action for every payment milestone. |
| `Please save opened cost sheet first` | Save the open cost sheet before continuing with the Offer action. |
| `All offers must be in draft status to revert to inquiry` | Return only Offers in draft status with **Back to Inquiry**. |
| `Check mandatory field(s)` | Review every field carrying a required marker, then save again. |
| `One or more items has ZERO quantity` | Enter a positive value in **Qty** for each item. |
| `One or more items has no unit` | Select a **Unit** for each item. |
| `An error occurred while processing your request` | Review the current Offer state and permissions, then retry the permitted command. |

## Offer and Offer-related messages

These are the ten messages owned by Offer entry, pricing, saving, or Offer
progression. Use the exact text when matching a message on screen.

| Area | Message |
|---|---|
| Validation | `This field is required` |
| Validation | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` |
| Validation | `Invalid input. Please enter a non-negative value` |
| Pricing | `Please enter action for each milstone` |
| Pricing | `Please save opened cost sheet first` |
| Reversion | `All offers must be in draft status to revert to inquiry` |
| Save validation | `Check mandatory field(s)` |
| Item validation | `One or more items has ZERO quantity` |
| Item validation | `One or more items has no unit` |
| Processing | `An error occurred while processing your request` |

After saving, look for `Offer updated successfully`. After sending or recording
the Offer as sent, look for `Offer Submitted To Client`.

### Messages owned by the Inquiries page

Inquiry conversion and Inquiry reversion messages belong with [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries),
because they describe the source record entering or leaving Offer work.

| Message | Owning work |
|---|---|
| `Converted to offer successfully` | Inquiry conversion |
| `Converted to inquiry successfully` | Inquiry reversion |
| `Converted To Regretted` | Inquiry outcome |
| `Converted to cancelled` | Inquiry outcome |
| `Converted to lost` | Inquiry outcome |
| `Please save opened inquiry first` | Inquiry save before conversion |
| `All inquiries must be in draft stage to revert to potential` | Inquiry reversion |

### Messages owned by Orders and purchasing pages

After the Offer hand-off, order, invoice, procurement, and purchasing messages
belong to [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) or the relevant purchasing page.

| Message or message group | Owning work |
|---|---|
| `Cannot be un-delivered — a due invoice already exists` | Orders and invoice delivery reversal |
| Purchasing item and package messages | Purchasing work |
| Order and purchasing exception messages | Orders and purchasing work |

### Messages owned by other pages

Shared sales-job, account, project, product, reference, finance, warehouse,
letters-of-guarantee, activity, and contact messages stay with the page that owns
that surface.

| Message | Owning work |
|---|---|
| `Custom fields saved successfully` and `Job updated successfully` | Sales job record |
| `Error saving custom fields` and `Job deleted successfully` | Sales job record |
| `An account with this name already exists` | Account work |
| `A project with this name already exists` | Project work |
| Product, reference, finance, warehouse, L/G, activity, and contact errors | Their related pages |

### Messages owned by Material requisition and Purchasing inquiry pages

Material requisition (MRQ) and Purchasing inquiry validation messages belong to
those related pages when that work is open.

| Message | Owning work |
|---|---|
| `Required Receiving Date` | Material requisition |
| `Required Receiving After` | Material requisition |
| `Required Offer Type` | Purchasing inquiry |
| `Required Bid Due Date` | Purchasing inquiry |

## What happens next

An eligible Offer becomes an Order. The conversion is available for an Offer in
**Valid**, `Considered-valid`, or **Expired** status, subject to the command's
state and permission conditions.

```mermaid
flowchart LR
    Valid -->|Convert To Order| Order
    ConsideredValid[Considered-valid] -->|Convert To Order| Order
    Expired -->|Convert To Order| Order
```

**Prerequisites**

- Have an eligible Offer in **Valid**, `Considered-valid`, or **Expired** status.
- Have permission to convert the Offer.
- Review the client, Vendor, prices, payment, delivery, currency, items, and
  payment milestones before conversion.

**Steps**

1. Open the eligible Offer record.
2. Select **Order** or **Convert To Order** in the Offer header.
3. Review the **Convert to order** dialog.
4. Confirm the conversion in the dialog.
5. Open the resulting Order panel.

The Order receives the Offer's Client, Vendor, payment terms, delivery terms,
currency, items, and payment milestones. Continue order confirmation, delivery,
and later exception work in [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) and [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered).

**Result:** The Order panel is available after the Offer-to-Order hand-off.
