# 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 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.xorosoft.com/xoroerp-1/connected-apps/xoro-shopify-implementation-deep-dive/order-sync-payment-deposit-and-payout-faqs-with-root-cause-and-fix.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.