Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gusto-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Prerequisites

If you don’t already have a Xero or QBO account, you must set up a free account with the integration you are testing:
  • Xero: If you don’t already have a Xero account, set up a one-month trial Xero account—this does not require payment, and will allow you to test in our Demo environment.
  • QBO: You will need a sandbox company to test flows.
    • Create a developer account at developer.intuit.com, which is free of charge. Once your developer account has been created, you by default have a sandbox company that you can use to test flows.

​
How to test the flows

  1. Make sure you have a testing account set up for your integration. If you don’t, follow the steps in the Prerequisites section.
  2. Create your desired flow and navigate to the generated flow URL.
  3. Select the button to connect to your integration.
  4. You’ll be taken to a page for signing into either Xero or QBO, where you should sign into your testing account.
  5. Connect to the Xero or QBO organization and you’ll be routed back to the mappings page on your flow.
From here, you should be able to fully test the behavior of the accounting integration, including account mappings and configurations. To see some examples of what these integration flows look like, see the Example views section.

​
Flow types

  • xero_accounting_integration: Complete end-to-end integration setup for Xero, triggers a “gusto:flow-finish” flow event upon completion of all mappings.
    • Individual child flows for custom navigation with Xero:
      • xero_mappings: Account mapping configuration only
      • xero_settings: Integration settings management
      • xero_payrolls_to_sync: Payroll synchronization interface
  • quickbooks_accounting_integration: Complete end-to-end integration setup for QBO
For more information, including any flow events and how they are triggered, see our Flow Types guide.

​
Example views

Check out these example views of the flows, which have similar UI for both Xero and QBO flows.

​
Mappings page

Below is an example view of the mappings page for a Xero integration: Example view of mappings page on a Xero account integration, showing accounting categories such as Tax adjustments or Benefits and whether they are assigned.

​
Configuration page

Here is an example view of the configuration page for a Xero integration: Example view of the account settings page on the Xero accounting integration flow, including options such as how to configure how to consolidate journal entries.

​
Sync payrolls page

Here is an example view of the page for syncing payrolls manually and viewing past payroll syncs: An example view of the section for syncing payrolls, displaying payroll dates, what type of payroll they were, check date, payroll amount, last synced, and an option to sync the payroll again.

​
FAQ

​
Where will I see synced data on my accounting integration?

In Xero: Xero has two options for syncing payroll data, configurable in the Xero payroll accounts settings under Xero transaction type.
  • If you sync as “Bills,” each payroll will sync to Business > Bills to Pay.
  • If you sync as “Journal,” each payroll will sync to Accounting > Reports > Journal Report,
In QBO: From http://developer.intuit.com, navigate to your sandbox company. From there, click Reports > Standard Reports and then search for “Journal” to see where ledger data will sync.

​
Are these flows customizable?

Yes, you can customize the logo in the left panel once inside the flow. The auth page is not customizable, as it’s not owned by Gusto.
401(k) (Vestwell) Submit Feedback