The Quickbooks Desktop Integrator
Installing the integrator
Minimum requirements
Both FastManager and QuickBooks need to be installed on the same computer that you will be using to integrate.
You need to have at least FastManager version 2014.75 installed to integrate with Quickbooks Desktop
To use the Quickbooks Desktop Integrator, you need to have QuickBooks PRO 2007
or better installed.
You need to have QuickBooks open and logged into the correct company file while using the Integrator.
Getting Connected
Ensure that QuickBooks Desktop is open on the computer where you want to use the integrator, then use the shortcut on your desktop to open the Integrator
In order to properly grant access permissions to the Integrator, you need to login to Quickbooks as the Administrator.
- This is only necessary the first time you use the Integrator.
Select Quickbooks Desktop Application
and click on Connect
If this is the first time you are connecting, QuickBooks will prompt you for permission if you are logged in as the administrator.
From the QuickBooks permission screen, select Yes, whenever this QuickBooks company file is open
The next time you open the Integator, Quickbooks will not prompt for your permission again
Setting up the Integrator
Once you are connected to Quickbooks, you will be presented with the Preferences
and Setup
screens, one at a time.
This will only happen the first time that you run the Integrator. Once the Preferences and Setup have been done, you will no longer be prompted each time you open the Integrator.
However, if you want to view or edit any of the Preferences or Setup, you can just click on the appropriate button at the top of the Integrator window:
Preferences
To access the preferences area, you can click on the Preferences button.
The Preferences
window has 4 tabs:
The General Tab
Add company name and contact person to bill to address
If this option is selected, then the Integrator will ADD the company name and contact person to the Bill To
field on the Invoice in Quickbooks
This option is only useful if preference is not already enabled in Quickbooks
Show this screen before exporting invoices
Show this screen before exporting payments
Show this screen before exporting purchase orders
The Payments Tab
Select your preferences when exporting Payments to Quickbooks
Payments that have been applied to Work Orders in FastManager can also be exported to Quickbooks, even before the job is Invoiced.
Later, once the WIP is converted to an Invoice, that invoice can also be exported to Quickbooks and the payment (which is already in Quickbooks) will automatically be applied to the Invoice.
- This assumes that the preference: Apply payments to the same invoice in Quickbooks as in FastManager
has been selected
The Invoices Tab
Important Note about Invoice Numbers“ If you make no selection regarding Invoice Numbers, then the Invoice in Quickbooks will have the SAME NUMBER as it had in FastManager.
If you select:
Let Quickbooks assign invoice numbers
, then Quickbooks will give the Invoice a NEW NUMBER.
Optionally, you may also have the Integrator ADD A PREFIX to the FastManager Order Number (the prefix will show up in front of the Invoice number in Quickbooks)
The Purchase Orders Tab
When you are done setting your Preferences, click on OK
Setup
In order to exchange data with QuickBooks you need to cross match certain data fields in QuickBooks with those in FastManager.
For example: The sales rep in FastManager might be John Smith
and the Sales Rep in QuickBooks could be J Smith.
You only need to do the setup once. You only need to come back to the setup screen if you make changes to any of its values in either FastManager or QuickBooks.
To access the setup area, you can click on the Setup button.
You will see different tabs from where you can setup different values.
On each one, there will be a list of options on the left, which are the values as they appear in FastManager and a corresponding list on the right, of the same types of items as they appear in Quickbooks
From the drop-down selection on the right (“Quickbooks items”), select the appropriate value to map to the item listed on the left (the items from FastManager)
If, on any of the tabs on the Setup screen, some items are missing from the Quickbooks side (always listed on the RIGHT), you may need to go to Quickbooks to create these.
After you have created the new item in Quickbooks you will need to close and reopen the Integrator in order for the item/s in question to show up in the drop-down selection.
It might therefore be a good idea to review all the different tabs and compile a list of what is needed in Quickbooks, then go to Quickbooks and create ALL the missing items, then close and reopen the Integrator once in order for all the new items to show up.
This can reduce or remove the need to close and reopen the Integrator multiple times as new items are added to Quickbooks during the initial setup.
General Tab
Country
– Only required if the country is outside the USA.
Date Format
: Enter: dd-mm-yyyy (Only required if the country selected is something other than USA.)
Company charges sales tax
Line Items
Every SALES GROUP in FastManager will link to a corresponding LINE ITEM CODE in Quickbooks.
On the left you will see a list of the existing Sales Groups in FastManager.
If no items show up in the drop-down, this will either be because there are none, or because there are too many.
The Integrator will not show the list if there are too many items.
You may need to create new Line Items in Quickbooks.
If necessary, in Quickbooks, go to Lists -> Item List
and then Items -> New Item
to create a new Line Item.
The new line item must NOT be of the type: Inventory Part
If this is a physical item, such as an item that will correspond with the Sales Group called: Apparel
, then the best item type to use will be Non-inventory Part
or Other Charge
.
If this is a Service item, such as an item that will correspond with an embellishment like Screen Printing, then the best item type to use will be Service
or Other Charge
.
If this is going to be the Discount
item, then the only item to choose will be the type: Discount
All the items in all of the imported vendor catalogs will ALL be listed under a single Sales Group in FastManager, (most likely: Apparel
).
In other words, all the different vendor SKU's will end up under the same item code in Quickbooks.
For Apparel
or other physical goods, or for any items or services that you expect to include on any Purchase Order in FastManager: - in Quickbooks, when creating the item be sure to check the box: This item is used in assemblies
. That will allow you to select both the Sales (Income) account as well as the Purchasing (“Cost of goods”) account.
Remember: If you create new Line Items in Quickbooks, you will need to close and reopen the Integrator in order to see the new items in the drop-down selection.
Sales Tax
The Sales Tax tab is seperated into 2 sections: Tax Codes
and Tax Items
It is important that the corresponding Tax Items have the same percentage,
If the precentage/s ever change - make sure to change them in both programs!
Sales Reps
On the right hand side, select the Sales Rep from Quickbooks to correspond with the Sales Rep from FastManager.
Customer Terms
On the right hand side, select the “Customer Terms” from Quickbooks to correspond with the same from FastManager.
Payment Methods
In the center column, select the Payment Method from Quickbooks to correspond with the same from FastManager.
By default, all payments that are exported from FastManager will be posted to the Undeposited Funds
account in Quickbooks.
If necessary, in the Deposit To
column, you can select a different or specific banking or other “Current Asset” account in Quickbooks for payments in that particular payment method to be posted to directly.
Customer Groups
On the right hand side, select the Customer Type from Quickbooks to correspond with the Customer Group from FastManager.
In FastManager, the customer groups are found at: Edit -> Lists -> Customer Industry
When you are done with the setup on each tab, click on Apply
It is possible that you might get one more prompt from Quickbooks to give permission to the Integrator.
If you do, select: Yes, whenever this company file is open
(as you did before)
That is all there is to setting up the integrator.
You only need to revisit this section if you make any changes in QuickBooks or FastManager that will effect the associated values.
Importing/Exporting Customers
It is a good idea to first EXPORT any existing customers from FastManager to Quickbooks
!!! note If the customer already exists in Quickbooks you will be prompted with the option to link the customer or cancel the export
You should also IMPORT any existing customers from Quickbooks to FastManager:
In the future, as new customers are added to FastManager, you can export them to Quickbooks in the same way.
In fact, it is recommended to export new customers to Quickbooks prior to exporting new Invoices, since it will ensure that all the extra information (such as additional contact info) is exported as well.
Sending Invoices
Click on Export → Invoices
If any Invoices exist for which there is no customer in Quickbooks, the Integrator will prompt you to create the customer in Quickbooks “on the fly”
Payments, Customers, Suppliers and Purchase Orders can all be exported the same way.
QuickBooks will try to apply the payment to existing transactions it may have.
If you want to control the application of payments to invoices yourself uncheck the
Apply payments to existing invoices in QuickBooks
option on the
Payments tab of the
Preferences
screen.
Troubleshooting