What is Two-Way Sync?
Two-Way Sync automatically keeps data synchronized between multiple construction management systems. When changes are made in one system, they’re automatically reflected in the other system, ensuring all stakeholders always have the latest information.How It Works
The sync process runs automatically on a schedule, comparing data between systems and making updates where needed:Identify Changes
Records are compared to identify new items that need to be created and existing items that have been updated.
Transform Data
Data is transformed to match the destination system’s requirements. This may include field mapping, data format conversions, and in some cases, AI-powered matching (such as matching specification sections or submittal types between different project configurations).
Create Records
New records are created in the destination system with all relevant fields and attachments.
Update Records
Existing records are updated when changes are detected, based on the current workflow state.
Key Features
Bidirectional Sync
Changes flow in both directions based on workflow states, allowing both teams to collaborate seamlessly.
State-Based Logic
Synchronization behavior adapts based on the current status of each record, ensuring the right updates happen at the right time.
Automatic Attachments
Files and attachments are automatically transferred between projects during sync operations.
AI-Powered Matching
For complex records like Submittals, AI intelligently matches specifications and types between different project configurations.
Error Recovery
Failed syncs are tracked and can be retried after fixing issues, with detailed logging for troubleshooting.
Scheduled Execution
Syncs run automatically on a regular schedule, typically every 15-30 minutes, with no manual intervention required.
Specialized Syncers
Kroo provides specialized syncers for common construction workflows:ACC RFIs
Synchronize Requests for Information (RFIs) between ACC systems with support for questions, responses, and closure workflows.
ACC Submittals
Synchronize Submittals between ACC systems with complex approval workflows, including AI-powered spec matching and multi-stage state transitions.
Contact Kroo support for additional platform-specific syncer documentation.
Getting Started
To enable Two-Way Sync:- Contact Kroo Support at [email protected]
- Provide System Information:
- Platform types (ACC, Procore, etc.)
- Project IDs or Company IDs for both systems
- User IDs for assignments
- Company IDs for workflow participants
- Configuration Setup: Kroo will configure the sync based on your workflow requirements
- Initial Sync: Monitor the first sync cycles to ensure everything is working correctly
Each syncer has specific setup requirements. See the Specialized Syncers section for detailed configuration information for each platform and data type.
How Two-Way Sync Works
Two-Way Sync operates through a series of automated steps that run on a regular schedule:Fetch from Both Systems
The sync engine retrieves current data from both systems (e.g., System A and System B) using API connections.
Compare & Identify Changes
Records are compared to find:
- New records that exist in one system but not the other
- Existing records where field values have changed
- Records that match workflow state requirements
Transform Data
For records that need syncing:
- Field mappings are applied (e.g., matching field names between systems)
- AI transforms may run (e.g., matching spec sections between different projects)
- Custom business logic is applied based on record state
Write Changes
Changes are pushed to the destination system:
- Create: New records are created with all relevant fields
- Update: Existing records are updated with changed fields only
- Attachments: Files are downloaded from source and uploaded to destination
Scheduled Execution: Syncs typically run every 15-30 minutes automatically. No manual intervention is required for routine operations.
Monitoring & Troubleshooting
Sync Details Portal
The Sync Details portal in the Kroo app provides real-time visibility into all sync operations. This is your first stop for identifying and troubleshooting sync issues. Access the portal:- Log into the Kroo app
- Navigate to Two-Way Sync → Details
- Status: Visual indicator showing “Sync’d” (successful) or “Errored” (failed)
- Error logs: Detailed error messages explaining why a sync may have failed
- Record details: View source and destination records with “View Rfi” or similar buttons
- Last updated: Timestamp showing when each sync last ran
- Search & filter: Find specific syncs by name, code, or status
- Export: Download sync data as CSV for analysis
Best Practice: If you suspect a sync failure or have questions about sync status, check the Sync Details portal first. The error logs provide specific information about what went wrong and how to fix it.
Common Failure Scenarios
Transient Errors
Transient Errors
Examples: API rate limits, network timeouts, temporary service outagesResolution: Automatic retry on next sync cycle (no action needed)
Configuration Errors
Configuration Errors
Examples: Invalid user IDs, missing parameters, permission issuesResolution: Fix configuration and mark records for retry
Data Quality Errors
Data Quality Errors
Examples: Missing required fields, AI matching failures, invalid valuesResolution: Improve source data quality, add missing metadata
System Errors
System Errors
Examples: ACC API changes, unexpected responses, software bugsResolution: Contact Kroo support for investigation
Getting Help
If you encounter issues with Two-Way Sync:- Check the Specialized Syncers pages for syncer-specific troubleshooting
- Review error messages in sync logs (available through Kroo support)
- Contact Kroo support at [email protected] with:
- Project IDs for both systems
- Record IDs (RFI or Submittal numbers)
- Error messages or symptoms
- Timestamp when the issue occurred
Kroo support can access detailed sync logs, AI matching reasoning, and system diagnostics to quickly identify and resolve issues.