Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Order Sync, Payment, Deposit & Payout FAQs with Root Cause & Fix

🔹 1. FAQs (User Understanding)

  • Why are my Shopify orders showing as “Pending” in XoroERP? Answer: Orders may appear as Pending if the system is unable to allocate payment or deposit at the time of sync.

    This usually happens when:

    • Payment is not yet received in Shopify

    • Payment gateway restrictions exist

    • Payment waiver settings are enabled

    👉 Once payment is available and synced, the system may:

    • Automatically allocate the order

    • Update the order status accordingly

  • Why is the deposit not getting created for my Shopify order in XoroERP? Answer: This is commonly caused by payment configuration settings, especially:

    • Payment Waiver enabled

    • Payment Terms configuration

    • Gateway restrictions

    If the order is created without payment, deposit will not be generated. Once payment is synced later, the system may auto-allocate deposit based on configuration.

  • Why are Shopify orders not syncing at the configured interval (e.g., 15 minutes)? Answer: This indicates a sync timing mismatch issue.

    Even if the sync is configured (e.g., every 15 minutes):

    • Orders may not be picked due to backend delays

    • Integration service may be unavailable

    • System timeout or queue issues

    👉 This should be treated as a critical integration issue, especially if affecting multiple clients.

  • Why am I getting “Account Not Found” errors for gift cards? Answer: This occurs when the Chart of Accounts name has been changed after initial mapping.

    Shopify integration depends on exact account mapping. If the account name is modified:

    • The mapping breaks

    • System cannot identify the account

    👉 Solution:

    • Go to Shopify settings in Xoro

    • Re-select the correct account

    • Save mapping again

  • Why are my payouts not syncing from Shopify to XoroERP? Answer: Payout sync issues can occur due to:

    • Incorrect or missing account configuration

    • Mapping issues

    • Integration failures

    • Specific order-level errors

    👉 Recommended steps:

    • Check payout settings

    • Verify mapping

    • Review related tickets/logs

    • Validate using the correct account credentials

🔹 2. Setting-Related FAQs (Configuration Understanding)

  • How does payment configuration affect Shopify order processing in XoroERP? Answer: Payment configuration directly impacts:

    • Deposit creation

    • Order allocation

    • Order status (Pending vs Allocated)

    Key settings to verify:

    • Payment Terms

    • Payment Waiver

    • Gateway restrictions

    Incorrect configuration can:

    • Prevent deposit creation

    • Keep orders in the Pending state

  • What happens if I change the Chart of Accounts after Shopify mapping is done? Answer: Changing account names breaks the existing Shopify mapping.

    Impact:

    • Gift cards fail

    • Payments fail

    • “Account not found” errors appear

    👉 Always:

    • Re-map accounts after any COA changes

  • Why should we avoid using default tax text (PST/GST/QST) in Canadian Shopify accounts? Answer: Using standard tax combinations as default text can cause:

    • Incorrect tax calculation

    • Mapping errors

    • Order processing issues

    👉 Best Practice:

    • Configure tax properly based on the region

    • Avoid using generic or combined tax defaults

  • How do sync settings impact Shopify integration behavior? Answer: Sync interval settings define how frequently data is fetched.

    However:

    • Sync may fail due to backend issues

    • Timing mismatch may occur

    👉 Sync configuration alone does not guarantee real-time data consistency

🔹 3. User-End Understanding (System Behavior)

  • What happens when a Shopify order is created without payment? Answer: In XoroERP:

    • Order is created

    • No deposit is allocated

    • Status may remain Pending

    Later:

    • If payment is received and synced

    • System may automatically allocate deposit

  • How does XoroERP handle inventory issues during Shopify order sync? Answer: If inventory is insufficient:

    • Orders may get stuck or remain unprocessed

    • System may not allocate inventory

    👉 Recommended approach:

    • Identify such orders

    • Mark them appropriately (e.g., “not restock”)

    • Prevent unwanted auto adjustments

  • What should I do when orders are stuck due to system or inventory issues? Answer:

    • Do not repeatedly rerun processes

    • Identify root cause (inventory / sync / config)

    • Mark resolved if required

    • Report issue if system-related

  • How does XoroERP handle order allocation after sync? Answer: Allocation depends on:

    • Inventory availability

    • Payment status

    • Configuration settings

    Orders may:

    • Auto-allocate

    • Remain pending

    • Update after re-sync

🔹 4. Business Cases (Real Scenarios)

🟩 Case 1: Order Created Without Payment → Deposit Missing

Scenario: Shopify order is synced, but no deposit is created.

Cause:

  • Payment not available

  • Payment waiver enabled

System Behavior:

  • Order remains Pending

  • No deposit allocation

Resolution:

  • Sync payment

  • Verify payment settings

  • Re-sync order if required

🟩 Case 2: Gift Card Error After Account Change

Scenario: Gift card application fails with “Account not found”.

Cause:

  • Chart of Account name changed

System Behavior:

  • Mapping breaks

  • Gift card cannot be applied

Resolution:

  • Re-map account in Shopify settings

  • Save configuration

🟩 Case 3: Orders Not Syncing at Scheduled Interval

Scenario: Orders not syncing despite 15-minute configuration.

Cause:

  • Backend sync delay

  • Integration issue

System Behavior:

  • Orders not picked

  • Delay in processing

Resolution:

  • Report as critical

  • Check logs

  • Escalate to ECOM team

🟩 Case 4: Payout Not Syncing

Scenario: Payout missing for specific order.

Cause:

  • Mapping issue

  • Account configuration

  • System error

Resolution:

  • Verify account mapping

  • Check tickets/logs

🟩 Case 5: Orders Stuck Due to Inventory

Scenario: Orders not processed due to insufficient inventory.

Resolution:

  • Identify such orders

  • Mark appropriately

  • Avoid auto adjustments when inventory updates

🔹 5. Common Issues (Quick Identification)

  • Orders stuck in Pending → Payment / deposit issue

  • Deposit not created → Payment config / waiver issue

  • Gift card errors → COA mapping issue

  • Orders not syncing → Sync timing / service issue

  • Payout missing → Mapping / account issue

  • Inventory errors → Insufficient stock

  • Timeout / service unavailable → Backend / integration issue

  • Product import errors → Variant / option mismatch

🔥 Why This Structure Works (Important)

This is now:

  • Chatbot-ready → Clear intent-based questions

  • User-friendly → Explains “why + what + how”

  • Scalable → You can keep adding cases

  • Support-reducing → Covers real-world scenarios

PreviousOrders Created Without Payment (Shopify Integration)
Next3PL Connections

Last updated

Was this helpful?