BHHS Franchise Reporting API

BHHS Franchise Reporting API

Overview

The implementation of two new submission types for Berkshire Hathaway HomeServices (BHHS) Franchise Reporting is now available.

These updates leverage an API to allow for seamless, real-time data synchronization, reducing manual entry and ensuring that each branch office remains compliant with franchise requirements.

New BHHS submission types

  1. BHHS Roster Sync

    Maintaining an accurate agent roster is now automated. This feature synchronizes the local agent data with the BHHS master roster to ensure every agent is properly accounted for.

    The Logic:

    To prevent data duplication and maintain clean records, the API follows these specific rules:

    • Active Agents Only: The system only pulls records for agents who are currently active (records that have not been deleted).
    • Smart Matching: The sync specifically targets profiles that do not yet have a "BHHS Agent #" assigned.
    • Auto-Population: Once the sync is successful, the official BHHS agent number is automatically written back to the agent’s profile, completing the link between systems.

    Submission Process:

    1. Go to the Tools main menu
    2. Click the Push submenu
    3. Click the new button - darwin will open a pop-up window called Push Submission

    From the Push Submission window:

    1. Select the submission destination to BHHS Roster
    2. Select the company
    3. Click the preview button
    4. Click the submit button
  2. BHHS Txns Closing

    This submission type is designed specifically for Closed Transactions.

    Submission Process:

    1. Go to the Tools main menu
    2. Click the Push submenu
    3. Click the new button - darwin will open a pop-up window called Push Submission

    From the Push Submission window:

    1. Select the submission destination to BHHS Txns Closing
    2. Select the company
    3. Click the preview button
    4. Click the select all button
    5. Click the submit button

Understanding Submission Statuses

darwin Cloud provides real-time feedback regarding the progress of data transmissions.

Below is a guide to interpreting the feedback:

The "In Progress" Status

After clicking Submit, an "In Progress" label appears next to the submission, indicating the system is communicating with the BHHS API.

  • Refresh Button: A refresh button remains visible during this stage and disappears once the submission process is complete.

Success vs. Fail Submission

Each record is validated individually. Once the "In Progress" status clears, results are displayed as follows:

If the record is...

Then...

Successful

The Success Checkbox is marked, and the Submit button disappears to prevent duplicate entries.

Unsuccessful

The Success Checkbox remains empty, and the Submit button remains visible to re-attempt the sync.

Error Handling
  • If a submission is unsuccessful, the specific error message returned by the BHHS API is displayed in the last column.

This allows for data correction before a re-submission is attempted.

    • Related Articles

    • RE/MAX Franchise Reporting - Send to API

      The "Send to API" feature allows users to submit franchise reporting to RE/MAX in real-time. Notes When submitting via the API, users will not receive an email with the spreadsheet, as all the data is accessible directly within darwin Cloud. If a ...

    • Berkshire Hathaway HomeServices (BHHS) Franchise Reporting: Set Up and Submission Process

      Before running the franchise reports for Berkshire Hathaway, the franchise ID numbers should be entered for the company, for all offices, and for all active agents. Enter Franchise ID for the Company Enter the brand code and Affiliate ID on the ...

    • RE/MAX Franchise Reporting: Set Up and Submission Process

      Setting Up RE/MAX Franchise Report in darwin Cloud Enter RE/MAX Office ID's The RE/MAX Office ID must be filled in for every office with transaction data associated. To enter the Office ID: Click Company menu Click Office submenu Enter the 9-digit ...

    • eRelocation API Integration

      Overview You can now connect your eRelocation account and darwin. darwin reduces the need to reissue checks because an agent did not tell you about a referral prior to closing by pulling customer data from eRelocation into darwin as buyer/seller ...

    • Anywhere Franchise: How do I Add a New Company in darwin Cloud?

      Companies set up in darwin Cloud are designed to keep finances separated between different legal entities, as bank accounts assigned to one company cannot be accessed from other companies. Companies can also be used for franchise reporting purposes ...