Troubleshooting Guide
This concise section covers common issues across API integration, order syncing, inventory updates, product mapping, order processing, and performance. Use it to quickly diagnose and resolve operational problems.
Credentials Issue
Symptoms: Sync failures, connection timeouts, authentication errors
Causes: Invalid credentials, expired tokens, connectivity issues
Fix:
- Validate credentials in Configured Channels → Locations
- Check internet settings
- Resave credentials to refresh token
- Contact support if unresolved
Order Sync Failures
Symptoms: Missing, delayed, or duplicated orders
Causes: Misconfigured sync settings, API lag, system errors, incorrect credentials
Fix:
- Ensure Order Sync Toggle is ON and sync date is correct
- Cross-check order in Shopee portal
- Use Force Create Order in Orders → Failed Orders
Inventory Sync Discrepancies
Symptoms: Mismatched inventory across systems, overselling
Causes: Buffer stock issues, sync errors, inactive locations
Fix:
- Audit inventory across systems
- Check Inventory Logs for sync issues
- Adjust buffer stock, trigger reconciliation manually
- Confirm item is active, location is mapped, and inventory sync is ON
Product Mapping Issues
Symptoms: Products not listed or show incorrect data
Causes: Missing/incorrect Product IDs, status inactive
Fix:
- Check Channel Mapping tab for unmapped SKUs
- Validate and correct Shopee Product IDs
- Use auto-mapping or upload via bulk file
Order Status Update Failures
Symptoms: Status not syncing to Shopee
Fix:
- Update status manually in Orders tab
- Use bulk update tools if needed
Emergency Protocol
Critical: Major outages, sync failures → Contact Fynd Support immediately
Operational: Minor issues → Log ticket, implement workarounds