# Purchase job record

Use the Purchase job record to orient a procurement job, see its current stage, and choose the
page that owns the next piece of work.

## What a Purchase job record is

A Purchase job record is the shared workspace for one procurement job. It brings the common
package information together with the work that may follow: material requisition (MRQ), request
for quotation (RFQ), quotation, and purchase order. Use it to see the job's position and move to
the focused page for the work you need to complete.

| If you need to… | Go to |
|---|---|
| Complete shared information or package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) |
| Work with an RFQ | Purchase job RFQs |
| Work with a quotation | Purchase job quotations |
| Work with a purchase order | Purchase job orders |
| Create an MRQ that starts purchasing work | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
| Create a direct purchase order | Create direct purchase order |
| Review the procurement chain | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |
| Review comments, files, or history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) |

## Before you start

The workspace changes with the record's identity, subscription, stage, and open panel. Prepare a
route that matches the work you intend to do, and use a saved record before opening its companion
tabs.

| Check | What it affects |
|---|---|
| The page is not missing and the subscription includes the feature | The MRQ, RFQ, and quotation areas can be available. |
| The job has an ID | The saved-record tabs can open. |
| The job is at an eligible stage | The applicable stage panel can appear. |
| The applicable panel is open | Its fields and actions can appear. |
| Your company configuration defines mandatory fields | Some offer and order fields can be required. |

On the edit record surface, **Purchaser**, **Product Type**, and **Package Title** carry
required markers, while **Branch** does not. Work from the values and required markers shown on
your record. If you cannot change a field or action, use the condition and message shown on screen
before asking for access.

## Find and open a Purchase job

Choose the route that matches the work you are starting or resuming.

| Your goal | Declared route | Use it for |
|---|---|---|
| Start a purchase job | `new` | A new Purchase job workspace. |
| Start a direct order | `newDirectPO` | A direct-order Purchase job workspace. |
| Return to a saved job | `edit/:ID` | The workspace for the job identified by its ID. |

**Prerequisites**

- You know whether the work follows the ordinary procurement chain or starts as a direct order.
- For an existing job, you know its record ID.

**Steps**

1. Open the route for the work you need: `new`, `newDirectPO`, or `edit/<ID>`.
2. If you opened `edit/<ID>`, confirm that the Purchase job record surface loads for that ID.
3. If you opened a new route, confirm that the new Purchase job surface loads before entering
   stage-specific work.

**Result:** The applicable Purchase job workspace is open for a new job, a direct order, or a
saved record.

### Open the workspace

The record surface is the shared area at the top of the workspace. On the edit surface,
it contains **Branch**, **Purchaser**, **Product Type**, and **Package Title**. The stage bar shows
**MRQ**, **RFQ**, **Offer**, **PO**, and **Received**. Record commands include **Save** and
**Save and Close**.

Saved records also show saved-record tabs labelled **Attachment**, **Purchase Invoices**, and
**Last Modifications**. **Attach File** is visible with the record surface. Open a saved-record tab
only after the record has an ID; new records do not meet the tab condition.

![Identify the shared record fields, stage bar, and record commands before opening a panel.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png)

## Understand the workspace

Treat the Purchase job record as one workspace with areas that hand work to one another. Shared
information identifies the job, package items describe what is being procured, the stage bar
shows where the job is in the chain, and the stage panels hold the focused work for that stage.
Saved-record tabs keep follow-up information with a saved record.

```mermaid
flowchart LR
    S[Shared information] --> P[Package items]
    P --> M[MRQ panel]
    M --> R[RFQ panel]
    R --> Q[Quotation panel]
    Q --> O[Purchase-order panel]
    S --> C[Saved-record tabs]
```

The shared record area owns the record-level commands. The focused pages own the detailed work
inside the MRQ, RFQ, quotation, purchase-order, files, and payables areas.

> **Note:** List columns can differ. Use the headers shown in the list you opened.

### Shared information and package items

Shared information identifies the Purchase job. The package-item area lists the products carried
by the job and connects the common record to the stage work.

The inquiry, offer, and order grids include these columns:

| Column | Where it helps |
|---|---|
| **Product** | Identifies the product in the row. |
| **Unit** | Identifies the row's unit. |
| **Qty** | Shows the row quantity. |
| **Stage** | Shows the row stage. |

The offer and order grids also include **Unit Price**, **Item Price**, **Currency**,
**Discount (%)**, and **Tax (%)**. The product-entry action for an MRQ is owned by the focused
MRQ work rather than by this workspace map. For detailed shared fields and package-item changes,
continue to [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information).

### Stage panels

Each stage panel is a focused work area for one part of procurement. Its availability depends on
the subscription, the job's current stage, the job's related work, and whether that panel is open.

| Panel family | When it can appear | Focused work |
|---|---|---|
| MRQ / inquiry | The subscription is included, the page is present, the job has inquiries at an eligible stage, and the inquiry is open. | MRQ and inquiry work |
| RFQ | The subscription is included, the current stage is Offer and before Order, and the offer is open. | RFQ work |
| Quotation / offer | The subscription is included, the current stage is Offer and before Order, and the offer is open. | Quotation work |
| Purchase order | The current stage is Order through Delivered, or the job is a direct order at Unknown, and the order is open. | Purchase-order work |

The ordinary panel flow is MRQ, RFQ, quotation, then purchase order.

![Locate the MRQ stage and its package-item area in the workspace.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e9fb173bda2191108110fc2c6a23d10d.png)

## Save the record and choose a hand-off

Record-level saving prepares the shared Purchase job surface for the focused work that follows.
The workspace shows **Save** and **Save and Close** as the record commands.

**Prerequisites**

- You have entered the shared information required on your record.
- You have added the package information required for the next stage.
- You know whether the next work belongs to the MRQ, RFQ, quotation, or purchase-order page.

**Steps**

1. Review the shared record fields and the package-item rows.
2. Select **Save** to keep the record open for the next workspace action.
3. Select **Save and Close** when you have finished the record-level work and want to leave the
   workspace.
4. Choose the focused page for the next work.

   | Next work | Focused page |
   |---|---|
   | MRQ creation | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
   | RFQ work | Purchase job RFQs |
   | Quotation work | Purchase job quotations |
   | Purchase-order work | Purchase job orders |

**Result:** The shared record-level save command has been chosen, and the next focused page is
identified.

![Identify the quotation hand-off after reviewing the shared record.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7afb0e4f61c9c4c8803ff74a8031ae5f.png)

### Open an order-only panel

The order-only branch is a direct-order workspace or a later-stage workspace where the
purchase-order panel is available.

| Condition | Purchase-order panel availability |
|---|---|
| Direct order at `Unknown` | The purchase-order panel can appear when the order is open. |
| Current stage from **Order** through **Delivered** | The purchase-order panel can appear when the order is open. |
| Other stage or a closed order | The order-panel condition is not met. |

**Prerequisites**

- You are using the `newDirectPO` route or the job is already from **Order** through
  **Delivered**.
- The purchase order is open.

**Steps**

1. Open the Purchase job record from the direct-order route or the later-stage record route.
2. Read the stage bar to confirm the job is at `Unknown`, **Order**, or a later stage through
   **Delivered**.
3. Open the purchase-order panel when it is available.
4. Continue with the purchase-order procedure on the purchase job orders page.

**Result:** The direct-order or later-stage workspace is open at the purchase-order hand-off.

![Recognise the order-only branch from the stage bar and purchase-order surface.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/675705bc3734a525afd12d6253b095eb.png)

## Choose the ordinary or direct-order path

Use the ordinary path when procurement moves through an MRQ, RFQ, quotation, and purchase order.
Use the direct-order path when the work starts directly with a purchase order.

| If you need to… | Choose this path | Continue with |
|---|---|---|
| Start with a material request and obtain supplier quotations | Ordinary procurement chain | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq), then the MRQ, RFQ, quotation, and purchase-order focused pages. |
| Start with a purchase order without the ordinary chain | Direct purchase order | Create direct purchase order, then the purchase-job orders page. |
| Understand the whole stage sequence | Ordinary or direct, according to the job | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |

The direct-order branch has its own creation procedure and uses the order-only condition above.

## When the workspace rejects an action

When a panel or record action is refused, first check the current stage, the record ID, the
panel's open state, and the package rows. Then match the message on screen to the table below.

| What you see | Check before continuing |
|---|---|
| `Check PO mandatory field(s)` | Complete the mandatory purchase-order fields. |
| `Please insert at least one PO` | Add a purchase order before continuing. |
| `Check RFQ mandatory field(s)` | Complete the mandatory RFQ fields. |
| `Please insert at least one RFQ` | Add an RFQ before continuing. |
| `Please insert at least one product` | Add a product to the package or applicable panel. |
| `Check mandatory field(s)` | Review the visible required markers and complete those fields. |
| `Inquiry must have at least one item` | Add an inquiry item. |
| `Offer must have at least one item` | Add an offer item. |
| `Order must have at least one item` | Add an order item. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Do not delete items at either of those stages. |
| `An error occurred while processing your request` | Review the action and the current record state before retrying. |
| `Package products cannot be empty` | Add package products before saving. |
| `Please enter action for each milstone ` | Enter an action for each payment milestone. |
| `Required Offer Type` | Complete **Offer Type**. |
| `Required Bid Due Date` | Complete **Required Bid Due Date**. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value in the stated range. |
| `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. |
| `Product package deleted from all inquiries` | The package-deletion action reports completion for inquiries. |
| `Product package deleted from all offers` | The package-deletion action reports completion for offers. |
| `Product package deleted from all orders` | The package-deletion action reports completion for orders. |
| `Item(s) Regretted` | The item action reports that the item is regretted. |
| `Item(s) Cancelled` | The item action reports that the item is cancelled. |
| `Item(s) Rejected` | The item action reports that the item is rejected. |
| `Item(s) Reactivated` | The item action reports that the item is reactivated. |
| `Order updated successfully. Undelivered. A draft invoice was deleted` | Review the updated order and its undelivered state. |
| `Job reactivated successfully` | The reactivation action reports completion. |
| `Email sent to client. Added to emails list activity` | The email action reports that the email was sent and added to email activity. |
| `Converted to inquiry successfully` | The conversion action reports completion. |
| `Converted to offer successfully` | The conversion action reports completion. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and retry the action. |
| ` You already have a contact with this name` | Review the contact name before continuing with contact work. |
| `Your request was completed successfully` | The request reports completion. |
| `Just '_'‘-''.' And '&' Characters Accepted` | Use only the characters named by the message. |

Stage conditions also explain why a panel is absent: the inquiry panel needs an eligible inquiry and
an open inquiry; the RFQ and quotation panels need the Offer stage or earlier and an open offer;
the order panel needs the later-stage or direct-order condition and an open order. Tabs need a
subscription, a present page, and a record ID.

The workspace also carries shared file and contact components. Their messages belong to the
focused file-management and contact procedures, not to this workspace map.

### Out of scope

This page maps the workspace and its hand-offs. It does not repeat the detailed procedures for
shared fields, package-item editing, RFQs, quotations, purchase orders, files, or payables.

| Work | Owning page or boundary |
|---|---|
| Shared fields and package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) |
| RFQ actions, fields, and validations | Purchase job RFQs |
| Quotation actions, fields, and validations | Purchase job quotations |
| Purchase-order fields, approval, and receipt | Purchase job orders |
| Comments, attachments, mail activity, and log history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) |
| Payables filters and allocation actions | Payables page |
| Contact duplicate-name handling | Contact record page |
| File-name character handling | File management page |

## Continue the Purchase job

After saving, use the stage bar and saved-record areas to choose the next destination.

| If the next task is… | Continue with… |
|---|---|
| Create or complete the MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
| Complete shared fields or package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) |
| Complete RFQ work | Purchase job RFQs |
| Complete quotation work | Purchase job quotations |
| Complete, approve, activate, or receive a purchase order | Purchase job orders |
| Review files or record history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) |
| Follow the lifecycle from one stage to the next | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |

The purchase-order list shows **Purchasing no.**, **MRQ no.**, **P.O. no.**,
**Purchaser**, **Job stage**, **Package title**, **Forecasted receiving date**, **Order total
price (incl. tax)**, **Supplier**, and **Sub-supplier order no.**. Continue from the stage and
order surfaces that are available to you.
