2022

Page tree

Versions Compared

Key

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

...

Overview:

...


Data Flow:
Process Map:
Pre-requisites

...

for

...

Integration:

...


DBSync package (QuickBooks

...

Integration)

...

Installation

...

in

...

Salesforce:

...


DBSync Profile Setup:
Running the Integration:

Anchor
_Toc381191457
_Toc381191457

Overview:

DBSync for Salesforce & QuickBooks Online Integration is an easy to use application to integrate Salesforce Accounts / Contacts, Products, Opportunity with QuickBooks Online Customers, Items, Invoice, Sales Receipt & Credit Memo. This is also useful to migrate historical QuickBooks Online data into Salesforce or vice versa.
DBSync provides Bi-directional sync with pre-built field to field map along with flexibility for more complex and dynamic mapping capability. DBSync also has an automatic online update, enabling DBSync customers to enjoy all the product updates and features with every new release.

Anchor
_Toc381191458
_Toc381191458
Data Flow:

Data flow of Bi-directional integration between Salesforce & QuickBooks Online is shown in the below table.

Image Added

Anchor
_Toc381191459
_Toc381191459

Process Map:

Process Map of Bi-directional integration between Salesforce & QuickBooks Online is shown in the below image.


Image Added

Anchor
_Toc381191460
_Toc381191460

Pre-requisites for Integration:

  • Integration of Salesforce to QBOE transaction is invoked provided the Generate field in Salesforce Opportunity is selected with the required transaction.
  • It is mandatory that SF Opportunity (to be integrated with QBOE Invoice) is associated with the respective SF Account & also should have Products with Standard Price Book attached to it for DBSync to invoke integration.

Anchor
_Toc381191461
_Toc381191461
DBSync package (QuickBooks Integration) Installation in Salesforce:

  • Click on the below link to install the DBSync App from AppExchange

https://login.salesforce.com/?startURL=%2Fpackaging%2FinstallPackage.apexp%3Fp0%3D04t600000001gWU&crc=1

...

.

  • Enter your Salesforce Username and Password to install DBSync Package in that Salesforce instance. The Salesforce instance must have the administrative privileges to install App.
  • DBSync Package Installation Details will be displayed in your Salesforce instance. Click on 'Continue'.


Image Added

  • Approve Package API Access and then click on 'Next'.


Image Added

  • Choose Security Level to Grant Access and then click on 'Next'.


Image Added

  • Package is ready to be installed. Click Install to 'install'.

Image Added

  • Install complete message will be displayed which confirms that DBSync Package is installed.

Image Added

  • Go to setup  Image Added  Customize  Image Added  Account  Image Added  'Page Layout'  Image Added  Edit the Page Layout. Under the Page Layout drag the fields specified below to add it in Page Layout and Save.
    • Fields: "Quickbooks Id", "QB Error"
    • Button: " Update Account To QBOE"

Image Added

  • Go to setup  Image Added  Customize  Image Added  Contact  Image Added  'Page Layout  Image Added  Edit the Page Layout.
  • Under the Page Layout drag the fields and buttons specified below to add it in Page Layout and Save.
    • Fields: "Quickbooks Id", "QB Error", "QBName"
    • Button: " Update Contact To QBOE"

Image Added

  • New Buttons "Update Opportunity To QBOE_New" and "Update Invoice from QBOE_New" should be created in Salesforce Opportunity by referring the below steps.

Go to setup  Image Added  Customize  Image Added  Opportunity  Image Added  'Buttons, Links and Actions'  Image Added New Button or Link.
Enter the below mentioned details and save to create two buttons.

Label: Update Opportunity To QBOE_New

Behavior: Execute JavaScript

Display Type: Detail Page Button

OnClick JavaScript:

Panel
Wiki Markup

var URL="{\!$User.AVSFQB__QBOE_DBSync_Server__c}/qboe.m?sfUrl={\!$Api.Partner_Server_URL_140}&qboeCT={\!$User.AVSFQB__QBOE_Connection_Ticket__c}&pdl=processdefinition_SFQB_OpportunityTo{\!Opportunity.AVSFQB__Generate_Object__c}.xml&recordId={\!Opportunity.Id}&dbsyncId={\!$User.AVSFQB__DBSync_Id__c}&profileName={\!$User.AVSFQB__DBSync_Profile__c}&sessionId={\!$Api.Session_ID}&dbsyncPasswd={\!$User.AVSFQB__DBSync_Passwd__c}";
window.open(URL,"DBSync","menubar=0,resizable=0,width=650,height=300");
\\ !worddav7d63493d58da95bf16ba18cf074bf105.png|height=247,width=666,align=center,border=1!\\ \\ *Label:* Update Invoice from QBOE_New *Behavior:* Execute JavaScript *Display Type:* Detail Page Button *OnClick JavaScript:*


Image Added

Label: Update Invoice from QBOE_New

Behavior: Execute JavaScript

Display Type: Detail Page Button

OnClick JavaScript:

Panel
Wiki Markup

var URL="
\
{\!$User.AVSFQB
\
__QBOE_DBSync_Server
{
_
}{
_
}
c
\
}/qboe.m?sfUrl=
\
{\!$Api.Partner_Server_URL_140
\
}&qboeCT=
\
{\!$User.AVSFQB
{
_
}{
_
}
QBOE_Connection_Ticket
{
_
}{
_
}
c
\
}&pdl=processdefinition_
QBSF_InvoiceToInvoice.
SFQB_OpportunityTo{\!Opportunity.AVSFQB__Generate_Object__c}.xml&recordId=
\
{\!Opportunity.Id
\
}&dbsyncId=
\
{\!$User.AVSFQB
{
_
}{
_
}
DBSync_Id
{
_
}{
_
}
c
\
}&profileName=
\
{\!$User.AVSFQB
{
_
}{
_
}
DBSync_Profile
{
_
}{
_
}
c
\
}&sessionId=
\
{\!$Api.Session_ID
\
}&dbsyncPasswd=
\
{\!$User.AVSFQB
{
_
}{
_
}
DBSync_Passwd_
\
_c
\
}";
 

window.open(URL,"DBSync","menubar=0,resizable=0,width=650,height=300");
\\ !worddav15652ef26a9488728fe2b7efd81c1e1d.png|height=247,width=666,align=center,border=1!\\ * These new buttons along with the other required fields should be included in the page layout by following the below steps. Go to setup  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Customize  !worddav0b8fec8d6f166595e9d433ac50d97557.png|height=12,width=37!  Opportunity  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  'Page Layout'  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Edit the Page Layout. \\ * Under the Page Layout drag the fields specified below to add it in Page Layout. ** Fields: "Quickbooks Id", "Primary Contact", "Generate", "QB Error" ** Buttons: "Update Opportunity To QBOE_New", "Update Invoice from QBOE_New" !worddav9f9344d8ffc939c70eb3b0a841ce2358.png|height=347,width=666,align=center,border=1!\\ * Move Invoices from the Opportunity Related List to the page layout. * Click on Invoices in the Related List Section and hit "edit properties" button. Select columns as Invoices, Invoice number, Total Invoice Amount, Payments, Balance, Days Outstanding, and Transaction Date. Save the opportunity 'page layout'. !worddav720ef7255c915b8383b949a877381c52.png|height=399,width=666,align=center,border=1!\\ * Go to Setup  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Customize  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Opportunity  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Opportunity Products  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Edit Page Layout to move 'QuickBooksID' field to the page layout. !worddav61a9d9b3bafd45bb6598d99d75e3353f.png|height=309,width=666,align=center,border=1!\\ \\ * New Button "Update Product To QBOE_New" should be created in Salesforce Product by referring the below steps. * Go to setup  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  Customize  !worddav0b8fec8d6f166595e9d433ac50d97557.png|height=12,width=37! Product  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37!  'Buttons and Links'  !worddavfded01d627e64f8ce213dd9b1f396b83.png|height=13,width=37! New Button or Link. * Enter the below mentioned details and save to create two buttons. *Label:* Product To QBOE_New *Behavior:* Execute JavaScript *Display Type:* Detail Page Button *OnClick JavaScript:* var URL ="\{\!$User.AVSFQB\__QBOE_DBSync_Server{_}{_}c\


Image Added

  • These new buttons along with the other required fields should be included in the page layout by following the below steps.

Go to setup  Image Added  Customize  Image Added  Opportunity  Image Added  'Page Layout'  Image Added  Edit the Page Layout.

  • Under the Page Layout drag the fields specified below to add it in Page Layout.
    • Fields: "Quickbooks Id", "Primary Contact", "Generate", "QB Error"
    • Buttons: "Update Opportunity To QBOE_New", "Update Invoice from QBOE_New"

Image Added

  • Move Invoices from the Opportunity Related List to the page layout.
  • Click on Invoices in the Related List Section and hit "edit properties" button. Select columns as Invoices, Invoice number, Total Invoice Amount, Payments, Balance, Days Outstanding, and Transaction Date. Save the opportunity 'page layout'.

Image Added

  • Go to Setup  Image Added  Customize  Image Added  Opportunity  Image Added  Opportunity Products  Image Added  Edit Page Layout to move 'QuickBooksID' field to the page layout.

Image Added

  • New Button "Update Product To QBOE_New" should be created in Salesforce Product by referring the below steps.
  • Go to setup  Image Added  Customize  Image Added Product  Image Added  'Buttons and Links'  Image Added New Button or Link.
  • Enter the below mentioned details and save to create two buttons.

Label: Product To QBOE_New

Behavior: Execute JavaScript

Display Type: Detail Page Button

OnClick JavaScript: var URL ="{!$User.AVSFQB_QBOE_DBSync_Serverc}/qboe.m?sessionId=

...

{

...

!$Api.Session_ID

...

}&sfUrl=

...

{

...

!$Api.Partner_Server_URL_140

...

}&qboeCT=

...

{

...

!$User.AVSFQB

...

QBOE_Connection_Ticket

...

c

...

}&pdl=processdefinition_SFQB_Item.xml&recordId=

...

{

...

!Product2.Id

...

}&dbsyncId=

...

{

...

!$User.AVSFQB

...

DBSync_Id

...

c

...

}&profileName=

...

{

...

!$User.AVSFQB

...

DBSync_Profile

...

c

...

}&dbsyncPasswd=

...

{

...

!$User.AVSFQB

...

DBSync_Passwd_

...

c

...

}";

...

window.open(URL,"DBSync","menubar=0,resizable=0,width=650,height=300");

...

Image Added

  • Go to Setup  Image Added  Customize  Image Added  Product  Image Added 'Page Layout' fields to add is "QuickBooks Item type" , "QuickBooks Id" , "QB Error", "COGS" and "OnHand'" and Buttons "Update Product To QBOE_New" to the page layout.

Image Added

  • Go to setup Image Added Customize Image Added  Users  Image Added 'Page Layout' Image Added Edit the Page Layout. Under the Page Layout drag the fields and buttons specified below to add it in Page Layout and Save.
    • Field "DBSync Id"
    • Field "DBSync Passwd"
    • Field "DBSync Server URL"
    • Field "DBSync Profile"

Anchor
_Toc381191462
_Toc381191462
DBSync Profile Setup:

  • Go to mydbsync.com & register for Free Trial. Ensure that Source & Target Adapters are Salesforce & QuickBooks Online respectively.

Image Added

...

Image Added
Image Added
Image Added

  • Go to Process Template tab in DBSync home page and click on SalesforceQuickBooksOnline:BiDirectional to include process template for Bi-directional Integration of Salesforce & QuickBooks Online.
  • Click on Launch in My Home tab, you will see SalesforceQuickBooksOnline:BiDirectional profile in the next tab of your browser.
  • Click on Quick Start to configure Salesforce & QuickBooks Adapters

...

Configure Salesforce Adapter:

...

  • Enter Salesforce Username, Password & Security Token. Click on Save Properties to save the settings. Click on Validate to confirm the Salesforce connections settings are valid.

Image Added

...

Configure QuickBooks Online Adapter:

...

  • Go to QuickBooks Online Connection properties, click on Configuration link, which will take you to new tab to authorize Intuit to securely share your data to DBSync QBRv3. 

Image Added

  • Click on Authorize to continue. Confirmation email will be displayed as "Your QuickBooks Online is now connected with the Profile. Please close this window now".

Image Added

  • Go to DBSync Quick Start, all the QuickBooks Online Adapter Connection properties fields will be auto populated. Click on Save Properties of to save the settings. Click on Validate to confirm the QuickBooks Online connections settings are valid.

Image Added

Anchor
_Toc381191463
_Toc381191463

Running the Integration:

DBSync Integration of Salesforce & QuickBooks Online can be initiated by the following three methods.

  • Using Salesforce custom buttons:
  • Using DBSync Scheduler:

...

Using Salesforce custom buttons:

...

  • Salesforce custom buttons in Salesforce Accounts, Contacts and Opportunity can be used to update these specific records into QuickBooks as and when required. To set Auto run of integration, one of the next methods should be used. 
  • Salesforce Custom Button Update Account to QBOE in Accounts Object is shown below.

Image Added

  • Salesforce Custom Button Update Contact to QBOE in Contacts Object is shown below. 

Image Added

  • Salesforce Custom Button Update Opportunity to QBOE and Update Invoice from QBOE in Opportunities Object is shown below. 

Image Added

...

Using DBSync Scheduler:

...

  • Scheduler available in DBSync Account can be used to schedule the integration.
  • Login to DBSync account, click on Launch to go to DBSync profile page and click on Scheduler on the top right corner.

Image Added

  • Select the integration profile and required process to auto run. Edit the Cron Settings to set the frequency of Auto run and Save Cron Job.

Image Added