Skip to main content
Procore

Integration by Ryvit: Add a Procore Project to Viewpoint® Vista™

Objective

To create a new project in Procore and export it to the Integration by Procore as a new job with a unique Integration by Procore Job ID.

Background

If your company implemented the Integration by Procore in your environment, you have the ability to create a new project in Procore and then send that project to the ERP Integrations tool for review by accounting approvers. Upon your acceptance by an approver, Procore will export the appropriate project data and then create a new 'Job' with a unique 'Job ID' in Viewpoint® Vista™.

To accomplish this, your company must first setup the Integration by Procore Connector (see Integration by Procore: Setup Guide). The next step is to create a new project in Procore using the Steps below. Once the project is created, you will copy the "Integration by Procore Cost Codes" list to your Procore project, assign at least one (1) cost type to each code, and then send all of your new project information to the ERP Integrations tool for accounting approval.

After an accounting approver reviews and submits an 'Accept' response for the Procore project in the ERP Integrations tool (see Integration by Procore: Accept or Reject a Project for Export to the  Integration by Procore), Procore will export the project during the synchronization process.

In addition to creating a new 'Job' and 'Job ID' in Integration by Procore, the following project information in Procore will be synced with your new Integration by Procore job: 

  • Cost Codes
  • Cost Types
  • Job Cost Data (see the 'Job Costs' tab)

Things to Consider

Steps

Launch the Project Creation Assistant

Add Project Details

  1. Make sure Project Details is highlighted in the right sidebar.
  2. Under General Information, do the following:

    Create_Project.png

     
    1. Project Template. If this is the first project you are creating for use with the Integration by Procore choose 'Do Not Apply a Template'. If you have previously created a project and set up one or more project templates for your company account, select the desired template. 
      Notes:

      • This field is only visible and available when the project templates feature is enabled on your company's Procore account.
      • To select a template from the list, the desired project template must be active. See Configure a Project Template.
    2. Project Name. Enter a name for the construction project. When the ERP Integrations tool is enabled for the Integration by Procore, the Project Name is limited to a maximum of sixty (60) characters in length. This value displays in a variety of places in the Procore web application, including the Select a Project menu, CSV and PDF exports, and custom reports.

    3. Project Photo. Click the photo area and then upload the photo that you want appear as the project photo on the project's Home page. The image must not exceed the 3MB maximum. It must also be saved in the GIF, JPG, or PNG file format. To change this photo at a later time, see Add or Edit General Project Information or Add a Project Photo.

    4. Project Type. Select a project type from the drop-down list. These selections are created with the company's Admin tool. See Add a Custom Project Type.

    5. Project Stage. Select a project stage from the list. Depending on your selection, additional Procore features may be enabled (e.g., if you select the Bidding stage, the project's Bidding tool will be enabled in Procore). These selections are created with the company's Admin tool. See Add Custom Project Stages to Your Company.

    6. Job Number. Enter a unique project ID or number to differentiate it from other company projects.

    7. Start Date. This represents the date that the project will start and also will be used to calculate construction volume.

    8. Completion Date. Select the anticipated project completion date. Once the project has begun, you can compare this field against the actual finish date.

    9. Project Description. Enter a brief project summary.

    10. Estimated Project Value*. Enter the anticipated project value upon completion. Enter a value to the nearest whole number. For example, if your project's estimated value is $18 million dollars, enter $18,000,000.00 in the box.

 

 

  1. Under ERP Integration, do the following (Note: this step is only relevant to companies that are integrated with certain ERP systems):

     portfolio-project-creation-erp-integration.png

    1. Allow project to be synced with ERP. Leave this checkbox marked if you plan to sync any part of the project's financials with your ERP software. This will ensure that the ERP Standard cost code list will be available to select from when configuring your Project Level cost codes. 
     Important
    • This checkbox will be marked by default if your company has an available set of ERP cost codes, unless the template the project is created from does not have this box marked. 
    • If you plan to sync your new Procore project with your ERP software you MUST leave this checkbox marked. If you un-mark this box, you will not be able to re-mark it later if cost codes from a different Company Level list have been copied to the Project Level list in the Project Admin tool.

     

  2. Under Account and Contact, do the following:

    vv-account-and-contact.png
    1. Office. Choose the office that is managing this project. These selections are created in the company's Admin tool. See Add an Office Location.

    2. Project Address. Enter the job site's physical address. If your company is adding a project for use with the Integration by Procore integration, do NOT enter commas (,) in the Project Address field.

      Notes:

    3. Country. Select the country from the drop-down list. 

    4. State. Select the state for the project from the drop-down list.

    5. City. Enter the full city name for the project. 
      Note: Do not abbreviate the city name. 

    6. Zip. Enter the ZIP/postal code for the project.
      Note: Procore uses a third-party service to automatically determine the County name based on the 'Address' and 'ZIP' fields. Since this is auto-determined, there is no data-entry for County in the Create New Project page. To change the County value, see Update General Project Information.

    7. Timezone. Choose the correct time zone for the project from the drop-down list. This time zone will determine time stamps on items in the project.

    8. Job Phone. Enter in the main contact phone number of the job site. Team members will be able to see this phone number and use it if desired.

    9. Job Fax. Enter the onsite fax number here (if available). This gives team members the ability to see and use the project's fax number when needed. 

  3. Under Advanced, do the following:

    advanced_details_create_project.png
    1. Project Flag. Select a color for the project flag from the drop-down list. The system's default color selections are: RED, YELLOW, and GREEN. This lets you visually organize your projects (e.g., you might want to flag internal projects as RED and commercial projects as GREEN). 

    2. Departments. Select one or more departments who have responsibility for the project. These selections are created with the company's Admin tool. See Custom Company Projects.
      Note: These departments appear in the Timecard and Directory tool, and may also appear in other Procore tools depending on your company's specific configuration.

    3. Bid Type. Select the bid type from the list. These selections are created with the company's Admin tool. See Add a Custom Bid Type.

    4. Owner. Select the owner type from the drop-down list. These selections are created in the company's Admin tool. See Add a Custom Owner Type.

    5. Square Feet. Enter the project's square footage.

    6. Program. Select the program to classify your project under. ​These selections are created with the company's Admin tool. See Add Programs.
      Note: You can view your projects by program using the Programs tool.

    7. Region. Select the region you want to classify your project into. These selections are created with the company's Admin tool. See Add Project Regions.
      Note: You can view projects by region in the Portfolio tool.

    8. Parent Job. Select the name of the parent project in Procore from the drop-down list. In Procore, a parent job is a Procore project that has been designated as the 'parent' project for one or more related project(s) in Procore's Portfolio tool. To learn more, see What's the difference between a job, a parent job, and a sub job?

    9. Warranty Start Date. Select the start date for the construction contract warranty.

    10. Warranty End Date. Select the end date for the construction contract warranty.

    11. Copy Directory From. Select one of the projects in your company's Procore account to copy the user and company information from that project's Directory into your current project's Directory tool. See Copy Directory From One Project to Another.

  4. Click Create Project
    This button turns GREY and becomes unavailable for further use.
  5. Choose from these next steps:

Add and Remove Tools in the Project Toolbox

Add Project Cost Codes 

  1. Make sure Cost Code in highlighted in the right sidebar.
    This reveals the cost code page for your new project.
  2. Copy the desired codes to your project as follows:
    1. Copy All Codes
      To copy all of the codes from the Integration by Procore Standard Cost Code list:
      1. Click Copy All Codes.
        The system reveals the following confirmation message: "Once you add this cost code, the source list cannot be changed."
      2. Click OK to acknowledge the confirmation message. 
        This moves all the codes in the Integration by Procore Standard Cost Code List to the Project Cost Codes list.  
    2. Copy Selected Codes
      To copy only selected codes from the Integration by Procore Standard Cost Code list:
      1. Expand the desired division folder(s).
      2. Highlight the desired cost codes.
      3. Click Copy Selected Codes
         Tip
  3. Click Next
    The system reveals the Cost Type Assignments page. 

Assign Default Cost Types to Cost Codes 

  1. Stay on the Cost Code page.
    The system reveals the Cost Types Assignments page.
  2. For each cost code listed, mark one (1) or more checkboxes to assign each code to one (1) or more cost type.
    Important!
    • To sync cost codes with Integration by Procore, every project cost code must be assigned at least one (1) cost type.
    • If your company's Procore account is using the Procore + Integration by Procore connector, Cost Types are created and maintained in Integration by Procore. 

      vv-cost-type-assignments.gif

      Your cost type assignments are automatically saved and Procore confirms that it has created your new project. This also reveals the New Project Created page.  
  3. Continue with Send a New Project to the ERP Integrations Tool.

Send a New Project to the ERP Integrations Tool 

  1. At the New Project Created page, choose from these options:
    1. If you want to send your new Procore project data to the Company level ERP Integrations Tool for accounting acceptance, click the Send to ERP button. Before the data is synced between the two systems, an accounting approver must accept the data as described in Integration by Procore: Accept or Reject a Project for Export to Vista.

      send-to-erp-button.png

      OR
    2. If you want to send your new Procore project data to the Company level ERP Integrations tool at a later time, click Continue Project Setup
      1. When you are ready to send your data to the ERP Integrations tool, see Integration by Procore: Send a Procore Project to ERP Integrations for Accounting Acceptance
      2. Before the data is synced between the two systems, an accounting approver must accept the data as described in Integration by Procore: Accept or Reject a Project for Export to Vista.

        continue-project-setup-button.png

Update Directory

Upload Drawings

Upload Specifications

Upload Schedule

See Also

The Integration by Ryvit is the product of a partnership between Procore and Ryvit, a third-party developer. Viewpoint, Inc. is not affiliated with this connector. All Vista marks and logos are owned by Viewpoint, Inc.