Translations of this page:
  • en

The Quickbooks Online Integrator

Quickbooks Online Integration currently only works in the USA


For integrating with Quickbooks Desktop CLICK HERE



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

If you have not used or setup the Integrator before, skip to Getting Connected

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)

Once connected, a special flag is added to the FastManager company database which connects to the specific Quickbooks Online company.
You will not be able to connect the same FastManager company to multiple different QB Online companies.
Also note that you will not be able to use the same FastManager Company with both the Desktop and Online versions of Quickbooks.
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 your Preferences
Once the FastManager Company file has been authorized it will no longer be necessary to have either FastManager or Quickbooks Online open in order to integrate with your Quickbooks Online company.
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
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

  • Select your preferences when exporting Invoices to Quickbooks
    • The most commonly selected preferences are indicated in the image above
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)


  • 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 be J 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)

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
    • In Quickbooks Online, go to Taxes -> Edit Tax Settings and check if Do you charge sales tax? is set to Yes or No



  • 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.
When integrating with Quickbooks Online, FM is unable to retrieve a list of the QB Item Codes, and so you will not see a drop-down selector.
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.
In Quickbooks Online, the “Category” of a product or service acts like a “Main Item” would in Quickbooks Desktop, and the item itself is then like a sub-item.
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 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.
Quickbooks Online uses the same overall Discount setup that FastManager does (it lists it in a seperate item code).
There is therefore no need to create a “Discount” line item code
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 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 Codeson the left, simply check the box next to Tax(T) and leave the box next to Non(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



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

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.

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.

  • If the option: Send Customer Groups, on the General tab, is not checked, then this tab is unused
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

  • 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


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


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 ExportInvoices

  • Select the invoices that you want to send.
  • Click on the Run button to start exporting 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.