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

Panel

Overview

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

Panel

Anchor
_Toc381191458
_Toc381191458
Data Flow

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

Anchor
_Toc381191459
_Toc381191459

Panel

Process Map

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


Anchor
_Toc381191460
_Toc381191460

Panel

Pre-requisites for Integration

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

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

...

  1. Get the following App from AppExchange

...

  1. for your Salesforce instance - https://login.salesforce.com/packaging/installPackage.apexp?p0=

...

  • 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'.

...

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

...

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

...

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

Image Removed

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

Image Removed

  • Go to setup ? Customize ?  Account ? 'Page Layout' ? 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 Removed

  • Go to setup ? Customize ? Contact ? 'Page Layout' ? 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 Removed

  • 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 ? Customize ? Opportunity ? 'Buttons, Links and Actions' ? 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:

No Format

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");

...

Behavior: Execute JavaScript

Display Type: Detail Page Button

OnClick JavaScript:

No Format

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.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");

Image Removed

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

Go to setup ? Customize ? Opportunity ? 'Page Layout' ? 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 Removed

  • 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 Removed

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

...

  • New Button "Update Product To QBOE_New" should be created in Salesforce Product by referring the below steps.
  • Go to setup ? Customize ? Product ? 'Buttons and Links' ? 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:

No Format

var URL ="{!$User.AVSFQB__QBOE_DBSync_Server__c}/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 Removed

  • Go to Setup ? Customize ? Product ? '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 Removed

...

  1. 04t600000001jlq
  2. Note: If you are installing into a Sandbox, you must replace the initial portion of the URL with http://test.salesforce.com.
  3. Input Username and Password of the Salesforce instance where you would like to install DBSync. The Username and Password must belong to a user with administrative privileges to install.
  4. You can see details like App Name, Publisher, Version Name, Version Number along with Components & API Access.
  5. Select a profile - Admin, All Users or a specific profile. The selected profile will have access to the installed package. Then, click install or upgrade.
  6. Once the process is complete, you will see a message - Installation or Upgrade complete. 
  7. Assign DBSync Page Layouts to Accounts, Contacts, Opportunity, Opportunity Products and Products objects. Refer to the following steps to assign DBSync Page layout to Accounts Object. Existing Page Layout will be replaced by DBSync Page Layout. Any custom fields available in the existing page layout should be moved to DBSync Page Layout if required.
  8. Go to Salesforce Setup > Customize > Accounts > Page Layouts. This will show the list of available Page Layouts for Accounts Object. Click on Page Layout Assignment.
  9. You will find the list of default Page Layouts assigned for every Salesforce Profile. Click on Edit Assignment to proceed.
  10. Click on the Page Layout next to the required profile. Account Layout is the existing Page Layout for System Administrator Profile. The profile should be assigned to DBSync's Page Layout. In this case Account Layout should be selected next to System Administrator's profile.
  11. Select DBSync Account Layout from Page Layout To Use picklist. Page Layout will be changed from Account Layout to DBSync Account Layout. Click on Save to save the new Page Layout assignment.
  12. Similarly, assign DBSync Page Layout for Salesforce Objects - Contacts, Opportunity, Opportunity Products and Products.
Panel

Anchor
_Toc381191462
_Toc381191462
DBSync Profile Setup

  1. Go to www.mydbsync.com & register for Free Trial.

...

Image Removed

...

  1.  Ensure that Source

...

  1. and Target Adapters are Salesforce

...

  1. and QuickBooks Online respectively.

Image Removed

  1. Login using to

...

  1. DBSync account

...

  1. . Go to Company tab

...

  1. . Click on edit to view DBSync's Org Properties. Click on edit and replace the existing URL with https://dbsync01.appmashups.com/qboev3/login.m

Image Removed
Image Removed
Image Removed

  1. Go to Process Template tab

...

  1. on DBSync's home page and click on SalesforceQuickBooksOnline:BiDirectional to include process template for Bi-directional Integration of Salesforce & QuickBooks Online.
  2. Click on Launch

...

  1.  on My Home tab

...

  1. . You will see

...

  1. Project page on the next tab of your browser.
  2. Click on

...

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.

...

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. 

...

  • 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".

...

  1. Projects on the left panel. Then, click on the project SalesforceQuickBooksOnline:BiDirectional.
  2. Click on Connectors. You will see Salesforce & QuickBooks Online connectors. These connectors need to be configured as follows:
  3. Click on Salesforce Connector. Select appropriate End Point under Quick Setup tab. Click on Connect to Salesforce. This will take you to Salesforce login page. Enter your Username & Password to login into Salesforce. Once you login, your Salesforce connector will be connected to your Salesforce instance. If you want to connect using different Salesforce instance, click on Disconnect in Quick Setup tab. Then, connect using the required Salesforce credentials.
  4. You can also use Advanced Properties tab to connect to your Salesforce instance. Go to Advanced Properties. Fill in the Salesforce Username, Password and, Security Token for your Salesforce Instance. Select the appropriate End Point. Once you enter all the required details, click on Validate Connection. If the validation is successful, click on Save to Save the Salesforce details. If the validation fails, you will see Validation Errors on the top right corner. Review details in Validation Errors section and make the necessary changes in Advanced Properties. Then, click on Validate Connection again.
  5. Click on QuickBooks Online Connector. Then, click on the link Connect to QuickBooks. Sign into QuickBooks online to authorize DBSync Salesforce Integration for QuickBooks to connect to Intuit.
  6. You can also connect to QuickBooks Online using Advanced Properties tab in QuickBooks Online Connector Settings.
  7. Go to Advanced Properties. Enter following details - Application OAuth Key, Application OAuth Secret, User OAuth Key, User OAuth Secret, Realm Id, Datasource, OAuth Last Updated, OAuth URL.
  8. Click on Save to save the settings. Click on Validate Connection to confirm that the QuickBooks Online connections settings are valid.

Image Removed

Anchor
_Toc381191463
_Toc381191463

Panel

Running the Integration

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

...

:

  • Clicking on Salesforce custom buttons.
  • Using DBSync Scheduler.

...

Click on Salesforce custom buttons:

    ...

    1. Click the custom button on Salesforce Accounts, Contacts and Opportunity

    ...

    1. to update

    ...

    1. specific records into QuickBooks as and when required. To set Auto run

    ...

    1. integration, use one of the

    ...

    1. following methods

    ...

    1. .

    ...

    ...

    1. Click Update Account to QBOE

    ...

    1.  button on the Accounts Object

    ...

    1. .

    Image Removed

    ...

    1. Click Update Contact to QBOE

    ...

    1.  on the Contacts Object

    ...

    1. .

    ...

    ...

    1. Click Update Opportunity to QBOE and Update Invoice from QBOE

    ...

    1.  button on the Opportunities Object

    ...

    Image Removed

    Using DBSync Scheduler
    • Scheduler available in DBSync Account. It 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 Removed

    • 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.

    ...