meta data for this page
- en
The Quickbooks Online Integrator
Installing the integrator
- FastManager's QuickBooks Integrator is a separate program which is automatically installed at the same time as FastManager
- If you already have FastMananager installed, look for the QuickBooks Integrator shortcut on your desktop:
Minimum requirements
- You need to make sure that FastManager has been updated to the latest version in order to integrate with the Quickbooks Online.
Moving from Quickbooks Desktop to Quickbooks Online
The integrator keeps a local configuration file that contains all of the information for your Integrator setup.
You will find this file in your FastManager Data Folder
It is called: QBSetup.xml
- DELETE or rename this file.
- doing that will reset (remove) all the integrator setup so that you can start over and link it up with your QB Online company setup.
Getting Connected
Login to your Quickbooks Online company
Open FastManager and login (make sure you are connected to the correct Company Database)
You will not be able to connect the same FastManager company to multiple different QB Online companies.
However, it is possible to use one FM company with QB Online, and a different FM company with QB Desktop
Now open the Quickbooks Integrator
- select
Quickbooks Online
and click on Connect
You will be prompted with what looks like an error message saying:
Authorization Required. | |
---|---|
Unable to connect Quickbooks Online |
Click Ok
This will open a browser tab where you will be able to authorize the connection from the Integrator to your Quickbooks Online company file
Once authorized, go back to the Integrator and click on Connect
again
- Now the Integrator will open up properly and you should be prompted to go through your
Setup
and yourPreferences
However, it useful to have at least FastManager open just to be sure that FastManager is connected to the correct FastManager Company Database.
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
- If any of these are selected, then this preferences screen will pop up (for review) just before the Invoices/Payments/PO's are exported
The Payments Tab
Select your preferences when exporting Payments to Quickbooks
- The most commonly selected preferences are indicated in the image above
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
- Select your preferences when exporting Invoices to Quickbooks
- The most commonly selected preferences are indicated in the image above
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)
Always send invoices amortized
- By default, all invoice lines are UNamortized when they get exported to Quickbooks. This is to split out the Sales Values for each different line item (such as Apparel / Embroidery / Setup charge / etc…)
- If you wish, you may keep the total sales value combined on the item line/s (which will leave the services and additional charge lines with ZERO sales value)
The Purchase Orders Tab
- Select your preferences when exporting Purchase Orders to Quickbooks
- The most commonly selected preferences are indicated in the image above
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 beJ Smith.
- We will link these two reps together on the
Sales Reps
tab of the Integrator setup screen
- 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)
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
- In Quickbooks Online, go to
Taxes -> Edit Tax Settings
and check ifDo you charge sales tax?
is set toYes
orNo
- If it is set to
Yes
- check the box in the Integrator Setup- Leave the box unchecked if the setting in Quickbooks is
No
Line Items
Every SALES GROUP in FastManager will link to a corresponding LINE ITEM CODE in Quickbooks.
- On the left, under:
This Sales Group in FM =
you will see a list of the existing Sales Groups in FastManager. - and on the right, under:
This item code in Quickbooks
, you will type in the item code from QB Online that must correspond with that Sales Group.
You will have to type in the full Quickbooks Item Code on the right under:
This item code in Quickbooks
. When entering the item code, it must be typed exactly as it appears in Quickbooks.
So if your product or service in Quickbooks Online has a category, then in the Integrator Setup, you should write the item as
category-name:item-name
(insert-image)
You may need to create new Line Items in Quickbooks.
- If necessary, in Quickbooks Online, go to
Sales
–>Products and Services
- 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 beNon-inventory Part
orOther 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
orOther Charge
.
There is therefore no need to create a “Discount” line item code
Apparel
).In other words, all the different vendor SKU's will end up under the same item code in Quickbooks.
Apparel
or other physical goods, or for any items or services that you expect to include on any Purchase Order in FastManager: - in Quickbooks Online, when creating the item be sure to check the box: I purchase this product/service from a vendor
, listed under: Puchasing Information
. That will allow you to select both the Sales (Income) account as well as the Expense (“Cost of goods”) account.
Sales Tax
The Sales Tax tab is seperated into 2 sections: Tax Codes
and Tax Items
- Under
Tax Codes
on the left, simply check the box next toTax(T)
and leave the box next toNon(N)
unchecked- These refer to each line item on an Invoice and indicates if the line item is (T)axable or (N)on-taxable
- On the right, under
Tax Items
, select the correct QB tax item to correspond with each tax type from FM
If the precentage/s ever change - make sure to change them in both programs!
Sales Reps
Quickbooks Online has no built-in support for Sales Reps. However, on the Invoice there is room for 3 “Custom Fields”.
FastManager will send the Sales Rep to Custom Field 1, so you can name that custom field to Sales Rep
- Any records you create under 'Custom Field 1' in Quickbooks Online will then show up on the Sales Rep tab of the Integrator setup screen
Customer Terms
On the right hand side, select the “Customer Terms” from Quickbooks to correspond with the same from FastManager.
- If the option:
Send Customer Terms
, on the General tab is not checked, then this tab is unused
Payment Methods
In the center column, select the Payment Method from Quickbooks to correspond with the same from FastManager.
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.
- If the option:
Send Customer Groups
, on the General tab, is not checked, then this tab is unused
Edit -> Lists -> Customer Industry
When you are done with the setup on each tab, click on Apply
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
- In the Integrator, click on Export →
Customers
- The Integrator will build a list of all the customers in FastManager
- You can uncheck the box next to any customer/s that you do NOT want to export to Quickbooks at this time
- Then click on Run to begin the export
You should also IMPORT any existing customers from Quickbooks to FastManager:
- In the Integrator, click on Import →
Customers
- The Integrator will build a list of all the customers in Quickbooks
- You can uncheck any customers in the list that you do not want to import into FastManager at this time
- Click on
Run
to begin the import- you will be prompted with the option to also import any balances that the customer/s have in Quickbooks
In the future, as new customers are added to FastManager, you can export them to Quickbooks in the same way.
Sending Invoices
Click on Export
→ Invoices
- Select the invoices that you want to send.
- Click on the Run button to start exporting Invoices
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.