Shopify and Xero Integration Guide

With OneSaas, you're able to setup your complete integration within minutes using our simple setup process. Below is a step by step walk through, highlighting some useful key points throughout the process:

  1. Connect
  2. Configure
  3. Retrieve & Validate
  4. Preview
  5. Send & Finish


Begin here by connecting your apps to OneSaas. If you haven't already connected your apps, you can follow our guides to integrate Shopify and Xero. Select Configure to move forward.

Back To Top


The configuration process described below is for a standard integration between Shopify and Xero. If you are also connecting a third app, then you'll have to configure this as you go through the setup process.

Please never hesitate to reach out to our friendly support team for help at any point in time.

  1. Start the configuration process by selecting the first workflow, to sync Shopify orders into Xero, as shown below:
  2. An Advanced Settings window will pop-up:
    • Retrieve Orders with Statuses

    Select the order statuses you'd like OneSaas to retrieve from Shopify and send to Xero. 

    • Retrieve Orders with Payment Status

    Select which orders you'd like to be retrieved from Shopify based on the payment status.

    • Order prefix

    The prefix you input here is added to all your orders retrieved from this Shopify account. For example: if you have order '1234' in Shopify and you add the prefix 'SPFY-' in the configuration. Your order will be retrieved into OneSaas with the order number 'SPFY-1234' and sent to Xero accordingly.

    This prefix can be configured separately for multiple Shopify connections, to make it easier to identify the source of each invoice in Xero.

    Tip: The Order Number Prefix is limited to 4 characters!

    • The Shipping and Discount Products

    The shipping and discount products are used by OneSaas to represent all shipping / discount values on orders. You can either select one from the already existing inventory list or create a new item by clicking on the '+' button. You can read more about how this works here. Click on Save Changes.

  3. You'll be now redirected to the first page of the configuration to select additional workflows:
    • The first option allows you to select how you want your Shopify paid and unpaid orders to be sent to Xero. The options are Draft, Submitted/Awaiting Approval or Authorised/Awaiting Payment. Please select the appropriate option for your business.
    • At the second configuration option, you can select how the orders should appear in Xero: with the Original Customer, the Customer's Organization (Company) or a single Online Sale customer. You can read more details about this here.
    • Select this option if you want OneSaas to automatically create your Shopify items in Xero. The products will only be created if they do not already exist in Xero. Please be sure to read our guide to data matching here if your products are already setup in Xero, to prevent duplicates from being created.
    • Select the option to sync payment details from Shopify to Xero, if you wish OneSaas to automatically transfer the payment details.

    Click on Next.

  4. You'll be taken to the tax configuration page:Here, for each tax created / defined in your Shopify, you must select it's correspondent tax in Xero. You can read more about the tax configuration here. Click on Next to continue once you are done.
  5. The next page will require you to map the payments from Shopify to a Xero account.Additional details about the payment mapping can be found here. Click on Next.
  6. Here please select how you wish orders to be sent to Xero. They can be posted individually or as daily summaries to Xero. More information about the daily summaries here. Hit Next to continue.
  7. Select the option at this step, if you wish OneSaas to automatically update your stock from Xero to Shopify. Please note that if your items are not setup accordingly in Xero then this option will overwrite your Shopify stock with 0. Click on Next.
  8. The Transaction Settings allow you to select the automatic invoice number and the default due date.
    • Automatic invoice number

    By selecting this option OneSaas will allow your accounting system to assign an automatic invoice number, e.g. to adhere to sequential invoice number rules, rather than using the invoice number provided by Shopify.

    • Default Due Date Offset

    Default Due Date offset for new transactions that have no Due Date. This option will never override DueDates received from other systems.

  9. On the Items Settings configuration page, you'll have to select the income and expense accounts to be used for inventoried and non inventoried items. To read more about the products setup please click here.
  10. You've now reach the final page where you can review your configuration, set the integration start date, select your timezone and the automatic synchronization. Please note that you must agree to the OneSaas user agreement terms and conditions before you can trigger your first synchronization.

Back To Top

Retrieve & Validate

OneSaas should now be syncing. As soon as this is done, you're able to use our review page to fix up any remaining configuration changes you weren't able to get to. For example, if you weren't able to map your tax's initially, you can do so now! Once everything is good to go, you should see a big green tick indicating you're ready to move forward. Please select Preview to continue.

Back To Top


Finally, you're able to see the data that we were able to pull into OneSaas. For example, in the screenshot below you can see an invoice that were were able to pull in from your Shopify store. If you're happy with everything, select Send Data & Finish to push your data as configured by yourself.

Back To Top

Send & Finish

You should now see another sync running. However, this time instead of just pulling your data into OneSaas, we're pushing it too. Once the sync is completed, you'll be taken to review your first report. Once you've had a look you can either upgrade to a paid plan or continue with the free trial.

Back to top


Was this article helpful?
0 out of 0 found this helpful



Powered by Zendesk