Blackmann Integration — Shopify Edited Order Sync (Account Editor)

This guide helps merchants using Blackmann (3PL) understand how to configure the integration so that Account Editor order edits are always reflected correctly. Blackmann reads edits based on your iPaaS (Integration Platform as a Service) — the setup depends on which iPaaS you use.

Choose Your Integration Path

Which iPaaS are you using with Blackmann?

✅ Path A — High Cohesion iPaaS

Live edits sync in real-time. Account Editor Delayed Master Flow may not be needed. Jump to Path A below.

🔄 Path B — Other iPaaS / Standard

Orders must be finalized before Blackmann downloads. Requires Account Editor Delayed Master Flow. Jump to Path B below.

Path A — High Cohesion iPaaS (Live Edit Sync)

⚡ High Cohesion — Live Updates with Blackmann

If you are using High Cohesion as your iPaaS with Blackmann, edits sync in real-time. This means:

• ✅ Orders can download to Blackmann immediately
• ✅ Edits made in Account Editor during the editing window sync automatically
• ✅ Account Editor Delayed Master Flow is not necessary
• ✅ No Shopify Flow import required

Step 1 — Order Created

Customer places an order → Order is downloaded by Blackmann via High Cohesion immediately.

Step 2 — Customer Edits Order

Customer opens Account Editor and makes changes — adds items, removes items, changes quantities, updates address.

Step 3 — Live Sync

High Cohesion pushes the edits to Blackmann in real-time. Blackmann's order data is updated automatically — no delay, no manual capture.

Step 4 — Order Shipped

Blackmann ships the order with the latest version of all items, quantities, and details.

Path B — Standard Integration (Account Editor Delayed Master Flow)

If you are not using High Cohesion, or if live sync is not confirmed on your account, use this standard integration method. Blackmann typically downloads orders when payment status is "Paid".

🔄 How the Account Editor Delayed Master Flow Works

Step 1 — Order Created

Customer places an order → Payment is Authorized (not yet captured).

Step 2 — Grace Period Active

The editing window opens. Customer or merchant can edit the order in Account Editor — add items, remove items, change quantities, update address.

Step 3 — Blackmann Skips the Order

Because payment status is still Authorized, Blackmann does not download the order. The order is invisible to Blackmann during the entire editing window.

Step 4 — Grace Period Ends

Shopify Flow automatically captures payment → Status updates to Paid.

Step 5 — Blackmann Downloads

Blackmann sees the order for the first time with all edits already included — correct items, quantities, and totals.

📋 Step 1 — Change Payment Capture Setting in Shopify

Set Shopify to hold payment in Authorized state so Blackmann cannot import the order until editing is complete and payment is captured.

1. Log in to Shopify Admin
2. Go to Settings → Payments
3. Scroll down to Payment capture method
4. Select "Manually capture payment for orders"
5. Click Save

⚡ Step 2 — Import the Account Editor Delayed Master Flow

The Account Editor Delayed Master Flow is a pre-built Shopify Flow automation that holds payment capture for a configurable grace period, then captures automatically — triggering Blackmann to download the finalized order.

1. Download the Account Editor Delayed Master Flow file (provided with this guide)
2. In Shopify Admin, go to Apps → Shopify Flow
3. Click Import and select the downloaded .flow file
4. Configure the grace period timing to match your editing deadline (e.g., 30 minutes)
5. Click Activate to enable the Flow
6. Click Save

🚫 Step 3 — Disable Shipping Methods App Block in Account Editor

Blackmann does not support shipping method changes during the editing window. To prevent customer confusion, you must disable the Shipping Methods App Block in Account Editor settings.

1. Open your Account Editor app settings in Shopify Admin
2. Navigate to the App Blocks or Account Editor configuration
3. Find the Shipping Methods App Block
4. Set it to Disabled
5. Click Save

⏱️ Step 4 — Configure the Editing Deadline

Set how long customers have to edit their order before the grace period expires and payment is captured. This deadline should match the timing configured in the Shopify Flow.

1. Open Account Editor app settings
2. Find the Editing Deadline setting
3. Set the deadline to match your Flow timing (e.g., 30 minutes)
4. Click Save

✏️ Step 5 — Your Account Editor Workflow

Once setup is complete, this is the automated flow for every order:

1. New order arrives → Payment = Authorized (Blackmann does not see it ✅)
2. Grace period active → Customer can edit in Account Editor — add/remove items, change quantities, update address
3. Grace period expires → Shopify Flow automatically captures payment
4. Payment becomes Paid → Blackmann downloads the finalized order ✅
5. Order is shipped with all edits included — no manual intervention needed

What happens after this setup:

• ✅ Correct order total — removed items not counted
• ✅ Added items appear correctly in Blackmann
• ✅ Quantity changes reflected accurately
• ✅ Address changes included in the download
• ✅ No manual payment capture needed — fully automated

Settings Summary

Path A — High Cohesion iPaaS

Path B — Standard (Account Editor Delayed Master Flow)

Testing Checklist

Before going live, run through this checklist to confirm everything works correctly:

• ✅ Place a test order — verify it does not appear in Blackmann immediately (Path B) or appears instantly (Path A)
• ✅ Make edits during the editing window — add/remove items, change address
• ✅ Wait for the editing period to expire (Path B only)
• ✅ Confirm order appears in Blackmann with all edits included
• ✅ Test live edit sync — make additional changes and verify they appear in Blackmann (Path A only)
• ✅ Verify shipping method changes are blocked if using Path B (App Block disabled)

Troubleshooting

Best Practices

• Confirm your iPaaS first — contact High Cohesion and Blackmann to verify whether live sync is active before choosing a path
• If using Path B, keep the grace period short — 30 minutes to 2 hours is ideal
• Always disable the Shipping Methods App Block when using Path B — Blackmann cannot process shipping changes via delayed capture
• Sync the editing deadline in Account Editor with the Flow timing so customers see an accurate countdown
• Monitor Shopify Flow run history after launch to confirm payment captures are firing correctly
• Test the full flow end-to-end before going live with real orders

Need Help?

If orders still don't sync correctly after following this guide, contact Account Editor Support and share:

• Your store URL
• Which iPaaS you are using (High Cohesion or other)
• Screenshot of Shopify → Settings → Payment capture method
• Screenshot of Shopify Flow → Account Editor Delayed Master Flow status and run history (Path B)
• The affected order number

Updated on: 08/04/2026