...
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 |
---|
\\{}{}\\{\!$Api.Partner_Server_URL_140 | \\{}{}{}{}\QBSF_InvoiceToInvoice.SFQB_OpportunityTo{\!Opportunity.AVSFQB__Generate_Object__c}.xml&recordId= | \\\{}{}{}{}\\{}{}{}{}\\\\{}{}\\
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
- Login using to dbsync account, go to Company tab, click on edit to view DBSync Org Properties. Click on edit and replace the existing URL with https://dbsync01.appmashups.com/qboev3/login.m
...
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