# Project management workspace

Use Project management to follow the bill of materials (BOM), purchasing, stock,
and delivery work attached to a project. This page helps you find the right list,
read its current stage, orient yourself in the related project record, and hand the
work to the page that owns the next step.

A bill of materials (BOM) is the list of products and quantities needed for the project.

## Project management workspace

Project management is the workspace for the material and delivery work that turns a
project into an orderable, receivable, and deliverable result. The workspace also
includes a material requisition (MRQ), the request used to start material-requisition
work for stock.

The project delivery chain moves from project planning through BOM preparation,
purchasing, stock and inspection, and delivery. Project management brings these
views together; the focused pages own the detailed MRQ, purchasing, warehouse, and
order procedures.

```mermaid
flowchart LR
    A[Project management] --> B[BOM preparation]
    B --> C[Purchasing]
    C --> D[Stock and inspection]
    D --> E[Delivery]
    A --> F[MRQ for stock]
    F --> C
```

| If you need to… | Go to |
|---|---|
| Choose the project-work list and open related records | [Find project work](#find-project-work) |
| Understand the columns and list tools | [Read the project-management list](#read-the-project-management-list) |
| Check the shared project record | [Open and orient a project record](#open-and-orient-a-project-record) |
| Create an MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
| Continue through procurement | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |
| Continue through warehouse fulfillment and delivery | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Create a shipping order | [Shipping orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/shipping-orders) |
| Create an assembly order | [Assembly orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/assembly-orders) |

The project-management list is at `/projects-management/list/:List/view`. The shared
project record is at `/projects-management/edit/:id`.

## Before you start

Project-management surfaces depend on your subscription, permission, the saved state
of a record, and company configuration. The same project can therefore expose fewer
fields or actions in another setup.

Company configuration is the configuration area for configurable fields and list layout.

Prerequisites

- Your subscription includes Project management. If it does not, the list is replaced
  by an upgrade surface.
- Your subscription includes the stock material-requisition feature before you use
  **MRQ for stock**.
- You have access to the relevant list or record page.
- You know the project record or project work you need to open.
- For record-level actions, the record is saved first.

The form enforces these required fields: **Salesperson Responsible**, **Product Type**,
**Job Title**, **Client**, **Vendor**, and **Bid Due Date**. **Order chance**, **End User**,
**Estimated Value**, **File Number**, **Client Inquiry Number**, **Inquiry Date**,
**Requested Offer Type**, **Contact to Decision Makers**, **Budget Availability**, and
**Chance in Competition** are required only where your company configuration makes
them required. **Status**, **Branch**, and **Expected Order Date** are not required by
the listed rules.

## Find project work

Project work is grouped by the list that represents its current work position. Use
the list tabs to move from the broad project view to a focused work queue.

| Work you need to find | Select |
|---|---|
| All project work | **All** — `/projects-management/list/all/view` |
| BOM preparation work | **BOM Preparation** |
| Current material requisitions | **Current MRQs** |
| Purchasing work | **In Purchasing** |
| Stock work | **In Stock** |
| Delivered work | **Delivered** |
| Running project jobs | **Running Jobs** |
| Delivered project jobs | **Delivered Jobs** — `/projects-management/list/delivered-orders/view` |

Use the visible **All**, **BOM Preparation**, **Current MRQs**, **In Purchasing**, **In Stock**,
**Delivered**, and **Running Jobs** tabs for the project-work queues. Use the tab
labels visible in your list for the purchasing and goods queues.

Prerequisites

- Project management is included in your subscription.
- You know which work position you need to review.

Steps

1. Open the Project management list.
2. Select the tab that matches the work position you need.
3. Follow the destination that matches the selected work.

   | If you selected or found… | Then… |
   |---|---|
   | Purchasing work | Choose the purchasing list and use its available filters. |
   | A sales-job, MRQ, receiving, or inspection link in the row | Open the related link. |
   | Stock work with the stock MRQ feature included in your subscription | Select **MRQ for stock**. |
   | BOM preparation work | Open the **BOM Preparation** list. |

**Result:** The selected project-work list or related record is open. Selecting
**BOM Preparation** opens the BOM preparation list.

When **In Purchasing** is open, its available filters are **All**, **RFQs**,
**Quotations**, **Orders**, and **Stuck**.

![The All project-work list with its tabs and columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d06c576f6b6d8d4c900f0308fe33f1ca.png)

## Read the project-management list

The project-management list is a work queue: its visible columns come from the saved
list layout, while the stage value in each row tells you where that project work is.

On **All**, use these columns:

| Column | What it identifies |
|---|---|
| **Product** | The product in the project work row |
| **Sub-supplier** | The sub-supplier associated with the row |
| **MRQ No.** | The material-requisition number |
| **Purchsing No.** | The purchasing number; the spelling is shown exactly this way |
| **Description** | The row description |
| **Quantity** | The row quantity |
| **Stage** | The current project-work stage |
| **Required receiving date** | The required receiving date |

On **BOM Preparation**, use **Product**, **Description**, **Quantity**, **PM responsible**,
and **Odoo order no.**

The list uses the selected layout rather than a fixed column set. Work from the
headers you can see. Select **Refresh** to reload the list. Select **Table Layout** to
work with the table layout. Select **Settings** to open the available list settings.
Use **Export** when the export action is available.

> **Note:** A different saved layout can change the headers you see. Use the visible
> headers as your working reference.

![The BOM Preparation list and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5439623a0ace62d970608300744da82e.png)

## Open and orient a project record

A project record is the shared job record behind project-management work. It holds
the project information used by the sales and delivery chain. In project-management
context, the record uses the Project management breadcrumb and provides an **Orders**
link.

The record route is `/projects-management/edit/:id`. Its core fields include:

| Field | Type | Requirement |
|---|---|---|
| **Salesperson Responsible** | Picker | Required |
| **Product Type** | Select | Required |
| **Job Title** | Text | Required |
| **Client** | Picker | Required |
| **Vendor** | Picker | Required |
| **Bid Due Date** | Date | Required |
| **Order chance** | Select | Configurable |
| **Status** | Select | Not required |
| **Branch** | Text | Not required |
| **Expected Order Date** | Date | Not required |

Additional fields can be configurable or stage-dependent. **Status** and **Order
chance** are part of the record's stage-related information; the other panels and
fields shown depend on the record stage, subscription, page availability, and inquiry
state.

The record provides a shared **Save and close** surface. Save the record before using
record-level actions that require a saved record.

Use the fields and links that appear on the project record you opened.

## Handle stage and setup differences

A stage-dependent surface is a field, tab, dialog, filter, or action that appears only
for a particular project stage or record condition. Use the Company configuration
described in Before you start when interpreting configurable fields and list layout.

| What changes | Condition that controls it |
|---|---|
| The whole list or an upgrade surface | Whether the subscription includes Project management |
| Main list tabs | Subscription inclusion and enabled breadcrumbs |
| Purchasing and goods filters | The corresponding list-tab group |
| Record fields | Subscription, page existence, job stage, and whether an inquiry is open |
| Stage-action dialog fields | The matching dialog name |
| List columns | The selected table layout |
| Project-management breadcrumb and **Orders** link | The record is in Project management context |

When a stage-action dialog opens, its fields depend on the dialog name. The possible
fields include **Regret Reason**, **Regret Date**, **Comment**, **Cancellation Reason**,
**Cancellation Date**, **Amount**, **Lost Reason**, **Lost Date**, **Winner Name**,
Difference (%), **Delivery Time Difference**, **Reject Date**, **Offer validation
type**, **Request extension as date**, **Request extension as period**, **Order
Activation Date**, and **Delivery Date**.

Use the surface that is visible for the current record. A missing field or action can
result from subscription, page availability, permissions, inquiry state, stage, or
company configuration rather than from a damaged record.

## When the work does not proceed

When an action stops, match the message to the situation before changing the record.
Use the following messages and restrictions when project work stops.

| What you see | What to check or do |
|---|---|
| `This field is required` | Complete the required field named on the form. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a positive value no greater than `999,999.00`. |
| `An error occurred while processing your request` | Review the record and request again through the owning procedure. |
| `An account with this name already exists` | Use the existing account or change the account name according to your process. |
| `A project with this name already exists` | Use the existing project or choose a name that is not already used. |
| `Custom fields saved successfully` | The custom-field change is saved. |
| `Error saving custom fields` | Review the custom-field values and save again through the owning record procedure. |
| `You cannot edit or delete the product after the purchase package is created` | Do not edit or delete that product after the purchase package exists. |
| `Cannot be deleted. Product is in purchasing` | Continue from the purchasing work instead of deleting the product here. |
| `You cannot edit the product after the PO is created` | Do not edit the product after the purchase order exists. |
| `Booked quantity for this job is greater than the required BOM quantity` | Correct the booked quantity so it does not exceed the required BOM quantity. |
| `Cannot be un-delivered — a due invoice already exists` | Do not reverse delivery while the due invoice exists. |
| `All offers must be in draft status to revert to inquiry` | Return every offer to draft before reverting to inquiry. |
| `Please save opened inquiry first` | Save the open inquiry before continuing. |
| `All inquiries must be in draft stage to revert to potential` | Return every inquiry to draft before reverting to potential. |

Successful record and project-work actions use these messages:

| Action | Message |
|---|---|
| Save the job | `Job updated successfully` |
| Save custom fields | `Custom fields saved successfully` |
| Delete the job | `Job deleted successfully` |
| Regret the job | `Job regretted successfully` |
| Cancel the job | `Job cancelled successfully` |
| Mark the job missed | `Job missed successfully` |
| Reactivate the job | `Job reactivated successfully` |
| Convert to an offer | `Converted to offer successfully` |
| Convert to an inquiry | `Converted to inquiry successfully` |

If a related purchasing, warehouse, account, contact, MRQ, or activity action shows
one of these messages, follow the message's instruction and continue in the owning
work area.

| Message | Reader guidance |
|---|---|
| `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. |
| `Please enter action for each milstone` | Enter an action for every milestone. |
| `Please save opened cost sheet first` | Save the open cost sheet before continuing. |
| `Error: Vendor not saved yet` | Save the vendor before continuing. |
| `Error: Client not saved yet` | Save the client before continuing. |
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and enter the value again. |
| `You already have a contact with this name` | Use the existing contact or choose another name. |
| `This product is already included in BOM` | Use the existing BOM item instead of adding it again. |
| `The first variant cannot be deleted` | Keep the first product variant. |
| `An error occurred while connecting to your CRM system.` | Check the CRM connection before continuing. |
| `Please select one product` | Select one product before continuing. |
| `Package must have at least one item` | Add an item to the package before saving. |
| `You cannot save without adding at least one product` | Add at least one product before saving. |
| `This record is related to saved data and cannot be deleted` | Keep the record because saved data depends on it. |
| `Action not allowed` | Use an action available for the current record. |
| `Please enter at least one email` | Enter at least one email address. |
| `Inquiry must have at least one item` | Add an item to the inquiry before continuing. |
| `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 to the order before continuing. |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep items at either of these stages. |
| `Please select one or more items to create a RFQ.` | Select at least one item before creating the RFQ. |
| `Required Offer Type` | Select an offer type before continuing. |
| `Required Bid Due Date` | Enter the bid due date before continuing. |
| `This Field Is Required` | Complete the required account field. |
| `Error loading accounts` | Check the account list before continuing. |
| `Serial you have entered already exist and belong to same manufacturer` | Enter a different serial. |
| `There is error in serial you have entered` | Correct the serial and enter it again. |
| `Minimum: At least one serial` | Add at least one serial. |
| `Please Add Extension to activate the LG` | Add an extension before activating the L/G. |
| `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | Remove the extensions or deductions before reverting the L/G. |
| `Please choose a date after the current expiry date` | Choose a date after the current expiry date. |
| `One topic and at least one note is required` | Add one topic and at least one note. |

## Out of scope on this workspace

The project-management workspace overview ends at the hand-off to shipping-order or
assembly-order work. The shipping-order and assembly-order screens have separate
routes and own their detailed controls. Use the focused pages for those procedures;
do not treat a project-management list row as the complete order-creation screen.

### Out of scope messages

The following message belongs to the owning saved-record page rather than this
workspace:

| Message | Owning page |
|---|---|
| `Your request was completed successfully` | Account details and other saved-record pages |
| `Required Receiving After` | Products page |

## Create a shipping order

A shipping order is the separate order-creation surface for the shipping part of
project delivery. The project-management workspace provides the hand-off; the
shipping-order page owns the creation procedure and its required selection, date,
item, and save controls.

Open [Shipping orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/shipping-orders) to create and locate a shipping order.

## Create an assembly order

An assembly order is the separate order-creation surface for the assembly part of
project delivery. The project-management workspace provides the hand-off; the
assembly-order page owns the creation procedure and its required fields, product
selection, and save controls.

Open [Assembly orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/assembly-orders) to create and locate an assembly order.

## Continue the project flow

Use the related project-management links to hand work to its owning page. A related
record link opens the project-management record in a new tab with the project context.

| Next work | Open |
|---|---|
| Create and follow an MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) |
| Complete a saved MRQ | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) |
| Continue procurement | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) |
| Fulfil and deliver warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) |
| Create a shipping order | [Shipping orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/shipping-orders) |
| Create an assembly order | [Assembly orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/assembly-orders) |
| Continue from project records in Orders and delivered orders | Use the **Orders** or **Delivered Jobs** project-record route when it is available. |

The project delivery chain therefore continues from Project management to the owning
MRQ, procurement, warehouse, shipping, assembly, and delivered-order pages rather
than being completed on this overview page.
