Skip to content
D
Documentation

Project management workspace

concept
11 min readUpdated

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.

Project managementBOM preparationPurchasingStock and inspectionDeliveryMRQ for stock
If you need to…Go to
Choose the project-work list and open related recordsFind project work
Understand the columns and list toolsRead the project-management list
Check the shared project recordOpen and orient a project record
Create an MRQCreate an MRQ
Continue through procurementPurchase job workflow
Continue through warehouse fulfillment and deliveryWarehouse fulfillment flow
Create a shipping orderShipping orders
Create an assembly orderAssembly 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 findSelect
All project workAll — /projects-management/list/all/view
BOM preparation workBOM Preparation
Current material requisitionsCurrent MRQs
Purchasing workIn Purchasing
Stock workIn Stock
Delivered workDelivered
Running project jobsRunning Jobs
Delivered project jobsDelivered 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 workChoose the purchasing list and use its available filters.
    A sales-job, MRQ, receiving, or inspection link in the rowOpen the related link.
    Stock work with the stock MRQ feature included in your subscriptionSelect MRQ for stock.
    BOM preparation workOpen 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

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:

ColumnWhat it identifies
ProductThe product in the project work row
Sub-supplierThe sub-supplier associated with the row
MRQ No.The material-requisition number
Purchsing No.The purchasing number; the spelling is shown exactly this way
DescriptionThe row description
QuantityThe row quantity
StageThe current project-work stage
Required receiving dateThe 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

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:

FieldTypeRequirement
Salesperson ResponsiblePickerRequired
Product TypeSelectRequired
Job TitleTextRequired
ClientPickerRequired
VendorPickerRequired
Bid Due DateDateRequired
Order chanceSelectConfigurable
StatusSelectNot required
BranchTextNot required
Expected Order DateDateNot 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 changesCondition that controls it
The whole list or an upgrade surfaceWhether the subscription includes Project management
Main list tabsSubscription inclusion and enabled breadcrumbs
Purchasing and goods filtersThe corresponding list-tab group
Record fieldsSubscription, page existence, job stage, and whether an inquiry is open
Stage-action dialog fieldsThe matching dialog name
List columnsThe selected table layout
Project-management breadcrumb and Orders linkThe 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 seeWhat to check or do
This field is requiredComplete the required field named on the form.
Invalid input. The value must be greater than 0 and cannot exceed 999,999.00Enter a positive value no greater than 999,999.00.
An error occurred while processing your requestReview the record and request again through the owning procedure.
An account with this name already existsUse the existing account or change the account name according to your process.
A project with this name already existsUse the existing project or choose a name that is not already used.
Custom fields saved successfullyThe custom-field change is saved.
Error saving custom fieldsReview the custom-field values and save again through the owning record procedure.
You cannot edit or delete the product after the purchase package is createdDo not edit or delete that product after the purchase package exists.
Cannot be deleted. Product is in purchasingContinue from the purchasing work instead of deleting the product here.
You cannot edit the product after the PO is createdDo not edit the product after the purchase order exists.
Booked quantity for this job is greater than the required BOM quantityCorrect the booked quantity so it does not exceed the required BOM quantity.
Cannot be un-delivered — a due invoice already existsDo not reverse delivery while the due invoice exists.
All offers must be in draft status to revert to inquiryReturn every offer to draft before reverting to inquiry.
Please save opened inquiry firstSave the open inquiry before continuing.
All inquiries must be in draft stage to revert to potentialReturn every inquiry to draft before reverting to potential.

Successful record and project-work actions use these messages:

ActionMessage
Save the jobJob updated successfully
Save custom fieldsCustom fields saved successfully
Delete the jobJob deleted successfully
Regret the jobJob regretted successfully
Cancel the jobJob cancelled successfully
Mark the job missedJob missed successfully
Reactivate the jobJob reactivated successfully
Convert to an offerConverted to offer successfully
Convert to an inquiryConverted 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.

MessageReader guidance
Invalid input. Please enter a non-negative valueEnter zero or a positive value.
Please enter action for each milstoneEnter an action for every milestone.
Please save opened cost sheet firstSave the open cost sheet before continuing.
Error: Vendor not saved yetSave the vendor before continuing.
Error: Client not saved yetSave 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 nameUse the existing contact or choose another name.
This product is already included in BOMUse the existing BOM item instead of adding it again.
The first variant cannot be deletedKeep the first product variant.
An error occurred while connecting to your CRM system.Check the CRM connection before continuing.
Please select one productSelect one product before continuing.
Package must have at least one itemAdd an item to the package before saving.
You cannot save without adding at least one productAdd at least one product before saving.
This record is related to saved data and cannot be deletedKeep the record because saved data depends on it.
Action not allowedUse an action available for the current record.
Please enter at least one emailEnter at least one email address.
Inquiry must have at least one itemAdd an item to the inquiry before continuing.
Offer must have at least one itemAdd an item to the offer before continuing.
Order must have at least one itemAdd an item to the order before continuing.
Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deletedKeep 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 TypeSelect an offer type before continuing.
Required Bid Due DateEnter the bid due date before continuing.
This Field Is RequiredComplete the required account field.
Error loading accountsCheck the account list before continuing.
Serial you have entered already exist and belong to same manufacturerEnter a different serial.
There is error in serial you have enteredCorrect the serial and enter it again.
Minimum: At least one serialAdd at least one serial.
Please Add Extension to activate the LGAdd an extension before activating the L/G.
LG has one or more extensions or deductions and cannot be reverted to the requested stageRemove the extensions or deductions before reverting the L/G.
Please choose a date after the current expiry dateChoose a date after the current expiry date.
One topic and at least one note is requiredAdd 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:

MessageOwning page
Your request was completed successfullyAccount details and other saved-record pages
Required Receiving AfterProducts 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 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 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 workOpen
Create and follow an MRQCreate an MRQ
Complete a saved MRQComplete an MRQ record
Continue procurementPurchase job workflow
Fulfil and deliver warehouse workWarehouse fulfillment flow
Create a shipping orderShipping orders
Create an assembly orderAssembly orders
Continue from project records in Orders and delivered ordersUse 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.

Was this page helpful?

Need help using the product?