Xeroom Updates & Releases

We provide release notes on the latest version bug fixes and enhancements as well as the previous recent history.

Known Issues:

Any issues that we are aware of and working on will be listed here.  If you hit a new or unexpected issue after upgrading then please let us know with an email to [email protected] and if important then roll back to the previous version.  We aim to get urgent fixes tested and released within a few days but if complex it may take longer.

Latest releases are given below with summary notes.

 

Xeroom Version Development & Releases

WordPress Official Site – We are unable to host Xeroom on the official WordPress site since our plugin is not free.

Minimum Supported Versions – Xeroom is always checked to run on the latest stable (ie normally within a week of release) versions of WordPress and Woocommerce. PHP is supported to 8.3.20.  We now only support these min versions php 8.2, Woocommerce 8.1 and WordPress 6.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 by logging in to Menu/Resources/My Account above.

Knowledge-base Support Portal – This is available on Menu/Resources/Help Portal for immediate self-help support on common issues that have arisen with more than one customer.  Please check here first for a solution before raising a Help Desk Ticket.

Automatic upgrade process  -You will get a notification of the update 12 hours after we release it in your WordPress plugin page.  Just select Update Now and it should upgrade automatically. All the settings should be saved but please double-check and that it is showing the Premium version if you are using that.  If it doesn’t show then simply hit the licence reactivate button and it will switch.

Manual upgrade process –  The plugin and release notes are available in your account download area. Downloads are available for up to one year after purchase or renewal.  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.

Cancellation – You can cancel your subscription at any time but we do not provide prorata refunds.

 

Version 3.2.5 – Due out 10th December, 2025

Bug Fixes:

1. Inventory synch log files – Fixed for missing items and show better messaging.
2. WC email preview error.
3. New product creation in Xero from Global Product Synch failing.
4. Saving of API credentials on virgin install of Starter Version.

Enhancements:

1.Compatability added for WC Smart Coupons Plugin by Storeapps – This is one of the best coupon/discount plugins.
2. Link to WC order from Xero invoice added – click through to the relevant order in WooCommerce from the Xero invoice.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3. COGS mapping added to Global Product Synch – Now the costs of good sold fields set in WooCommerce at the product level can be mapped to the same products in Xero.
4. Inventory adjustments and bills generated in Xero now use COGS instead of 0.

5. Daily summary orders – These are now handled so instead of lots of small value invoices getting created in Xero only one gets created with a breakdown of all the orders & payments made for the day.  This is very useful for retail shops who don’t capture full customer details.

 

 

 

 

 

 

 

 

 

Version 3.2.4 – Released 13th October, 2025

Bug Fixes:

1. Address mapping postcode error.
2. Invoice # Cannot be empty.
3. Order wrongly sent on Completion when set to be Manual.
4. Fix “An inventory synch is already running” error.
5. Add Xero token buffer and cache clear every 15 mins.
6. Fix parsing of special characters to Xero for Tracking Categories.
7. Starter version Xero Authorize button not displaying.

Enhancements:

1. Xero credentials UX mod for saving.
2. Updated Xero SDK library.
3. Remove all Xeroom data from dtb.

 

Version 3.2.3  – Released 28th August, 2025

Bug Fixes:

1. Xero error – Invoice # cannot be empty – Number check added to avoid this error.
2. Tax on product discounts was not correct.
3. Address mapping was missing a line.
4. Xeroom licence behaviour on authentication failure – If no connection made to our server 7 days grace period kicks in. Messaging and UX improved for connection.
5. Starter version tax was being posted as a rounding adjustment.
6. WooCommerce Wholesale Pro Suite Compatibility Issue – Wholesale discount handling fixed.
7. Send Payment on Completion fixed – For bank transfer gateways.
8. Credit note processing Xero error – “The invoice you are trying to allocate to has already been paid off”.

Enhancements:

1. Inventory synch – For variable products the parents are now synched too. 5 minute synch removed to prevent problems with synchs not completing.
3. Product synch – Option to Synch All products added and special characters encoded.
4. Synch logs Improvements – Child ID added instead of associated parent.
5. Improved error logging – All Xero API errors are now added to the Xeroom debug log.
6. Product description – Confusion caused by truncating long WC descriptions to 50 characters when using special characters.
7. “On-the-fly” variable products – Attribute description and selection now added to the invoice line item description.
8. Discounts – Now posted to COGS account in Xero and corrected for tax.
9. Inventory synch tab layout – Improved UX notes, warning and help article link added.

10. % Discounts displayed in Xero – Choice of show as line item or discount %

 

 

 

 

Version 3.2.2  – Released 28th June, 2025

Bug Fixes:

1. Refund error in WC release 9.9.3 – gave an E_Error call to member function get_items.
2. Refund validation exemption error – When no payments are sent from WC and “Ensure Original Payment Sent prior to Generating Credit Note,” is not set to No. Xero sets the wrong account type for payments to Overheads causing this error and ” account type is wrong”.

Enhancements:

1. Inventory synch – Warning messages given if scheduled synch fails to run.
2. LineAmountTypes – Allows control of how Xero receives the line items tax from WooCommerce ie exclusive, inclusive or notax – Note for “Inclusive” there is a known error of Rounding Adjustment.  Previous versions had this set by default to be “Exclusive” which worked fine on everything apart from Stripe Fees in the Australian region which exported exclusive and had tax added twice leaving a hanging payment due.

 

3. Xero Field Mapping – Mapping of custom fields to Xero.  You can now map any field to Xero eg capturing of customer VAT and placing against the contact in Xero.  The field can be a standard WooCommerce field from the wp_postmeta or wp_usermeta  tables or additional custom fields created by any custom field plugin such as the free advanced-custom-fields plugin . You can map them to any valid field in the Xero contacts or invoices section – more details given in the Xero API documentation. Note this is a powerful feature intended for IT/Web experts only and provided as is without support although we welcome any bug reporting.  Any mappings should be fully tested.

 

Version 3.2.1  – Rolled into 3.2.2 above

If you need these known errors showing in the WC Status/Error Logs fixing before the release date please email support for a download.

Bug Fixes:

  1. Payment Sending not sending – Due to on Processing GetStatus Error in the last release if you use HPOS and not set correctly.
  2. GetMessage error on order Completion for some orders – E_ERROR in line 9052
  3. Call to a member function get_status() critical error – indexinit 8719

Enhancements:

1. WooCommerce Wholesale Pro plugin compatability added.

2. Starter version – Xero Order Status column added.

 

 

Version 3.2.0  – Released 7th June, 2025

Bug Fixes:

1. Inventory synch on a schedule – was stopping occasionally.

2. Payment Sending on Processing – was not sending in the last release.

3. Synch of Xero payments back to WC – Bug in processing status change from 3rd party plugins fixed.

Enhancements:

1. Extra Sales Account by Product Category – Current asset and liability accounts added to drop-down list for selection.

Version 3.1.9  – Released 30th May, 2025

Note: Version 3.1.8 was rolled into this version due to adding more enhancements.

Bug Fixes:

1. Credit notes “Validation exemption” error – Fix for case where payment not sent from WC but made in Xero. Now it is synched back to Xeroom to permit the refund.

2. Filter orders by Xero status – Fixed after changes in WooCommerce hooks.

Enhancements:

1. Global Product Synch – This has been improved by adding Update (existing products only) or Replace (all products existing + new)

2. Xero Account Drop-Down Selection Lists – These now exclude deleted or voided accounts from Xero.
3. My Account Page Improvements – to fit in with new website and show all licences, subscriptions etc.
4. Xero Connection – Improved error handling and messages in event of failure.
5. Global Inventory Synch – When on a schedule and with server based cron execution a new synch job will not spawn until the previous one has completely finished.  This avoids any overload building up on the server if it is hit with a delay or attack for any reason.
6. Stripe Fees – Expense type account can now be used as well as Overhead type for posting to.
7. Sales posting to Current Liability Accounts in Xero – This is now enabled which is useful for clearing accounts (usually Current Assets) or a deferred liability (eg for memberships)
8. Configure payments posting by order status change triggers AND by gateway.

9. Add Xero errors to the WC Order notes as well as Xeroom Debug. The name of the user who posts the order is now stamped on the notes for audit purposes.

 

Version 3.1.7 – Released 26th February, 2025

 

Bug Fixes:

  1. Credit Notes failed to post – 400 Bad Request validation exemption occurred due to the CN status being Awaiting Approval and not Authroised.
  2. Recurring coupons fixed product discount – not posting the correct qty for multiple uses of same coupon.
  3. Company Name Address Mapping Empty – When using a different delivery address to billing caused a blank address for some Contacts
  4. Partial refund of shipping – Credit Notes were not correct – Known issue not fixed yet.
  5. Global Inventory Synch – for Xero to Woo when a tracked product was 0 was not updating in WooCommerce and “Untracked in WC” log file entry wrong.
  6. Coupon tax to follow product correctly.

Enhancements:

1. Global Inventory Synch Debug – Limit of 10 products removed.

 

Version 3.1.6 – Released 8th February, 2025

 

Bug Fixes:

1. Global Inventory Synch – Stopping at first batch.

Enhancements::

1. Coupons & Discounts – Amount can be posted to a separate contra-sales account so total value is available.


Version 3.1.5 – Released 4th February, 2025

Bug Fixes:

  1. Coupons – Xero error of “line total does not match expected line total” due to WC code change.
  2. Extra sales accounts for geography not displaying correctly

Enhancements:

  1. Xero Account No – Added to the Order and User List screens
  2.  Discounts – Can be posted to expense account so the value of all discounts and coupons can be seen.

 

Version 3.1.4 – Released  15th January, 2025

Bug Fixes:
1. Invoice Due Date – Getday on null error fixed.
2. 100% Discount & Zero Value Orders not Posting
3. Xeroom_root_path – error fixed.
4. Invoice prefix field setting fixed.
5. Success confirmation message fixed.

Enhancements:
1. Inventory log synch file improvements.
2. Payment methods – List only enabled ones not all
3. Coupons – WooCommerce Subscription Recurring % coupons added in addition to Simple coupons.

 

Version 3.1.3 – Released  6th November, 2024

Bug Fixes:

  1. Contact Mapping – Populating address details from Xero when set now fixed.
  2. Extra sales accounts – Setting not showing
  3. E_Error line – Xeroom.php line 439 uncaught string.
  4. Guzzle Error On activation -Library Conflict with other plugins

Enhancements:
1. Contact mapping – Mapping option added to enable mapping of the contact details by Xero Contact Account number.  For example this enables companies to map orders from different branches to the same head office address in Xero.  The account number is set in the WooCommerce User details:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2. Shipping Method – This now shows on the invoice after the word shipping (which can be edited if desired).

 

 

 

 

 

 

3. Xero Invoice Due Date – The Xero default settings can now be used on the invoices created including specific ones by contact.

 

 

 

 

 

 

 

Version 3.1.2 – Released  12th September, 2024

Enhancements:
1. Extra Sales Accounts Mappings – Drop down lists of eligible acs added.
2. Log files no limited to 50 to avoid clutter.

Bug Fixes:
1. Global Product Synch – WC to Xero not synching for new products.
2. Global Product Synch – Xero to WC not working.
3. eBay and Amazon – Feature setting not saved.
4. Daily limits to no of order sends – Counter sometimes errors and displays a 0 instead of user error message.

 

Version 3.1.1 – Released 7th August, 2024

Enhancements:
1. Set invoice due date to a specific day of the month – Useful for payments on account. This is in addition to the existing custom due date where you can add extra days to the Xero default setting of 3 days. In the case of February it will use 28th if the specific day is set to be >29th.

2. Global Inventory Synch – The synch was not cycling through all the batches due to changes in WooCommerce that meant only the first batch ran. This has been fixed and improved with batches processed at the rate of one/minute and progress is also shown for the Synch Now button. Log files are generated for each batch.

3. Global Product Synch Set Batch Size – We have added the same batch size options that are in Global Inventory Synch.

4. Improved log files – The log filenames have been shortened and a batch number suffix added to each one for each run so it is easy to check that the synch is happening correctly and for all batches.

5. Filter products that are synched – In the WooCommerce All Products page we have added a filter to show the ones that are synched with Xero.

6. Xeroom Circuit Breaker – This limits the max number of orders and refunds that can be posted to Xero per day. The default is 50 but can be set.

Bug fixes:
1.Global Inventory Synch – The synch was not cycling through all the batches due to changes in WooCommerce that meant only the first batch ran.

1. Bulk resend status bar – was not showing on some sites.

2. Stripe fees – are now passed gross to match the payment and avoid tax being added again which was left unpaid in the Stripe Fee bill.

Notes on:

  1. How to bulk load product Xero attributes/ac settings
  2. Cron job management

Download full release notes.

 

 

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.

Enhancements:

    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.