BQE Core Integration Guide

Mosaic integrations securely connect your ERP systems to bring the right people, project, financial, and time entry data into Mosaic for resource planning and management. By automating data synchronization, Mosaic eliminates manual data entry, reduces errors, and centralizes critical information in one location.

During onboarding, we'll help you connect your system, review your data to ensure it flows correctly, and CS will guide you through the tools and workflows. Start with the step‑by‑step setup instructions below, then follow the settings guide to finish configuration and validate your data.


1. How do we integrate to BQE Core

Connection types

  • Cloud: Uses BQE Core's API with OAuth-based authentication (username and password). Mosaic syncs members, clients, projects, phases, activities, time entries, roles, and member bill/cost rates directly from the BQE Core API. Further setup details can be found at the links in section 7.

2. What Mosaic syncs from BQE Core

Data TypeDescription
MembersMember records (name, email, active/archived status)
Standard RolesRole definitions derived from member titles
Member RolesDefault role assignment per member
Member Project RolesMember-to-project role assignments from project staff classifications
ClientsClient records (name, description, status)
ProjectsProject records (name, code, fee, dates, billable status, project status)
PhasesPhase breakdowns under projects (name, code, fee, dates, billable status, phase status)
Work CategoriesBQE Core activity items synced to Mosaic for time categorization
Time EntriesTime records (hours, date, billability, rate, comments, approval status)
Member Bill RatesMember-level billing rate entries with effective date ranges
Member Cost RatesMember-level cost rate entries with effective date ranges

For detailed field mappings and settings per data type, see:

Not Synced

Data TypeDescription
DepartmentMember department assignments
Office / RegionGeographic or office classifications on members or projects
Rate GroupsBQE Core rate tables are not synced as Mosaic rate groups
Project ManagerProject Manager assignment is not pulled from BQE Core

3. What Mosaic provides during onboarding

  • Integration setup support (guidance, troubleshooting)
  • Pre-built connectors and setup instructions (outlined in this document)
  • Training & guidance on workflows and best practices

4. Implementation steps

StepWhat Happens
1. IntakeSubmit integration request and technical deep-dive forms
2. ValidationMosaic Solutions team reviews your forms and confirms requirements
3. ConnectionBQE Core OAuth credentials are configured and connectivity is established
4. ConfigurationIntegration settings are applied and initial data sync runs
5. TestingData is validated, discrepancies are resolved, and workflows are confirmed
6. Go-LiveIntegration is finalized and handed off to your team
📘

Timeline varies by environment complexity.

Your CSM will share a tailored schedule during onboarding.

Timely completion of forms and provision of credentials keeps things on track.

Requests to sync additional fields or change integration behavior are scoped as Statements of Work and billed at your contracted implementation rate.


5. Readiness Checklist

In order for onboarding to be considered successful, we need these items to be completed:

✅ Technical lead assigned - Designated integration point of contact for Mosaic

✅ Integration Request and Technical Deep Dive forms submitted

✅ BQE Core integration connection set up via OAuth credentials

✅ Setup Your Mosaic Integration Settings review call for onboarding

✅ Historical data sync confirmed by our Solutions team


6. What Mosaic needs from you and next steps

  1. Submit your integration request form and deep dive form (you should have already received this in your welcome packet)
    • Mosaic reviews & starts set up process. Solutions team will review your forms and may reach out.
  2. Provide IT point of contact in case troubleshooting is needed.
  3. Provide BQE Core connection details:
  4. Review the BQE Core Visual Settings Guide to plan your Mosaic configuration ahead of onboarding

7. Setup and Technical Documentation

Connecting BQE Core

Connection TypeResourceDescription
CloudBQE Core Integration SetupStep-by-step guide to connect BQE Core to Mosaic via OAuth

Cloud technical documentation

ResourceDescription
BQE Core Visual Settings GuideIntegration settings reference for BQE Core deployments
BQE Core Integrated DataDetailed field mappings, configurable settings, and troubleshooting for BQE Core
BQE Core API ExplorerBQE Core's official API reference documentation