# Connect to HelpYouSponsor

#### **1. Accessing the Integration**

* Go to the main menu and click **Settings → Integrations**.
* Locate the **QuickBooks** card.<br>

  <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FdTdUJ4YGN4ajsFXiXUQS%2Fimage.png?alt=media&#x26;token=caede233-f128-48de-b318-9c254b9bd57c" alt=""><figcaption></figcaption></figure>

Click **Sign in to QuickBooks** to begin the connection process.

***

#### **2. Authorizing QuickBooks**

After clicking **Sign in to QuickBooks, a** right-side drawer will open.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FwjxKo3UtzaIfNgYHRnKv%2Funknown.png?alt=media&#x26;token=0d2916e8-8e04-4a85-a87d-4924544e3657" alt=""><figcaption></figcaption></figure>

This drawer lists all your **Programs** in HelpYouSponsor. Each program can later be mapped to QuickBooks Online (QBO) fields so data syncs smoothly between the two systems.

Click **Authorize QuickBooks** to begin onboarding.

You’ll then:

1. Be redirected to QuickBooks Online.
2. Choose the **company** you want to link to HelpYouSponsor.

   <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2Fx7ITsPXM6ws5tG40GWqw%2Funknown.png?alt=media&#x26;token=6f783350-0520-49db-8fc5-7eb278ba7301" alt=""><figcaption></figcaption></figure>
3. Confirm your selection.
4. After connecting, you’ll return to the **Integrations** page.

The **QuickBooks card** will now be toggled **ON**, confirming a successful connection.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F9IK5YfPUgy4XPjt5v8HV%2Funknown.png?alt=media&#x26;token=1cc75814-a77f-451a-b7d8-7b1aef0f8073" alt=""><figcaption></figcaption></figure>

***

### **Field Mappings**

HelpYouSponsor supports mappings for **Customers** and **Items**.

#### **1. Mapping Customers**

1. In the right-side drawer, select the **Program** whose donor data you want to link to QuickBooks.<br>

   <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F92zBPal0dT6MMYe2TvBm%2Fimage.png?alt=media&#x26;token=7c3f25d0-6663-43bb-be16-95120ebea2ed" alt=""><figcaption></figcaption></figure>
2. Under the **Customer** tab, you’ll see the **Donor Form Fields** for that program.
3. Use the dropdown menus to match each donor field with a corresponding **QuickBooks field**.

   <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FBoJjvKU0Eap9ztNjpGVF%2Funknown.png?alt=media&#x26;token=22434afd-4378-4795-b845-f0835ad91b6c" alt=""><figcaption></figcaption></figure>

***

#### **2. Mapping Service Items**

1. Go to the **Service Item** tab.
2. You’ll see the **Recipient Form Fields** you created.
3. Use the dropdown menus to map these fields with **QuickBooks item fields**.<br>

   <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F510mTnoJqvoFWpNmbojE%2Funknown.png?alt=media&#x26;token=8969ad42-1441-4c17-bf86-248de91d68dc" alt=""><figcaption></figcaption></figure>

***

#### **3. Accounting Settings**

Under the **Accounting** tab, two key elements can be linked:

* **Chart of Accounts** — available from your QuickBooks organization account.

  <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FQdOMFXh3JUkP84SdK1fv%2Funknown.png?alt=media&#x26;token=bbb06049-d2f8-4e55-8ff3-402b5497b399" alt=""><figcaption></figcaption></figure>

  <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FQm376VOnl1s16SWnSen7%2Funknown.png?alt=media&#x26;token=456c7a71-7e79-4d53-972d-ed77e467f6bb" alt=""><figcaption></figcaption></figure>
* **Class** — the class list as configured in your QuickBooks account.

  <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FIEIar6kKL8K80vrhXXRc%2Funknown.png?alt=media&#x26;token=241e4926-a720-4d68-88ab-8b923aec5f7a" alt=""><figcaption></figcaption></figure>

  <figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FD7ZpQJi8hqo9scF79YH9%2Fimage.png?alt=media&#x26;token=28051298-06d1-4614-b0a2-86d7ee8b50c0" alt=""><figcaption></figcaption></figure>

### **Data Sync Behavior**

Once your integration is complete:

* **Newly created donations, customers, and items** will automatically sync to QuickBooks.
* **Data created before integration** will not sync retroactively.

***

### **Error Handling**

If you encounter an error message like the one below:

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FqbUd0R9TaWN5znZVE6Xi%2Funknown.png?alt=media&#x26;token=f953d9b5-362a-4725-9e70-6b3d527897cf" alt=""><figcaption></figcaption></figure>

Don’t worry — this simply means your QuickBooks connection needs to be refreshed.\
Click **Reauthorize** to restore your connection.

In rare cases, if further action is needed, the system will notify you when user intervention is required.
