ZenotiHelp

Connect an accounting provider

ZTZenoti Docs Team Updated September 3, 2026 6 min readGuide

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

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

  1. Navigate to Configuration > Integrations > Integration settings and expand Accounting.
  2. Open Provider.
  3. Select the tile for your accounting system.
  4. Select Continue. The Configuration panel opens for that provider.

Enter the account details

  1. 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.
  2. 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.

  3. 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.

  4. 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

  1. Open Authorize.
  2. Select Authorize. Zenoti opens the provider's sign-in and consent flow.
  3. Sign in with a provider user that administers the company file or organization, and grant access.
  4. 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.

  1. Open Manual Sync.
  2. 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.
  3. 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


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.

Was this article helpful?
Your feedback helps us improve our documentation.