> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.accounteditor.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Apparel21

### Apparel21 Integration — Shopify Edited Order Sync (Account Editor)
### 

###### This guide helps merchants using **Apparel21** (ERP) understand how to configure the integration so that Account Editor order edits are always reflected correctly. Apparel21 **does not read live edits** — orders must be fully finalized before Apparel21 downloads them.

||| **🛑 Important: Apparel21 has significant limitations with Order Editing. Only basic features are supported. Most Account Editor app blocks must be disabled before going live.**

---

### How the Integration Works

###### Apparel21 downloads orders from Shopify only when payment status is **"Paid"**. The Account Editor Delayed Master Flow creates a grace period between order creation and payment capture — giving you time to complete supported edits before Apparel21 ever sees the order.

### **Step 1 — Order Created**
###### Customer places an order → Payment is **Authorized** (not yet captured).

### **Step 2 — Grace Period Active**
###### The editing window opens. Customer can edit **supported features only** — shipping address, contact information, and invoice download.

### **Step 3 — Apparel21 Skips the Order**
###### Because payment status is still `Authorized`, **Apparel21 does not download the order**. The order is invisible to Apparel21 during the entire editing window.

### **Step 4 — Grace Period Ends**
###### Shopify Flow automatically captures payment → Status updates to '**Paid'**.

### **Step 5 — Apparel21 Downloads**
###### Apparel21 sees the order for the first time with **all supported edits already included**.

---

### Supported vs. Not Supported Features

| **Feature** | **Supported?** |
| ---- |
| Shipping Address Changes | ✅ Supported |
| Contact Information Updates (email, phone) | ✅ Supported |
| Downloadable Invoices | ✅ Supported |
| Product Removal | ❌ Not Supported |
| Product Addition (upsells) | ❌ Not Supported |
| Quantity Changes | ❌ Not Supported |
| Variant Swaps (size, color, etc.) | ❌ Not Supported |
| Shipping Method Updates / Upgrades | ❌ Not Supported |
| Discount Code Applications | ❌ Not Supported |

---

### Step-by-Step Setup

## **📋 Step 1 — Change Payment Capture Setting in Shopify**

###### Set Shopify to hold payment in **Authorized** state so Apparel21 cannot import the order until the editing window has closed 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**" **
5. Click **Save**

|| **⚠️ 7-day limit: Shopify Payments authorizations expire after 7 days. Always ensure your grace period is well within this window.**

---

## **⚡ 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 Apparel21 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**

| [⬇️ Download Account Editor Delayed Master Flow](https://drive.google.com/file/d/1dQ9pnbumzyJNy_NKW6JCSaF1aHCUOmUu/view?usp=sharing)
|| **📝 How the Flow works: When a new order is created, the Flow waits for the configured grace period. After the wait, it automatically captures payment — changing the status from `Authorized` to `Paid`. Apparel21 then downloads the order with all supported edits included.**

---

## **🚫 Step 3 — Disable Unsupported App Blocks in Account Editor**

###### Apparel21 has extensive limitations. You must disable all unsupported Order Editing features to prevent customer confusion and sync errors.

1. Open your **Account Editor** app settings in Shopify Admin
2. Navigate to the **App Blocks** configuration
3. Disable the following blocks one by one:

* **Primary Upsell** — product additions not supported
* **Product Catalog** — product additions not supported
* **Product Quantities** — quantity changes not supported
* **Switch Product Variants** — variant swaps not supported
* **Shipping Methods** — shipping upgrades not supported
* **Post-Purchase Discount Codes** — discount codes not supported
* **Order Cancellations** — product removal not supported

4. Set **Order Downgrade** setting to **OFF** — prevents product removal
5. Click **Save**

||| **🛑 Do not skip this step. If unsupported blocks are left enabled, customers will attempt actions that Apparel21 cannot process — leading to incorrect orders and customer complaints.**

---

## **✏️ Step 4 — Your Account Editor Workflow**

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

1. New order arrives → Payment = **Authorized** *(Apparel21 does not see it ✅)*
2. Grace period active → Customer can use **supported features only** — address update, contact update, invoice download
3. Grace period expires → Shopify Flow **automatically captures payment**
4. Payment becomes **Paid** → Apparel21 downloads the finalized order ✅
5. Order is processed with **all supported edits included**

###### **What happens after this setup:**

* ✅ Shipping address changes reflected in Apparel21
* ✅ Contact information updates included
* ✅ Invoice downloads available to customers
* ✅ Unsupported features hidden from customers
* ✅ No manual payment capture needed — fully automated

|| **✅ Setup complete! Apparel21 will receive the finalized order with all supported edits included. Unsupported features are disabled so customers only see what works.**

---

### Settings Summary

| **Where** | **Setting** | **Value** |
| ---- |
| Shopify → Settings → Payments | Payment capture method | `Automatically after fulfillment` |
| Shopify → Apps → Shopify Flow | Account Editor Delayed Master Flow | **Active** — grace period configured |
| Account Editor → App Blocks | Primary Upsell | **Disabled** |
| Account Editor → App Blocks | Product Catalog | **Disabled** |
| Account Editor → App Blocks | Product Quantities | **Disabled** |
| Account Editor → App Blocks | Switch Product Variants | **Disabled** |
| Account Editor → App Blocks | Shipping Methods | **Disabled** |
| Account Editor → App Blocks | Post-Purchase Discount Codes | **Disabled** |
| Account Editor → App Blocks | Order Cancellations | **Disabled** |
| Account Editor → Settings | Product Remove | **OFF** |

---

### Testing Checklist

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

**Flow & Timing**
* ✅ Place a test order — verify it does **not** appear in Apparel21 immediately
* ✅ Wait for the grace period to expire
* ✅ Confirm payment is captured automatically by the Flow
* ✅ Confirm order appears in Apparel21 with address and contact updates included

**Supported Features**
* ✅ Change shipping address during the editing window — verify it reflects in Apparel21
* ✅ Update contact information — verify it reflects in Apparel21
* ✅ Download invoice — confirm PDF generates correctly

**Unsupported Features (must be blocked)**
* ✅ Confirm customers **cannot** add or remove products
* ✅ Verify quantity changes are **blocked**
* ✅ Check variant swaps are **disabled**
* ✅ Ensure shipping method changes are **blocked**
* ✅ Confirm discount code field is **not visible**

---

### Troubleshooting

| **Issue** | **Likely Cause** | **Fix** |
| ---- |
| Orders appearing in Apparel21 too early | Payment capture not configured correctly, or Flow not activated | Verify payment capture setting and confirm the Account Editor Delayed Master Flow is **Active** |
| Orders not appearing after grace period | Flow is not capturing payment correctly | Open Shopify Flow → check the run history for errors → re-import if needed |
| Customers seeing unsupported features | Unsupported App Blocks still enabled | Double-check all unsupported blocks are **Disabled** in Account Editor settings (see Step 3) |
| Address changes not reflecting in Apparel21 | Edits made after grace period ended | Ensure all edits are completed **before** the grace period expires |
| Authorization expired (no payment captured) | Grace period exceeds 7-day limit | Reduce grace period to well under 7 days (recommended: 30 min – 2 hours) |

---

### Best Practices

* Always disable **all unsupported App Blocks** before going live — Apparel21 cannot handle product additions, removals, variants, or quantity changes
* Keep the grace period short — **30 minutes to 2 hours** is ideal for most stores
* 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 — including all supported and unsupported features — before going live with real orders
* Communicate clearly to customers which editing options are available post-purchase for your store

---

### Need Help?

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

* Your store URL
* Screenshot of Shopify → Settings → Payment capture method
* Screenshot of Shopify Flow → Account Editor Delayed Master Flow status and run history
* Screenshot of Account Editor → App Blocks configuration
* The affected order number