> ## 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 Integration FAQ

> Frequently asked questions about the MRI integration

## General Questions

<AccordionGroup>
  <Accordion title="What is MRI?">
    MRI Software is one of the UK's leading property management software platforms, used by hundreds of residential and commercial property managers. It provides comprehensive tools for managing properties, finances, tenancies, and maintenance.
  </Accordion>

  <Accordion title="Do I need MRI to use Manage.Management?">
    No, Manage.Management works perfectly as a standalone platform. The MRI integration is optional and designed for buildings that already use MRI and want to synchronize data between systems.
  </Accordion>

  <Accordion title="Which plans include MRI integration?">
    The MRI integration is available on Professional and Enterprise plans. Contact our sales team to upgrade your plan.
  </Accordion>

  <Accordion title="How much does the integration cost?">
    The integration is included in Professional and Enterprise plans at no additional cost. However, you'll need an active MRI subscription with API access enabled (contact MRI Software for pricing).
  </Accordion>
</AccordionGroup>

## Setup & Configuration

<AccordionGroup>
  <Accordion title="How do I get MRI API credentials?">
    Contact MRI Software support or your account manager to request MIX API access. They'll provide you with a Client ID, Database Name, User Name, Partner Key, Password, and Base URL. Make sure to specify you need access to the MRI MIX API.
  </Accordion>

  <Accordion title="Can I use sandbox credentials for testing?">
    Yes! We recommend starting with MRI's sandbox environment to test the integration before connecting to production data. You can switch to production credentials later in the settings.
  </Accordion>

  <Accordion title="How long does initial setup take?">
    Setup typically takes 15-30 minutes:

    * 5 minutes to enter credentials and test connection
    * 5 minutes to link your property
    * 5-20 minutes for initial data sync (depending on data volume)
  </Accordion>

  <Accordion title="Can I connect multiple buildings?">
    Yes, each building in Manage.Management can have its own MRI connection with separate credentials. This is recommended for security and data isolation.
  </Accordion>
</AccordionGroup>

## Data Synchronization

<AccordionGroup>
  <Accordion title="What data gets synchronized?">
    The integration syncs 8 entity types:

    * Properties & Units
    * Tenancies (lease information)
    * Contacts (residents, owners, suppliers)
    * Transactions (financial records)
    * Budgets (annual budgets and forecasts)
    * Invoices (supplier invoices)
    * Maintenance (work orders and repairs)
    * Documents (compliance certificates, legal files)
  </Accordion>

  <Accordion title="Is the sync bi-directional?">
    Yes, data flows both ways. Changes made in either MRI or Manage.Management are synchronized based on your conflict resolution settings.
  </Accordion>

  <Accordion title="How often does data sync?">
    Sync frequency is configurable per data type:

    * Real-time (within 15 minutes): Financial transactions, invoices
    * Hourly: Payments, urgent updates
    * Daily: Properties, tenancies, contacts, maintenance
    * Weekly: Documents, budgets
    * Manual: On-demand only
  </Accordion>

  <Accordion title="What happens if data changes in both systems?">
    The integration uses conflict resolution strategies:

    * **MRI Wins** (default): MRI data takes precedence
    * **Local Wins**: Manage.Management data preserved
    * **Merge**: Intelligent field-level merging
    * **Manual**: Flagged for human review
  </Accordion>

  <Accordion title="Can I pause synchronization?">
    Yes, you can disable sync at any time in Settings → Integrations → MRI. This won't delete any existing data, just stops new syncs.
  </Accordion>

  <Accordion title="How do I trigger a manual sync?">
    Navigate to Settings → Integrations → MRI → Sync Status and click "Sync All" or sync individual data types.
  </Accordion>
</AccordionGroup>

## Security & Privacy

<AccordionGroup>
  <Accordion title="How are my MRI credentials stored?">
    Credentials are encrypted using Supabase Vault with AES-256-GCM encryption. Your passwords and partner keys are never stored in plain text and are only accessible to authorized building directors.
  </Accordion>

  <Accordion title="Who can access MRI integration settings?">
    Only building directors (RTM/RMC directors) and super admins can configure the integration or access credentials. Regular homeowners cannot view or modify integration settings.
  </Accordion>

  <Accordion title="Is my data encrypted during sync?">
    Yes, all API communications use TLS 1.3 encryption. Data is encrypted both in transit (during sync) and at rest (in the database).
  </Accordion>

  <Accordion title="What happens to my data if I disconnect the integration?">
    Disconnecting the integration stops future syncs but doesn't delete any existing data in Manage.Management. You can reconnect at any time without data loss.
  </Accordion>

  <Accordion title="How often should I rotate credentials?">
    We recommend rotating MRI API credentials every 90 days. The system will alert you when rotation is due. You can rotate credentials in Settings → Integrations → MRI → Security.
  </Accordion>

  <Accordion title="Are API calls logged?">
    Yes, every API call, credential access, and sync operation is logged for security and compliance. Building directors can view audit logs in the Security tab.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection test failed - what should I check?">
    Common issues:

    1. **Invalid credentials**: Double-check your Client ID, Database Name, User Name, Partner Key, and Password
    2. **API access not enabled**: Contact MRI to enable API access on your account
    3. **Wrong environment**: Ensure you're using sandbox credentials for sandbox, production for production
    4. **Network issues**: Check your internet connection and firewall settings
  </Accordion>

  <Accordion title="Sync is failing with errors - what do I do?">
    1. Check the error logs in Settings → Integrations → MRI → Sync Status
    2. Common fixes:
       * Re-authenticate if you see "401 Unauthorized"
       * Check MRI property ID is correct
       * Ensure sync is enabled for the data type
    3. If errors persist, contact [support@manage.management](mailto:support@manage.management) with the error details
  </Accordion>

  <Accordion title="Data is missing after sync - why?">
    Possible reasons:

    * **Sync not enabled**: Check sync configuration for that data type
    * **Filters applied**: Some data types have filters (e.g., date ranges for transactions)
    * **Permissions**: Ensure your MRI API credentials have access to that data
    * **Mapping issues**: Verify your building is correctly linked to the MRI property
  </Accordion>

  <Accordion title="Sync is very slow - how can I speed it up?">
    * **Initial sync**: First sync takes longer due to data volume (this is normal)
    * **Reduce frequency**: Lower sync frequency for non-critical data types
    * **Incremental sync**: After initial sync, only changes are synchronized (much faster)
    * **Check API limits**: Ensure you're not hitting MRI's rate limits
  </Accordion>

  <Accordion title="I see 'Rate limit exceeded' errors - what does this mean?">
    The integration has built-in rate limiting to protect MRI's API:

    * **60 requests per minute**
    * **1,000 requests per hour**

    If you hit these limits, requests are automatically queued and retried. This is normal during large syncs and will resolve automatically.
  </Accordion>

  <Accordion title="Authentication keeps failing - what's wrong?">
    If you see repeated authentication failures:

    1. **Check credentials**: Ensure Client ID and Secret are correct
    2. **Credential expiry**: Some MRI credentials expire - contact MRI to renew
    3. **Account status**: Verify your MRI subscription is active
    4. **API access**: Confirm API access is enabled on your MRI account
    5. **Rotate credentials**: Try rotating to new credentials in MRI
  </Accordion>
</AccordionGroup>

## Performance & Limits

<AccordionGroup>
  <Accordion title="How much data can be synced?">
    There are no hard limits on data volume. The integration has successfully synced:

    * Buildings with 500+ units
    * 10+ years of financial transactions
    * Thousands of documents
    * Multiple properties per building
  </Accordion>

  <Accordion title="Will sync affect MRI performance?">
    No, the integration uses MRI's official API with built-in rate limiting to ensure it doesn't impact MRI performance. Syncs happen in the background without affecting your MRI usage.
  </Accordion>

  <Accordion title="Can I sync historical data?">
    Yes, the initial sync imports all existing data from MRI. You can also configure date ranges for financial transactions to limit historical data if needed.
  </Accordion>

  <Accordion title="What's the maximum sync frequency?">
    * **Real-time**: Within 15 minutes (for critical financial data)
    * **Hourly**: Every hour
    * **Daily**: Once per day (overnight)
    * **Weekly/Monthly**: As configured

    Higher frequencies use more API quota but provide more up-to-date data.
  </Accordion>
</AccordionGroup>

## Billing & Costs

<AccordionGroup>
  <Accordion title="Are there any API usage fees?">
    Manage.Management doesn't charge for API usage. However, check with MRI Software if they have API usage limits or fees on your subscription.
  </Accordion>

  <Accordion title="What happens if I downgrade my plan?">
    If you downgrade to a plan without MRI integration:

    * Sync will stop automatically
    * Existing synced data remains in Manage.Management
    * You can re-enable sync by upgrading again
    * No data is deleted
  </Accordion>

  <Accordion title="Can I try the integration before upgrading?">
    Yes! Contact our sales team for a 14-day trial of the Professional plan to test the MRI integration with your data.
  </Accordion>
</AccordionGroup>

## Advanced Features

<AccordionGroup>
  <Accordion title="Can I customize which fields are synced?">
    Currently, the integration syncs all available fields for each entity type. Field-level customization is on our roadmap. Contact support if you have specific requirements.
  </Accordion>

  <Accordion title="Can I sync to multiple MRI properties?">
    Each building in Manage.Management can connect to one MRI property. If you manage multiple MRI properties, create separate buildings in Manage.Management for each.
  </Accordion>

  <Accordion title="Is there an API for the integration?">
    Yes, developers can access the MRI integration programmatically. See our [API Reference](/integrations/mri-qube-api) for technical documentation.
  </Accordion>

  <Accordion title="Can I export sync logs?">
    Yes, building directors can export audit logs and sync logs in CSV or JSON format from Settings → Integrations → MRI → Security → Export Logs.
  </Accordion>

  <Accordion title="Does the integration support webhooks?">
    Webhook support is on our roadmap. Currently, the integration uses polling-based sync at configured intervals.
  </Accordion>
</AccordionGroup>

## Compliance & Legal

<AccordionGroup>
  <Accordion title="Is the integration GDPR compliant?">
    Yes, the integration is fully GDPR compliant:

    * Data Processing Agreement with MRI Software
    * Standard Contractual Clauses for international data transfer
    * Right to erasure support
    * Data subject access request support
    * Comprehensive audit logging
  </Accordion>

  <Accordion title="Where is my data stored?">
    * **Manage.Management data**: EU/UK data centers (Supabase)
    * **MRI data**: Customer's MRI server (via MIX API)
    * **Data transfer**: Protected by HTTPS with HTTP Basic Auth
  </Accordion>

  <Accordion title="Can I delete all synced data?">
    Yes, you can:

    1. Disconnect the integration (stops future syncs)
    2. Request data deletion via Settings → Integrations → MRI → Delete All Synced Data
    3. This is irreversible and removes all MRI-sourced data from Manage.Management
  </Accordion>

  <Accordion title="Who owns the synced data?">
    You (the building/RTM company) own all data. Manage.Management and MRI Software are data processors. You control the data and can request deletion at any time.
  </Accordion>
</AccordionGroup>

## Getting Help

<AccordionGroup>
  <Accordion title="Where can I find setup instructions?">
    See our comprehensive [Setup Guide](/integrations/mri-qube-setup) for step-by-step instructions with screenshots.
  </Accordion>

  <Accordion title="How do I contact support?">
    * **Email**: [support@manage.management](mailto:support@manage.management)
    * **Live Chat**: Click the chat widget on any documentation page
    * **Security Issues**: [security@manage.management](mailto:security@manage.management)

    Include your building ID and error messages for faster resolution.
  </Accordion>

  <Accordion title="Is there a community forum?">
    We're building a community forum for users to share tips and best practices. Join our mailing list to be notified when it launches.
  </Accordion>

  <Accordion title="Can I request new features?">
    Absolutely! We love feedback. Email your feature requests to [support@manage.management](mailto:support@manage.management) or use the feedback widget in the app.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="gear" href="/integrations/mri-qube-setup">
    Step-by-step instructions to configure the integration
  </Card>

  <Card title="Security Guide" icon="shield" href="/integrations/mri-qube-security">
    Learn about security measures and compliance
  </Card>

  <Card title="Sync Configuration" icon="arrows-rotate" href="/integrations/mri-qube-sync">
    Configure sync frequencies and conflict resolution
  </Card>

  <Card title="API Reference" icon="code" href="/integrations/mri-qube-api">
    Technical documentation for developers
  </Card>
</CardGroup>