QuickBooks Online Contact Mapping

QuickBooks Online Contact Mapping

When any transaction is posted we will look at profiles and the contact associated with a transaction and look for an existing QuickBooks Online Contact.  When the Contact does not exist in QuickBooks the contact is automatically created and then an internal connection is made between the Loft Profile and the QuickBooks Online Contact.

During our synchronization and before an entire batch of transactions get posted we pull every contact from QuickBooks Online, updating existing contacts and creating new ones.  When this happens the agents AP and AR balance in Loft is also synchronized. After we pull every contact we look for every QuickBooks Online contact that is not Linked with a Loft Profile and try to link them based on the following best match:

When the email is exactly the same we match them and create a link tom@exmaple.com = tom@example.com
When the name is contained in the other and matches 60% of the length we match them and create a link

Loft then looks for any changes in Loft that are different between QuickBooks Online contacts and Loft contacts (name, email, addresses) and pushes those changes to QuickBooks Online as an update to the contact record.

When an Agent is paid to their Organization

If an Agent is paid to an Organization Loft will post all bills and credit notes to the Organization name. The invoicing in QuickBooks Online will also be in the Organizations name as in order to allocate credit notes, the billing or invoices name needs to match the name posted from Loft. As a result we’ve created the following rule: 

Agent and Organization Syncing Rule

If the Agent is paid to the Organization Loft will sync the AR balance of the Organization in QuickBooks Online to the Agents profile in Loft. Unless the Organization profile has No ($0) AR Balance,  in that case Loft will pull in any balance that the Agent has in Accounts Receivable. 

Please note that if you remove the Agent in QuickBooks Online the Agent profile will not have a QuickBooks Online Contacts link so it's ok that this field is empty.
The Organization should show the Linked QuickBooks Online contact as the Organization in QuickBooks Online. 

Contact Setup in QuickBooks Online

Please note all batchable profiles in Loft when synced to QuickBooks Online will create 2 instances of a contact, a Vendor contact (this contact is what bills will be created with) and a Customer contact (this contact is what invoices will be created with).  These two contacts are separate and defined as following: 
Vendors will appear as your contact normally
Customers will have an asterisks prefix

Example: 
Siobhan O'Leary will appear as follows:
Vendor: Siobhan O'Leary
Customer: *Siobhan O'Leary

Contact Linking

If your AR is not coming through, you may have to relink your profile across the two apps. You can use this QuickBooks Online Contacts field to manually associate the profile in Loft to QuickBooks Online if necessary however we don’t advise it without first checking with us.

Contact Unlinking

In the event, you may have to reset your link to a profile in QuickBooks Online, you can click unlink, sync the 2 apps in Integrations>QuickBooks Online>Activity, and then relink the contact as shown in the step above. Please note, both contacts should be displayed in the link as shown below, if this is not the case, you're either missing the Customer (asterisked contact) or the Vendor.  If that's the case, follow the above step to unlink, then head over to QuickBooks Online, create the missing contact, sync QuickBooks Online, and relink the contact.

Quickbook Contact Mapping

How Contact mapping across the two apps look.


    • Related Articles

    • QuickBooks Online Settings & Mapping

      In this article we will outline Xero's API Settings & Mapping in Loft. Front End Mapping You’ll notice that you now can see back end mapping has been brought to your front end in QuickBooks Online>Settings page under your Integration menu. *mapping ...
    • Xero to QuickBooks Online Integration migration - Task list

      In this article, we'll go over the steps required from you, the client, to ensure a smooth migration of Xero>QuickBooks Online Important - Please read before you proceed! Because Xero will be removed as your accounting integration in Loft, that ...
    • What journal entries does Loft post to QuickBooks Online?

      Processing transactions through Loft automatically generates the accounting entries in QuickBooks Online. The following descriptions show you the results of Loft activities in your accounting records. Deposits When you post a deposit as a receipt in ...
    • Xero VS QuickBooks Online Integration

      Differences between Xero & QuickBooks Online integrations with Loft47. Pricing Pricing in Canadian $ & USD $ Xero's cost for the standard version required to integrate with Loft is around $48/monthly (they change their prices, so visit www.xero.com ...
    • Merge Contacts

      Merging Contacts PLEASE READ & WATCH THE VIDEOS OF THIS ARTICLE THOROUGHLY! We’ve opened up the ability to merge contacts for everyone using Loft. However, there are a few things we need to mention before you start to merge your contacts. Firstly, ...