Support, News & Latest Downloads

Support and Help

We provide support from here instead of the site who do not allow commercial plugins to be hosted.  If you don’t find an answer to your query then please post a topic question and we will aim to respond within 48 hours.

Licence Error

The lack of service means that the licence authentication would have failed in this period resulting in any orders not being posted to Xero and a “licence error” in debug.  To fix the orders will need to be manually sent to Xero by ticking them and selecting post as a batch in the Woocommerce order screen.  In general any loss of communication between your server and ours will trigger the same error which can happen from time to time for a variety of reasons outside of our control.


Downloads & Installation

Xeroom Free Trial Licence – We provide a full trial licence for 1-3 months for free.  The current key is TRIALMAR3120 which will run until the 31st March 2020.

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?
When the “Active” button is not showing as green in the settings page it means that Xeroom is not able to communicate from Woo to Xero.  This is usually accompanied by an “oath authorisation” error message in debug that sometimes gets truncated to ‘o’ . It means that the comms are not working between Woo and Xero so the API keys are either missing or wrong.  Ensure that you have used exactly the same security certificate in the Xero app to create the keys as is in the \xeroom\library\certs\ folder which is normally the default one that ships with the app OR if you have created a custom one then it is the same in both locations.  It can also mean that 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 Woocommerce 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
Invalid Documents debug error
This will occur if you have not used a valid Xero ac code for your payment/bank accounts in Xeroom.  Any preceding zeros or blanks are not permitted in this code despite being able to set them like that in Xero it will not permit payments to be made against them!