Skip to content

Commit a5dd8e5

Browse files
Stacyrch140Stacyrch140
authored
Merge pull request #306925 from Clare-Zheng82/1013-Update_Quickbook_v2_table_name
[Doc update] Update Quickbooks v2 status and name format
2 parents 3d0f393 + a5b83b2 commit a5dd8e5

1 file changed

Lines changed: 131 additions & 6 deletions

File tree

‎articles/data-factory/connector-quickbooks.md‎

Lines changed: 131 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: jianleishen
66
ms.author: jianleishen
77
ms.subservice: data-movement
88
ms.topic: conceptual
9-
ms.date: 09/12/2025
9+
ms.date: 10/14/2025
1010
ms.custom:
1111
- synapse
1212
- sfi-image-nochange
@@ -18,7 +18,8 @@ ms.custom:
1818

1919
This article outlines how to use the copy activity in an Azure Data Factory or Azure Synapse Analytics pipeline to copy data from QuickBooks Online. It builds on the [overview article about the copy activity](copy-activity-overview.md).
2020

21-
This article also describes how to upgrade the QuickBooks connector from version 1.0 to 2.0. Version 2.0 provides improved native QuickBooks support.
21+
> [!IMPORTANT]
22+
> The QuickBooks connector version 1.0 is at [removal stage](connector-release-stages-and-timelines.md). You are recommended to [upgrade the QuickBooks connector](#quickbooks-connector-lifecycle-and-upgrade) from version 1.0 to 2.0.
2223
2324
## Supported capabilities
2425

@@ -170,7 +171,7 @@ To copy data from QuickBooks Online, set the `type` property of the dataset to `
170171
| Property | Description | Required |
171172
|:--- |:--- |:--- |
172173
| `type` | The type of the dataset. It must be set to `QuickBooksObject`. | Yes |
173-
| `tableName` | Name of the table. | No (if `query` in the activity source is specified) |
174+
| `tableName` | Name of the table.| No (if `query` in the activity source is specified) |
174175

175176
Here's an example:
176177

@@ -189,6 +190,129 @@ Here's an example:
189190
}
190191
```
191192

193+
The connector version 2.0 supports the following QuickBooks tables:
194+
195+
- Account
196+
- Attachable
197+
- Attachable_AttachableRef
198+
- Attachable_AttachableRef_CustomField
199+
- Bill
200+
- BillPayment_Line
201+
- BillPayment_Line_LinkedTxn
202+
- Bill_Account_Based_Expense_Line
203+
- Bill_Item_Based_Expense_Line
204+
- Bill_LinkedTxn
205+
- Bill_Payment
206+
- Bill_TxnTaxDetail_TaxLine
207+
- Budget
208+
- Budget_Detail
209+
- Class
210+
- CompanyCurrency_CustomField
211+
- CompanyInfo_NameValue
212+
- Company_Currency
213+
- Company_Info
214+
- CreditCardPayment
215+
- CreditMemo_CustomField
216+
- CreditMemo_Description_Line
217+
- CreditMemo_Discount_Line
218+
- CreditMemo_Group_Individual_Item_Line
219+
- CreditMemo_Group_Item_Line
220+
- CreditMemo_Sales_Item_Line
221+
- CreditMemo_Subtotal_Line
222+
- CreditMemo_TxnTaxDetail_TaxLine
223+
- Credit_Memo
224+
- Customer
225+
- CustomerType
226+
- Department
227+
- Deposit
228+
- Deposit_CustomField
229+
- Deposit_Line
230+
- Deposit_Line_CustomField
231+
- Deposit_Linked_Transaction_Detail
232+
- Deposit_Linked_Transaction_Line
233+
- Deposit_TxnTaxDetail_TaxLine
234+
- Employee
235+
- Estimate
236+
- Estimate_CustomField
237+
- Estimate_Description_Line
238+
- Estimate_Discount_Line
239+
- Estimate_Group_Individual_Item_Line
240+
- Estimate_Group_Item_Line
241+
- Estimate_LinkedTxn
242+
- Estimate_Sales_Item_Line
243+
- Estimate_Subtotal_Line
244+
- Estimate_TxnTaxDetail_TaxLine
245+
- Invoice
246+
- Invoice_CustomField
247+
- Invoice_Description_Line
248+
- Invoice_Discount_Line
249+
- Invoice_Group_Individual_Item_Line
250+
- Invoice_Group_Item_Line
251+
- Invoice_LinkedTxn
252+
- Invoice_Sales_Item_Line
253+
- Invoice_Subtotal_Line
254+
- Invoice_TxnTaxDetail_TaxLine
255+
- Item
256+
- JournalCode_CustomField
257+
- JournalEntry_Description_Line
258+
- JournalEntry_Line
259+
- JournalEntry_TxnTaxDetail_TaxLine
260+
- Journal_Code
261+
- Journal_Entry
262+
- Payment
263+
- Payment_Line
264+
- Payment_Line_LinkedTxn
265+
- Payment_Method
266+
- Preferences
267+
- Preferences_SalesFormsPrefs_CustomField
268+
- Preferences_OtherPrefs_NameValue
269+
- Preferences_VendorAndPurchasesPrefs_POCustomField
270+
- Purchase
271+
- Purchase_Account_Based_Expense_Line
272+
- Purchase_Item_Based_Expense_Line
273+
- Purchase_TxnTaxDetail_TaxLine
274+
- Purchase_Order
275+
- PurchaseOrder_CustomField
276+
- PurchaseOrder_Account_Based_Expense_Line
277+
- PurchaseOrder_Item_Based_Expense_Line
278+
- PurchaseOrder_LinkedTxn
279+
- PurchaseOrder_TxnTaxDetail_TaxLine
280+
- RecurringTransaction
281+
- RecurringTransactionLines
282+
- RefundReceipt_CustomField
283+
- RefundReceipt_Description_Line
284+
- RefundReceipt_Discount_Line
285+
- RefundReceipt_Group_Individual_Item_Line
286+
- RefundReceipt_Group_Item_Line
287+
- RefundReceipt_Sales_Item_Line
288+
- RefundReceipt_Subtotal_Line
289+
- RefundReceipt_TxnTaxDetail_TaxLine
290+
- Refund_Receipt
291+
- ReimburseCharge
292+
- ReimburseCharge_Line
293+
- SalesReceipt_CustomField
294+
- SalesReceipt_Description_Line
295+
- SalesReceipt_Discount_Line
296+
- SalesReceipt_Group_Individual_Item_Line
297+
- SalesReceipt_Group_Item_Line
298+
- SalesReceipt_Sales_Item_Line
299+
- SalesReceipt_Subtotal_Line
300+
- SalesReceipt_TxnTaxDetail_TaxLine
301+
- Sales_Receipt
302+
- TaxClassification
303+
- TaxCode_PurchaseTaxRateList_TaxRateDetail
304+
- TaxCode_SalesTaxRateList_TaxRateDetail
305+
- Tax_Agency
306+
- Tax_Code
307+
- Tax_Rate
308+
- Term
309+
- Time_Activity
310+
- Transfer
311+
- Vendor
312+
- VendorCredit_Account_Based_Expense_Line
313+
- VendorCredit_Item_Based_Expense_Line
314+
- Vendor_Credit
315+
192316
## Copy activity properties
193317

194318
For a full list of sections and properties available for defining activities, see [Pipelines and activities in Azure Data Factory and Azure Synapse Analytics](concepts-pipelines-activities.md). This section provides a list of properties that the QuickBooks source supports.
@@ -200,7 +324,7 @@ To copy data from QuickBooks Online, set the source type in the copy activity to
200324
| Property | Description | Required |
201325
|:--- |:--- |:--- |
202326
| `type` | The type of the copy activity source. It must be set to `QuickBooksSource`. | Yes |
203-
| `query` | Use the custom SQL query to read data. <br><br>For version 2.0 of the QuickBooks connector, you can use only the QuickBooks native query, with limitations. For more information, see [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) on the Intuit Developer site. The `tableName` value specified in the query must match the `tableName` value in the dataset. <br><br>For version 1.0 of the QuickBooks connector, you can use the SQL-92 query. For example: `"SELECT * FROM "Bill" WHERE Id = '123'"`. | No (if `tableName` in the dataset is specified) |
327+
| `query` | Use the custom SQL query to read data. <br><br>For version 2.0 of the QuickBooks connector, you can use only the QuickBooks native query, with limitations. For more information, see [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) on the Intuit Developer site. <br><br>For version 1.0 of the QuickBooks connector, you can use the SQL-92 query. For example: `"SELECT * FROM "Bill" WHERE Id = '123'"`. | No (if `tableName` in the dataset is specified) |
204328

205329
Here's an example:
206330

@@ -265,8 +389,8 @@ The following table summarizes information about the versions of the QuickBooks
265389

266390
| Version | Release stage | Change log |
267391
| :----------- | :------- |:------- |
268-
| 1.0 | End of support announced | Not applicable. |
269-
| 2.0 | General availability |QuickBooks native query is supported, with limitations. `GROUP BY` clauses, `JOIN` clauses, and aggregate functions (`Avg`, `Max`, `Sum`) aren't supported. For more information, see [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) on the Intuit Developer site. <br><br>The `tableName` value specified in the query must match the `tableName` value in the dataset. <br><br>The SQL-92 query is not supported. <br><br>The `useEncryptedEndpoints` property is not supported. |
392+
| 1.0 | Removed | Not applicable. |
393+
| 2.0 | General availability |QuickBooks native query is supported, with limitations. `GROUP BY` clauses, `JOIN` clauses, and aggregate functions (`Avg`, `Max`, `Sum`) aren't supported. For more information, see [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) on the Intuit Developer site. <br><br>The SQL-92 query is not supported. <br><br>The `useEncryptedEndpoints` property is not supported. <br><br>Support specific Quickbooks tables. For the supported table list, go to [Dataset properties](#dataset-properties). |
270394

271395
### Upgrade the Quickbooks connector from version 1.0 to version 2.0
272396

@@ -277,6 +401,7 @@ The following table summarizes information about the versions of the QuickBooks
277401
1. On the **Edit linked service** pane, select **2.0** for the version. For more information, see the [linked service properties for version 2.0](#version-20) earlier in this article.
278402

279403
1. If you use a SQL query in the copy activity source or the lookup activity that refers to the version 1.0 linked service, you need to convert it to the QuickBooks native query. Learn more about the native query from [Copy activity properties](#copy-activity-properties) earlier in this article and from [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) on the Intuit Developer site.
404+
1. Note that version 2.0 supports specific Quickbooks tables. For the supported table list, go to [Dataset properties](#dataset-properties).
280405

281406
## Related content
282407

0 commit comments

Comments
 (0)