Skip to main content

Synchronizations Page

The Synchronizations Page is an admin tool for Property Managers to review reservation synchronization logs. MintCondition automatically syncs reservations every 15 minutes and also whenever a user manually triggers a sync. Once completed, all reservations appear on the Reservations page and Calendar page—the Synchronizations Page is strictly for monitoring the sync processes themselves.

⏳ How Reservation Sync Works​

  1. Automatic Sync: Every 15 minutes, MintCondition checks for new or updated bookings on connected channels (Airbnb, VRBO, Booking.com, etc.) using iCal or other APIs.
  2. Manual Sync: Property Managers can trigger an immediate synchronization from the Property Details Page under the Channels tab.
  3. Sync Logs: Each time a sync runs, MintCondition creates log entries in the Synchronizations Page, showing status and messages for each reservation or field that changed.

🗄️ Data Model Overview​

There are three main tables that capture sync details:

  1. Synchronizations Table
    • Represents a single sync process (either auto or manual).
    • Has a status (e.g., in progress, completed, failed) and a message describing overall results.
  2. Synchronized Reservations Table
    • Represent the reservations that were synched by one synchronization.
    • This list is displayed when cliecking on one synchronization.
    • Holds info like status, operation type (create, update, delete), and a message for any reservation-specific errors or updates.
  3. Synchronized Reservation Fields Table
    • Represents individual field changes within a synchronized reservations.
    • Shows old value vs. new value, so you can see precisely what changed.

In practice, an synchronized reservation lines up with each reservation that was read from the channel, while a synchronized reservation field details the change (like check-in date, guest name, or status) that was updated during the synchronization.

📋 Page Structure​

On the Synchronizations Page, you’ll see three sections—each loads progressively:

  1. Synchronizations Table
    Lists all sync processes relevant to the properties the user manages. Each row shows:

    • ID, Created On, Status (In Progress, Completed, Failed), Source, Target, Message (general notes).

  2. Synchronized Reservations Table
    When you click a row in the synchronizations table, MintCondition loads the related “reservations”. Each reservation row shows:

    • ID, Reservation Name/ID (if applicable), Status, Operation Type, Message.

  3. Synchronization Reservation Fields Table
    Clicking on a reservation row reveals field-level details. Each field row shows:

    • Field Name, Old Value, New Value.

This layered approach helps you drill down from a high-level sync record to specific reservation changes.

🔍 Filtering & Sorting​

All three tables (Synchronizations, Entities, Fields) support:

  • Sorting by clicking on column headers (ID, Created On, Status, etc.).
  • Filtering using text inputs or drop-downs (e.g., searching for a specific sync ID or reservation status).

You can also paginate to navigate large numbers of sync logs.

👀 Step-by-Step Usage​

1. Open the Synchronizations Page​

  • As a Property Manager, go to Admin → Synchronizations (or a similar path).
  • Initially, you see the Synchronizations Table with recent sync processes.

2. View a Specific Synchronization​

  • Click a row in the table to expand the Synchronization Entities below.
  • Each row in Synchronization Reservations corresponds to a reservation or relevant record the system tried to sync.

3. See Detailed Field Changes​

  • Click a reservation row to load the Synchronization Reservation Fields section.
  • Inspect which fields changed—old vs. new—and confirm if the sync performed correctly.

4. Checking Status & Error Messages​

  • If a sync fails, look for status = “Failed” or an error message in the Message column.
  • For partial successes, some entities may be Completed while others Failed, providing granular error messages.

💡 Viewing Reservations​

Remember, Reservations themselves live in the Reservations Page—this Synchronizations Page only logs the sync events that created/updated them.

  • If you want to check or delete the actual booking, go to Reservations.
  • The Calendar page also reflects new or updated bookings once the sync completes.

🔒 Permissions & Security​

  • Only Property Managers (or admin-level roles) see this page.
  • You see only sync logs for properties you manage.
  • Property Owners and Crew typically do not access this page since it’s an internal admin log.

⚙️ Example Workflow​

  1. Automatic 15-Minute Sync triggers.
  2. The system creates a new “synchronizations” record with status="In Progress".
  3. Each reservation processed becomes a “synchronization reservation” row (e.g., status="Completed" if no error).
  4. Field-level changes (like check_in_date from “2023-10-01” to “2023-10-02”) get logged in the “synchronization reservation fields” table.

After the process completes, you’ll see status="Completed" for the sync, or status="Failed" with an error message if something went wrong.

🚀 Key Takeaways​

  • Automatic & Manual Sync ensures your MintCondition calendar is always current.
  • Synchronizations Table → High-level overview of each sync run.
  • Synchronization Reservations Table → Reservation-by-reservation breakdown.
  • Fields Table → Field-by-field changes for precise debugging.
  • All updated reservations appear in Reservations and Calendar pages.

That’s it! With the Synchronizations Page, you have a clear audit trail of when your system synced, what reservations changed, and how fields were updated. This helps you troubleshoot errors, confirm updates, and maintain reliable property calendars.

To learn how to export an ICal from Mint Condition and import it to other booking platforms to avoid double bookings go to Export Ical