Support, News & Latest Downloads

Outage on 12th September 2019

Our hoster Havenswift was hit with a massive DDOS attack to all their WordPress sites which took down their main server along with all the sites.  Havenswift are a premium hoster and usually manage to prevent such attacks from taking out the server.  This is the first outage in 11 years of using them.  DDOS attacks can and do regularly affect all WordPress servers.  They had to build and restore to a new disk resulting in loss of service for just over a day meaning any Xeroom licence authentication would have failed in this period. 

We tried to post a message on the WordPress org website but they don’t permit any commercial organisations to do so despite being “in the family” and so unhelpfully removed our reply to questions.  We have taken an external download of all our users’ emails so in future we can email you of the status if such an incident ever happens again.  We are also looking at using an external 3rd party for support to communicate this.

For any orders that did not post to Xero during this outage (or future outages) simply tick the orders in the order screen and post them as a batch. Such attacks are impossible to stop, are becoming more and more common and will hit all of us sooner or later as WordPress is viewed as a favoured target.  We will normally be up again within 24-48 hours depending on the severity and this was as severe as it gets! 

Support and Help

We are looking to improve our support board soon with a third party site.  There is a lot of information here so you will find the answers to most issues listed.  If you don’t find an answer to your query then please post a topic question and we will aim to respond within a few days. 

Before posting any request please run through the following checklist as Xeroom is trying to make 2 very complex apps work with each other along with a miriad of frequently changing third-party plugins.  We do not provide free system integration work to make all your plugins work without conflict or free installs under the guise of support.  We have spend hundreds of hours of testing and bug fixing Xeroom and whilst not perfect nor entirely bug-free we do consider it to be in a pretty robust state.  We also provide a low-cost fixed-price installation service if you are not an IT professional with good knowledge of Woocommerce or Xero and we also provide a fixing service for non-working installs.

Please run through the following checklist before post a support message or contacting us:

  1. Have you checked that your server php version is 7.1 or above? 
  2. Are you using the latest versions of WordPress, Woocommerce and Xeroom?
  3. Do you have a valid Xeroom licence?
  4. Do you have ioncube 10.2 or above installed on your server?
  5. Have you checked the debug messages?
  6. Have you checked the Installation FAQs and bulletin board for your issue?
  7. Is there an active link to Xero showing as green in Xeroom?
  8. Are you able to replicate the issue on a test copy of your site?
  9. Take screenshots using a tool like Lightshot to help describe the symptoms/problem. 


Downloads & Installation

Xeroom Free Trial Licence – We no longer offer the limited free trial version.  Instead we offer a full licence for evaluation purposes that runs for free for 1-2 months.  Please email us with a blank email to [email protected]. You will get an automated response back within a min. If you don’t receive it for any reason please check your spam folder and if not there email us on [email protected]

WordPress Official Site – We are unable to host Xeroom on the official WordPress server since like many plugins we have encrypted code in it which is not permitted.  All our downloads are hosted here instead.

ioncube & Errors on installing or activation.  The xeroom download from WordPress is encrypted with the popular ioncube encoder.  In order to run the server must have the free ioncube loader installed. ioncube loader 10.2 is the latest which works with php 7.1 and above.  Please ask your host to provide this as it should be installed as standard and over 95% of hosts do.  If you need a new host who does have ioncube then please consider Havenswift  who have given me great service over the last 10 years.

We now only support php 7.1, ioncube loader 10.2, Woocommerce 3.5.3, WordPress 5.0.1 and above.  To check your current versions of:

  1. php – install the WordPress version info plugin and it will show in your page footer on the right.
  2. ioncube – install the ioncube tester plug plugin and it will show you the version no at the top of the page.


Xeroom v2.0.8 – 22nd May, 2019

NB: Requires the following min versions to work: php 7.1, ioncube loader 10.2, Woocommerce 3.5.3, WordPress 5.0.1  Download 

Bugfixes the “cannot redeclare oauth” critical error caused by conflict with other apps.



Xeroom v2.0.7 – 15th March, 2019

NB: Requires the following min versions to work: php 7.1, ioncube loader 10.2, Woocommerce 3.5.3, WordPress 5.0.1 Download

Contains the following fixes:

  1. Get_xero_option and ends_with fatal errors on activation (conflict with other plugins).
  2. Oauthconsumer declare critical error – when oauth used by other apps. 

Xeroom v2.0.6 –  21st February, 2019

NB: Requires the following min versions to work: php 7.1, ioncube loader 10.2, Woocommerce 3.5.3, WordPress 5.0.1 Download

  • Added – Rounding error fix.

Xeroom v2.0.5 –  30th January, 2019

NB Requires the following min versions to work: php 7.1, ioncube loader 10.2, Woocommerce 3.5.3, WordPress 5.0.1 Download 

We are pleased to release this version after extensive beta testing, improvements and fixes.   It is a big step forward and has the following new features and enhancements:

  1. Global Inventory Synchronization – Instead of just synchronising the inventory for the SKUs in the current order this feature provides a synch of all products’ inventories on demand or on a daily or hourly schedule.  Synchronization can be from Woo to Xero or vice-versa.  This will be invaluable to handle inventory for businesses that take phone orders that are entered directly into Xero (without going through the website) or via other online shops such as ebay or Amazon as well as normal website orders. This feature alone is worth it’s weight in gold since competitors charge up to $250/month for this with a dedicated inventory management system. 
  2. Send Orders and Payments to Xero in Batches – Instead of sending orders automatically at check-out this feature enables a selection of orders to be made on the Woocommerce order summary screen which are then sent to Xero in one go.  This is great for those taking feeds of orders from other systems into Woo that then need to be onward processed into Xero.  It is also useful for migrations where use of the Bulk Data Loader would be overkill and a few dozen orders can be simply and easily posted.  A throttling system has been added to feed Xero orders at a steady rate to avoid hitting their rate limits.
  3. Set Invoice Creation Trigger – Invoices can be sent manually or automatically on checkout or on completion. This is an alternative to the Auto completion control which is useful for preventing payments being posted automatically which makes the Xero invoice status “Paid” and thus editable.
  4. Set Invoice Creation Date – Can be set to be the date of posting or date of the order.
  5. Country tracking – The customer country is placed in the Xero custom country tracking label.  This can then be used for things like EU VAT reporting on digital goods where different VAT rates are due for different countries.
  6. Set Unlimited No of Sales Categories – The posting by geography or product category has been set to a customisable quantity and increased from 25 to an unlimited no.
  7. Xero Order Posting Management & Status – The Woo order summary screen now has a colour coded column giving the status of posting to Xero for each order.  The user can see at a glance the overall picture and easily manage them.
  8. Bulk Data Loader – Many improvements have been made in this tool for the posting and logging of large numbers of orders.  This is essential for those migrating and wanting their history to be uploaded into Xero.  The limit of 2000 has been removed, the Xero API feed rate of orders is now throttled to prevent limits being hit and the log files have been improved.
  9. Gross Prices Held in Woo No Tax Applied – Xero assumes prices are posted as net and so adds on GST which means it is added twice if prices are held gross in Woo.  This will fix it to remove the GST before posting so that it will be correct.
  10. No Taxes Fix – When no taxes are selected in Woo then Xero should not add on taxes on posting.
  11. Currency Deprecation Error – Fixed.
  12. Cancelled Orders at the Checkout  – Were wrongly being sent to Xero when they should not have been, now fixed.
  13. Rounding Errors – Are now placed in a Xero revenue ac.
  14. Coupons and Discounts – This has been rewritten to fix a bug and work properly.
  15. Free Trial Licence  – Button now sends an email request to our server for a trial licence key which is sent by the autoresponder to the user’s inbox.

Xeroom v2.0.4 Downloads – July 2018

Xeroom v2.0.4 for ioncube loader 10.2 which will run on php 5.6-7.2  download This is the latest versions and what most people have if you are not sure and want to try.   Xeroom v2.0.4 only for ioncube loader 10.0-10.1 which will run only on php 5.6 – 7.0 download

Xeroom v2.0.3 Downloads – March 2018 

In case you want to use an older version:

Xeroom v2.0.3 for ioncube loader 10.2 which will run on php 5.6-7.2 download 

Xeroom v2.0.3 only for ioncube loader 10.0-10.1 which will run on php 5.6 – 7.0  download



To install Xeroom on your site just download the plugin zip file from the link below to your pc.  Then go to Plugins/New/Upload/Choose File Then pick the downloaded zip file /Upload and it should install.  Then send a blank email with “Free Licence” in the subject line to [email protected] and you will get by return a licence key valid for 2 months or so.  Enter this and then click activate which will give you a green success message.  NB: If you don’t have Ioncube loader on your server it will not install or activate.

If you deleted a previous install to reinstall the new install will fail if the old files and xeroom directory have not been deleted so check if you get an error saying installation failed.

Encryption error

Normally you will be given a meaningful error message if you don’t have ioncube loader installed.  Occasionally, if you are using older versions of xeroom and php you will get a page of encrypted code like below then the normal error checking has failed as you should get a message.  You are either using an older version of Xeroom ie before 2.0.3,  and/or have no ioncube loader on your server and an old also an incompatible version of php running.  So please install the latest version of Xeroom, set your php to run v7.2 in cpanel and ask your hoster to install ioncube v10.2 and then it should work fine.

Frequently Asked Installation Questions

What does ‘o’ mean on the debug table?
‘o’ in debug means that the comms are not working between Woo and Xero so the API keys are missing (if they are wrong you will get an oauth authorisation error message).  Ensure that you have used the correct security certificate in the Xero app to create the keys as is in the \xeroom\library\certs\ folder.  Some of the settings are wrong or some information is missing in the settings page. Try checking the installation instructions again. Common errors include; the wrong code from Xero is being used, or incorrect words in the Sales Tax Account Name box.
I don’t have any sales tax what should I put in the Sales Tax Account Name box in settings?
For no sales tax then you have a choice of any tax method in Xero that is zero rated eg “No VAT” – see here for examples
Why am I still unable to receive invoices in Xero even through all the Xeroom settings are correct?
It may be helpful to remove and reinstall the plugin. Make sure that the old Xeroom director is deleted using the File Manager plugin. This often fixes any errors left by other conflicting plugins. You may also wish to try a new set of API keys.
What plugins should I avoid when using Xeroom?
Some people have found that other plugins which link Wooocommerce to Xero can conflict with Xeroom. We recommend that you test any connections in Xero and any WP plugins one at a time to reduce any conflicts.  Jetpack does as do the other plugins that speak to Xero such as Zapier or the WooCommerce connector for Xero.  Make sure such plugins are at least deactivated and preferably removed.  Then reinstall Xeroom so that no Xero API conflicts are hanging around in caches etc.

I don’t charge shipping what code should I use in Xeroom settings?

The default in Xero is 200 (the same as for sales) however you can create your own in Xero chart of accounts. If you don’t include shipping costs in Woocommerce orders then this will show as £0 on Xero invoices and in the next version will not show at all as a line item.
What bank code should I use?
This must be the Xero code not the actual bank code itself.  Xero does not have one set in the default chart of accounts so label your account with one usually 100 makes sense to use but you can change this in Xero if you wish