Shiptheory

Shiptheory is a shipping service that reads live edits. Orders sync in real-time once downloaded to Shiptheory.

Integration method required: Delayed Payment Capture Flow

15KB
DELAYED_Order Editing_ Master Flow.flow
Open

How Shiptheory Downloads Orders

Shiptheory downloads orders when the payment status is "Paid" in Shopify.

How the Integration Works

  1. Order created → Payment authorized (status: "Authorized")

  2. Grace period active → Customer can edit order

  3. Shiptheory does not download → Order not visible (not "Paid" yet)

  4. Grace period ends → Payment captured, status updates to "Paid"

  5. Shiptheory downloads order → Order sent with all edits included

  6. Live edits sync → Changes continue to sync in real-time after download

Setup Instructions

Step 1: Change Payment Capture Setting

  1. Go to Shopify Admin > Settings > Payments

  2. Change Payment capture method to Automatically after fulfillment

  3. Click Save

Step 2: Import Delayed Payment Capture 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 3: Configure Shiptheory Import Settings

Critical: Ensure Shiptheory is configured correctly to download only the right order statuses.

How to Configure:

  1. Log in to Shiptheory

  2. Navigate to Shopify Integration Settings

  3. Configure import settings:

  4. Import: "Paid" ✓

  5. Import: "Partially paid" ✓

  6. Import: "Partially refunded" ✓

  7. Do NOT import: "Authorized" ✗

  8. Do NOT import: "ON-HOLD" ✗

  9. Save settings

Why this matters: If Shiptheory imports "Authorized" orders, it will download orders before the editing period expires.

Reference: Shiptheory Shopify Integration Guide

Integration Limitations

Features Not Supported:

1. Gift Messages

  • Gift messages cannot be edited or synced through Shiptheory integration

2. Upgrading Shipping Methods Post-Purchase

  • Shiptheory does not support shipping method changes during the editing window

Required action: Disable the Shipping Methods App Block in Order Editing to prevent customer confusion.

Settings Summary

In Shopify:

  • Payment capture: Automatically after fulfillment

  • Shopify Flow: Delayed Payment Master Flow active

In Shiptheory:

  • Import: Paid, Partially paid, Partially refunded

  • Do NOT import: Authorized, ON-HOLD

In Order Editing:

  • Shipping Methods App Block: DISABLED

  • Editing Deadline: Configured

Testing

Test before going live:

  1. Place test order

  2. Verify order doesn't appear in Shiptheory immediately

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

  4. Wait for editing period to expire

  5. Confirm order appears in Shiptheory with all edits

  6. Test live edit sync: Make additional changes and verify they appear in Shiptheory

  7. Verify shipping method changes are blocked (App Block disabled)

Troubleshooting

Orders appearing in Shiptheory too early: Verify Shiptheory is NOT importing "Authorized" orders in integration settings

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

Live edits not syncing: Confirm Shiptheory integration is properly connected and configured

Edits not reflecting: Ensure edits were saved successfully before checking Shiptheory

Gift messages not working: This is expected—gift messages are not supported through Shiptheory integration

FAQ?

How do we integrate?

What is Shopify Flow?

PreviousDispatch LabNextTIFS 3PL

Last updated