I have tried printing a Spring Omni label and am seeing an error returned:

Error: 1: Invalid input : Spring Clear setup incomplete


The error message indicates that IOSS Order* is missing vital information, specifically MARKETPLACE_IOSS Order Extended Property.

*From the 1st of July, 2021, new EU VAT legislation requires online marketplaces to collect and declare the VAT paid on goods entering the EU valued at less than 150 EUR. To inform couriers that the marketplace has collected this tax, marketplaces must attach an IOSS number to every order that meets these criteria. 

To fix this, you would need to add MARKETPLACE_IOSS Order Extended Property to the Order following the steps below:

- Go to Shipping > Integrations > Properties > double-check to which Linnworks Order Extended Property MARKETPLACE_IOSS is linked. 

- Go back to Orders > Open Orders New > right-click on the Order in question > View Order > Edit > Properties > Extended Properties > add MARKETPLACE_IOSS with the correct value and Type as Attribute.

- Save changes and print label once more.

Keep in mind: This error also can be returned for IOSS orders when 'Customs Value Includes Tax' service option is enabled, meaning that the order total submitted to the courier (including tax) may exceed the 150€ threshold and become incompatible with IOSS.

Please go to > Shipping > Integrations > Spring Omni > Services > Edit screen and disable that setting to ensure that the customs value submitted to Spring Omni would not include the tax. This will ensure that the customs value will not exceed the above threshold.

If the error message will be the same, feel free to contact Linnworks Technical Support for help!

Additional information

IOSS Numbers on Orders

Shipping - Courier changes to support IOSS