How Do I Set Up and Use the Qonto Integration?

The Qonto integration connects Tribe CRM with Qonto, a business finance platform widely used by European small and medium-sized businesses. It automatically synchronises customer records and invoices between both systems, removing the need to enter data manually in two places. If your team uses Qonto for payments and invoicing alongside Tribe for customer relationship management, this integration keeps both tools aligned in real time. By following this guide, you will learn how to activate the integration, configure it correctly, and understand how data flows between Tribe and Qonto.

Table of Contents

What Does the Qonto Integration Do?
Prerequisites
How Do I Set Up the Qonto Integration
How Does Synchronisation Work?
What Data Is Synchronised?
Tips and Best Practices
Troubleshooting

What Does the Qonto Integration Do?

The Qonto integration creates a two-way data connection between Tribe CRM and Qonto. Customer records created or updated in Tribe are pushed to Qonto, and invoices created in Qonto are pulled into Tribe automatically. Payment status changes and credit notes from Qonto are also reflected in Tribe, so your CRM always holds an accurate picture of your billing activity.

Once set up, the integration handles the following:

Relationship synchronisation
Invoice synchronisation

Did you know? Credit notes created in Qonto are automatically reflected in Tribe as a negative invoice linked to the original. No manual action is required.

Did you know? Invoices created through the Qonto integration are compliant, giving you confidence that your billing data meets the necessary standards.

Prerequisites

Before activating the Qonto integration, ensure the following conditions are met:

An active Qonto account. The integration supports existing Qonto customers only. Creating a new Qonto account is outside the scope of this integration.
Customer relation types. Only records set to the Customer or Private Customer relation type can be synchronised. Other relation types will be skipped.
Debtor number. Each customer record must have a debtor number assigned. Invoices cannot sync without one.
VAT groups. VAT codes are matched automatically by percentage and country code. If no matching VAT group exists in Tribe, invoice sync will fail with an error message.
Units. Units used in invoices must be configured in Tribe and mapped to their Qonto equivalents in the connector settings.

Note: Tribe’s Invoice module must be activated to enable invoice syncing.

How Do I Set Up The Qonto Integration?

Install the Integration via the Marketplace.
Activate the integration by clicking “Activate.”
Click on “Log in to Qonto”.
Map Units.
Some units are mapped automatically on first initialisation. Adjust any mappings manually if needed.

Note: The initial sync runs on demand via the Sync button. Subsequent updates happen automatically based on the triggers described in the “How Does Synchronisation Work?” section below.

How Does Synchronisation Work?

Synchronisation between Tribe and Qonto is triggered in several ways, depending on the type of change.

Trigger	Entities Affected	Timing
Connector activation	Customers, Invoices, Credit Notes	On-demand via sync button
Change made in Tribe	Customers, Invoices	Immediate
Webhook from Qonto	Invoices, Payment Status	Near real-time
Background job (pull)	Customers, Credit Notes	Periodic

What Data Is Synchronised?

Person

Qonto	Tribe	Direction
First name + Last name (split)	Firstname	In / Out
First name + Last name (split)	Middelname	In / Out
First name + Last name (split)	Lastname (required)	In / Out
Email	emailAddress	In / Out
Phone number	phoneNumber	In / Out
Locale	Language	In / Out

Person Address

Qonto	Tribe	Direction
Address line 1 (split)	Street	In / Out
Address line 1 (split)	HouseNumber	In / Out
Address line 1 (split)	HouseNumberSuffix	In / Out
Zip code	PostalCode	In / Out
City	City	In / Out
Country	Country	In / Out

Organisation

Qonto	Tribe	Direction
Name	Name (required)	In / Out
Email	emailAddress	In / Out
Phone number	PhoneNumber	In / Out
Locale	Language	In / Out
TaxIdentificationNumber	ChamberOfCommerceNumber	In / Out
Vat number	VatNumber	In / Out

Organisation Postal Address

Qonto	Tribe	Direction
Address line 1 (split)	Street	In / Out
Address line 1 (split)	HouseNumber	In / Out
Address line 1 (split)	HouseNumberSuffix	In / Out
Zip code	PostalCode	In / Out
City	City	In / Out
Country	Country	In / Out

Organisation Invoice Address

Qonto	Tribe	Direction
Address line 1 (split)	Street	In / Out
Address line 1 (split)	HouseNumber	In / Out
Address line 1 (split)	HouseNumberSuffix	In / Out
Zip code	PostalCode	In / Out
City	City	In / Out
Country	Country	In / Out

Invoice

Qonto	Tribe	Direction
Customer	Relationship	In / Out
Invoice number	Number	In / Out
“Invoice_{number}”	Subject	In
Invoice date	Date	In / Out
DueDate - InvoiceDate	PaymentTermInDays	In / Out
Discount	DiscountPercentage	In / Out
Currency	Currency	In / Out

Note Invoice currency in Qonto is determined by the client's currency setting in Qonto. If a client is set to EUR in Qonto, an invoice sent from Tribe in a different currency will be converted to EUR automatically.

Product Lines

Qonto	Tribe	Direction
Title	Description	In / Out
Description	Extra Description	In / Out
Quantity	Quantity	In / Out
Find by name and vat rate	Product.[ExternalID]	In
UnitPrice	SalesPrice	In / Out
Purchase price from product	Product.PurchasePrice	In
Find by vat rate and country	VatGroup	In
LineDiscount	Discount	In / Out

Invoice ← Credit note

Qonto	Tribe	Direction
Customer	Relationship	In
Invoice number	Number	In
“Invoice_{number}”	Subject	In
Invoice date	Date	In
DueDate - InvoiceDate	PaymentTermInDays	In
Discount	DiscountPercentage	In
Currency	Currency	In

Invoice ← Credit note - Product Lines

Qonto	Tribe	Direction
Title	Description	In
Description	Extra Description	In
Quantity	Quantity	In
Find by name and vat rate	Product.[ExternalID]	In
UnitPrice	SalesPrice	In
Purchase price from product	Product.PurchasePrice	In
Find by vat rate and country	VatGroup	In
LineDiscount	Discount	In

Tips and Best Practices

Assign debtor numbers before syncing. Any customer without a debtor number will cause invoice sync to fail. Set debtor numbers on all relevant records before triggering a sync.
Verify VAT groups in advance. Ensure that every VAT rate used in your invoices has a matching VAT group configured in Tribe. Mismatches block invoice synchronisation.
Check relation types. Only Customer and Private Customer relation types are supported. Review your customer records and correct any that use a different type.
Use the navigation button for quick access. Any synced record in Tribe displays a direct link to the corresponding record in Qonto, saving time when switching between tools.

Troubleshooting

Invoice sync fails with an error message

This is most likely caused by a missing or unmatched VAT group. Check that all VAT rates in your invoices correspond to a configured VAT group in Tribe, matched by percentage and country code.

A customer record does not sync

Confirm that the record is set to the Customer or Private Customer relation type. Also verify that a debtor number has been assigned. Both conditions must be met for synchronisation to proceed.

Credit notes are not appearing in Tribe

Credit notes are pulled in periodically by a background job. If a credit note is missing, wait for the next scheduled pull.

Invoice currency is incorrect

Invoice currency in Qonto is inherited from the client's currency setting in Qonto. If the currency shown in Tribe differs from what you expect, verify the client's currency setting directly in Qonto.

Quick Summary

The Qonto integration automates the flow of customer and invoice data between Tribe CRM and Qonto, removing the need for manual data entry across both systems. Once activated and configured, synchronisation runs automatically in real time or near real time, with a periodic pull in the background on customers and credit notes. Ensuring that debtor numbers, VAT groups, units, and relation types are correctly set up before activation will allow the integration to run smoothly.