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.
-
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¶
- A Rules Engine rule runs the macro for an order.
- The macro fetches the order's channel XML through the Linnworks API.
- For each path in
NodesToBeExtracted, it finds the node and reads its value. - It formats each value using
Format. - 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¶
- In Linnworks, go to Apps > Application Store, search for XmlExtractor, and click Integrate.
- Go to Apps > Macro Configuration, add a configuration for the XmlExtractor macro, and fill in the three fields.
- 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.
-
Path syntax
How a path names a node, the
>>separator, and the prefixes for key/value lists. -
Examples
Complete configurations for WooCommerce, Shopify, and Etsy, and a Rules Engine walkthrough.
-
Limitations
First match wins, leaf nodes only, and the other things a path can't do.
-
Troubleshooting
Find the node names your channel sends, and work out why a value didn't come through.
-
Support
How to reach RFP IT Solutions, and what to include in a report.