> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.zenskar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QuickBooks

## Setup guide

This guide will help you connect your QuickBooks account with your Zenskar account.

1. Log into your Zenskar account.

<Image align="left" border={true} src="https://files.readme.io/28d06db886178a5fdd26ed63fafb58eaf8022add81a7de06c6cfaf1a7ecdb3de-image.png" className="border" />

2. Click **More** in the main navigation menu and go to **Integrations** → **ERP** → **QuickBooks**.

<Image align="center" border={true} src="https://files.readme.io/440ded8010b2a1ad85fbb37c55d7bcb0b83997d8d0319e7f37254fe2c8b58b66-image.png" className="border" />

<Image align="center" border={true} src="https://files.readme.io/d649d2d37a75b994b06dd79c3f1f7fe566f1e809173a887c854aa9c86294f7e9-image.png" className="border" />

3. Click **Connect To Quickbooks**, then click **Connect**.

<Image align="left" border={true} src="https://files.readme.io/c6133c407e804e6ceecd645ddb13101240a961de1dc031b76b46822c9a4d8ee0-image.png" className="border" />

4. Complete the authentication using your company’s QuickBooks credentials.

<Image align="left" border={true} width="60% " src="https://files.readme.io/79cb278c4b5d3bb3c38b3c9ab7b6f3047ec27e0cd43315a99de9c3e7f792faef-image.png" className="border" />

<Image align="left" border={true} width="60% " src="https://files.readme.io/111598fe80a9741272574eb5f8fded8bb465e074ca7b0dd66147a1b3ad7985c2-image.png" className="border" />

5. Select **Zenskar Entity** and **Data sync setup**.

<Image align="center" border={true} src="https://files.readme.io/ac7f654087147155abcd4aedcf3e3ad3ebdcf85c552219baca8a1a4778aa08f4-image.png" className="border" />

### Object sync:

* **Customers** require the following additional configuration:
  1. Select the **sync direction**. Syncs customer name, email, phone, address, and tax exemption status from Zenskar to QuickBooks. Customers are created as Customer objects in QuickBooks. Zenskar remains the source of truth.

<Image align="left" border={true} src="https://files.readme.io/91c614d4b3bb11e2392cce02a4032a11a1284680835f32ec83674966a9d7d21b-image.png" className="border" />

* **Invoices** require the following additional configuration:
  1. Select the **sync direction**. Exports invoices from Zenskar to QuickBooks with line items, tax details, and due dates. A link back to the Zenskar invoice is included in the private notes field.
  2. Select **Sales Account** for Invoices. The GL account in QuickBooks where invoice line items will be posted. This is the revenue account that gets credited when an invoice is created.
  3. Select **Tax Account** for Invoices. The GL account in QuickBooks where tax amounts from invoices are posted. Tax is applied at the invoice level, not per line item.
  4. Select **Discount Account** for Invoices. The GL account in QuickBooks where invoice discount amounts are recorded. If your invoices include discounts, they are tracked separately in this account. If not configured, discounts fall back to the sales account.

<Image align="center" border={true} src="https://files.readme.io/d916807a74df81ecb9e41e84ed9be2da390f86c2a701bc2d98065e105b28f9ca-image.png" className="border" />

* **Payments** require the following additional configuration:
  1. Enable **Export Payments**. When enabled, payment records from Zenskar are created in QuickBooks and allocated against their corresponding invoices. A single payment can be split across multiple invoices.
  2. Select the required **payment sources**. Select which payment types to sync (e.g., Stripe, manual). Each source maps to a deposit account in QuickBooks where the payment amount is recorded.

<Image align="center" border={true} src="https://files.readme.io/fc7030bb1f9375c14fa7a17a75e37221f12bae39e2467f7232a71524d0a79f7e-image.png" className="border" />

* **Credit Notes** require the following additional configuration:
  1. Select the **sync direction**. Exports credit notes from Zenskar as Credit Memos in QuickBooks. If the original invoice is unpaid, the credit memo is automatically applied against it.
  2. Select the **sales account** for credit notes. The GL account in QuickBooks where credit note amounts are posted. This is typically a revenue reversal or sales returns account

![](https://files.readme.io/e3224e0408ab8c92eb0d24ce81c22d9479d123c16b563d72b5710290360a27ca-image.png)

### Journal entries sync:

* **Customers** require the following additional configuration:
  1. Select the **sync direction**.

<Image align="left" border={true} src="https://files.readme.io/7cfc8847a96d8e79eb4ec6c35bec33d896270c975157bc8067f21ca141d4ac04-image.png" className="border" />

* **Journal Entries** require the following additional configuration:
  1. Select the **sync direction**. Exports double-entry accounting transactions (e.g., revenue recognition, adjustments) from Zenskar to QuickBooks as Journal Entries with debit and credit lines.
  2. **Journal Accounts Mapping**: Maps each Zenskar account (e.g., Accounts Receivable, Revenue, Cash, Tax Withheld) to a corresponding QuickBooks GL account. This ensures journal entry lines post to the correct accounts in your chart of accounts.

<Image align="center" border={true} src="https://files.readme.io/72d7f56dc9060753053593910d95dc5a9e4b668d9a5bc8c6eb5745bb70df7058-image.png" className="border" />

6. Click **Save Configuration** to complete the setup.

<Image align="left" border={true} src="https://files.readme.io/d611e9314477f52ae6a2fff7a169cb9180462cd495ad93a5b9003ae93ac524de-image.png" className="border" />
