# QuickBooks Online (QBO)

### Overview

The QuickBooks Online integration pulls sales and invoice data into Moselle, enabling accurate demand forecasting and financial reporting. Once connected, Moselle automatically syncs your QBO transactions and attributes revenue to the correct products.

***

### Connect QuickBooks Online

1. Navigate to **Settings → Integrations**
2. Select the **QuickBooks Online** widget
3. Click **Connect** — you will be redirected to the QuickBooks login page
4. Sign in with your QuickBooks credentials
5. Authorize Moselle to access your account

Once authenticated, Moselle begins syncing your sales and invoice data automatically.

***

### Setting Up QBO Products

For Moselle to track sales accurately, every product you sell must have a corresponding Product entry in QuickBooks Online.

#### Why This Matters

Moselle links QBO Products to your SKUs to attribute revenue correctly. Without proper product setup:

* New SKUs won't be detected
* Sales data may be misattributed
* Reporting and forecasting will be incomplete

When invoices use generic descriptions instead of linked products, Mo attempts to match sales to the correct SKUs. While this works in many cases, it isn't reliable when product names are similar or descriptions are vague.

#### Best Practices

**Create a QBO Product for every SKU**

Each product in your catalog should have a corresponding entry in QuickBooks Online, including:

* Products sold across different channels (DTC, Amazon, wholesale)
* Bundles and kits tracked separately from components
* Retailer-specific products requiring separate tracking

**Use QBO Products on all invoices**

When creating invoices, select the specific Product from your list rather than typing a generic description. This ensures sales are attributed to the correct SKU in Moselle.

**Review unlinked listings regularly**

Check your Moselle dashboard for products that aren't being tracked. Verify that a matching QBO Product exists and is linked correctly.

***

### Troubleshooting

| Issue                        | Cause                                     | Solution                                         |
| ---------------------------- | ----------------------------------------- | ------------------------------------------------ |
| SKU not appearing in Moselle | No QBO Product exists                     | Create the product in QBO and link it in Moselle |
| Sales under wrong product    | Invoice uses generic item                 | Update invoice to use the correct QBO Product    |
| Cannot link multiple SKUs    | Single QBO Product used for multiple SKUs | Create separate QBO Products for each SKU        |