Connect an accounting provider
Zenoti posts sales, payments, customers, items, taxes, and inventory documents to your accounting system through the Accounting accordion on the Integration settings page. This article covers choosing the provider, entering the account details, authorizing the connection, and the initial pull of master data. Mapping and schedules have their own articles.
On this page
- Before you begin
- Supported providers
- Panels on the Accounting accordion
- Choose the provider
- Enter the account details
- Authorize the connection
- Pull master data for the first time
- Reset or delete the integration
- What to configure next
- Failure path (connection)
- Related articles
Before you begin
Permission: You need organization administrator access in Zenoti. You also need administrator access to the accounting system during the authorization step.
- Only one accounting provider is configured per organization. Changing providers means resetting the integration, which removes every mapping.
- Finalize the chart of accounts, tax rates, payment accounts, locations, and vendors in the accounting system first. Zenoti maps to records that already exist there; it does not create them.
- Decide the sync start date. Zenoti ignores transactions dated before it.
- Keep the provider's API or sandbox credentials at hand where the provider requires them.
Supported providers
The Provider panel opens with Select Your Accounting Platform and shows one logo tile per available provider. Where both routes are available, Select Your Middle Ware lets you choose between the direct connection and the Codat middleware, and the tiles change with the choice.
| Provider | Connection | Notes |
|---|---|---|
| Xero | Direct or through Codat | Cloud. |
| QuickBooks Online | Direct or through Codat | Cloud. |
| NetSuite | Direct or through Codat | Direct connections use token-based authentication (client and access token pairs plus the NetSuite account number and role). |
| QuickBooks Desktop | Direct | Desktop edition of QuickBooks. |
| Manual | Through Codat | No live posting. Zenoti prepares sales, refunds, and journal entries for export. |
Panels on the Accounting accordion
Expand Accounting on the Integration settings page to see these panels. Each opens with a plus icon.
| Panel | What it holds |
|---|---|
| Provider | Provider tiles and the Continue button. Until a provider is chosen, the other panels show the message Error! Choose a provider. with a Choose provider link. |
| Configuration | The account section and the posting options for the chosen provider. |
| Authorize | The Authorize button that connects Zenoti to the provider account. |
| Manual Sync | One-off pulls and pushes of master data and transactions. |
| Locations | Center-to-location mapping. |
| Fields | Custom field mapping. |
| Payments Mapping | Payment type and item-type account mapping. |
| Tax Rates Mapping | Zenoti tax groups mapped to provider tax rates. |
| Supplier Mapping | Zenoti vendors mapped to provider suppliers. |
| Sync Schedule | The scheduled jobs that move data automatically. |
Choose the provider
- Navigate to Configuration > Integrations > Integration settings and expand Accounting.
- Open Provider.
- Select the tile for your accounting system.
- Select Continue. The Configuration panel opens for that provider.
Enter the account details
In Configuration, complete the account section.
Field What to enter Account Id (required) The identifier of your account in the accounting system. For NetSuite this is the account number; a sandbox account carries a suffix such as _SB1.Account Name A display name for the connection. Use Live Key Turn on to post to the production account rather than the provider's sandbox. For NetSuite direct connections, also enter Client Id, Client Secret, Access Token, Access Token Secret, Account Number In Provider, and Role In Provider. Generate the token pair in NetSuite for an integration record and role that can create and read the record types Zenoti posts.
Review the posting options below the account section. Under
INVOICE, Financials posts invoices Invoice Wise or Day Wise; Customer posts each invoice against the Invoice Guest or a Default customer; Multi Location turns on per-center location posting; Enable Journals / Post Journal Entries, Post Departments, Post Classes, and Enable Accounting V2 choose the posting model; the default-item fields name the items that receive liabilities, redemptions, discounts, fees, and taxes. The available options depend on the provider. Leave the defaults unless your finance team asks for a specific posting model.Select Save. Zenoti confirms with
Configuration Saved Successfully.
Some options are only offered in the advanced view of the panel. Select Advanced Configuration to show them.
Authorize the connection
- Open Authorize.
- Select Authorize. Zenoti opens the provider's sign-in and consent flow.
- Sign in with a provider user that administers the company file or organization, and grant access.
- Return to Zenoti. The panel shows that the company is authorized.
Zenoti can also produce an authorization link with Copy link to authorize so that the person who holds the provider credentials can complete the consent step from their own browser. Once the company is authorized the panel shows Is Authorized and offers Re-Authorize and De-Authorize; de-authorizing keeps the configuration but stops posting until you authorize again (Successfully De-authorized the company).
Pull master data for the first time
The Manual Sync panel starts with a note that these actions must be done at the time of the initial integration, and that once sync schedules are set up there is no need to run them manually.
- Open Manual Sync.
- Select Get on each master-data row in order: Locations, Accounts, Payment Methods, Customers, Taxes, All Items (or Products and Services), Suppliers / All Vendors, and Journals. The rows shown depend on the provider.
- For rows that push transactions to the provider (Sales and Refunds, Payments, Miscellaneous Journal Entries, Purchase Orders, Transfer Orders, Inventory Adjustments), pick a date in Choose a date and select Post. Use this only for the initial catch-up; scheduled jobs take over afterwards. The Manual provider offers Export instead, producing Excel or CSV for a chosen period.
Each row reports Success or a failure message when it finishes.
Reset or delete the integration
Use Reset Configuration to start over, or Delete Configuration to remove the integration. Before resetting, Zenoti lists what happens:
- Removes current configuration and provider mappings.
- Disables the sync jobs for items, guests, locations.
- Disables data push from Zenoti for the provider for all pending syncs.
- Disables reports and marks past data (that got synchronized or pending to be synchronized) as Archived in reports.
- Deletes the connection with the accounting application, this change is irreversible.
Select Proceed to confirm or Cancel to keep the integration.
What to configure next
- Configure accounting data mapping — map locations, payment types, items, tax rates, and suppliers before turning on jobs.
- Configure accounting sync schedules — add and schedule the posting jobs.
- Configure Xero VAT mapping — for Xero organizations in VAT regions.
- Sync financial data with accounting providers — run and monitor the first posting cycle.
Failure path (connection)
| Symptom | Cause | Resolution |
|---|---|---|
Error! Choose a provider. shows in every panel |
No provider tile has been chosen. | Open Provider, select a tile, and select Continue. |
Your <provider> credentials are invalid or not configured. |
The account details are wrong, or the connection has not been authorized. | Correct the fields in Configuration, select Save, then run Authorize again. |
Please ensure that your credentials are saved. when authorizing |
Save was not selected after entering the account details. | Select Save in Configuration first. |
| Provider consent succeeds but posting fails with an authorization error | The provider token expired or was revoked. | Open Authorize and select Re-Authorize. |
| Wrong company or organization connected | Consent was granted for a different provider tenant. | Select De-Authorize in Authorize, then Authorize again choosing the correct company. |
Items/COA cannot be reset with read access support login |
The reset was attempted from a read-only support session. | Ask an organization administrator to run the reset. |