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 Ryvit as a new job with a unique Integration by Ryvit Job ID.

Background

If your company implemented the Integration by Ryvit 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 Ryvit Connector (see Integration by Ryvit: 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 Ryvit 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 Ryvit: Accept or Reject a Project for Export to the  Integration by Ryvit), Procore will export the project during the synchronization process.

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

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

Things to Consider

Steps

Launch the Project Creation Assistant

  1. Navigate to the company's Portfolio tool.
  2. Click Create Project.

    create-portfolio-project.png

    This launches 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 Ryvit 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 Ryvit, 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 Ryvit 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

Tools selected on this page will appear in the project's tools menu, while tools that are not selected will not appear in the tools menu, and cannot be used.
Note: If you want to change which tools are available later, you can do so by navigating to the project's Admin tool. See Add and Remove Project Tools.

  1. Make sure Tools is highlighted.
    Important! If the Tools link does NOT appear in the Project Creation Assistant, it is because the project template that you applied to your new project already determined the project's tools. 
  2. Add and remove tools for the project as follows:
    • To add a tool individually: Mark the checkbox next to box that corresponds to desired tool. 
    • To add all available tools within a category: Mark the checkbox next to the category name.
      OR
      To add all available tools from all categories: Mark the checkbox next to Select All
      Note: Clicking the checkbox again will deselect all tools.
    • To remove a tool: Clear the checkbox for that tool. 
  3. If you want to rearrange the order of tools on the project's toolbar for all users:

    rearrange-project-tools.png
    1. Hover over the grip ⁞⁞ icon next to the tool you want to move.
    2. Use a drag-and-drop operation to move the tool to a new position in the product category.
  4. Click Select Tools
    Note: The system displays a GREEN banner to confirm your settings were saved. 

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 Ryvit 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 Ryvit Standard Cost Code List to the Project Cost Codes list.  
    2. Copy Selected Codes
      To copy only selected codes from the Integration by Ryvit 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 Ryvit, 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 Ryvit connector, Cost Types are created and maintained in Integration by Ryvit. 

      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 Ryvit: Accept or Reject a Project for Export to Viewpoint® 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 Ryvit: 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 Ryvit: Accept or Reject a Project for Export to Viewpoint® Vista™.

        continue-project-setup-button.png

Update Directory

  1. Make sure Directory is highlighted.

    add-directory.gif
     
  2. Add contacts and companies from the Company Directory to your Project Directory as follows: 
    • If your project is based on an existing project template, you can add all of the companies and employees for those companies by clicking Select All in the drop-down menu. 
    • To add a company from Procore's Company Directory and all of that company's employees, begin typing the company name. When the system finds the appropriate match, select the company from the list. This adds both the company and people to the Project Directory.
    • To add a person, begin typing the person's name. When the system finds the appropriate match, select that person from the list:
      Notes:
      • If you want to remove a company or a person, click the delete icon-permissions-no-access-x.png icon across from the company or person.
      • If you want to remove all companies or people, click Clear All in the drop-down menu. 
  3. For each person that you have selected to add, complete the following:
    • Permission Template. Select the desired permission template from the list or choose 'Apply a Template Later.' 
      Important!
      This is a required setting for all of the users that you intend to add. To learn how the selections in this list are created, see Manage Project Permissions Templates.
    • Project Role. Select the project role for the user. The selection you make here will list the person for each selected role on the project's Home page. To learn how the selections in this list are created, see Add a Custom Project Role.
  4. Click Next.
    A GREEN banner appears at the top of the page to confirm the number of companies and people added. 

Upload Drawings

  1. Make sure Drawings is highlighted.
  2. Complete the following:

    upload-drawings.gif
     
    • To learn how to format drawings before uploading them to a project, see How can I improve the accuracy of OCR on my drawings?
    • To skip this step and upload your project's drawing(s) at a later time, click Skip. When you are ready to upload your drawings, see Upload Drawings.
      • Attach File(s). Click this button to choose from these options: Upload a file from your computer, Select a file from Procore, or if you have enabled the Box integration, Select a file from Box.
        OR
        Drag and Drop File(s). Use a drag-and-drop operation to move files from your computer or network to this area on the page. 
      • Set Name. Enter a name for the drawing set. 
      • Set Date. Select a date for the drawing set using the calendar control. 
      • Default Drawing Date. Select a date for the drawing(s) using the calendar control.
      • Default Received Date.  Select the received date for the drawing(s) using the calendar control. 
  3. Click Next
    The system processes the drawings in the background.
    Note: You do NOT need to wait for the upload to complete. When finished, the system sends you an automated email notification with the subject line, "Drawing Upload Complete." To learn how to review and publish your drawings, see Review and Confirm Drawings and then Publish Drawings.

Upload Specifications

  1. Make sure Specifications is highlighted.
    Notes:
    • If you want to skip this step and upload a specification later, click Skip. This closes the Project Creation Assistant.
    • When you are ready to upload your specifications at a later time, see Upload Specifications.
  2. Complete the following:

    upload-specs-pdf-only.png

    Notes:
    • To learn how to format specifications before uploading them to a project, see How can I improve the accuracy of Specification Section Identification?
      • Attach File(s). Click this button to choose from these options: Upload a file from your computerSelect a file from Procore, or if you have enabled the Box integration, Select a file from Box.
        OR
      • Drag and Drop File(s). Use a drag-and-drop operation to move files from your computer or network to this area on the page. 
      • Set Name. Enter a name for the set. 
      • Set Date. Select a date for the set using the calendar control.
      • Default Issued Date. Select a date for the file(s) using the calendar control.
      • Default Received Date.  Select the received date for the file(s) using the calendar control. 
  3. Click Next
    The system processes the specification upload. 
    Note: You do NOT need to wait for the upload to complete. When finished, the system sends you an automated email notification with the subject line, "Specification Upload Complete." To learn how to review and publish your specifications, see Review and Publish Specifications.

Upload Schedule

  1. Make sure Schedule highlighted.
    Notes: 
  2. Complete the following:

    prototype-upload-schedule.png
     
  3. Click Attach File(s). Then navigate to the schedule file on your computer or network. Then click Open
    Notes:
    • The Project Creation Assistant only supports file upload via your web browser. It does not currently support file uploads stored in the Project level Documents tool.
    • If you want to store a schedule file in the Documents tool and then upload it, see "File Upload Via Procore Documents" in the Upload a Project Schedule File to Procore's Web Application.
    • You can also upload a schedule file using Procore Drive. For details, see Schedule in the Procore Drive User Guide. 
  4. Click Next

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 Viewpoint® Vista™ marks and logos are owned by Viewpoint, Inc.