Mobiclocks & CMiC Integration Design Document
Purpose: This document describes the integration between Mobiclocks and CMiC ERP. It is intended for CMiC's partner program and technical review teams.
Mobiclocks integrates with CMiC to synchronize project data (Job Sites, Cost Codes, and Cost Types) into Mobiclocks. This enables construction companies to manage field time tracking against live project data from CMiC, eliminating manual data entry and keeping both systems in sync.
Mobiclocks integrates with CMiC to synchronize project data (Job Sites, Cost Codes, and Cost Types) into Mobiclocks. This enables construction companies to manage field time tracking against live project data from CMiC, eliminating manual data entry and keeping both systems in sync.
Integration Architecture
Mobiclocks
Back-Office Web App
Admins
↔
Sync & Import Engine
- Manual sync triggers
- Scheduled auto-sync
↓
Data Store
- Job Sites
- Cost Codes
- Cost Types
HTTPS | Session Cookie Auth
Davit:
CMiC ERP REST API
https://{company}.cmic.com/api/v1/
GET/jcjobJob Sites
GET/jcjobcostcodesCost Codes (per Job Site)
GET/jcmastercategoriesCost Types
GET/jcjobcostcatcodesCost Code Categories & Budgets
Integration Flow
1
Connection Setup
An administrator enters CMiC API credentials (host, username, password) in Mobiclocks. Mobiclocks authenticates with CMiC using Basic Auth and stores the session token for all future requests. Sessions are automatically refreshed when they expire.
An administrator enters CMiC API credentials (host, username, password) in Mobiclocks. Mobiclocks authenticates with CMiC using Basic Auth and stores the session token for all future requests. Sessions are automatically refreshed when they expire.
2
Data Sync from CMiC
Mobiclocks pulls project data from CMiC across three categories: Job Sites (active projects), Cost Codes (attached to each job), and Cost Types (master categories such as Labor and Subcontractor).
Mobiclocks pulls project data from CMiC across three categories: Job Sites (active projects), Cost Codes (attached to each job), and Cost Types (master categories such as Labor and Subcontractor).
3
Selective Import into Mobiclocks
Administrators browse the synced data and selectively import Job Sites and Cost Codes into Mobiclocks. Only imported data is visible to field workers for time entry.
Administrators browse the synced data and selectively import Job Sites and Cost Codes into Mobiclocks. Only imported data is visible to field workers for time entry.
4
Ongoing Sync
Mobiclocks keeps data current via scheduled auto-sync (configurable interval) and on-demand manual sync triggered by an administrator.
Mobiclocks keeps data current via scheduled auto-sync (configurable interval) and on-demand manual sync triggered by an administrator.
5
Archive Management
Inactive job sites and cost codes can be archived in Mobiclocks without deletion, preserving historical time entry records.
Inactive job sites and cost codes can be archived in Mobiclocks without deletion, preserving historical time entry records.
CMiC APIs Consumed by Mobiclocks
Mobiclocks calls the following CMiC REST API endpoints. All requests are read-only (GET). Pagination is handled automatically using limit / offset parameters.
| Endpoint | Method | Fields Requested | Purpose |
|---|---|---|---|
{base-url}/ |
GET | — | Authenticate using Basic Auth (username + password). CMiC returns a session cookie used for all subsequent API calls. Session is automatically refreshed on expiry. |
{base-url}/jcjob |
GET | Job UUID, Job Code, Job Name, Status Code | Retrieve the list of projects / job sites from CMiC |
{base-url}/jcjobcostcodes |
GET | Cost Code UUID, Code, Name, Projected Qty, Work Measure Code | Retrieve cost codes associated with a specific job site |
{base-url}/jcmastercategories |
GET | Category UUID, Code, Name | Retrieve master cost type categories |
{base-url}/jcjobcostcatcodes |
GET | Job Code, Phase Code, Category Code, Budget Amount, Budget Units | Retrieve budget and category associations per job site cost code |
Mobiclocks Integration Management Capabilities
Davit:The following capabilities are available to administrators within Mobiclocks for managing the CMiC integration.
Connection & Settings
| Capability | Description |
|---|---|
| Connect to CMiC | Set up or update CMiC API credentials (host, username, password) |
| View Connection Status | Check current connection configuration and status |
| Configure Auto-Sync | Set sync interval and enable/disable automatic background sync |
| Configure Sync Filters | Filter which cost types are included during sync |
Job Sites
| Capability | Description |
|---|---|
| Sync Job Sites | Pull latest job sites from CMiC on demand |
| Browse Job Sites | View all job sites available from CMiC before importing |
| Import Job Sites | Add selected job sites into Mobiclocks for field use |
| View Imported Job Sites | See which job sites are currently active in Mobiclocks |
| Archive / Unarchive | Deactivate or reactivate job sites without data loss |
Cost Codes (per Job Site)
| Capability | Description |
|---|---|
| Sync Cost Codes | Pull latest cost codes for a specific job site from CMiC |
| Browse Cost Codes | View all available cost codes for a job site |
| View Cost Types | See cost types applicable to a job site |
| Import Cost Codes | Add selected cost codes into Mobiclocks |
| Archive / Unarchive | Deactivate or reactivate cost codes without data loss |
Cost Types
| Capability | Description |
|---|---|
| Sync Cost Types | Pull latest cost types from CMiC |
| Browse Cost Types | View all synced cost types |
| Activate / Deactivate | Control which cost types are available for use in Mobiclocks |
Security & Data Handling
- All communication between Mobiclocks and CMiC is over HTTPS
- Mobiclocks authenticates with CMiC using session-based auth (obtained via Basic Auth); sessions are automatically refreshed
- CMiC credentials are stored securely within Mobiclocks tenant-isolated settings
- Mobiclocks performs read-only operations against CMiC; no data is written back to CMiC
- Each Mobiclocks customer has fully isolated CMiC connection settings (multi-tenant architecture)
