v1.2.0 dbt_quickbooks

PR #189 includes the following updates:

Features

• Increases the required dbt version upper limit to v3.0.0

Full Changelog: v1.1.0...v1.2.0

v1.1.1-a2 dbt_quickbooks

PR #188 is a pre-release that includes the following updates:

Bug Fixes

• Introduced the quickbooks__home_currency variable to optimize multicurrency handling. When set transactions in the home currency will not apply exchange rate conversions, improving accuracy and performance. This variable is implemented across all 13 intermediate double-entry transaction models to ensure consistent multicurrency behavior throughout the package.

Full Changelog: v1.1.1-a1...v1.1.1-a2

v1.1.1-a1 dbt_quickbooks

PR #187 is a pre-release that includes the following updates:

Bug Fixes

• Fixes int_quickbooks__purchase_double_entry by bringing in purchase tax line amounts and converted amounts for customers leveraging multicurrency.
• Updates int_quickbooks__invoice_double_entry with join on currency_id for Accounts Receivable accounts to prevent fanout for customers with multiple currencies.

Full Changelog: v1.1.0...v1.1.1-a1

v1.1.0 dbt_quickbooks

PR #185 includes the following updates, based on the updates made in the v1.0.1-a1 and v1.0.2-a1 pre-releases:

Bug Fix

• Updates the is_overdue and days_overdue logic in the quickbooks__ap_ar_enhanced model to compare due_date with the current date instead of recent_payment_date, which can be null. This ensures accurate overdue status and day counts for bills and invoices.

Quickstart Updates

• Adds in quickstart.yml variables for tax line source tables so Quickstart customers can leverage tax lines.
  • If you leverage tax lines, we encourage you to review the accuracy of the end models following this update. If you notice any issues, please open a Fivetran support ticket and let our team know.
• See the v1.0.0 release notes to review the new tax line staging models and updates.

Full Changelog: v1.0.0...v1.1.0

v1.0.2-a1 dbt_quickbooks

PR #184 includes the following updates:

Bug Fix

• Updates the is_overdue and days_overdue logic in the quickbooks__ap_ar_enhanced model to compare due_date with the current date instead of recent_payment_date, ensuring accurate overdue status and day counts for bills and invoices.

Full Changelog: v1.0.1-a1...v1.0.2-a1

v1.0.1-a1 dbt_quickbooks

PR #179 is a pre-release that includes the following updates:

Quickstart Updates

• Adds in quickstart.yml variables for tax line source tables so Quickstart customers can continue to leverage tax lines.
• This update in essence replicates the prior tax line pre-release, but now based off the latest version of the QuickBooks data models.
• Please open a Fivetran support ticket if you'd like to test out this pre-release and see if the new tax line feature ties out your financial reporting.

Full Changelog: v1.0.0...v1.0.1-a1

v1.0.0 dbt_quickbooks

PR #178 includes the following updates:

Breaking Changes

Source Package Consolidation

• Removed the dependency on the fivetran/quickbooks_source package.
  • All functionality from the source package has been merged into this transformation package for improved maintainability and clarity.
  • If you reference fivetran/quickbooks_source in your packages.yml, you must remove this dependency to avoid conflicts.
  • Any source overrides referencing the fivetran/quickbooks_source package will also need to be removed or updated to reference this package.
  • Update any quickbooks_source-scoped variables to be scoped to only under this package. See the README for how to configure the build schema of staging models.
• As part of the consolidation, vars are no longer used to reference staging models, and only sources are represented by vars. Staging models are now referenced directly with ref() in downstream models.

Schema Updates

14 new models -- 14 potential breaking changes

NOTE: These models are not available to Quickstart users until we have validated tax lines work as expected. Please open a Fivetran support ticket if you'd like to try out the pre-release that contains tax line support. They are available for dbt Core customers only if you enable the appropriate variables (see the README for more details).

Data Model	Change Type	Old Name	New Name	Notes
stg_quickbooks__invoice_tax_line	New Staging Model			Source: invoice_tax_line table. Disabled by default, leverage using_invoice_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__journal_entry_tax_line	New Staging Model			Source: journal_entry_tax_line table. Disabled by default, leverage using_journal_entry_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__purchase_tax_line	New Staging Model			Source: purchase_tax_line table. Disabled by default, leverage using_purchase_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__refund_receipt_tax_line	New Staging Model			Source: refund_receipt_tax_line table. Disabled by default, leverage using_refund_receipt_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__sales_receipt_tax_line	New Staging Model			Source: sales_receipt_tax_line table. Disabled by default, leverage using_sales_receipt_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_agency	New Staging Model			Source: tax_agency table. Disabled by default, leverage using_tax_agency variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_rate	New Staging Model			Source: tax_rate table. Disabled by default, leverage using_tax_rate variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__invoice_tax_line_tmp	New Temp Model			Source: invoice_tax_line table. Enabled by default, leverage using_invoice_tax_line variable in dbt_project.yml to disable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__journal_entry_tax_line_tmp	New Temp Model			Source: journal_entry_tax_line table. Disabled by default, leverage using_journal_entry_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__purchase_tax_line_tmp	New Temp Model			Source: purchase_tax_line table. Disabled by default, leverage using_purchase_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__refund_receipt_tax_line_tmp	New Temp Model			Source: refund_receipt_tax_line table. Disabled by default, leverage using_refund_receipt_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__sales_receipt_tax_line_tmp	New Temp Model			Source: sales_receipt_tax_line table. Disabled by default, leverage using_sales_receipt_tax_line variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_agency_tmp	New Temp Model			Source: tax_agency table. Disabled by default, leverage using_tax_agency variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_rate_tmp	New Temp Model			Source: tax_rate table. Disabled by default, leverage using_tax_rate variable in dbt_project.yml to enable. (Once available in a future update, this will be dynamically handled for Quickstart users.)

Bug Fixes

• Corrected the int_quickbooks__invoice_double_entry model to accurately map bundled invoice lines to the correct amount, converted_amount, account_id, index, and class_id.

Under the Hood

• Updated seed files to ensure accurate representation of invoice bundles.
• Updated run_models.sh to execute for when the new variables are enabled.
• Updated general_ledger_amounts_match integrity test to properly validate general ledger amounts.
• Excluded the running_balance and cumulative_running_balance values from the consistency_general_ledger validation test as these results can change based on how the window function orders transactions on the same date.

Full Changelog: v0.21.1...v1.0.0

v0.21.1 dbt_quickbooks

PR #176 includes the following updates:

Schema & Data Updates

4 total changes • 0 possible breaking changes

• This package now provides full multicurrency support for our financial reporting with exchange rates for credit card payments and transfers now introduced.

Data Model	Change Type	Old Behavior	New Behavior	Notes
int_quickbooks__credit_card_pymt_double_entry	New logic	converted_amount was same as amount	exchange_rate now utilized to calculate converted_amount.	Adds multicurrency support for credit card payment transactions.
int_quickbooks__transfer_double_entry	New logic	converted_amount was same as amount	exchange_rate now utilized to calculate converted_amount.	Adds multicurrency support for transfers.
stg_quickbooks__credit_card_payment_txn	New columns		exchange_rate	Adds multicurrency support for credit card payment transactions.
stg_quickbooks__transfer	New columns		currency_id, exchange_rate	Adds multicurrency support for transfers.

Documentation Update

• Removed references to credit card/transfer multicurrency transactions not being supported in DECISIONLOG and README.

v0.22.0-a1 dbt_quickbooks

PR #171 is a pre-release that introduces the following updates.

Schema Updates

14 new models -- 14 potential breaking changes

Data Model	Change Type	Old Name	New Name	Notes
stg_quickbooks__invoice_tax_line	New Staging Model			Source: invoice_tax_line table. Disabled by default, leverage using_invoice_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__journal_entry_tax_line	New Staging Model			Source: journal_entry_tax_line table. Disabled by default, leverage using_journal_entry_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__purchase_tax_line	New Staging Model			Source: purchase_tax_line table. Disabled by default, leverage using_purchase_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__refund_receipt_tax_line	New Staging Model			Source: refund_receipt_tax_line table. Disabled by default, leverage using_refund_receipt_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__sales_receipt_tax_line	New Staging Model			Source: sales_receipt_tax_line table. Disabled by default, leverage using_sales_receipt_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_agency	New Staging Model			Source: tax_agency table. Disabled by default, leverage using_tax_agency variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_rate	New Staging Model			Source: tax_rate table. Disabled by default, leverage using_tax_rate variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__invoice_tax_line_tmp	New Temp Model			Source: invoice_tax_line table. Enabled by default, leverage using_invoice_tax_line variable in dbt_project.yml to disable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__journal_entry_tax_line_tmp	New Temp Model			Source: journal_entry_tax_line table. Disabled by default, leverage using_journal_entry_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__purchase_tax_line_tmp	New Temp Model			Source: purchase_tax_line table. Disabled by default, leverage using_purchase_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__refund_receipt_tax_line_tmp	New Temp Model			Source: refund_receipt_tax_line table. Disabled by default, leverage using_refund_receipt_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__sales_receipt_tax_line_tmp	New Temp Model			Source: sales_receipt_tax_line table. Disabled by default, leverage using_sales_receipt_tax_line variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_agency_tmp	New Temp Model			Source: tax_agency table. Disabled by default, leverage using_tax_agency variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)
stg_quickbooks__tax_rate_tmp	New Temp Model			Source: tax_rate table. Disabled by default, leverage using_tax_rate variable in dbt_project.yml to enable. (This will be dynamically handled for Quickstart users.)

Bug Fixes

• Corrected the int_quickbooks__invoice_double_entry model to accurately map bundled invoice lines to the correct amount, converted_amount, account_id, index, and class_id.

Feature Updates

• This update incorporates tax lines into the below double entry models.
  • int_quickbooks__invoice_double_entry
  • int_quickbooks__journal_entry_double_entry
  • int_quickbooks__purchase_double_entry
  • int_quickbooks__refund_receipt_double_entry
  • int_quickbooks__sales_receipt_double_entry
• These lines then filter into our financial end models to provide more accurate financial reporting.
• We created logic to the account for each invoice tax line to the tax agency associated with an account.
• We provide fallbacks to the 'Sales Tax Payable' and 'Global Tax Payable' accounts if needed with variables you can leverage to configure your own custom account.
• Created equivalent double entry line for a tax item that associates with the invoice's existing Accounts Receivable account.
• To prevent uniqueness test failures with these tax line items, we start the tax line index in each double entry model at 10000.
• Created enable/disable variables to map to each of the new source tables and their downstream dependencies. For dbt core users, see the README for more details about how to configure these variables.

Under the Hood

• Updated quickstart.yml with the new variables for each new table to enable/disable based on the whether the source tables are being utilized.
• Created new seed files for the above source tables to test and validate new models work as expected.
• Updated seed files to ensure accurate representation of invoice bundles.
• Updated run_models.sh to execute for when the new variables are enabled.
• Removed redundant default variable configs from the dbt_project.yml.
• Updated general_ledger_amounts_match integrity test to properly validate general ledger amounts.
• Excluded the running_balance and cumulative_running_balance values from the consistency_general_ledger validation test as these results can change based on how the window function orders transactions on the same date.

Full Changelog: v0.21.0...v0.22.0-a1

v0.21.0 dbt_quickbooks

PR #173 includes the following updates:

dbt Fusion Compatibility Updates

• Updated package to maintain compatibility with dbt-core versions both before and after v1.10.6, which introduced a breaking change to multi-argument test syntax (e.g., unique_combination_of_columns).
• Temporarily removed unsupported tests to avoid errors and ensure smoother upgrades across different dbt-core versions. These tests will be reintroduced once a safe migration path is available.
  • Removed all dbt_utils.unique_combination_of_columns tests.
  • Removed all accepted_values tests.
  • Moved loaded_at_field: _fivetran_synced under the config: block in src_quickbooks.yml.

Under the Hood

• Updated conditions in .github/workflows/auto-release.yml.
• Added .github/workflows/generate-docs.yml.

Full Changelog: v0.20.1...v0.21.0