Linnworks

Linnworks is a WMS (Warehouse Management System) that reads live edits when the order status is set to "ON HOLD".

Integration methods available: Delayed Payment Capture Flow OR On Hold Status Flow


Integration Method 1: Delayed Payment Capture

When to Use This Method

Use Delayed Payment Capture if:

  • You want orders to download to Linnworks AFTER the editing period

  • You don't need Linnworks to read live edits during the editing window

  • Standard setup with no special stock management requirements

How It Works

Linnworks downloads orders when payment status is "Paid". By delaying payment capture, orders remain "Authorized" during the editing window and download to Linnworks only after edits are complete.

Setup Instructions

Step 1: Import Delayed Payment Master Flow

  1. Download DELAYED_Order Editing_Master Flow.flow

  2. Navigate to Shopify Admin > Apps > Shopify Flow

  3. Import the Flow file

  4. Configure timing to match your editing deadline (e.g., 30 minutes)

  5. Activate the Flow

  6. Save

Step 2: Change Payment Capture Setting

  1. Go to Shopify Admin > Settings > Payments

  2. Change Payment capture method to Automatically after fulfillment

  3. Click Save

Step 3: Verify Linnworks Channel Settings

Important: Confirm Linnworks is configured correctly.

  1. Log in to Linnworks

  2. Go to Channel Settings for your Shopify store

  3. Verify:

  4. Download paid orders: ENABLED (standard/default)

  5. Download unpaid orders: DISABLED (checkbox should be OFF)

  6. Save if any changes were made

Note: This should work out of the box for most merchants, but it's wise to confirm their channel settings.


Integration Method 2: On Hold Status

When to Use This Method

Use On Hold Status if:

  • You need Linnworks to read live edits in real-time

  • Stock is managed by Linnworks and needs to be reserved for orders

  • Orders have future delivery dates

How It Works

Orders are placed "ON HOLD" during the editing window. Linnworks downloads these on-hold orders and can read live edits. Payment is captured immediately (not delayed), but orders remain on hold until the editing period expires.

Setup Instructions

Step 1: Import HOLD Master Flow

  1. Download HOLD_Order Editing_Master Flow.flow

  2. Navigate to Shopify Admin > Apps > Shopify Flow

  3. Import the Flow file

  4. Configure timing to match your editing deadline (e.g., 30 minutes)

  5. Activate the Flow

  6. Save

Note: Payment capture settings in Shopify do NOT need to be changed. Leave on Automatic.

Step 2: Enable "Download on hold orders" in Linnworks

  1. Log in to Linnworks

  2. Go to Channel Settings for your Shopify store

  3. Enable the checkbox: "Download on hold orders"

  4. Save

Important: Orders will show as "unpaid" in Linnworks, but this is just how Linnworks displays on-hold orders. Do NOT enable "Download unpaid orders"—leave that disabled.

Reference: Linnworks Order Editing Integration Guide

Step 3: Disable "Stop edits once payment is captured" in Order Editing

  1. Navigate to Order Editing Settings

  2. Locate "Stop edits once payment is captured"

  3. Disable this setting (toggle OFF)

  4. Save

Why? Since payment is captured immediately with On Hold Status, this setting would prevent customers from editing. Disabling it allows edits during the hold period.


Which Method Should You Choose?

Feature

Delayed Payment Capture

On Hold Status

Live edits in Linnworks

No

Yes

Stock reservation

After editing period

During editing period

Payment capture timing

After editing period

Immediate

Future delivery dates

Not ideal

Supported

Setup complexity

Standard

Requires specific Linnworks settings

Recommendation:

  • Most merchants: Use Delayed Payment Capture (simpler, standard)

  • Stock-managed stores or future delivery: Use On Hold Status


Settings Summary

Method 1: Delayed Payment Capture

In Shopify:

  • Payment capture: Automatically after fulfillment

  • Shopify Flow: Delayed Payment Master Flow active

In Linnworks:

  • Download paid orders: ENABLED

  • Download unpaid orders: DISABLED

In Order Editing:

  • Editing Deadline: Configured


Method 2: On Hold Status

In Shopify:

  • Payment capture: Automatic (no change needed)

  • Shopify Flow: HOLD Master Flow active

In Linnworks:

  • Download on hold orders: ENABLED

  • Download unpaid orders: DISABLED

In Order Editing:

  • Stop edits once payment is captured: DISABLED

  • Editing Deadline: Configured


Testing

Test before going live (for either method):

  1. Place test order

  2. Verify order appears in Linnworks at correct time:

  3. Delayed Payment: After editing period expires

  4. On Hold Status: Immediately, marked as on hold

  5. Make edits during editing window (add/remove items, change address)

  6. For On Hold Status: Verify edits appear in Linnworks in real-time

  7. Wait for editing period to expire

  8. Confirm order is released from hold (if using On Hold Status)

  9. Verify all edits are reflected correctly


Troubleshooting

Method 1: Delayed Payment Capture

Orders appearing too early: Verify Linnworks isn't downloading unpaid/authorized orders

Orders not appearing after grace period: Check Flow is capturing payment correctly

Edits not reflecting: Ensure edits were completed before payment capture


Method 2: On Hold Status

Orders not appearing in Linnworks: Verify "Download on hold orders" is enabled

Can't edit after payment: Check "Stop edits once payment is captured" is disabled in Order Editing

Orders not releasing from hold: Verify HOLD Master Flow is removing hold status after editing period


FAQ?

How do we integrate?

What is Shopify Flow?

Last updated