Financials Management: Introducing Work Breakdown Structure
This announcement represents a single point in time. Future releases may impact the information below.
Beta Announced: 04/11/2021 | Beta Released: 05/11/2021 | Feature Announced: 24/02/2022
Phased Release Started: 03/03/2022 | Phased Release Completed: 01/04/2022
Financials Management: Introducing Work Breakdown Structure
Procore is pleased to announce the phased release of Work Breakdown Structure (WBS) is now complete. WBS is a robust, flexible method for organizing and reporting on financial information. With WBS, your company can now create a customised framework of unique segments and rules for tagging, tracking and reporting using data from Procore's Financial Management tools.
This update includes a new user experience in the Company and Project level Admin tools for WBS was deployed to all Procore customers. You do not have the option to opt-out of the new experience.
Whether you're a Main Contractor, Owner or Speciality Contractor, you can choose from three (3) default segments (cost code, cost type and an optional sub job segment on projects) and/or create up to ten (10) custom segments (such as phase, area and so on). You can also arrange all segments in any order you want. This allows you to define a unique company budget code structure to use on all your projects. You can also opt to create a unique budget code structure for use on specific projects.
Once your budget code structure is defined, your project team can begin assigning budget codes to your project's financial line items in our Project Financials tools. To learn more, see What is a budget code in Procore's WBS?
Key Features
Common Questions
- Do we have to create custom segments?
- Can I sync budget codes with WBS custom segments in Procore with our integrated ERP system?
- How does WBS improve the Procore API?
- Do we need to update our API integrations for WBS?
- Is there an updated version of the Procore Imports app for WBS?
- Are custom segments compatible with Procore's Field Productivity tools?
- Can I turn WBS ON/OFF for a single user or single project?
- Do 'Cost Code' segment items carry over to new projects from a project template?
- Where can I go to learn more about WBS?
Do we have to create custom segments?
No. If your company is happy using Procore's cost code, cost type and optional sub job objects in Procore's Financials Management tools, your team can continue using these objects on existing projects with Procore's Project Financials tools. This is because, with WBS, cost code and cost type are default segments. As in previous versions of Procore, sub job also continues to be an optional segment that you can turn ON or OFF at the project level.
If you won't be creating custom segments, the only users who will notice the WBS update are your company's Procore Administrator and any users who have been granted 'Admin' level permissions on the Project Admin tool.
These pages are being deprecated... | This page is being introduced... |
|
|
Important
As your team considers creating custom segments with WBS, important things to be aware of include:
- For customers using Procore's ERP Integrations tool to sync data with an integrated ERP system, see Can I sync budget codes with WBS custom segments in Procore with our integrated ERP system?
- For customers who have built a custom integration using Procore's API, see How does WBS improve the Procore API? and Do we need to update our API integrations for Work Breakdown Structure?
- For customer using Procore's Resource Management tools, see Are custom segments compatible with Procore's Resource Management tools?
Can I sync budget codes with WBS Custom Segments in Procore with our integrated ERP system?
Not yet. Procore's ERP Integrations tool is specifically designed for one- and two-way data synchronisation. Data synchronisation is a process that requires the fields in your Procore database to be consistent with the fields in your integrated ERP system's database. Because your integrated ERP system does NOT support Procore's new 'custom segment' concept, Procore customers using the ERP Integrations tool are not yet able to synchronise the 'custom segment' fields created for WBS.
It is important to note that users with the appropriate access permissions to the Company and Project level Admin tools will see the new 'Work Breakdown Structure' page, instead of the 'Cost Code', 'Cost Type' and 'Sub Job' pages. However, the Add Segment button below the 'Segments' table will be greyed out and unavailable for use. You will NOT have the ability to add custom segments or add items to custom segments.
To learn how custom segments work with an integrated ERP system, see How do I use custom segments with an ERP Integration?
How does WBS Improve the Procore API?
Like all software products, an API proceeds through all stages of the product lifecycle. APIs are introduced, enhanced over time and when new improvements become available, APIs are deprecated. With WBS, the new API has been improved to provide Procore customers a greatly improved and more flexible method for organizing and reporting on your financial information.
In the table below, the following WBS concepts and features on the left are being introduced. On the right, Procore plans to deprecate the legacy objects and features on a future date yet to be announced. To learn more about the Work Breakdown Structure and Procore's API, visit the Work Breakdown Structure page on developers.procore.com.
What is being introduced with WBS? | What is being deprecated in the future? 1 |
Segment 2 Segment Item 3 Budget Code The 'wbs_code_id' in Procore's Work Breakdown Structure The 'wbs_code_id' is now used to store the unique identifiers from your external systems for Procore's new segment, segment item and budget code objects. |
Cost Code Cost Type Sub Job The 'origin_id' field in Procore's Financial Management tools The 'origin_id' field is used to store the unique identifiers for your external systems for Procore's cost code, cost type and sub job objects. |
1 Procore intends to announce deprecation and sunset dates in the future. After the sunset date, these items will no longer be available to Procore customers. Procore is notifying customers of our intent now, so your team can ask questions, plan ahead and decide how to best implement this improvement in your environment.
2 The new 'Segment' object includes two (2) default segments (Cost Code and Cost Type) and one (1) optional Sub Job segment. These segments require the new 'wbs_code_id' field.
3 The 'Segment Item' object includes the items that reside within the Cost Code, Cost Type and Sub Job segments. These segment items require the new 'wbs_code_id' field.
Do we need to update our API integrations for WBS?
Eventually, yes. However, Procore recognises that it takes time for our customers to develop a WBS that fits your specific environment. If you plan to use WBS to create custom segments right away, integration changes are a requirement. If you don't intend to create custom segments, no immediate action is necessary. You can continue using the legacy cost code, cost type and sub job objects and features. However, a deprecation date for the legacy objects and features will be announced by Procore in the future.
Important
How much time do we have to update our legacy API integrations to the new WBS API? While Procore has not yet formally announced an official sunset timeline for the legacy endpoints that utilise cost_code, cost_type and sub_job, we are notifying our customers now that these endpoints are listed as deprecated in the reference documentation and a sunset date will be announced in the future. To support our customers in their long-range planning processes and to provide you with ample notice, Procore's future sunset announcement will provide its users with a minimum of one (1) year's notice before the legacy endpoints are sunset.To clarify how the changes to the Procore API affect our customers, please review the following information:
If you intend to create custom segments in WBS... |
If you don't intend to create custom segments in WBS... |
Integration changes are requiredYou can start using the custom segments, segment items and WBS code objects and features. However, you must update your API integrations. |
|
To take advantage of the new functionality associated with WBS, any existing API integrations that you have independently developed or purchased to integrate data with Procore must be updated to support Procore's new WBS API.
Is there an updated version of the Procore Imports app for WBS?
Yes. If you are currently using the Procore Imports app to import your cost code/cost type/sub jobs into your Procore account, there is a new version available and it is compatible with Procore's WBS. If you are planning to import your custom segment data and have received the WBS update, you must use the new version of the app. If you have not yet received the WBS update, you can continue using the existing version of the Procore Imports app until your company receives WBS. The new Procore Imports apps is also being gradually rolled out to Procore customers starting on February 25, 2022.
Important
The updated Procore Imports app is backwards compatible with previous versions of Procore. After your company receives the WBS update, you must uninstall the previous version of the Procore Imports app from your Microsoft Windows system. You can then download and install the updated version of the app using the instructions below.Helpful resources about the updated Procore Imports app include:
- Prepare Segment Items for Import into the Procore Imports App
- Import Segment Items into Your Company Level Admin Tool
- Import Segment Items into Your Project Level Admin Tool
Are Custom Segments compatible with Procore's Field Productivity tools?
Not yet. If Procore's Field Productivity tools under 'Resource Management' are enabled on your company's Procore account, the Work Breakdown Structure's custom segment objects and features are not yet supported.
It is important to note that users with the appropriate access permissions to the Company and Project level Admin tools will see the new 'Work Breakdown Structure' page, instead of the 'Cost Code', 'Cost Type' and 'Sub Job' pages. However, the Add Segment button below the 'Segments' table will be greyed out and unavailable for use. You will NOT have the ability to add custom segments or add items to custom segments. To learn more, see What are segments? and What custom segments should we create for our company's Work Breakdown Structure?
Can I turn WBS on for a single user or project?
No. The WBS features are turned ON by Procore by default. The new user interface is being deployed to all Procore company accounts and all Procore projects.
Do 'Cost Code' Segment Items carry over to new Projects from a Project template?
No. Cost Codes unique to a project template do NOT carry over to new projects by default. However, if your organisation meets the eligibility requirements, a backend configuration setting is available to Procore customers who meet specific eligibility criteria to turn this capability on. To learn more, see How do my project specific code code segment items get carried over from a project template to a new project?
Where can I go to learn more about WBS?
To learn more about this exciting new feature, start by reading the About Work Breakdown Structure page. To view our full collection of documentation, please visit the Work Breakdown Structure landing page on en-gb.support.procore.com.
See Also
If you would like to ask questions or share any feedback, please contact support@procore.com.