This article explains how Qoblex customers and suppliers reach QuickBooks. Unlike the Xero contact import, QuickBooks sync is one-directional (Qoblex → QuickBooks) — there is no “import contacts from QuickBooks” action. Contacts are pushed to QuickBooks automatically as part of syncing the documents that reference them.
Requires the QuickBooks integration to be installed and connected.
When it happens
- A customer is created in QuickBooks when a Qoblex sales document for that customer syncs.
- A supplier is created in QuickBooks as a Vendor when a Qoblex purchase document for that supplier syncs.
How records are matched
For each contact, Qoblex:
- Skips the contact if it already carries an external reference (it is already linked to QuickBooks — or to another accounting integration; see the limitation below).
- Otherwise looks for an existing QuickBooks customer/vendor by name (the Given name — see the mapping). If one is found, it is reused; if not, Qoblex creates it.
- Stores the QuickBooks record’s id as the contact’s reference, so later syncs reuse it instead of creating a duplicate.
Matching is by name, not by email — a QuickBooks customer whose name differs from the Qoblex contact will not match and a new QuickBooks record is created.
Field mapping (Qoblex → QuickBooks)
The mapping below applies to both customers (QuickBooks Customer) and suppliers (QuickBooks Vendor). The fields map the same way, with one difference in the Given name fallback noted in the table.
| Qoblex field | QuickBooks field | Notes |
|---|---|---|
| Contact person | Given name | Used as the match key. If no contact person is set, the company name is used instead. For suppliers, set a contact person or company name so the vendor does not sync without a name (see Troubleshooting). |
| Company name | Company name | |
| Primary email | ||
| Mobile phone | Primary phone | The landline is used when there is no mobile number. |
| (company currency) | Currency | The currency used for the sync. |
| First address | Billing address | The contact’s first address becomes the QuickBooks billing address. |
What you see
When a contact syncs, Qoblex logs a notification — “Customer/Vendor name synced to QuickBooks” — with a link to open the record in QuickBooks. The contact then carries the QuickBooks reference.
Limitation
A contact stores a single external reference. If it was already linked to another accounting integration (for example imported from Xero), QuickBooks sync skips it rather than creating a second link. Use one accounting integration as the system of record for a given contact.
