2022

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Panel

Multi-select UOM configuration

...

Set Up – Multiple Units of Measure Per Item
QB QuickBooks company file has multi-select UOM option per ITEM. A single item can have multiple UOM selected and one of the UOM values has to be assigned as default. However, while generating a transaction, you can use different sets based on the requirement or conversion required for a given transaction.
In the example shown below for the ITEM z0b1-739 the default UOM set lb739has the base unit as POUND (lb) but has several related units Square Feet, Linear Feet and sheet with default values as shown. The above can be read as
1 pound = 1.03 Sq Feet
1 pound = 3.3818 Linear Feet
1 pound = 33.8183 sheets
The same ITEM when selected within a transaction in QuickBooks, we can use the following conversions based on the quantity and UOM set used.

Field Mappings for Invoice Item Line with UOM
Below is a table listing out mappings / data required from Salesforce for successful integration of a QuickBooksInvoice transaction with a Unit of Measure.

Salesforce

R

QuickBooks

R

Comments

Rate

Y

Rate

Y

The rate has to be calculated precisely based on the quantity and based on the conversion for a particular UOM.

Quantity

Y

Quantity

Y

Quantity should be calculated from SF based on the Unit and Conversion used for a particular Product

UOM

N

UnitOfMeasure

N

The correct UOM should be referred with the names matching the U/M list in QuickBooks


Rate:

The rate or amount of the LineItem should be precise based on the UNIT used and the quantity used. The calculation of thisneeds this needs to happen on the Salesforce side at the Opportunity Line Item level based on the PRODUCT selected and UNIT used before DBSync can parse/push this data into QuickBooks without the transaction erring out.

...

MaxLength - 31
This is the qbxml QuickBooksxml name for selecting a UOM for a given transaction line item. For a given UNIT, there are several RELATED UNITS based on which the Quantity and Rate changes. For a given ITEM LINE, if the right BASE UNIT name, corresponding QUANTITY, and RATE should be provided at all times for a successful integration of an Invoice transaction. A corresponding field on the OpportunityProducts object can either be a Picklistor Text field and data needs to be populated at all times.

Panel

Field Mappings for Invoice integration with Sales Tax

This section illustrates the field mappings required for QuickBooksInvoice integration based on SalesTaxCode configuration in QuickBooks.
In order to ensure a seamless integration of a transaction with SalesTaxCode DBSync will require the following information from Salesforce to integrating the same into QuickBooks.

Salesforce

R

QuickBooks

R

Comments

ItemTaxCode

Y

ItemSalesTaxRef

Y

This field should be on the Opportunity object and the NAME should match with the QuickBooksSalesTaxCode list at all times

Customer Tax Code

N

CustomerSalesTaxCodeRef

N

This field should be on the Opportunity object and the NAME should match with the QuickBooksCustomerTaxCode list at all times

SalesTaxCode

Y

SalesTaxCodeRef

Y

This field should be on the Opportunity Products object and again should match with QuickBooks available list.

TaxAmount

N

TaxAmount

N

Should be on the Opportunity Products Object

CheckBox

N

IsTaxable

N

Should be on the LineItem level.


ItemSalesTaxRef:MaxLength = 31
The ItemSalesTaxRef field is the one which calculates the tax based on whether aLineItem is taxable or not. The ItemSalesTax is setup on each Item in quickbooks at the time of configuration. A corresponding field in Salesforce should always be on the Opportunity object as it is on the Invoice header on QuickBooks. Secondly the SFDC field name should always match with the ItemSalesTax code list available in QuickBooks and preferable data-type in Salesforce is Text Field or Picklist.

CustomerSalesTaxCodeRef:MaxLength = 3
The customer Tax Code in QuickBooks holds the values Taxable Sales &Non-Taxable Sales. It could also hold custom values based on how QuickBooksCustomerTaxCode is configured. The corresponding field in SFDC needs to be again at the Opportunity level and preferably has to be Text field with the data values matching with the QuickBooksCustomerSalesTaxCodeRef list.

...