# Job Profitability

Use **Job Profitability** to find a saved sales job, compare its profitability measures,
and continue to the record page that owns related cost detail.

## Job Profitability at a glance

**Job Profitability** is the place to compare one sales job's actual revenue, direct cost,
gross profit, and gross margin. A profitability record is the saved job's detail view for
these currency measures and the cost groups that explain them.

**Purchasing Cost** groups purchase-order items. The additional-cost group contains cost
transactions by cost type.

| If you need to… | Go to |
|---|---|
| Choose a status list and find a saved job | [Review the Job Profitability list](#review-the-job-profitability-list) |
| Open one saved job's profitability record | [Find a job and open its profitability view](#find-a-job-and-open-its-profitability-view) |
| Compare currency-specific measures | [Review profitability and cost summaries](#review-profitability-and-cost-summaries) |
| Understand why a tab or detail row appears | [Handle conditional tabs and detail rows](#handle-conditional-tabs-and-detail-rows) |
| Enter or allocate a direct-cost transaction | [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) |
| Read the wider sales-job context | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) |
| Review the profitability record's fields and detail groups | [Job Profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) |

![Identify the Job Profitability status tabs, columns, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c8298ff2bab32fba1e46134e12c5c2ad.png)

## Before you start

Job Profitability lists are available only when the relevant subscription and access conditions
are in place. The list is for saved-job work; use it to review an existing sales job rather
than create the job itself.

| Check | What must be true | Why it matters |
|---|---|---|
| Subscription | Job Profitability is included in the subscription | The Job-costing list and its tabs are shown. |
| Subscription state | Job Profitability is not included | The subscription-upgrade surface is shown instead of the list. |
| Saved job | The sales job has already been saved | The list locates saved job work and leads to its profitability detail. |
| Page state | The Job Profitability page is available | A page-not-found state does not provide the list work area. |
| Access | Your account has the required Job Profitability access | The related work can stop with `You don’t have permission`. |

The default list opens with **Running Jobs**. Use the status tabs to move to another list view.

## Review the Job Profitability list

The Job Profitability list groups saved jobs by work status. **Running Jobs** and
**Delivered Jobs** are the two top-level tabs. When **Delivered Jobs** is selected, its
secondary choices are **All**, **Awaiting Payment**, and **Paid**.

Your selected list layout determines which columns appear. The nine available columns are:

| First column | Second column | Third column |
|---|---|---|
| **Job No.** | `Gross Margin (€)` | `Gross Margin (ج.م.‏)` |
| `Total Direct Cost (€)` | `Purchase Cost (€)` | `Purchase Cost (ج.م.‏)` |
| `Other Direct Cost (€)` | `Sales price (€)` | **Client** |

> **Note:** Read the headers visible in your list. A saved list layout controls which columns
> appear, so another layout can present a different set of headers.

The visible list controls are **Refresh**, **table layout**, and **Settings**.

![Identify the Running Jobs tab and the visible profitability columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6858c836ace471ed031c73815695525d.png)

Choose the list that contains the saved job:

| Select | List |
|---|---|
| **Running Jobs** | The running-job list |
| **Delivered Jobs** | The delivered-job list |
| **All** | The delivered-jobs group, with all delivered jobs |
| **Awaiting Payment** | The delivered jobs awaiting payment |
| **Paid** | The delivered jobs marked paid |

![Identify the Delivered Jobs choices All, Awaiting Payment, and Paid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6331ce50e43d450ec02cf1e6679b2faa.png)

## Find a job and open its profitability view

Use the list choice that contains the saved sales job you want to inspect.

**Prerequisites**

- The Job Profitability subscription is included.
- You can open the Job Profitability list.
- You know which saved sales job you need to review.

**Steps**

1. Select the list that contains the job.

   | Job location | Select |
   |---|---|
   | Running-job group | **Running Jobs** |
   | Delivered-job group, all delivered jobs | **Delivered Jobs**, then **All** |
   | Delivered jobs awaiting payment | **Delivered Jobs**, then **Awaiting Payment** |
   | Delivered jobs marked paid | **Delivered Jobs**, then **Paid** |

2. Locate the saved job from the visible row columns, including **Job No.**, **Client**, and
   any profitability columns in your selected layout.
3. Select the row's available edit or open action.
4. If you use the context menu, open the row only when it belongs to the same branch.

**Result:**

The saved job's profitability record opens. Continue with [Review profitability and cost
summaries](#review-profitability-and-cost-summaries).

## Review profitability and cost summaries

Choose a currency view, then compare the values shown for the same measures in that currency.

| Currency view | Measures to compare |
|---|---|
| **Reference Currency** | **Actual Revenue**, **Actual Direct Cost**, **Gross profit**, and **Gross margin** |
| **Local currency** | **Actual Revenue**, **Actual Direct Cost**, **Gross profit**, and **Gross margin** |

The summary separates the two cost explanations:

| Group | What it contains |
|---|---|
| **Purchasing Cost** | Purchase-order items |
| Additional-cost group | Cost transactions grouped by cost type |

Use these measures to compare what the job earned with the direct cost assigned to it. Continue
cost-transaction entry or allocation on [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions), and review
the detailed profitability view on [Job Profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record).

## Handle conditional tabs and detail rows

Visible areas change according to the selected status, currency, list layout, number of cost
items, and whether editing is allowed.

| Surface | It appears when… |
|---|---|
| Secondary status tabs | **Delivered Jobs**, **Awaiting Payment**, or **Paid** is selected |
| Job list grid | **Running Jobs**, **Delivered Jobs**, **Awaiting Payment**, or **Paid** is selected and a selected list layout exists |
| Currency measures | The selected currency matches the relevant reference or local currency |
| Purchase-order detail | The purchase-item group is expanded |
| Additional-cost detail | The cost contains more than one item and its detail is not collapsed |
| Direct-cost area | Editing is allowed |

**Prerequisites**

- You have opened the status list or profitability record you need to inspect.
- For detail work, you can identify the purchase order or cost transaction.

**Steps**

1. Select the status or detail surface that matches your task.

   | If you need to… | Select |
   |---|---|
   | Show delivered-job status choices | **Delivered Jobs** |
   | Change the delivered-job list | **All**, **Awaiting Payment**, or **Paid** |
   | Read measures in another currency | The available currency choice |
   | Expand or collapse purchase-order items | **POs** in **Purchasing Cost** |
   | Start direct-cost work | **Direct Cost**, when editing is allowed |

2. Select the order row to display its items or products.
3. Select the purchase-order rows you need to add them to allocation.
4. In the additional-cost group, select the cost group when it contains more than one item and its
   detail is collapsed.
5. Select the additional-cost row to recalculate the allocation.

**Result:**

The list shows the selected status group, and the profitability record shows the currency
measures and cost detail available for its conditions. Continue detailed entry and allocation
work on [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions).

## When validation or access goes wrong

Use the exact message to choose the next safe action. Messages from the direct-cost editor and
allocation work belong on [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions), not on the list procedure.

| What you see | What to do |
|---|---|
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value and repeat the action. |
| `NO Data to Export` | Open the list's settings surface, confirm that **Export** is available, and use it only when the list has data to export. |
| `Are you sure you want to Delete this transaction ?` | Stop and confirm that the transaction is the one you intend to delete before selecting the confirmation control. |
| `Your request was completed successfully` | Continue after confirming that the requested operation completed. |
| `An error occurred while processing your request` | Recheck the record and continue on the owning detail page. |
| `You don’t have permission` | Continue with an account that has the required access. |

Select **Settings** to find **Export**.

## Out of scope

The Job Profitability list covers status selection and saved-job list review. It does not
provide the detailed editor surfaces below.

| Boundary | Use instead |
|---|---|
| No direct-cost transactions tab | Use [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) for direct-cost entry and allocation. |
| Grid captions are selected by the saved layout | Read the headers visible in your list. |
| Direct-cost editor validation and allocation messages | Continue with [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions). |
| Account, contact, file, and address messages | Continue with the owning account, contact, file, or address page. |

## Continue with the detailed work

Choose the page that owns the next task.

| If you need to… | Continue with |
|---|---|
| Choose **Running Jobs**, **Delivered Jobs**, **All**, **Awaiting Payment**, or **Paid** | **Job Profitability** on this page |
| Review one job's currency measures and profitability detail | [Job Profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) |
| Enter a direct-cost transaction or manage allocation records | [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) |
| Read the job's wider sales, stage, and related-work context | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) |
