> ## Documentation Index
> Fetch the complete documentation index at: https://kb.manage.management/llms.txt
> Use this file to discover all available pages before exploring further.

# MRI Sync Configuration

> Configure synchronisation frequencies, conflict resolution, and monitoring

## Sync Dashboard

The MRI Sync Dashboard provides real-time visibility into your synchronisation status. Access it from **Settings > Integrations > MRI > Sync Status**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/managemanagement/images/mri-sync-dashboard.png" alt="MRI Sync Dashboard" />
</Frame>

## Sync Frequencies

Configure how often each data type synchronises with MRI:

### Available Frequencies

| Frequency     | Interval                 | Best For                                |
| ------------- | ------------------------ | --------------------------------------- |
| **Real-time** | Within 15 minutes        | Financial transactions, urgent updates  |
| **Hourly**    | Every hour               | Invoices, payments, time-sensitive data |
| **Daily**     | Once per day (overnight) | Properties, tenancies, contacts         |
| **Weekly**    | Once per week            | Documents, budgets, static data         |
| **Monthly**   | Once per month           | Archive data, annual records            |
| **Manual**    | On-demand only           | Sensitive data, controlled updates      |

### Recommended Configuration

```json theme={null}
{
  "syncFrequency": {
    "properties": "daily",
    "tenancies": "daily",
    "transactions": "hourly",
    "budgets": "weekly",
    "invoices": "hourly",
    "maintenance": "daily",
    "documents": "weekly"
  }
}
```

<Tip>
  Higher sync frequencies use more API quota. Balance real-time needs against API limits.
</Tip>

## Conflict Resolution

When data changes in both systems between syncs, the integration uses conflict resolution strategies:

### Resolution Strategies

<AccordionGroup>
  <Accordion title="MRI Wins (Default)">
    MRI data takes precedence. Changes made in Manage.Management will be overwritten.

    **Best for:** Properties where MRI is the primary system of record.
  </Accordion>

  <Accordion title="Local Wins">
    Manage.Management data takes precedence. Changes in MRI will not overwrite local data.

    **Best for:** Buildings transitioning away from MRI or using MM as primary.
  </Accordion>

  <Accordion title="Merge">
    Attempts to merge changes from both systems. Fields changed in only one system are updated.

    **Best for:** Active use of both systems with different workflows.
  </Accordion>

  <Accordion title="Manual">
    Conflicts are flagged for manual review. No automatic resolution occurs.

    **Best for:** Sensitive data requiring human oversight.
  </Accordion>
</AccordionGroup>

## Manual Sync Operations

### Trigger a Full Sync

To manually synchronise all data:

```typescript theme={null}
// From the dashboard
Click "Sync All" button

// Via API
POST /api/mri/sync/building/{buildingId}
```

### Sync Specific Entity Types

Sync individual data types when needed:

| Entity       | Action                              |
| ------------ | ----------------------------------- |
| Properties   | Sync building and unit details      |
| Transactions | Sync financial records              |
| Contacts     | Sync resident and supplier contacts |
| Documents    | Sync compliance documents           |

## Monitoring & Alerts

### Sync Status Indicators

| Status         | Meaning                                  |
| -------------- | ---------------------------------------- |
| 🟢 **Success** | Sync completed without errors            |
| 🟡 **Warning** | Sync completed with some skipped records |
| 🔴 **Error**   | Sync failed - check error logs           |
| ⚪ **Pending**  | Sync scheduled but not yet started       |

### Error Handling

Common sync errors and resolutions:

<AccordionGroup>
  <Accordion title="Rate Limit Exceeded">
    The MRI API has rate limits. The system automatically retries with exponential backoff.

    **Resolution:** Wait for retry or reduce sync frequency.
  </Accordion>

  <Accordion title="Authentication Failed">
    API credentials may have been changed or revoked on the MRI server.

    **Resolution:** Verify your MIX API credentials are still valid. If needed, re-enter credentials in Settings → Integrations → MRI.
  </Accordion>

  <Accordion title="Record Not Found">
    A record in MRI was deleted but exists locally.

    **Resolution:** Record will be marked as inactive, not deleted.
  </Accordion>

  <Accordion title="Validation Error">
    Data from MRI doesn't match expected format.

    **Resolution:** Check MRI data quality or contact support.
  </Accordion>
</AccordionGroup>

## Sync Logs

View detailed sync history in **Settings > Integrations > MRI > Sync Logs**:

* Timestamp of each sync operation
* Records processed, created, updated, skipped
* Duration of sync operation
* Any error messages

<Note>
  Sync logs are retained for 90 days. Export logs if you need longer retention.
</Note>