What's happening
Shopify is retiring its older REST API, and Linnworks is moving your Shopify integration over to Shopify's newer GraphQL API.
Because you use Shopify POS, this isn't just a behind-the-scenes change we can carry out for you. There are a small number of settings you must check after the upgrade to make sure your POS orders keep processing automatically.
Everything else - your existing orders, statuses, and general settings stays as it is today, and Inventory sync and stock levels are unaffected.
Why this is a good thing
The GraphQL API unlocks real improvements for both your in-store (POS) and online orders:
Faster order downloads - up to around 5x faster, for POS and online orders alike.
Multi-fulfilment support - If an order ships in multiple parts (different couriers, different locations, or partial shipments), Linnworks can handle this now.
POS orders - improved handling and reliability across different POS order scenarios.
Presentment currency support - online orders can be downloaded in the currency your buyer actually paid in, rather than only your store's default currency.
Improved tax and duty handling - includes support for stores using Avalara for tax calculations.
What's changing specifically for POS
The old “Process POS orders,” which controlled whether POS orders were auto-processed, does not exist after the upgrade.
What do you need to do for your POS orders to continue auto-processing in Linnworks?
- Enable POS orders to be marked as fulfilled in Shopify’s backend/admin panel. If your POS orders are not automatically fulfilled at the point of sale, you will need to enable this in your Shopify POS settings.
- See Shopify's guide on fulfilling POS orders for instructions.
- Enable “Download processed Orders” in your Linnworks integration.
- Review the “Deduct Stock for Fulfilled POS Orders”.What it does: Controls whether Linnworks deducts stock when a POS order is processed.
- OFF (Default): Marking a POS order as processed does not deduct stock for that sale in Linnworks. Leave it OFF if: stock for POS sales is already being deducted somewhere else and it’s not managed by LW. Turning this on as well would deduct that stock twice.
- ON: When a POS order is processed, Linnworks automatically deducts the stock. Have it ON if you want Linnworks to be the single source of truth for stock across your online store and physical till, and nothing else is currently deducting stock for those in-store sales.
POS Shopify status | “Download processed orders” | “Deduct Stock for Fulfilled POS Orders” | Outcome |
POS order fulfilled on Shopify | ON | ON | Order downloads and processes with stock deduction |
POS order fulfilled on Shopify | ON | OFF | Order downloads and processes without stock deduction |
POS order fulfilled on Shopify, “Download processed orders” OFF | OFF | - | Order does not download |
POS order unfulfilled on Shopify | - | - | Order downloads but does not auto-process |
Other new settings you'll see in your integration
As part of the upgrade, some new configuration options will show up under your channel integration configuration screen. We are not switching any of them on for you, so the integration will keep working the same way it does today.
If you'd like to explore any of these settings yourself later on, they'll be there, but you don't need to do anything now.
For reference, here's what you might see:
- Split Orders by Shopify Fulfilments controls whether Linnworks creates a separate order for each fulfilment. This is the most important new setting to understand.
- OFF (Default): When upgrading and it’ll defaults to OFF after the upgrade. Most customers upgrading want orders to behave the same way they did before managing the fulfilment routing within Linnworks, so they don’t need to change it.
- ON: Other customers may rely on Shopify’s fulfilment routing and want each fulfilment to be tracked independently. Thus, the setting should be ON for Linnworks will mirror Shopify’s fulfilment assignments regardless of location mapping in the integration. A Block from Merge flag is applied to each order to prevent auto-merging. Related orders are linked via order relationships.
If you’re not sure, leave it OFF. You can change this setting at any time without re-authenticating or re-syncing.
- Presentment Currency controls whether orders download in the buyer's payment currency.
- OFF (Default): Orders download in your shop's base currency
- ON: Orders download in the currency the buyer actually paid in. This will be for customers selling in multiple currencies and want order values, and invoices in Linnworks to reflect exactly what each customer paid in their own currency.
- Uses Avalara for Tax Calculations adapts how Linnworks reads tax data so it lines up with Avalara's calculations.
- OFF (Default): Standard Shopify tax handling. You don't use Avalara, it simply doesn't apply to you.
- ON: you use Avalara's Shopify plugin to calculate sales tax.
- Download Duties as a Service Item(under Order Taxes) controls whether import duties show up as a separate line item on the order.
- OFF (Default): No duty line item is added. This matches the behaviour you're used to today. Order line counts, totals, and printed invoices are unaffected. Duty amounts are still available in the order XML.
- ON: Import duties are added as a service line item on the order, alongside your products.
