iFranchise Reporting API
iFranchise API Reporting
First time reporting to iFranchise? Please check this article before proceeding.
We are pleased to offer the new Loft47>iFranchise reporting functionality, which will further streamline your workflow and eliminate data entry! Once the functionality has been turned on for your brokerage, head to Integrations>iFranchise. Set the filters for the month you are reporting for, select the Office, and click Search Deals. You can click Upload all deals, or upload a specific deal.
We are pleased to offer the new Loft47>iFranchise reporting functionality, which will further streamline your workflow and eliminate data entry! Once the functionality has been turned on for your brokerage, head to Integrations>iFranchise. Set the filters for the month you are reporting for, select the Office, and click Search Deals. You can click Upload all deals, or upload a specific deal.
Once you have uploaded deals, you will see a Success status, or a Failed status
If you received a Failed status for any deal, it will likely be related to one of the following iFranchise imposed requirements.
REQUIREMENTS
iFranchise data rules for deal upload
- Street address, City, State, and Country must be present and google maps
- Addresses cannot be in CAPITAL letters
- Sale price required (even if it is 0, enter 0 - do not leave it blank)
- Firm & Close dates must be entered
- Firm date must be before the Agent Paid / Transacted Date
- Property Management / Lease or Referral, you must 0 out the allocation ends
- Deal Status must be Closed status
IFRANCHISE CONTACT
For any other questions related to uploading deals to iFranchise, please have your region contact GryphTech:
Lisa Clark
Manager of Accounts
GryphTech
+1 905 815 7790 (Mobile & WhatsApp) | SKYPE: lisalawclark | lclark@gryphtech.com
Known errors & their meanings
Error Code | What it means | How to fix |
{"transaction"=>["Commission Row - 1 Errors: - RMXAgentID XXXXXXX does not match Office Number XXX"]} | 1. You haven't updated your Agent's ID or 2. An inactive agent was paid on a deal and that agent needs to be added back into your iFranchise regional roster. | Ask your regional rep to add back any inactive agents so you can upload this deal or add the deal manually in your iFranchise reporting. |
{"transaction"=>["Transaction, Agent Double Ender and Office Double Ender cannot be part of the same Transaction"]} | Multiple Agents are on 1 deal but belong to different reporting offices. | Report this to your regional rep - they need to change a setting on their side to allow agents to report in the office the transaction is created under. This setting is available for the regional admins in iFranchise. |
| {"transaction.Buyers[2].BuyerFirstName"=>["The field BuyerFirstName must be a string with a maximum length of 50."]} The request is invalid.: {"transaction.Sellers[0].SellerFirstName"=>["The field SellerFirstName must be a string with a maximum length of 50."]} | First & Last name contact fields have been limited to 50 characters. | Either report this to your regional rep & request a change to this limitation, or edit the data to fit the rule. |
{"transaction.Sellers[3].SellerSequenceNumber"=>["The field SellerSequenceNumber must be between 1 and 3."], "transaction.Sellers[4].SellerSequenceNumber"=>["The field SellerSequenceNumber must be between 1 and 3."], "transaction.Sellers[5].SellerSequenceNumber"=>["The field SellerSequenceNumber must be between 1 and 3."]} | The number of Buyers and Sellers have been limited to 3 for each side. | Either report this to your regional rep & request a change to this limitation, or edit the data to fit the rule. |
{“transaction”=>[“LeadSource has an invalid value”]} | Source of business contact does not match the set the predefined lead source list in iFranchise reporting. | Either report this to your regional rep & request a change to this limitation, or edit the data to fit the rule. |
{"transaction"=>["Commission Row - 2 Errors: - When CommissionType is Office Double Ender, Side cannot have a value of Both"]} | Deals with this error have 2 agents from the same office on the deal but one is double ending and the other is a referral. | Report this to your regional rep, they may have advice. |
Deal address is not valid for iFranchise | Addresses have to match google map address coded by Gryphtech and can NOT be in all caps. If your addresses are in all caps, they need to be changed to Title case. Extra spaces between words, after commas, etc also causes this error, please check and remove any extra spaces. If you get additional errors after the change, please contact your regional rep regarding this. | Either report this to your regional rep & request a change to this limitation, or edit the data to fit the rule. |
undefined method `titleize' for nil:NilClass | The deal has no address or is missing part of the address in detail's page | Make sure the address is fully entered |
| The request is invalid.: {“transaction”=>[“The IntegratorID 1XXXXX is not allowed to report transactions for Office XXXX"]} | Gryphtec must enable each new office ID | Report this to your regional rep, ask the regional rep to contact iFranchise software company Gryphtec to add your office to iFranchise reporting |
“The sum of Listing/Selling Sides should be 1 instead of 2.0” | Unknown | Report this to your regional rep, ask the regional rep to contact iFranchise software company Gryphtec regarding this error. |
Related Articles
iFranchise - 1st time set up
iFranchise API Reporting Welcome! Any new iFranchise brokerage joining Loft47 first must reach out to their regional reporting rep to ensure their region will allow API reporting to iFranchise. The iFranchise regional representative has to ...Franchise reporting for RE/MAX LLC Brokerages
Before creating your Franchise upload, ensure each Agent & selling Broker has their RE/MAX Master ID entered in their profile's Internal ID field. Also confirm your brokerage's RE/MAX Office ID has been entered into the Office profile (external ID ...Reporting in Loft
All reporting is filter based, so each report can be generated for any date range, can be based on Closed or Pending transactions, can be based on Agent, Teams, Offices or across the Brokerage as a whole. This list is not exhaustive of the reporting ...How Loft works with SkySlope
How Loft works with SkySlope Setting up SkySlope The SkySlope integration will save you time by eliminating the need for duplicate data entry. Here are the step-by-step instructions, as well as this video. To set up the integration, ensure you are a ...Agent & Outside Brokerage auditing for tax reporting
Scouring through your Brokerage's people's page to check each agent, their organization, and Outside Brokerage profile(s) are up to date can be daunting. The easiest way is to head to Reports> Tax Returns Report, choose the year you're reporting ...