Xeroom Updates & Releases

Xeroom Version Development & Releases

Xeroom Versions –We provide below information on the latest version, the previous few versions and what is planned for the next one currently in development.

WordPress Official Site – We are unable to host Xeroom on the official WordPress server since our plugin is not free.  We have limited resources and want to invest all of our energy, money and time on delivering a World-leading quality product to our paying customers rather than be distracted with those who expect a cut-down version for free.

Minimum Supported Versions – Xeroom is always checked to run on the latest stable (ie within a few weeks or release) versions of WordPress and Woocommerce.  We now only support these min versions php 7.2, Woocommerce 4.5 and WordPress 5.4.  To check your current versions of php install any php info plugin or check with your host or on cpanel.  

Downloads –  If you have a valid licence then please obtain downloads from your account secure area – see below.

Coming soon! – New knowledgebase for faster self-help support.

Automatic upgrade process  -You will get a notification of the update a few days after the release date in your WordPress plugin page (providing you are on version 2.2.0 and above).  Just select Update Now and it should upgrade automatically. All the settings should be saved but it is wise to take screenshots of them just in case any problem arises. If you need the new functionality and fixes urgently then please email us for the download link.  Go to the new version and double-check that the settings are all retained.

Manual upgrade process –  The plugin and release notes are now available in your account download area. Downloads are available for up to one year after purchase or renewal.  Download the Xeroom zip file to your pc.  All the settings should be saved but it is wise to take screenshots of them just in case any problem arises.  Then deactivate and delete your current version.  Upload the new version from your pc, install and activate it. NB: it is important to avoid two copies on your server or to have it installed in a directory of any name other than Xeroom as that prevents the automatic updates working in the future.  Go to the new version and double-check that the settings are all correct.  Do a test order to double-check – this is easiest to do if you just select an existing order and resend it.


Version 2.5.0 – Released 14th August, 2022

An update alert has been sent to your plugin dashboard on 14th of August 2022 but if it has not appeared for any reason then please email [email protected] for a download link.  Version 2.4.2 was a bug fix release available on limited release and has been rolled into 2.5.0 which has some significant enhancements.  A brief summary is given below and full details are in the release notes.


1. Installation configuration process simplified – All the account mappings to Xero will show selections as drop-down text boxes prepopulated with all the valid account values and names from your connected Xero account.  The same will show for the valid tax methods and for product level accounts and tracking categories.

2. Order notes – Ability to turn off the transfer of notes placed on the order from going to Xero.

3. Mapping of Cost Of Goods Sold and Inventory Asset Accounts at product level – These can now be selected from a drop-down list and added onto the Product in WooCommerce. They are all shown together with the Xero tracking category (if active) and with the sales account mapping.  These mappings have been placed here rather than picking them up from the Xero end to avoid any drop in performance of the checkout when posting live orders to Xero.

4. Invoice Paid in Xero Updating WooCommerce – Bug fix and option to turn of autocompletion added.

Bug Fixes:

1. Fix for WP Engine hosting critical error on initialisation preventing activation of Xeroom.
2. Fix to stop bills being created in Xero on inventory adjustment.
3. Fix for critical Guzzle error conflicts with other plugins.
4. Fix for Xero tracking attribute not displaying on invoice.
5. Fix for Send On Hold setting not saving.
6. Fix for Xero new product creation name limit of 50 characters.



Version 2.4.1 – 8th May, 2022

Product to Xero Account Mapping Added – Products can now be individually mapped to a specific Xero sales account instead of just as product categories. This is useful for reporting on your main products in the Xero Profit and Loss Account.  Xero does permit reporting against products but only as a separate report and not part of the more useful P&L. Products can still be mapped via the categories but if set at product level will take priority.  This means that the P&L can look great by showing a break-out of important products individually and the rest as broader categories.


Version 2.4.0 – 30th March, 2022

NB: This release contains critical updates  – Please upgrade ASAP – These resolve the critical errors when activating Xeroom and when authorising the connection to Xero as a result of updates to the Xero and Guzzle libraries. The full release notes can be viewed here.


    1. Synch payments made in Xero back to WooCommerce – This feature is ideal for B2B customers that work with payments on account “POA” for orders. When an invoice is paid in Xero it will change the status in WC to state “Paid in Xero” with a blue colour.  The order status also is changed to Completed. Note the status box outline is in blue when the invoice has been automatically sent to the customer directly from Xero.
      2.Purchase Orders for WooCommerce
      – Support added so the PO number and name and address details captured by this plugin will appear on the face of the invoice in Xero as a line item (Xero won’t allow custom fields in the invoice). Again, this is useful for B2B customers who order using PO’s and pay via POA.
      3. Translate message – Xero connection status broken to be meaningful.
      4. Delivery address – Option to add to invoice.  It is added as a line item as Xero doesn’t permit any customisation of it’s invoice form.
      5. Invoice numbering – Improved layout and options added to use Xero numbering/WC Order number/Custom number from PDF plugin.

6. Invoice reference – Improved layout and use of custom invoice no or customer name with prefix, gateway and payment ref options.  Also option to use purchase order number has been added which is captured on a website using the Purchase Orders for WooCommerce plugin by McGregor Media Web Design.

Bug fixes:

  1. Inventory synch for when it reaches zero.
  2. Guzzle error for sending invoice from Xero – library updated.
  3. Shipping tax not following product tax rates for wildcard countries.
  4. Undefined index error in inventory synch WC to Xero.
  5. Invoice reference to use WC Sequential Number plugin.
  6. Undefined function error during authorisation step to Xero.
  7. Paypal gateway cancellation return.
  8. Broken connection not updating on button.
  9. Undefined property php error in bulk send
  10. Send invoice and send payment on completion.
  11. Illegal String Offsets in Tax Rates error on send invoice.
  12. Upgrade process improved and licence check added.
  13. WC version 6.1 ajax error.
  14. Guzzle error on authorising connection to Xero.
  15. Company name and Xero contact error fixed.



Version 2.3.2 – 1st December, 2021

This is our biggest release ever and has been a huge effort by the team and beta testers to get a solid stable feature-rich release.  Version 2.3.1 was on limited release from 4th November to our group of beta users.  Whilst perfection is what we hope for we do live in a real World but did find some extra bugs plus a significant issue in the way Xero handles the data.  We felt these were significant enough to warrant delaying the final release – which is now version 2.3.2.   Release Notes –   Please read these for a full explanation of the new features and how they work so you can get the most from the plugin Xeroom v2.3.2 release notes. Main Enhancements – We continue to pack in many great enhancements to Xeroom, that nobody else offers, based on solid user feedback which are briefly listed below along with the key bug fixes.

  1. Global Product Synch – Currently new products get created in Xero as soon as they are ordered.  This will update or replace all products in Xero on demand or on a daily schedule.  This will make initial setup quicker and ongoing maintenance easier.  NB: Xero will only permit this to tracked products.
  2. Send Xero invoices from WooCommerce – Orders from the WC order dashboard can be selected and processed as a batch. Xero will email them all out to the customers.  Now you no longer need to create any invoices in WC as they can be kept all together in Xero where they should be.
  3. Xero Tracking Capture – WC Products can be assigned tracking labels that have been created in Xero enabling full use of Xero tracking for sales analysis and reporting by product groups, branches, depts, cost centres, geographies etc.
  4. Xero Address No Contact in Xero – If using existing Xero addresses to map orders to their accounts and the address is blank then it will use the WooCommerce one as a fall-back.
  5. Xero Address Using Company as Contact – If the company field is blank in WooCommerce then the contact name will be used as a fall-back.
  6. Send invoices trigger “On hold” added – Some POA customers wish to show orders as “on hold” until paid at the end of the month but want to create and send invoices now. This will be possible as well as the other triggers.
  7. Rounding Adjustment Account – Now made user selectable.
  8. Sales Sub-Categories Posting – This will enable sub-categories’ descendants to be picked up and posted to the correct Xero sales sub-account corresponding to the first level of category. Eg An order for say product latte in the category Drinks/hot/coffee/ will be posted to drinks in Xero without the user having to fill in the hierarchy flags of Drinks and hot.
  9. Excel library – Version updated for download files compatible with php7.3 and above.
  10. Xero Connection URI – The exact Xero connection URI is generated and displayed for your website eliminating most setup connection errors.
  11. Inventory Synch Schedule – Near real-time synch of every 5 minutes option added.
  12. Hyphens and leading Xeros in Xero Bank Acs – added.
  13. Handling of special characters by Xero – enabled.
  14. Custom Ship Code – and description added.
  15. Order Notes – Now posted to Xero as a line on the invoice face.
  16. WC Sequential Order Numbers Plugin – Compatibility added.
  17. WC Subscriptions Plugin – Compatibility added for points based SKUs and discounts.
  18. WC PDF Invoice plugins – Compatibility extended.
  19. Debug error messages – Now displaying all as multipage.

Main Bug Fixes (30 in all):

  1. InvalidState – Connection error.
  2. Missing Payment Gateways –  Afterpay and Zippay were not showing in Xeroom Settings.
  3. Licence key not saving & authenticating
  4. Simple tax setting lost intermitendly
  5. Inventory Synch Set to None – Not unlinking the synch check on order
  6. Invoice number generator – Prefix and start number customisation not working correctly.
  7. Invoice numbering in Xero – Conflict with Xero format meant Xero sequence not being followed.
  8. Address Creation in Xero – For new addresses.
  9. Array() error – Triggered on various conditions.
  10. Coupon & discount errors – various including tax adjustment, manually applied discounts and fixed coupon being applied twice.
  11. Credit Note errors  – For zero rated tax and when invoice has a rounding error not being shown.


Xeroom v2.2.3 – 6th July 2021

This version is shipping and the update will be polled to existing users in the next week so can be updated via the WordPress normal plugin page when the notification is showing. 1. Tracking Categories added – beta version 2. Xero Connection – Xero token refresh every 15 mins to prevent drops. 3. Global Inventory Synch improvements – any error is displayed in synch tab. 4. Batch Send cron job processes optimised for call rate into XeroAPI and restart every 5 mins. 5. Fix to use hyphens in Xero ac codes. 6. Fix for GST settings not showing if only standard rate taxes set in WC. 7. Fix for manual Payment Send button not working due to Xero API changes. 8. Fix for licence authentication warning message.


Xeroom v2.2.2 – 7th April 2021

This is a quick follow-on release from 2.2.1 due to a bug in the GST/VAT tax settings.  We have fully revamped this part of Xeroom to take advantage of the improved database storage of the tax details.  A download link with release notes will be emailed out to all current customers in the next few days.  Note that your GST/VAT tax settings may need to be reset on this upgrade if you have an older version of Xeroom due to the new storage location in the database.  Also fixed in this release was the custom shipping method setting that was getting cleared when the tax settings were reset.  Full release notes for v2.2.2 and v2.2.1

Xeroom v2.2.1 – 17th March 2021

This contains the following enhancements and fixes: 1. Fixed licence authentication on first installation bug. 2. Ability to set custom shipping price code and description. 3. Ability to send orders containing SKU codes longer than the 30 character limit set by Xero. Hyphens in SKU codes also now processed. 4. Invoice Creation Date and Send Invoices settings preserved on upgrade. 5. Prevent Failed status orders from posting – set posting to be on Processing. 6. Bulk send cron job cancel button added. 7. Bulk data loader export/import spreadsheet file error fixed. 8. Enable any of the many WooCommerce PDF plugins’ numbers to be used with Xeroom eg wcpdfinvoices.com 9. Plugin updater added to enable upgrade info and one click upgrades to be done like other plugins. 10. Tax setting design improved and bug fixed. 11. Various other bug fixes. Full release notes.

Xeroom v2.2.0 – January, 2021

This is a major release with many bug fixes and over 20 enhancements making Xeroom by far the best WooCommerce-Xero integration plugin on the market.  If you don’t believe us just compare our features.  You might not need them all now but in the future that can easily change so it is worth having them there for when you do.  Many are based on useful practical customer feedback to make life easier and quicker for expensive bookkeepers and IT staff.  We have put the thought and effort in so you don’t have to.  Xeroom will pay for itself very quickly, many times over. We have spent over 250 manhours of development on this version alone during the last quarter of 2020.  The upgrade is free for existing customers you should have been sent a newsletter with a download link on.  We also offer an installation, check and test service in our shop for $97.  For more details please read our full release notes. Main Bug fixes:

  • Canadian customer tax error.
  • Deprecated Coupon Code and UnitPrice error.
  • Variable product with 3 or more variations not posted.
  • Failed orders cannot be reposted.
  • Batch loading success message missing.
  • OAuthSignatureMethod_HMAC_SHA1 class already in use.
  • Credit notes on cancelled orders charging GST twice.
  • Guzzle http class conflict with other plugins resolved.
  • Various other conflict causing errors fixed.

Enhancements added:

  1. Send invoice on order processing trigger – Option so the invoice can be posted once status changes to processing for payment on account at the end of the month.
  2. Credit note automatic generation – On full or partially refunded orders.
  3. Product posting to Xero enhanced – Price, GST rate and account to be added to new products created in Xero.
  4. Licence validation grace period – If the check fails for any reason eg server, comms or expiration then a 7 day grace period to be given before deactivation.  The licence is only checked once per day instead of on each order avoiding delays/failed postings at checkout.
  5. Set custom invoice number prefix
  6. Set custom invoice reference prefix
  7. Payment gateway card payment reference – Placed in invoice reference.
  8. Cancelled orders – Inventory entry reversed.
  9. Set Xero invoice no using WooCommerce Invoice PDF plugin number.
  10. Allow payments into credit/asset accounts – Essential for use in clearance accounts that most book keepers use.
  11. Xero Due Date – Ability to customise the default setting.
  12. New name mapping options – For company name and email address. Ability to map person name, company name or email to main Xero contact.
  13. Control of name mapping – Can use new and overwrite or existing Xero name
  14. Batch processing rate control – Added to prevent hitting the Xero API call rate and number limits.
  15. Resend an order or batch of orders – To override the control to prevent duplicate invoices from same order.
  16. Option to include/exclude payment gateways in automatic sending – This will enable the Woocommerce Invoice Gateway plugin to work which adds Invoice payment gateway functionality to your WooCommerce store. This type of payment method is used in B2B with customers placing orders “on account” that then get paid at the end of the month in one go.
  17. Add PO numbers to orders – Ability to set custom field in WooCommerce to capture this and send to Xero.
  18. Automatic purchase bill generation –Inventory adjustments caused Xero to create these which has now been prevented.
  19. Xero Connection Status – Improvements.
  20. Layout – Improved layout and new logo.

Older Versions 

Xeroom v2.1.0 – June, 2020 This has a much simplified installation procedure using the latest and more secure OAuth2.0 protocol for more secure connections to Xero.  It is also not encrypted and so does not require IonCube to work.  Tested on php7.3, WordPress 5.5.3 and Woocommerce 4.7.1.  Detailed instructions are given here http://www.xeroom.com/installation-instructions/. Xeroom v2.0.8 –  May, 2019  No longer supported.  NB: Requires ioncube loader to be installed on your server and the following min versions to work: php 7.2, ioncube loader 10.2, Woocommerce 4.1, WordPress 5.3.  Has various bug fixes including 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 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

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