Skip to main content

Supra Implementation Instructions

Updated

 

How it works:

GrowthZone uses an API to send a one-way sync to Supra. Once live, updates are sent from GrowthZone to Supra every 90 minutes.

 

 

PROJECT KICK OFF

 

Overview: 

The Integration Specialist reaches out to SUPRA and the customer to receive data files for offices and agents. Testing is done only in Production, however a test file is provided during Staging. 

 

Ticketing Process for RE Integrations (Review the below and we'll remove the red notation)

  • When requesting the initial data files, the Integration Specialist will CC platformintegrations@growthzone.com email to create a SUPRA- (Tenant  Name) ticket for project visibility. That ticket will then be related to the main Migration ticket.
  • All communication with the vendor, for the project, will be tracked in this related ticket. All project movement, communication between GZ Teams, updates, date files, and meeting dates will still be placed in a private note in the main Migration ticket for the Onboarder and Migrations team. 
  • The purpose of the related SUPRA- (Tenant Name) ticket is to allow visibility on the vendor communications for all RE Integrations staff. The related SUPRA- (Tenant Name) ticket will remain In Progress until the full integration is turned on and completed. The RE Integration point of contact for the project will be the Assignee on the  related SUPRA- (Tenant Name).

 

 

Data Process:

Customer will need to request Agent & Office files from Supra for the import. Email suprafieldengineering@carrier.com and request the files be sent to GrowthZone.

  • Project timeline will depend on whether the customer wants to do a data conversion within Supra i.e. they want to change their key fields over to the NRDS Id.

  • If they want Supra to do the Id conversion, their lead times is 90 days and Supra may charge for this process.

  • If they are not doing a data conversion, then request the files and provide to conversions.

    • Hello Supra,

       

      We are looking to have you provide Office & Agent data files for _______________. Client NAME, could you respond back letting Supra know we have permission to request the files? We are looking at a Go Live date of ________, this is a new set up/vendor switch.

 

 

Outlined process for other integrations that may be occurring simultaneously: 

M1 (if applicable) - https://helpdesk.growthzone.com/staff/kb/articles/2395-nrds-implementation-instructions

 

Lockbox (if applicable) -

Sentrilock https://helpdesk.growthzone.com/staff/kb/articles/2392-sentrilock-implementation-instructions;

SUPRA https://helpdesk.growthzone.com/staff/kb/articles/2391-supra-implementation-instructions

 

 

STAGING| TESTING

 

  • Once the data has been pulled from SUPRA and all other integrations, the Integration Specialist will create a staging database.
  • Verify the Import Feature Settings are on. Setup -> Import Features
  • Verify in the Setup -> Real Estate Integrations -> MLS Tab  that SUPRA is selected as the LockBox. 
  • Once all data sources are obtained, and the Staging Database is created, the Integration Specialist will move the ticket to In Review for the Onboarder to move to Migrations when ready. 

 

Once the Staging data has been imported by Migrations, it should be reviewed by Onboarding in conjunction with Platform Integrations and the Customer to ensure that the data was being imported correctly.  

 

PROVIDING A TEST FILE

 

  1. Double check that the GrowthZone Real Estate API has been setup by Conversions

Go to Setup>Applications>API Key Permissions ***If this is not a visible option in Setup, then the API module needs to be added via tenant settings.

 

 

​

Add Real Estate Settings

  • Go to Setup>Integrations>Real Estate Settings

  • Select to “Enable Sync” and set Go Live to yesterday

  • Supra FTP Site = Test

  • Supra Password = Test

  • Lockbox Member Level

    • Agent Id

      • NRDS Id - if selected, this means that ALL of their Agents have the NRDS Id as their Agent Id and we will pull from that field to send to Supra, no need to add the id. If this is true for all but one, then Custom needs to be selected instead.

      • MLS Id - if selected, this means that ALL of their Agents have the MLS Id as their Agent Id and we will pull from that field to send to Supra, no need to add the id. If this is true for all but one, then Custom needs to be selected instead.

      • Custom - this allows for a free text field to accommodate any type of format

    • Office Id

      • NRDS Id - if selected, this means that ALL of their Offices have the NRDS Id as their Agent Id and we will pull from that field to send to Supra, no need to add the id. If this is true for all but one, then Custom needs to be selected instead.

      • MLS Id - if selected, this means that ALL of their Offices have the MLS Id as their Agent Id and we will pull from that field to send to Supra, no need to add the id. If this is true for all but one, then Custom needs to be selected instead.

      • Custom - this allows for a free text field to accommodate any type of format

Ensure tenant settings were received in IIT| Staging https://realestate.growthzonepreview.com/

  • Go to Message Types>GZ Tenant Settings>Find tenant

 

 

Force Kafka:

Go to Setup>GrowthZone Staff Only Tools>Kafka Utilities>Force Changed Contact Kafka

 

Retrieve Agent & Office files:

Once the records have finished processing ( can take up to 90 minutes) the Agent & Office .txt files can be retrieved.

  • Option 1: Go to Setup>Event Log and select the last Agent & Office file to download

    • If no record of the file is there, then use Option 2 as there could be a delay of recording the file in the Event Log

  • Option 2: Go to IIT>Subscribers>Supra>Office/Agent>select your tenant and the option to download https://realestate.growthzonepreview.com/

 

Send files to suprafieldengineering@carrier.com for review. They will do comparisons and provide any feedback. Once approved, Supra will provide the FTP site username and password for Go Live. GrowthZone will provide an Agent and Office file back to Supra so that they can validate that the data was imported into GrowthZone correctly.

 

Turn off Sync - after testing is completed, turn off the sync by going to Setup>Integrations>Real Estate Settings>remove sync checkbox & save

 

GO LIVE:

 

Coordinate go live with Supra and they will provide the final set of files used for Production (Email suprafieldengineering@carrier.com)

 

Setup:

  • Double check the API Key Permissions for GrowthZone Real Estate is assigned: Setup>Applications>API Key Permissions

  • Go to Setup>Integrations>Real Estate Settings and check the “Enable Sync” box and set the Go Live date & time. Remember to set the time for at least 2hrs from the time you are completing this to allow for all contacts to get to IIT. For example, if it is 8:00 AM set the go live time to 10:00 AM.

    • Supra - FTP Site Setup User Name = provided by Supra

    • Supra - FTP Site Setup Password = provided by Supra

    • Member Level (Agent Id) = set to what was defined during testing

    • Office Source = set to what was defined during testing

    • Listing Agent Source - Supra ONLY = set to what was defined during testing

    • Lockbox Office Level (Office Id) = set to what was defined during testing

  • Save

  • Go to Setup>GrowthZone Staff Only Tools>KafkaUtilities>Force Changed Contact Kafka

 

Troubleshooting Tips & Tricks

  • Files Not Received: In IIT if the files are showing up with an error with a message Rebex.Net.SftpException: A supplied password or user name is incorrect. ---> Have Supra verify they don't have the login set to reset password upon first login. 

     

 

Related articles