Skip to content

Free · In the Linnworks Application Store since 2020 · Used by over 400 merchants

Bring your channel's order data into Linnworks

Gift messages, delivery instructions, personalisation, checkout fields: your sales channel sends them with every order, and Linnworks stores them in the order's XML where nothing can use them. XmlExtractor copies the values you name onto the order as extended properties or notes, so the Rules Engine, order views, pick lists, and invoices can use them.

Install from the Application Store Read the docs

  • Channel data, on the order


    WooCommerce order meta, Shopify checkout and line-item attributes, Etsy personalisation and variations, or any node in any channel's order XML. Name it, and it lands on the order.

  • Nothing to host, nothing to log in to


    XmlExtractor is a macro. A Rules Engine rule runs it as each order downloads, inside Linnworks. There is no server, no account, and no subscription.

  • Ready for Shopify's GraphQL change


    Linnworks is switching Shopify stores to a new order XML. XmlExtractor reads both shapes, and most configurations carry on unchanged. The migration guide covers the rest.

How it works

  1. A Rules Engine rule runs the macro for an order.
  2. The macro fetches the order's channel XML through the Linnworks API.
  3. For each path in NodesToBeExtracted, it finds the node and reads its value.
  4. It formats each value using Format.
  5. It writes the results to the order according to Target.

A complete configuration is three fields. This one puts a Shopify checkout field on the order as a processing note for the packing bench:

Parameter Value
NodesToBeExtracted NoteAttribute.Delivery instructions
Target ProcessingInternalNote
Format Delivery: {{value}}

Result: an internal processing note on every matching order, for example Delivery: Leave with the neighbour at number 12. More configurations, per channel, are in Examples; what a path can and can't do is on Limitations.

Install

  1. In Linnworks, go to Apps > Application Store, search for XmlExtractor, and click Integrate.
  2. Go to Apps > Macro Configuration, add a configuration for the XmlExtractor macro, and fill in the three fields.
  3. In Orders > Rules Engine, add a rule that runs the macro for the orders you want.

Getting started walks through each step, with the parameter and target tables.

Like it? Tell other merchants

XmlExtractor has been free since 2020, and reviews in the Application Store are how other Linnworks users find it. If it saves you time, open Apps > Application Store in Linnworks, find XmlExtractor, and leave a rating and a few words. Thank you.

Something missing, or a channel it doesn't read well? Tell us at renzo@rfpitsolutions.co.uk. Requests from merchants are where most of the features so far came from.

Documentation

  • Getting started


    Install the application, configure the macro, and create the rule.

    Getting started

  • Path syntax


    How a path names a node, the >> separator, and the prefixes for key/value lists.

    Path syntax

  • Examples


    Complete configurations for WooCommerce, Shopify, and Etsy, and a Rules Engine walkthrough.

    Examples

  • Limitations


    First match wins, leaf nodes only, and the other things a path can't do.

    Limitations

  • Troubleshooting


    Find the node names your channel sends, and work out why a value didn't come through.

    Troubleshooting

  • Support


    How to reach RFP IT Solutions, and what to include in a report.

    Support