# QuickBooks Sync

ProForge Core connects to QuickBooks Online (QBO) so you do not have to enter the same data twice. Projects, timesheets, and cost codes sync between the two systems to keep your books accurate without the extra work.

## How It Works

Once connected, ProForge Core can push data to QuickBooks Online and pull data back. This keeps your accounting system up to date with the project activity happening in ProForge Core. You control what syncs and when -- nothing moves without your review.

Here is what syncs:

* **Projects** sync as QBO Customers/Sub-customers or Projects (depending on your QBO setup).
* **Timesheets** -- payroll hours from weekly payroll entries post as time entries in QBO, tagged to the right customer and service item.
* **Cost Codes** map to QBO service items or expense categories so costs land in the right accounts.
* **Vendor Bills** can sync as QBO bills for payment tracking.

## Steps

### Connecting to QuickBooks Online

1. Go to **Settings** and select **QuickBooks Integration**.
2. Click **Connect to QuickBooks**.
3. Sign in to your QuickBooks Online account and authorize the connection.
4. Once connected, you will see a confirmation with your QBO company name.

### Setting Up the Sync Mapping

1. After connecting, go to the **Mapping** tab.
2. Map your **Cost Codes** to the corresponding QBO service items or expense accounts.
3. Review the **Project Mapping** -- choose whether projects sync as QBO customers, sub-customers, or projects.
4. Set your **Timesheet Mapping** preferences (which payroll fields map to which QBO fields).
5. Click **Save Mapping**.

### Running a Sync

1. Go to **QuickBooks Integration** and click **Sync Now**.
2. Review the **Sync Preview** -- it shows what will be created or updated in QBO.
3. Confirm to proceed.
4. After the sync completes, review the **Sync Log** for any errors or warnings.

### Automatic Sync

1. In **QuickBooks Integration**, go to the **Schedule** tab.
2. Enable automatic sync and choose the frequency (daily, weekly, etc.).
3. The system will sync in the background and notify you if anything needs attention.

![qbo integration overview](/files/aGFegL2VHvvGRz9J5AaK)

## Related Pages

* [Weekly Payroll Entry](/project-management/proforge-core/payroll/weekly-payroll-entry.md) -- timesheet data that syncs to QBO
* [Cost Codes](/project-management/proforge-core/setting-up-a-project/cost-codes.md) -- mapped to QBO service items
* [Importing Vendor Bills](/project-management/proforge-core/importing-vendor-bills.md) -- bills can sync to QBO


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.proforgeerp.com/project-management/proforge-core/syncing-with-quickbooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.