Integrated Data

Dynamics 365 Business Central

What this page covers: A complete reference mapping every Dynamics 365 Business Central field to its Mosaic equivalent. Use this guide when configuring your integration, verifying synced data, or troubleshooting discrepancies.

Integration typeCloud (API)
Setup complexityLow
PrerequisiteBusiness Central Integration Setup

How Data Flows

Business Central (API) → Mosaic Sync Engine (field mapping) → Mosaic (3 synced data types)

The integration uses the Business Central API to access Employee, Job, and Job Task data. Mosaic syncs these records on a scheduled basis.


Integrated Data Types

The integration syncs 3 data categories from Business Central into Mosaic:

#Data TypeDescription
1EmployeesStaff records with names, emails, and job titles
2ProjectsJob records including title, number, and status
3PhasesJob Task breakdowns under projects (includes budget, start/end dates)

This list may expand as new features are added.


Reading the Field Mapping Tables

Symbol legend for technical tables

The Technical Reference tabs below use a shorthand notation for API sources. Read this legend before reviewing the mappings.

SymbolMeaningExample
.API entity field referenceEmployee.FirstName = the FirstName field from the Employee entity

Detailed Field Mappings


Employees

What Syncs to MosaicWhere It Comes From in Business Central
First NameThe employee's first name
Last NameThe employee's last name
EmailThe employee's company email address
RoleThe employee's job title

Projects

What Syncs to MosaicWhere It Comes From in Business Central
Project TitleThe job description
Project NumberThe job number
Project StatusThe job status

Phases

What Syncs to MosaicWhere It Comes From in Business Central
Phase TitleThe job task description
Phase NumberThe job task number
Phase FeeThe job task budget amount
Start DateThe job task start date
End DateThe job task end date

Unsupported Data Sources

  • Changing field names in Mosaic to match custom labelling in Business Central
  • Integrating Data Types that are not explicitly listed in the Business Central Integration Documentation

Please Note:

If there is a data endpoint not listed in this documentation and it is required for your integration, it will be a customization, charged at an hourly rate. For more information, see Integration Requests.


Business Central Documentation Links

A consolidated reference of all Business Central documentation referenced in this guide:

TopicLink
API Reference (v2.0)Business Central API
Employee EntityEmployee API
Project (Job)Project API
Project TaskProject Task API

Related Documentation